PowerScale OneFS Upgrade Planning and Process Guide

Download the OneFS installation bundle file

1. From the OneFS Downloads page, download the installation bundle file for the target version of OneFS to which you are upgrading.
   NOTE:It is recommended that you use a OneFS installation bundle file that includes the latest patches. If the installation bundle is used, you can skip the patch installation task in the post-upgrade steps. Contact your support representative for access to an installation file that does not include patches.

   NOTE: If you use the web administration interface to upgrade from OneFS 9.3.0.x or earlier, to OneFS 9.4.0.0 or later, you must first change the file extension from .isi to .tar.gz. (example: change OneFS_v9.4.0.0_Install.isi to OneFS_v9.4.0.0.Install.tar.gz)
2. Open a secure shell (SSH) connection to any node in the cluster and log in using the root account.
3. Move the installation file that you downloaded into the /ifs/data directory on the cluster you want to upgrade.
4. Validate the integrity of the installation file.
   For OneFS 9.4.0.0 and later, use the following instructions:
   1. To import the package into the OneFS Catalog, run the isi upgrade catalog import /ifs/data/<filename>.isi command.
   2. To verify the package, run the isi upgrade catalog verify --file /ifs/data/<filename>.isi command.
   For OneFS 9.3.0.0 and earlier, use the following instructions:
   1. Optional: On the OneFS downloads page, click Checksum Values and record the SHA-256 checksum value displayed.
   2. Optional: In OneFS CLI, run the following command where <installation-file-name> is the name of the downloaded installation file:
      • sha256 /ifs/data/<installation-file-name>
   3. Optional: Compare the SHA-256 checksum value that you recorded from the downloads page on the Online Support site to the checksum value returned from the SHA-256 command. If the values do not match, re-download the installation file.
5. (OneFS 9.3.0.0 and earlier) To unzip the downloaded tgz file, run the following command, where <installation-file-name> is the name of the downloaded tgz file:

   gzip -d /ifs/data/<installation-file-name>

   NOTE:Clusters running OneFS 9.4.0.0 and later are not required to unzip .tgz files.
6. (OneFS 9.3.0.0 and earlier) To unbundle the .tar file, run the following command where <installation-file-name> is the name of the OneFS install tar file:

   tar -vxf /ifs/data/<installation-file-name> /ifs/data/

   NOTE:Clusters running OneFS 9.4.0.0 and later are not required to unbundle .tar files.
7. (OneFS 9.3.0.0 and earlier) Validate the manifest file (example: OneFS_v9.3.0.0_Install.tar.gz). See the Checking Manifests section of the PowerScale OneFS Security Configuration Guide for more information.
   NOTE:Clusters running OneFS 9.4.0.0 and later use the OneFS Catalog to verify packages.