Create Volumes

To create a new volume, use

applications volumes create --application=<app_name> --volume=<vol_name> --capacity=<capacity> --pool=<pname> --n=<n> --k=<k> [--groupedVolume=<name> | --cgid=<numbers> | (--encryptionKey=<encryptionKey> [--saveEncryptedRecoveryKey])]

This is a short version of the applications volumes create command. For a full description please refer to Creating a logical volume.

Required parameters

• --application=<app_name>: The application that the volume will be associated with.
• --volume=<vol_name>: The volume name. Replace <vol_name> with any unique (within the application instance) name of your choice.
• --capacity=<capacity>: The storage capacity for the newly created volume. Replace <capacity> with a number appended by capacity storage units (M or MB, G or GB, T or TB, and so on).
• --pool=<pname> The pool that will be used for the underlying storage media.
• --n=<n>: The number of data fragments for the volume. Replace <n> with the number of fragments. This must be in powers of two, typically 1, 2, 4, or 8.
• --k=<k>: Specify redundancy level, namely the number of simultaneous drive failures that the logical volume can sustain before losing data. Replace <k> with a numerical value for the redundancy level.

Optional parameters

• To specify an existing consistency group for a newly created volume, use one of the following options:

  Option	Description
  --groupedVolume=<name>	Use this option to add the new volume to the same consistency group as the existing volume specified by <name>.
  --cgid=<numbers>	Use this option to specify the ID of an existing consistency group to which the volume will be added.

  Note that when using one of these options, the system does not create a new consistency group for the volume. Instead, the volume is mapped to the consistency group that was specified.

• If you do not map the volume to an existing consistency group, the system creates a new consistency group for the volume. In this case, you can choose to encrypt the new consistency group. To encrypt the new consistency group, you must use the --encryptionKey option. The --saveEncryptedRecoveryKey is optional. Note: Encrypting the consistency group is a permanent operation.

  • --encryptionKey=<encryptionKey>: Specify an encryption key for the consistency group. Replace <encryptionKey> with an encryption password of your choice.
  • --saveEncryptedRecoveryKey: This is an optional feature. StorONE gives you the option to store your volume encryption key securely with StorONE. This way, we can assist you in recovering a volume encryption key if necessary. When you use this option, your encryption key will be encrypted using the StorONE public key and stored in your S1 relay station database.

Examples

1. To create a volume videos on application instance training with a capacity of 500GB using media pool HDD1 with n=8 data fragments and k=2 data redundancy, run:

   applications volumes create --application training --volume videos --capacity 500GB --pool HDD1 --n=8 --k=2
   

S1 creates a new consistency group for the newly created volume videos.

2. To create a volume with the same parameters as in example 1, but with an encrypted consistency group using the key CorrectHorseBatteryStaple, run the following command:

   applications volumes create --application training --volume videos --capacity 500GB --pool HDD1 --n=8 --k=2 --encryptionKey CorrectHorseBatteryStaple
   

What to do next

After creating a volume, map it to a Storage Area Network (SAN) for block storage, or add a filesystem to the volume for file or object storage.