PowerScale OneFS Upgrade Planning and Process Guide

Perform a rolling upgrade using the CLI

You can use the command-line interface or the web administration interface to upgrade the version of OneFS that is running on the cluster.

1. Open a secure shell (SSH) connection on any node in the cluster and log in with the root account.
2. To perform a rolling upgrade, run the following command, where <install-image-path> is the file path of the upgrade install image. The file path must be accessible in an /ifs directory.
   For OneFS 8.2.2 and later:

   isi upgrade cluster start --rolling <install-image-path> 

   For OneFS 8.2.1 and earlier:

   isi upgrade cluster start <install-image-path>

   NOTE:The isi upgrade cluster command runs asynchronously. The command does not run the entire upgrade process; instead, it sets up the upgrade process, which nodes take turns controlling. For this reason, the command returns quickly. To view the progress of the upgrade, use the isi upgrade view command or the web administration interface.
3. Optional: You can specify the following rolling upgrade options:

   Options

   Description

   Nodes to select for upgrade

   Upgrade specific nodes with the --nodes <integer_range_list> option. Specify the nodes in their upgrade order as a comma-separated list (for example, --nodes 7,3,2,5) or as a dash-separated range (for example, --nodes 1-7) of logical node numbers (LNNs). NOTE:We recommend that you upgrade all the nodes. If you upgrade some nodes, a weekly alert is sent to confirm that the upgrade is making progress. Do not leave the cluster in a partially upgraded state for a prolonged period. Some new features in the upgrade might not be available until all the nodes in the cluster have been upgraded and the upgrade is committed. Refer to the release notes for the OneFS version that you are upgrading to for information about features that require all the nodes to be upgraded.

   OneFS 9.2.0.0 and later ignores the node restart order. Instead, OneFS restarts any node that is ready, as long as only one node is restarting at a time.
   The following example for OneFS 8.2.2 through OneFS 9.1.0.x starts a rolling upgrade on nodes 7,3,2,5, in that order:

   isi upgrade cluster start --rolling <install-image-path> --nodes 7,3,2,5 

   The following example for OneFS 8.2.1 and earlier starts a rolling upgrade on nodes 7,3,2,5 in that order:

   isi upgrade cluster start <install-image-path> --nodes 7,3,2,5 

4. Optional: To add nodes to a current upgrade, run the following command, where <nodes> is the list of LNNs:

   isi upgrade add-nodes <nodes>

5. Optional: To add any remaining nodes to the upgrade, run the following command:

   isi upgrade add-remaining-nodes