pxc_volume_create.md

pxc volume create

Create a volume in Portworx

pxc volume create [NAME] [flags]

Examples

  # Create a volume called "myvolume" with size as 3GiB and replicas set to 3:
  pxc volume create myvolume --size=3 --replicas=3

  # Create a volume called "myvolume" with label as "access=slow" and size as 3 GiB:
  pxc volume create myvolume --size=3 --labels 'access=slow'

  # Create a volume with daily snapshot policy at 00h:10m with retain=2 (maintaing two snapshot copies at a given time):
  pxc volume create snapvol --daily 00:10,2

  # Create a volume with weekly snapshot for every monday at 00h:12m with retain=2 (maintaing two snapshot copies at a given time):
  pxc volume create snapvol --weekly monday@00:12,2

  # Create a volume with monthly snapshot on 25th of every month at 10h:10m with retain=2 (maintaing two snapshot copies at a given time):
  pxc volume create snapvol --monthly 25@10:10,2

Options

      --size int                   Size in GiB
      --replicas int               Number of replicas also called HA level [1-3] (default 1)
      --shared                     Shared volume using sharedv4 model
      --deprecated-shared          Shared volume (deprecated)
      --labels string              Comma separated list of labels as key-value pairs: 'k1=v1,k2=v2'
      --fs string                  Filesystem type for the volume [none, ext4] (default "ext4")
      --sticky                     Sticky volume
      --journal                    Journal data for this volume
      --encryption                 encrypt this volume
      --aggregation-level uint32   aggregation level (Valid Values: [1, 2, 3] (default 1)
      --nodes strings              Replica set nodes for this volume
      --io-profile string          IO Profile (Valid Values: [sequential cms db db_remote sync_shared]) (default "sequential")
      --groups string              list of group with volume access details, 'group1:r, group2:w'
      --collaborators string       list of collaborators with volume access details, 'user1:r, user2:w'
      --queue-depth uint32         block device queue depth (Valid Range: [1 256]) (default 128)
      --early-ack                  Reply to async write requests after it is copied to shared memory
      --async-io                   Enable async IO to backing storage
      --nodiscard                  Disable discard support for this volume
      --group-enforced             Enforce group during provision
      --scale uint32               auto scale to max number (Valid Range: [1 1024]) (default 1)
      --passphrase string          Passphrase for an encrypted volume
      --periodic string            periodic snapshot interval in mins,k (keeps 5 by default), 0 disables all schedule snapshots
      --daily strings              daily snapshot at specified hh:mm,k (keeps 7 by default)
      --weekly strings             weekly snapshot at specified weekday@hh:mm,k (keeps 5 by default)
      --monthly strings            monthly snapshot at specified day@hh:mm,k (keeps 12 by default)
      --policy string              Schedule policy names separated by comma
  -h, --help                       help for create

Options inherited from parent commands

      --pxc.config string       Config file (default is $HOME/.pxc/config.yml)
      --pxc.config-dir string   Config directory (default "/home2/lpabon/.pxc")
      --pxc.context string      Force context name for the command
      --pxc.token string        Portworx authentication token
      --pxc.v int32             [0-3] Log level verbosity

SEE ALSO

• pxc volume - Volume life cycle management

Auto generated by spf13/cobra on 29-Sep-2021