6.3 HP StoreAll 9300/9320 Storage Administrator Guide (AW549-96072, June 2013)

• 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 160).
• 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 file system with ibrix_umount and resume running
upgrade60.sh. You can verify segment states with the Linux lvscan command.
Migrating large files
The upgrade60.sh utility does not upgrade files larger than 3.8 TB. After the upgrade is complete
and the file system is mounted, migrate the file to another segment in the file system using the
following command:
ibmigrate -f filesystem -m 1 -d destination_segment file
The following example migrates file.9 from its current segment to destination segment 2:
ibmigrate -f ibfs -m 1 -d 2 /mnt/storeall/test_dir/dir1/file.9
After the file is migrated, you can snap the file.
Synopsis
Run the upgrade utility:
upgrade60.sh [-v -n] file system
The -n option lists needed conversions but does not attempt them. The -v option provides more
information.
160 Cascading Upgrades