psm jcs add-storage

Use this command to add block storage to a node without changing the instance compute shape. Be aware that, if you add additional block storage, you cannot remove it later.
If you plan to add storage to a node, be aware of the following:
  • You can scale a node only if a version of Oracle Java Cloud Service that supports scaling a node was used to create your service instance.

  • You cannot add storage to a node running on Oracle Java Cloud Service - Virtual Image instances.

Storage Limits

Product Version Storage Limits
Oracle Cloud Infrastructure Classic You can perform up to 6 add-storage operations. Each time, you can add from 1 to 2000 GB.
Oracle Cloud Infrastructure You can run up to 17 add-storage operations. In each operation, you can add capacity in 50-GB multiples up to a maximum of 2000 GB.

Note:

Every time you add storage to a volume, that counts as an "operation" for the purpose of these limits.

Syntax

In the following syntax, line breaks have been added for clarity. Do not include them when entering the command.

psm jcs add-storage -s|--service-name serviceName
    -c|—config-payload pathToJson
    [-of|--output-format json|html|short]
    [-wc|--wait-until-complete true|false]

Parameters

All parameters are required unless otherwise specified.

Parameter Description
-s|--serviceName serviceName Name of the Oracle Java Cloud Service instance.
-c|—config-payload pathToJson Specifies the path to the JSON file containing the information necessary to add storage to a Java Cloud Service instance. The format of this file, as shown in Sample Payloads, is the same as the request body you provide when adding storage to a Java Cloud Service instance by using the REST API. For information about this format, see the Request/Body (addstorage-postrequestm) section of Add Storage to an Existing or New Volume in the REST API for Oracle Java Cloud Service.
-of|--output-format json|html|short (Optional) Output format of the command’s response:

Accepted values: json, html, short

The default output format is the one you specified when using the psm setup command to configure the psm CLI.

-wc|--wait-until-complete true|false

(Optional) A boolean value that, when set to true, makes the command behave synchronously; that is, it does not return until the submitted job is complete. The following message is displayed until the job is complete:
Waiting for the job to complete... (it cannot be cancelled)
Default: false

Sample Payloads

Note:

You can find parameter descriptions for the following sample payloads in the Request/Body (addstorage-postrequestm) section of Add Storage to an Existing or New Volume in the REST API for Oracle Java Cloud Service.

The following payloads are used to add block storage to an Oracle Java Cloud Service instance. The first example will add storage to the domains volume. This example adds 2 GB of storage.

{
   "components": {
      "WLS": {
         "domain": 2,
         "hosts":["exampleinstance-wls-1"]
		}
	}
}

This example will add a user defined partition, which is created in a new volume named user_defined_partitions. Subsequent user defined partitions are added to the same user_defined_partitions volume. This example adds 2 GB of storage.

{
   "components": {
      "WLS": {
         "user_defined_partitions": 2,
         "hosts":["exampleinstance-wls-1"]
    }
  }
}

Examples

$ psm jcs add-storage -s ExampleInstance  -c c://home/templates/my-new-storage.json -of json