Manually update IBM Spectrum Scale to meet Db2 pureScale Feature requirements (Linux®)

IBM® Spectrum Scale is installed as part of Db2 pureScale Feature installation. However, during a Db2 pureScale Feature installation, if a IBM Spectrum Scale cluster already exists but was not created by the Db2® installer, or, you manually updated the IBM Spectrum Scale level, a failure can occur when you install the Db2 pureScale Feature. A failure occurs if the already installed IBM Spectrum Scale level does not match the release or efix level that is required by the Db2 installer.

About this task

IBM Spectrum Scale is currently the only supported file system in a Db2 pureScale environment. Prior to installing Db2 pureScale Feature, if a IBM Spectrum Scale cluster is not already on your system, the Db2 installer automatically installs IBM Spectrum Scale, and creates a IBM Spectrum Scale cluster and filesystem. When the Db2 installer creates a IBM Spectrum Scale cluster and filesystem, this is referred to as a Db2 managed cluster. However, if a IBM Spectrum Scale cluster already exists on your system, this is referred to as a user-managed cluster.

After a Db2 managed cluster is installed on your system, you must not manually update the IBM Spectrum Scale level, or manually apply a non-security related efix. If you do manually update the IBM Spectrum Scale level, or manually apply a non-security efix, problems can occur when you upgrade to a new Db2 version. (The problem occurs when you attempt to install the new Db2 version.) You receive an error message indicating IBM Spectrum Scale is already installed and you must manually update your IBM Spectrum Scale cluster. If this error occurs, before you can continue, you must follow the steps in this topic.

For instructions on manually updating a security efix, please refer to the "Online upgrade of IBM Spectrum Scale level with a security-related efix" topic. When upgrading to a new Db2 version at a later time, you may receive an error message indicating IBM Spectrum Scale is already installed and you must manually update your IBM Spectrum Scale cluster. If this error occurs, before you can continue, you must follow the steps in this topic.

Procedure

To update IBM Spectrum Scale to meet Db2 pureScale Feature requirements:

Log on as root.
Compare the existing IBM Spectrum Scale release and efix level already installed, to the levels on the installation media.
To verify the IBM Spectrum Scale release already installed on the system, run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -v install
```
To verify the IBM Spectrum Scale release on the installation media, run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -v media
```
If the IBM Spectrum Scale release level already installed is at a lower level than the level on the installation media, a IBM Spectrum Scale release level update is required. Otherwise, continue to verify the IBM Spectrum Scale efix level.
To verify the IBM Spectrum Scaleefix level already installed on the system,
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -s install
```
To verify the IBM Spectrum Scale efix level on the installation media, run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -s media
```
If the installed IBM Spectrum Scale efix level is at a lower level than the level on the installation media, an IBM Spectrum Scale level update is required.
Stop IBM Spectrum Scale on the current host:
```
/usr/lpp/mmfs/bin/mmshutdown
```
Verify that IBM Spectrum Scale has shutdown properly:
The IBM Spectrum Scale state on the host must indicate down.
```
/usr/lpp/mmfs/bin/mmgetstate -a
```
Update either the IBM Spectrum Scale release level or IBM Spectrum Scale modification level. Perform one of these steps:
- To update the IBM Spectrum Scale release level (for example, from 3.3 to 3.4), run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/installGPFS -g
```
- To update the IBM Spectrum Scale modification level (for example, from 3.3.1 to 3.3.4), run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/installGPFS -u
```
After updating either the IBM Spectrum Scale release level or IBM Spectrum Scale modification level, you must build the GPFS portability layer by issuing these commands:
```
cd /usr/lpp/mmfs/src
make Autoconfig
make World
make InstallImages 
```
Start IBM Spectrum Scale on the host:
```
/usr/lpp/mmfs/bin/mmstartup
```
Verify that IBM Spectrum Scale has started properly.
The IBM Spectrum Scale state on the host must indicate active.
```
/usr/lpp/mmfs/bin/mmgetstate -a
```
Mount all IBM Spectrum Scale file systems:
```
/usr/lpp/mmfs/bin/mmmount all
```
Verify the IBM Spectrum Scale level now matches the release or efix level that is required by the Db2 installer.
Verify the IBM Spectrum Scale release installed on the system matches the IBM Spectrum Scale release on the installation media:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -v install
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -v media
```
Verify a IBM Spectrum Scale efix level installed on the system matches the IBM Spectrum Scale efix level on the installation media:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -s install
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -s media
```
Repeat steps 3 to 10 on the next host until all hosts are updated.

Results

All IBM Storage Scale hosts are now at the required code level.

What to do next

Continue installing Db2 pureScale Feature.