Skip to content

Datastore Add

Below are steps to add a new datastore to a Proxmox cluster.
It is assumed that the volume has already been created on the relevant storage device and mapped to all of the proxmox cluster nodes. If not, look at Volume/LUN Tasks to create a volume

Volume Group Creation

Information

Run the following steps on ONLY ONE of the cluster nodes

iSCSI Rescan

Inform the host to check for new device paths 

iscsiadm -m node --rescan

Multipath Rescan

Inform the multipath driver to check and consolidate the newly added device paths 

multipath -r
You can confirm that the device is found by running multipath -l. Take note of the new multipath device (e.g. mpathd is the new device, so our dev mapper would be /dev/mapper/mpathd)

Add volume to LVM

You will now need to add the volume to the hosts LVM configuration 

pvcreate /dev/mapper/<mpath_device>

Volume Group

We now need to create the volume group.

New Volume Group

Our standard (default) pattern for flash arrays is to create a dedicated volume group for each mapped volume. You can now create a volume group for that volume 

vgcreate VGNAME /dev/mapper/<mpath_device>
vgs

Extend existing Volume Group

Not applicable at this point in time. If you need help with this please ask, and we'll add it to the guide

Volume Group Discovery

You will now need to inform all of the cluster nodes that there is an LVM volume group that can be used.

Information

Run the following steps on ALL of the cluster nodes

You can execute all of the below commands on all nodes with Oxide Cluster Run (e.g. oxide -j1pi 'whomai', where j1pi is the jnb1 proxmox internal/uat cluster (use oxide --help for other cluster options))

iSCSI Rescan

Inform the hosts to check for new device paths 

iscsiadm -m node --rescan

Multipath Rescan

Inform the multipath drivers to check and consolidate the newly added device paths 

multipath -r
You can confirm that the device is found by running multipath -l. Take note of the new multipath device (e.g. mpathd is the new device, so our dev mapper would be /dev/mapper/mpathd)

Add volume to LVM

You can now trigger LVM on each host to scan and add the new volume group into it's inventory.

pvscan
pvs
You should see the PV and a VG in the output of pvs

Add datastore to Proxmox

You can now finally add the storage to the cluster

Storage wizard

Click Datacentre -> Storage -> Add -> LVM

Settings

Please configure the below settings for the datastore

  1. Provide a meaningful ID, as it cannot be changed without being removed (keep it the same as the volume group name if possible)
  2. In the Volume Group drop-down, you should now be able to select your new volume group (e.g. VGNAME). Select it.
  3. Toggle Shared on
  4. You can leave all of the rest as default

Click Add

Validation

  1. Look at the data centre inventory on the left (make sure you're in Server View)
  2. Expand all servers so that you can see their contents
  3. Your storage (meaningful ID) should now show in the side bar under each server
  4. It may start with a grey circle simple on it.
  5. After several seconds the symbol should disappear

Billing

Warning

Now you add it to BILLING.

Add the unique volume name (that you created on the pure) linked with the pfa_m2m sku to the relevant customer.