From 76cb4969235ce76f4776971432d3fd74e7e04f27 Mon Sep 17 00:00:00 2001 From: Nicole Rappe Date: Tue, 14 Jan 2025 18:28:34 -0700 Subject: [PATCH] Update Workflows/Linux/Expand iSCSI-Based ZFS Filesystem.md --- .../Expand iSCSI-Based ZFS Filesystem.md | 33 ++++++++++++------- 1 file changed, 22 insertions(+), 11 deletions(-) diff --git a/Workflows/Linux/Expand iSCSI-Based ZFS Filesystem.md b/Workflows/Linux/Expand iSCSI-Based ZFS Filesystem.md index fffce2a..65255ff 100644 --- a/Workflows/Linux/Expand iSCSI-Based ZFS Filesystem.md +++ b/Workflows/Linux/Expand iSCSI-Based ZFS Filesystem.md @@ -7,23 +7,34 @@ The purpose of this workflow is to illustrate the process of expanding storage f This document also assumes you did not enable Logical Volume Management (LVM) when deploying your server. If you did, you will need to perform additional LVM-specific steps after increasing the space. ## Increase iSCSI Disk Size -This part should be fairly straight-forward. Using whatever hypervisor/storage appliance hosting the iSCSI target, expand the disk space of the LUN to the desired size. +This part should be fairly straight-forward. Using whatever hypervisor / storage appliance hosting the iSCSI target, expand the disk space of the LUN to the desired size. ## Extend ZFS Pool This step goes over how to increase the usable space of the ZFS pool within the server itself after it was expanded. ``` sh iscsiadm -m session --rescan # (1) -parted /dev/sdX # (2) -unit TB # (3) -resizepart X XXTB # (4) -zpool online -e /dev/sdX # (5) -zpool scrub # (6) +lsblk # (2) +parted /dev/sdX # (3) +unit TB # (4) +resizepart X XXTB # (5) +zpool list # (6) +zpool online -e /dev/sdX # (7) +zpool scrub # (8) ``` 1. Re-scan iSCSI targets for changes. -2. Open partitioning utility on the ZFS volume / LUN / iSCSI disk. Replace `dev/sdX` with the actual device name. -3. Self-explanatory storage measurement. -4. Resizes whatever partition is given to fit the new storage capacity. Replace `X` with the partition number. Replace `XXTB` with a valid value, such as `10TB`. -5. Brings the ZFS Pool back online. Replace `` with the actual name of the ZFS pool. -6. This tells the system to scan the ZFS pool for any errors or corruption and correct them. Think of it as a form of housekeeping. \ No newline at end of file +2. Leverage `lsblk` to ensure that the storage size increase from the hypervisor / storage appliance reflects correctly. +3. Open partitioning utility on the ZFS volume / LUN / iSCSI disk. Replace `dev/sdX` with the actual device name. +4. Self-explanatory storage measurement. +5. Resizes whatever partition is given to fit the new storage capacity. Replace `X` with the partition number. Replace `XXTB` with a valid value, such as `10TB`. +6. This will allow you to list all ZFS pools that are available for the next command. +7. Brings the ZFS Pool back online. Replace `` with the actual name of the ZFS pool. +8. This tells the system to scan the ZFS pool for any errors or corruption and correct them. Think of it as a form of housekeeping. + +## Check on Scrubbing Progress +At this point, the ZFS pool has been expanded and a scrub task has been started. The scrubbing task can take several hours / dayas to run, so to keep track of it, you can run the following command to check the status of the ZFS pool / scrubbing task. + +```sh +zpool status +``` \ No newline at end of file