Changing the IBM Spectrum Scale product edition

You can change the IBM Spectrum Scale product edition from your currently installed product edition either by using the installation toolkit or manually.

The available product edition change paths¹ are as follows.

IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Access Edition
IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Management Edition
IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Advanced Edition
IBM Spectrum Scale Advanced Edition to IBM Spectrum Scale Data Management Edition

The methods that can be used to change the product edition are as follows.

Installation toolkit (cluster online) ²
Manual node by node (cluster online) ³
Manual all nodes (cluster offline)

Note:

¹ These are the only edition changes that are supported.
² If you are planning to use the installation toolkit for changing the product edition, be aware that the product edition change by using the installation toolkit can be performed only when you are upgrading to a newer version of IBM Spectrum Scale. If you do not want to upgrade to a newer version of IBM Spectrum Scale, you must change the product edition manually.
³ You must change the whole cluster to the same product edition. If you are using the manual node by node method, ensure that the product edition is changed on each node in the cluster.

You can use one of the following sets of steps to change the IBM Spectrum Scale product edition.

Use the following steps for changing the product edition by using the installation toolkit.
1. Download from IBM® FixCentral the installation image of the IBM Spectrum Scale edition that you are planning to change to.
2. Extract the installation image.
  For performing an upgrade by using the installation toolkit, a key requirement is the cluster definition file.
3. Obtain the cluster definition file by using one of the following options.
  - Copy the old cluster definition file /usr/lpp/mmfs/SpectrumScale_version/installer/configuration/clusterdefinition.txt to the newly extracted package location /usr/lpp/mmfs/SpectrumScale_version/installer/configuration/clusterdefinition.txt
  - Use the ./spectrumscale config populate command to traverse the existing cluster and populate the cluster definition file.
  For more information about obtaining the current cluster configuration, see Step 4 of Performing online upgrade by using the installation toolkit.
4. Run the installation toolkit upgrade precheck procedure.
```
cd /usr/lpp/mmfs/5.0.x.x/installer
./spectrumscale upgrade precheck
```
5. Run the installation toolkit upgrade procedure.
```
cd /usr/lpp/mmfs/5.0.x.x/installer
./spectrumscale upgrade run
```
With these steps, the product edition is changed and the applicable packages are installed on all nodes specified in the cluster definition file.
Use the following steps to change the product edition manually, one node at a time.
Note: In the following steps, rpm and dpkg commands are used for installing and uninstalling packages. You can also use package manager commands such as yum, zypper, and apt-get for installing and uninstalling packages, if the respective repository is set up in your environment.
1. Download from IBM FixCentral the installation image of the IBM Spectrum Scale edition that you are planning to change to.
2. Extract the installation image.
3. Unmount all file systems on the node.
```
mmumount all
```
4. Verify that file systems are unmounted.
```
mmlsmount -L -N NodeName
```
5. Shut down GPFS on the node.
```
mmshutdown
```
6. Uninstall the current license package using one of the following commands depending on your product edition change path and the operating system.
  - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Access Edition or IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition
    RHEL and SLES:
```
rpm -e License_Package_Name
```
    You can obtain the license package name by using the rpm -qa | grep gpfs.license command.
    Ubuntu:
```
dpkg -P License_Package_Name
```
    You can obtain the license package name by using the dpkg -l | grep gpfs.license command.
  - IBM Spectrum Scale Advanced Edition to IBM Spectrum Scale Data Management Edition
    RHEL and SLES:
```
rpm -e License_Package_Name
```
    You can obtain the license package name by using the rpm -qa | grep gpfs.license command.
    Ubuntu:
```
dpkg -P License_Package_Name
```
    You can obtain the license package name by using the dpkg -l | grep gpfs.license command.
7. Install the new license package by using one of the following sets of commands depending on your product edition change path and the operating system.
  - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Access Edition
    RHEL and SLES:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_rpms
rpm -ivh gpfs.license.da*.rpm
```
    Ubuntu:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_debs
dpkg -i gpfs.license.da*.deb
```
  - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Management Edition
    RHEL and SLES:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_rpms
