6.1 HP IBRIX X9000 Network Storage System CLI Reference (TA768-96057, June 2012)

upgrade60.sh
Upgrades pre-6.0 file systems for software snapshots.
Description
To support software snapshots, the inode format was changed in the X9000 6.0 release. The
upgrade60.sh utility upgrades a file system created on a pre-6.0 release, enabling software
snapshots to be taken on the file system.
The utility can also determine the needed conversions without actually performing the upgrade.
When using the utility, you should be aware of the following:
• The file system must be unmounted.
• Segments marked as BAD are not upgraded.
• The upgrade takes place in parallel across all file serving nodes owning segments in the file
system, with at least one thread running on each node. For a system with multiple controllers,
the utility will run a thread for each controller if possible.
• Files up to 3.8 TB in size can be upgraded. To enable snapshots on larger files, they must be
migrated after the upgrade is complete (see “Migrating large files” (page 155).
• In general, the upgrade takes approximately three hours per TB of data. The configuration of
the system can affect this number.
Running the utility
Typically, the utility is run as follows to upgrade a file system:
upgrade60.sh file system
For example, the following command performs a full upgrade on file system fs1:
upgrade60.sh fs1
Progress and status reports
The utility writes log files to the directory /usr/local/ibrix/log/upgrade60 on each node
containing segments from the file system being upgraded. Each node contains the log files for its
segments.
Log files are named <host>_<segment>_<date>_upgrade.log. For example, the following
log file is for segment ilv2 on host ib4–2:
ib4-2_ilv2_2012-03-27_11:01_upgrade.log
Restarting the utility
If the upgrade is stopped or the system shuts down, you can restart the upgrade utility and it will
continue the operation. (To stop an upgrade, press Ctrl-C on the command line or send an interrupt
signal to the process.)
There should be no adverse effects to the file system; however, certain blocks that were newly
allocated by the file system at the time of the interruption will be lost. Running ibrix_fsck in
corrective mode will recover the blocks.
NOTE: The upgrade60.sh utility cannot upgrade segments in an INACTIVE state. If a node is
rebooted or shuts down with an unmounted file system, the file system segments owned by that
node will be in an INACTIVE state. To move the segments to ACTIVE states, mount the file system
with ibrix_mount. Then unmount the filesystem with ibrix_umount and resume running
upgrade60.sh. You can verify segment states with the Linux lvscan command.
154 X9000 File Serving Software commands