Managing Host Storage

StorageOS uses the storage available on the nodes where it is installed to present as available for volumes.

In order to mitigate against problems caused by filling the host root disk, we recommend mounting a separate device into the /var/lib/storageos directory. StorageOS is agnostic to the type of filesystem mounted in /var/lib/storageos.

Extending Available Storage

StorageOS uses subdirectories of /var/lib/storageos/data to hold user data. By default, the directory /var/lib/storageos/data/dev1 will be created when a node is bootstrapped, and used for pool data. It is possible to shard the data by creating more directories into this structure. StorageOS will save data in any directory that conforms to the pattern /var/lib/storageos/data/dev[0-9]+, such as /var/lib/storageos/data/dev2 or /var/lib/storageos/data/dev5. This functionality enables operators to mount different devices into devX directories and StorageOS will recognise them as available storage automatically.

There are two possible options to expand the available disk space for StorageOS to allocate:

1. Mount filesystem in /var/lib/storageos/data/devX
2. Use LVM to expand the logical volume available to StorageOS

Option 1: Mount Additional Devices

This option enables operators to expand the cluster’s available space at any time without having to stop applications or forcing operational downtime. The expansion of disk is transparent for applications and StorageOS Volumes. StorageOS will use the new available space to create new data files.

1. Context

   We assume that there is a disk available in our Linux system without formatting in addition to the root filesystem. StorageOS data dir dev1 (/var/lib/storageos/data/dev1) is using /dev/xvda1. We will use the device /dev/xvdf to expand StorageOS available space.

   List available block devices in the host.

   root@node0:~# lsblk
   NAME    MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
   xvda    202:0    0  128G  0 disk
   `-xvda1 202:1    0  128G  0 part /
   xvdf    202:80   0  100G  0 disk
   

   Check StorageOS cluster’s available capacity.

   $ storageos get node -ojson | jq -r '.[] | { name: .name, capacity: .capacity.total  }'
   "node0"
   137,438,953,472
   "node1"
   137,438,953,472
   "node2"
   137,438,953,472
   

2. Format device

   root@node0:/var/lib/storageos/data# mkfs -t ext4 /dev/xvdf
   mke2fs 1.42.12 (29-Aug-2014)
   Creating filesystem with 26214400 4k blocks and 6553600 inodes
   Filesystem UUID: 380712fa-6f82-477a-81a5-d7466d4c6b7f
   Superblock backups stored on blocks:
           32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208,
           4096000, 7962624, 11239424, 20480000, 23887872
   
   Allocating group tables: done
   Writing inode tables: done
   Creating journal (32768 blocks): done
   Writing superblocks and filesystem accounting information: done
   

3. Mount filesystem

   root@node0:~# mkdir -p /var/lib/storageos/data/dev2
   root@node0:~# mount /dev/xvdf /var/lib/storageos/data/dev2
   

4. Verify available storage

   In less than 30 seconds, StorageOS will see the new available capacity.

   $ storageos get node -ojson | jq -r '.[] | { name: .name, capacity: .capacity.total  }'
   "node0"
   244,491,013,324
   "node1"
   137,438,953,472
   "node2"
   137,438,953,472
   

   Note that the node node0 has increased the TOTAL capacity in 100Gi.

Persist the mount at boot by adding the mount endpoint to /etc/fstab

Option 2: Expand Existing Devices Backed by LVM

This option enables operators to take advantage of LVM to manage disks.

1. Context

   We assume that /var/lib/storageos is mounted onto an LVM volume. We are using a volumegroup named storageos and logical volume called data. There is a second physical disk /dev/xvdg unused.

   List available block devices in the host.

   root@node2:~# lsblk
   NAME             MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
   xvda             202:0    0  128G  0 disk
   `-xvda1          202:1    0  128G  0 part /
   xvdf             202:80   0  100G  0 disk
   `-storageos-data 254:0    0   99G  0 lvm  /var/lib/storageos
   xvdg             202:96   0  100G  0 disk
   

   Check StorageOS cluster’s available capacity.

   $ storageos get node -ojson | jq -r '.[] | { name: .name, capacity: .capacity.total  }'
   "node0"
   137,438,953,472
   "node1"
   137,438,953,472
   "node2"
   107,696,304,947 # --> LVM storageos/data volume
   

2. Add physical disk to LVM

   root@node2:~# vgextend storageos /dev/xvdg
     Volume group "storageos" successfully extended
   

   The volume group storageos must have 2 physical volumes (#PV)

   root@node2:~# vgs
     VG        #PV #LV #SN Attr   VSize   VFree
     storageos   2   1   0 wz--n- 199.99g 104.99g
   

3. Extend logical volume data

   root@node2:~# lvextend -L+100G /dev/storageos/data
     Size of logical volume storageos/data changed from 95.00 GiB (24320 extents) to 195.00 GiB (49920 extents).
     Logical volume data successfully resized
   

4. Resize the FileSystem

   Your filesystem must support the option to be expanded, and to do so while in use. Otherwise, you need to unmount first.

   root@node2:~# resize2fs /dev/storageos/data
   resize2fs 1.42.12 (29-Aug-2014)
   Filesystem at /dev/storageos/data is mounted on /var/lib/storageos; on-line resizing required
   old_desc_blocks = 6, new_desc_blocks = 13
   The filesystem on /dev/storageos/data is now 51118080 (4k) blocks long.
   

5. Check new available space

   The mounted file system to /var/lib/storageos has increased its size.

   root@node2:~# df -h /dev/mapper/storageos-data
   Filesystem                  Size  Used Avail Use% Mounted on
   /dev/mapper/storageos-data  192G   60M  183G   1% /var/lib/storageos
   

   StorageOS available storage has increased too.

   $ storageos get node -ojson | jq -r '.[] | { name: .name, capacity: .capacity.total  }'
   "node0"
   137,438,953,472
   "node1"
   137,438,953,472
   "node2"
   206,158,430,208 # --> 100G more available
   

Persist the mount at boot by adding the mount point to /etc/fstab