Upgrading to IBM Spectrum Scale 4.2.y from IBM Spectrum Scale 4.1.x

IBM Spectrum Scale 4.2 release supports node-at-a-time upgrade if the previous nodes in the cluster are running IBM Spectrum Scale 4.1.x release. IBM Spectrum Scale 4.1.x nodes can coexist and interoperate with nodes that are running IBM Spectrum Scale 4.2. However, new functions that depend on format changes will not be available until all nodes have been upgraded. The following procedure can also be used to upgrade from IBM Spectrum Scale 4.2.y to 4.2.z, for example from IBM Spectrum Scale 4.2.2 to 4.2.3.

Note: If you have protocols in use, to upgrade to the IBM Spectrum Scale 4.2.y release, you must have the IBM Spectrum Scale 4.2 release installed and running on the system. Before proceeding with the upgrade, see the IBM Spectrum Scale FAQ in IBM® Knowledge Center (www.ibm.com/support/knowledgecenter/STXKQY/gpfsclustersfaq.html).

To upgrade a cluster to IBM Spectrum Scale 4.2.y release from IBM Spectrum Scale 4.1.x release, perform the following steps:

Stop all user activity in the file systems on the designated node.
For information about how to stop and unmount NFS running over IBM Spectrum Scale file systems, see Unmounting a file system after NFS export.
Cleanly unmount the mounted IBM Spectrum Scale file system. Do not use force to unmount the designated node.
Follow any local administrative backup procedures to ensure protection of your file system data in the event of a failure.
Stop IBM Spectrum Scale on the node to be upgraded in the cluster using the mmshutdown command.
For example: mmshutdown -N k164n04, where k164n04 is the designated node.
Upgrade to IBM Spectrum Scale 4.2 release depending on the operating system:
For Linux nodes:
- Extract the IBM Spectrum Scale software as described in the Extracting the IBM Spectrum Scale software on Linux nodes topic.
  The installable images will be extracted to the following location: /usr/lpp/mmfs/4.2.*
  For SLES and Red Hat Enterprise Linux nodes:
  - For IBM All Spectrum Scale Editions: rpm -Fvh /usr/lpp/mmfs/4.2.*/gpfs*.rpm
  - For IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition:
    rpm -ivh gpfs.adv-4.2.*.rpm - This must be installed to use the Async disaster recovery feature.
    
    rpm -ivh gpfs.crypto-4.2.*.rpm
  - For IBM Spectrum Scale Standard Edition and IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition:
    To optionally install the call home feature, see Monitoring the IBM Spectrum Scale system by using call home.
    
    To optionally install the Performance Monitoring tool, see the Manually installing the performance monitoring tool topic.
    
    To optionally install the IBM Spectrum Scale GUI, see the Manually installing IBM Spectrum Scale management GUI topic.
    
    Note: When upgrading to the IBM Spectrum Scale 4.2 from IBM Spectrum Scale 4.1.1, RHEL7 users can refer to the Upgrading IBM Spectrum Scale components with the installation toolkit topic for more information on deploying protocols using the installation toolkit.
- For Debian and Ubuntu Linux users:
  - For IBM Spectrum Scale Express Edition, run the following command:
```
dpkg -i gpfs.base*deb gpfs.gpl*deb gpfs.gskit*deb 
gpfs.msg*deb gpfs.doc*deb
```
  - For IBM Spectrum Scale Standard Edition, run the following command:
```
dpkg -i gpfs.base*deb gpfs.gpl*deb gpfs.gskit*deb 
gpfs.msg*deb gpfs.doc*deb gpfs.ext*deb 
```
  - For IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition, run the following command:
```
dpkg -i gpfs.base*deb gpfs.gpl*deb gpfs.gskit*deb gpfs.msg*deb 
gpfs.doc*deb gpfs.ext*deb  gpfs.adv*deb gpfs.crypto*deb
```
  - To optionally install the Performance Monitoring tool on Debian 7, run the following command:
```
dpkg -i gpfs.gss.pmcollector_4.2.*.D7*deb 
gpfs.gss.pmsensors_4.2.*D7*.deb
```
  - To optionally install the Performance Monitoring tool on Ubuntu 14, run the following command:
```
dpkg -i gpfs.gss.pmsensors_4.2.*.U14.*.deb 
gpfs.gss.pmcollector_4.2.*.U14.*.deb
```
- After successful upgrade, you must rebuild the GPL layer. For more information, see the Building the GPFS portability layer on Linux nodes topic.
For Hadoop users:

To upgrade the IBM Spectrum Scale Hadoop Connector through Ambari, see Upgrading HDFS Transparency in IBM Spectrum Scale: Big Data and Analytics Guide.

To upgrade the IBM Spectrum Scale Hadoop Connector manually, see Upgrading the HDFS Transparency cluster in IBM Spectrum Scale: Big Data and Analytics Guide.
For AIX® nodes:
Note: Specific to AIX, when upgrading from 4.1.x to 4.2.y.z, you must upgrade to 4.2.y.0 first and then you can upgrade to 4.2.y.z.
- Copy the installation images and install the IBM Spectrum Scale licensed programs as described in the Installing IBM Spectrum Scale on AIX nodes section.
  Note: If you use SMIT to upgrade IBM Spectrum Scale on AIX, IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition users must install gpfs.adv.
For Windows nodes
1. Open the Programs and Features control panel and remove IBM Spectrum Scale Express Edition 4.1.x or IBM Spectrum Scale Standard Edition 4.1.x.
  1. Uninstall IBM Spectrum Scale 4.1.1 and reboot.
  2. Uninstall IBM GPFS GSKit 8.0.x.x and reboot.
  3. Uninstall the IBM Spectrum Scale 4.1.1 license.
2. Copy the installation images and install the IBM Spectrum Scale licensed program as described in Installing IBM Spectrum Scale on Windows nodes.
  Note: For Windows upgrades, it is required that all IBM Spectrum Scale administration commands are executed from the 4.2 node.
Start IBM Spectrum Scale on the designated node in the cluster using the mmstartup command. For example: mmstartup -N k164n04, where k164n04 is the designated node.
Mount the file systems if this is not done automatically when the IBM Spectrum Scale daemon starts.

When all nodes in the cluster have been successfully upgraded to the new IBM Spectrum Scale level, proceed to the Completing the upgrade to a new level of IBM Spectrum Scale topic.