rpm -ivh gpfs.license.dm*.rpm
```
    Ubuntu:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_debs
dpkg -i gpfs.license.dm*.deb
```
  - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Advanced Edition
    RHEL and SLES:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_rpms
rpm -ivh gpfs.license.adv*.rpm
```
    Ubuntu:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_debs
dpkg -i gpfs.license.adv*.deb
```
  - IBM Spectrum Scale Advanced Edition to IBM Spectrum Scale Data Management Edition
    RHEL and SLES:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_rpms
rpm -ivh gpfs.license.dm*.rpm
```
    Ubuntu:
```
cd /usr/lpp/mmfs/5.0.x.x/gpfs_debs
dpkg -i gpfs.license.dm*.deb
```
8. Start GPFS on the node.
```
mmstartup
```
9. Repeat the preceding steps on all nodes in the cluster.
Use the following steps to change the product edition manually, all nodes at the same time.
Note: In the following steps, rpm and dpkg commands are used for installing and uninstalling packages. You can also use package manager commands such as yum, zypper, and apt-get for installing and uninstalling packages, if the respective repository is set up in your environment.
1. Download from IBM FixCentral the installation image of the IBM Spectrum Scale edition that you are planning to change to.
2. Extract the installation image.
3. Unmount all file systems.
```
mmumount all -a
```
4. Verify that file systems are unmounted.
```
mmlsmount -L
```
5. Shut down GPFS on all nodes.
```
mmshutdown -a
```
6. Uninstall the current license package using one of the following commands depending on your product edition change path and the operating system.
  - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Access Edition or IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition
    RHEL and SLES:
```
mmdsh -N NodeList rpm -e License_Package_Name
```
    You can obtain the license package name by using the rpm -qa | grep gpfs.license command.
    Ubuntu:
```
mmdsh -N NodeList dpkg -P License_Package_Name
```
    You can obtain the license package name by using the dpkg -l | grep gpfs.license command.
  - IBM Spectrum Scale Advanced Edition to IBM Spectrum Scale Data Management Edition
    RHEL and SLES:
```
mmdsh -N NodeList rpm -e License_Package_Name
```
    You can obtain the license package name by using the rpm -qa | grep gpfs.license command.
    Ubuntu:
```
mmdsh -N NodeList dpkg –P License_Package_Name
```
    You can obtain the license package name by using the dpkg -l | grep gpfs.license command.
  NodeList is a file that contains the list of nodes.
7. Use one of the following sets of commands depending on your product edition change path and the operating system.
  - Install the new license package.
    - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Access Edition
      RHEL and SLES:
      mmdsh -N NodeList rpm -ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.license.da*.rpm
      Ubuntu:
      mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.license.da*.deb
    - IBM Spectrum Scale Advanced Edition to IBM Spectrum Scale Data Management Edition
      RHEL and SLES:
      mmdsh -N NodeList rpm -ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.license.dm*.rpm
      Ubuntu:
      mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.license.dm*.deb
  - Install the new license package, and gpfs.adv and gpfs.crypto packages.
    - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Data Management Edition
      RHEL and SLES:
      mmdsh -N NodeList rpm -ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.license.dm*.rpm mmdsh -N NodeList rpm -ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.crypto*.rpm mmdsh -N NodeList rpm –ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.adv*.rpm
      Ubuntu:
      mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.license.dm*.deb mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.crypto*.deb mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.adv*.deb
    - IBM Spectrum Scale Standard Edition to IBM Spectrum Scale Advanced Edition
      RHEL and SLES:
      mmdsh -N NodeList rpm -ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.license.adv*.rpm mmdsh -N NodeList rpm -ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.crypto*.rpm mmdsh -N NodeList rpm –ivh /usr/lpp/mmfs/5.0.x.x/gpfs_rpms/gpfs.adv*.rpm
      Ubuntu:
      mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.license.adv*.deb mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.crypto*.deb mmdsh -N NodeList dpkg -i /usr/lpp/mmfs/5.0.x.x/gpfs_debs/gpfs.adv*.deb
  NodeList is a file that contains the list of nodes.
8. Start GPFS on all nodes.
```
mmstartup -a
```