launch
******


Description
===========

Launches a new DB System in the specified compartment and Availability
Domain. You'll specify a single Oracle Database Edition that applies
to all the databases on that DB System. The selected edition cannot be
changed.

An initial database is created on the DB System based on the request
parameters you provide and some default options. For more information,
see Default Options for the Initial Database.

The DB System will include a command line interface (CLI) that you can
use to create additional databases and manage existing databases. For
more information, see the Oracle Database CLI Reference.


Usage
=====

   oci db system launch [OPTIONS]


Options
=======


--availability-domain [text]
----------------------------

The Availability Domain where the DB System is located. [required]


--compartment-id, -c [text]
---------------------------

The Oracle Cloud ID (OCID) of the compartment the DB System  belongs
in. [required]


--cpu-core-count [integer]
--------------------------

The number of CPU cores to enable. The valid values depend on the
specified shape:

* BM.DenseIO1.36 and BM.HighIO1.36 - Specify a multiple of 2, from 2
  to 36. - BM.RACLocalStorage1.72 - Specify a multiple of 4, from 4 to
  72. - Exadata.Quarter1.84 - Specify a multiple of 2, from 22 to 84.
  - Exadata.Half1.168 - Specify a multiple of 4, from 44 to 168. -
  Exadata.Full1.336 - Specify a multiple of 8, from 88 to 336.
  [required]


--database-edition [STANDARD_EDITION|ENTERPRISE_EDITION|ENTERPRISE_EDITION_EXTREME_PERFORMANCE|ENTERPRISE_EDITION_HIGH_PERFORMANCE]
-----------------------------------------------------------------------------------------------------------------------------------

The Oracle Database Edition that applies to all the databases on the
DB System.

Exadata DB Systems and 2-node RAC DB Systems require
ENTERPRISE_EDITION_EXTREME_PERFORMANCE. [required]


--hostname [text]
-----------------

The host name for the DB System. The host name must begin with an
alphabetic character and can contain a maximum of 30 alphanumeric
characters, including hyphens (-).

The maximum length of the combined hostname and domain is 63
characters.

**Note:** The hostname must be unique within the subnet. If it is not
unique, the DB System will fail to provision. [required]


--shape [text]
--------------

The shape of the DB System. The shape determines resources allocated
to the DB System - CPU cores and memory for VM shapes; CPU cores,
memory and storage for non-VM (or bare metal) shapes. To get a list of
shapes, use the ListDbSystemShapes operation. [required]


--subnet-id [text]
------------------

The OCID of the subnet the DB System is associated with.

**Subnet Restrictions:** - For single node and 2-node (RAC) DB
Systems, do not use a subnet that overlaps with 192.168.16.16/28 - For
Exadata and VM-based RAC DB Systems, do not use a subnet that overlaps
with 192.168.128.0/20

These subnets are used by the Oracle Clusterware private interconnect
on the database instance. Specifying an overlapping subnet will cause
the private interconnect to malfunction. This restriction applies to
both the client subnet and backup subnet. [required]


--backup-subnet-id [text]
-------------------------

The OCID of the backup network subnet the DB System is associated
with. Applicable only to Exadata.

**Subnet Restrictions:** See above subnetId's **Subnet Restriction**.


--cluster-name [text]
---------------------

Cluster name for Exadata and 2-node RAC DB Systems. The cluster name
must begin with an an alphabetic character, and may contain hyphens
(-). Underscores (_) are not permitted. The cluster name can be no
longer than 11 characters and is not case sensitive.


--data-storage-percentage [integer]
-----------------------------------

The percentage assigned to DATA storage (user data and database
files). The remaining percentage is assigned to RECO storage (database
redo logs, archive logs, and recovery manager backups). Specify 80 or
40. The default is 80 percent assigned to DATA storage. This is not
applicable for VM based DB systems.


--defined-tags [complex type]
-----------------------------

Defined tags for this resource. Each key is predefined and scoped to a
namespace. For more information, see Resource Tags.

Example: *{"Operations": {"CostCenter": "42"}}* This is a complex type
whose value must be valid JSON. The value can be provided as a string
on the command line or passed in as a file using the
file://path/to/file syntax.

The --generate-param-json-input option can be used to generate an
example of the JSON which must be provided. We recommend storing this
example in a file, modifying it as needed and then passing it back in
via the file:// syntax.


