Migrating to IBM Spectrum Scale 4.2.x from IBM Spectrum Scale 4.1.x

IBM Spectrum Scale™ 4.2 release supports node-at-a-time migration if the previous nodes in the cluster are running IBM Spectrum Scale 4.1.x release. IBM Spectrum Scale 4.1 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 migrated.

Note: To migrate to IBM Spectrum Scale 4.2.0.1 release, the user must have the IBM Spectrum Scale 4.2 release installed and running on the system. Before proceeding towards the upgrade, see the IBM Spectrum Scale FAQ in IBM® Knowledge Center.

To migrate a cluster to IBM Spectrum Scale 4.2.x release from IBM Spectrum Scale 4.1 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 in IBM Spectrum Scale: Administration and Programming Reference.
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 migrated in the cluster using the mmshutdown command.
For example: mmshutdown -N k164n04, where k164n04 is the designated node.
Migrate 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 GPFS software on Linux nodes topic.
  The installable images will be extracted to the following location: /usr/lpp/mmfs/4.2.0.0
  For SLES and RedHat Enterprise Linux nodes:
  - For IBM All Spectrum Scale Editions: rpm -Fvh /usr/lpp/mmfs/4.2.0.0/gpfs*.rpm
  - For IBM Spectrum Scale Advanced Edition:
    rpm -ivh gpfs.adv-4.2.0-0*.rpm - This must be installed to use the Async disaster recovery feature.
    
    rpm -ivh gpfs.crypto-4.2.0-0*.rpm
  - For IBM Spectrum Scale Standard Edition and IBM Spectrum Scale Advanced Edition:
    To optionally install the call home feature, see Understanding the call home functionality in IBM Spectrum Scale: Advanced Administration Guide.
    
    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 migrating to the IBM Spectrum Scale 4.2 from IBM Spectrum Scale 4.1.1, RHEL7 users can refer to the Upgrading GPFS components with the spectrumscale installation toolkit topic for more information on deploying protocols using the spectrumscale 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, 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 migration, you should 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, see Upgrading IBM Spectrum Scale connector in IBM Spectrum Scale: Advanced Administration Guide.
For AIX® nodes:
- 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 migrate IBM Spectrum Scale on AIX, IBM Spectrum Scale Advanced 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.1.X or IBM Spectrum Scale Standard Edition 4.1.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 migrations, 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 migrated to the new IBM Spectrum Scale level, proceed to the Completing the migration to a new level of IBM Spectrum Scale topic.