Skip to main content
Version: 3.1

PX-Fast volumes using pxctl

This section provides instructions for performing operations on PX-Fast volumes using pxctl.

Create a PX-Fast volume

To create a PX-fast volume, run the following command on any of the worker nodes of your cluster:

pxctl volume create --fastpath <px-volume>
Volume successfully created: 913654286436616938

Attach a volume

Attach you PX-Fast volume to the host on the same node:

pxctl host attach <px-volume>

List volumes in your cluster

Run the following command to get the list of volumes within a cluster:

pxctl volume list
ID          NAME                        SIZE    HA  SHARED  ENCRYPTED   PROXY-VOLUME    IO_PRIORITY STATUS      SNAP-ENABLED    
1150247763189801500 pvc-d7941878-19c9-43d3-b404-84d9193d55a5 2 GiB no no no LOW up - detached no
79554029234843357 v1 1 GiB no no no LOW up - detached no
909303106655754070 v2 1 GiB no no no LOW up - attached on 10.13.160.65 no

Note the ID or name of one of the volume; you can use it to view details using the pxctl command.

Get volume details

Run the following command to get the detailed PX-Fast setting and usage information for a volume:

pxctl volume inspect -e <px-volume>
Volume               :  909303106655754070
Name : v2
Size : 1.0 GiB
Format : ext4
HA : 1
IO Priority : LOW
Creation time : Oct 11 01:43:36 UTC 2022
Shared : no
Status : up
State : Attached: 0c99e1f2-9d49-4d53-9315-502e658bc307 (10.13.160.65)
Last Attached : Oct 11 01:43:42 UTC 2022
Device Path : /dev/pxd/pxd909303106655754070
Mount Options : discard
Reads : 40
Reads MS : 20
Bytes Read : 1060864
Writes : 0
Writes MS : 0
Bytes Written : 0
IOs in progress : 0
Bytes used : 33 MiB
Replica sets on nodes:
Set 0
Node : 10.13.160.65 (Pool 8ec9e6aa-7726-4855-a9f1-f9131bf7ef9d )
Replication Status : Up

Displaying extended volume state:
Fastpath preferred : true
Fastpath promoted : true
Fastpath dirty : false
Fastpath force failover : false
Fastpath attached : FASTPATH_ACTIVE
Fastpath coordinator : 0c99e1f2-9d49-4d53-9315-502e658bc307
Fastpath replicas : 1
Fastpath replica property follows:
Replica : 0
On Node : 0c99e1f2-9d49-4d53-9315-502e658bc307
Protocol : FASTPATH_PROTO_LOCAL
Secure : true
Exported : true
Target : /dev/pwx0/909303106655754070
Source : /dev/pwx0/909303106655754070
Type : Block device
Imported : true
Mapped local device: /dev/pwx0/909303106655754070

Get pool details servicing your volume

Run the following command to view the details of the pool servicing your volume:

pxctl service pool show
PX drive configuration:
Pool ID: 0
Type: PX-StoreV2
UUID: 58ab2e3f-a22e-492a-ad39-db8abe01d4f0
IO Priority: HIGH
Labels: medium=STORAGE_MEDIUM_SSD,beta.kubernetes.io/arch=amd64,beta.kubernetes.io/os=linux,iopriority=HIGH,kubernetes.io/arch=amd64,kubernetes.io/hostname=username-vms-silver-sight-3,kubernetes.io/os=linux
Size: 25 GiB
Status: Online
Has metadata: No
Balanced: Yes
Drives:
0: /dev/sda, Total size 32 GiB, Online
Cache Drives:
No Cache drives found in this pool
Metadata Device:
1: /dev/sdd, STORAGE_MEDIUM_SSD

Update a volume to enable PX-Fast

You can update an exiting volume to use the PX-Fast functionality by running the following command:

pxctl volume update --fastpath <px-volume>

Volume : 289859383805313381
Name : v5
Size : 1.0 GiB
Format : ext4
HA : 1
IO Priority : LOW
Creation time : Oct 14 02:35:02 UTC 2022
Shared : no
Status : up
State : detached
Mount Options : discard
Reads : 0
Reads MS : 0
Bytes Read : 0
Writes : 0
Writes MS : 0
Bytes Written : 0
IOs in progress : 0
Bytes used : 1.0 MiB
Replica sets on nodes:
Set 0
Node : 10.13.161.121 (Pool 06fcc73a-7e2f-4365-95ce-434152789beb )
Replication Status : Detached

Displaying extended volume state:
Fastpath preferred : true
Fastpath promoted : false
Fastpath dirty : false
Fastpath force failover : false
Fastpath attached : FASTPATH_INACTIVE

Fastpath preferred : true means that this volume can use PX-Fast functionality if it is a one replica volume and attached locally.

Was this page helpful?