--disk-redundancy [HIGH|NORMAL]
-------------------------------

The type of redundancy configured for the DB System. Normal is 2-way
redundancy, recommended for test and development systems. High is
3-way redundancy, recommended for production systems.


--display-name [text]
---------------------

The user-friendly name for the DB System. It does not have to be
unique.


--domain [text]
---------------

A domain name used for the DB System. If the Oracle-provided Internet
and VCN Resolver is enabled for the specified subnet, the domain name
for the subnet is used (don't provide one). Otherwise, provide a valid
DNS domain name. Hyphens (-) are not permitted.


--freeform-tags [complex type]
------------------------------

Free-form tags for this resource. Each tag is a simple key-value pair
with no predefined name, type, or namespace. For more information, see
Resource Tags.

Example: *{"Department": "Finance"}* This is a complex type whose
value must be valid JSON. The value can be provided as a string on the
command line or passed in as a file using the file://path/to/file
syntax.

The --generate-param-json-input option can be used to generate an
example of the JSON which must be provided. We recommend storing this
example in a file, modifying it as needed and then passing it back in
via the file:// syntax.


--initial-data-storage-size-in-gb [integer]
-------------------------------------------

Size, in GBs, of the initial data volume that will be created and
attached to VM-shape based DB system. This storage can later be scaled
up if needed. Note that the total storage size attached will be more
than what is requested, to account for REDO/RECO space and software
volume.


--license-model [LICENSE_INCLUDED|BRING_YOUR_OWN_LICENSE]
---------------------------------------------------------

The Oracle license model that applies to all the databases on the DB
System. The default is LICENSE_INCLUDED.


--node-count [integer]
----------------------

Number of nodes to launch for a VM-shape based RAC DB system.


--wait-for-state [PROVISIONING|AVAILABLE|UPDATING|TERMINATING|TERMINATED|FAILED]
--------------------------------------------------------------------------------

This operation creates, modifies or deletes a resource that has a
defined lifecycle state. Specify this option to perform the action and
then wait until the resource reaches a given lifecycle state.


--max-wait-seconds [integer]
----------------------------

The maximum time to wait for the resource to reach the lifecycle state
defined by --wait-for-state. Defaults to 1200 seconds.


--wait-interval-seconds [integer]
---------------------------------

Check every --wait-interval-seconds to see whether the resource to see
if it has reached the lifecycle state defined by --wait-for-state.
Defaults to 30 seconds.


--admin-password [text]
-----------------------

A strong password for SYS, SYSTEM, and PDB Admin. The password must be
at least nine characters and contain at least two uppercase, two
lowercase, two numbers, and two special characters. The special
characters must be _, #, or -. [required]


--character-set [text]
----------------------

The character set for the database. The default is AL32UTF8. Allowed
values are: AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715,
AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768,
AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E,
BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257,
BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5,
CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251,
EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852,
EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851,
EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861,
IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC,
JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSCCS,
KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772,
LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10,
NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3,
TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254,
TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC,
WE8DG, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252,
WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8,
ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS,
ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS.


--db-name [text]
----------------

The database name. It must begin with an alphabetic character and can
contain a maximum of eight alphanumeric characters. Special characters
are not permitted. [required]


--db-version [text]
-------------------

A valid Oracle database version. To get a list of supported versions,
use the command 'oci db version list'. [required]


--db-workload [text]
--------------------

Database workload type. Allowed values are: OLTP, DSS


--ncharacter-set [text]
-----------------------

National character set for the database. The default is AL16UTF16.
Allowed values are: AL16UTF16 or UTF8.


--pdb-name [text]
-----------------

Pluggable database name. It must begin with an alphabetic character
and can contain a maximum of eight alphanumeric characters. Special
characters are not permitted. Pluggable database should not be same as
database name.


--ssh-authorized-keys-file [filename]
-------------------------------------

A file containing one or more public SSH keys to use for SSH access to
the DB System. Use a newline character to separate multiple keys. The
length of the combined keys cannot exceed 10,000 characters.


--from-json [text]
------------------

Provide input to this command as a JSON document from a file.

Options can still be provided on the command line. If an option exists
in both the JSON document and the command line then the command line
specified value will be used


-?, -h, --help
--------------

Show this message and exit.
