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-xxxxxxxx-xxxx-xxxx-xxxx-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: xxxxxxxx-xxxx-xxxx-xxxx-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 xxxxxxxx-xxxx-xxxx-xxxx-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	: xxxxxxxx-xxxx-xxxx-xxxx-502e658bc307
	Fastpath replicas	: 1
	Fastpath replica property follows:
		Replica	: 0
			On Node		: xxxxxxxx-xxxx-xxxx-xxxx-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:  xxxxxxxx-xxxx-xxxx-xxxx-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 xxxxxxxx-xxxx-xxxx-xxxx-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.