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

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

About this task

IBM Storage Scale is currently the only supported file system in a Db2 pureScale environment. Prior to installing Db2 pureScale Feature, if a IBM Storage Scale cluster is not already on your system, the Db2 installer automatically installs IBM Storage Scale, and creates a IBM Storage Scale cluster and filesystem. When the Db2 installer creates a IBM Storage Scale cluster and filesystem, this is referred to as a Db2 managed cluster. However, if a IBM Storage 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 Storage Scale level, or manually apply a non-security related efix. If you do manually update the IBM Storage 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 Storage Scale is already installed and you must manually update your IBM Storage 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 Storage 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 Storage Scale is already installed and you must manually update your IBM Storage Scale cluster. If this error occurs, before you can continue, you must follow the steps in this topic.

Procedure

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

Log on as root.
Compare the existing IBM Storage Scale release and efix level already installed, to the levels on the installation media.
To verify the IBM Storage Scale release already installed on the system, run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -v install
```
To verify the IBM Storage Scale release on the installation media, run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -v media
```
If the IBM Storage Scale release level already installed is at a lower level than the level on the installation media, a IBM Storage Scale release level update is required. Otherwise, continue to verify the IBM Storage Scale efix level.
To verify the IBM Storage Scaleefix level already installed on the system,
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -s install
```
To verify the IBM Storage Scale efix level on the installation media, run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/db2ckgpfs -s media
```
If the installed IBM Storage Scale efix level is at a lower level than the level on the installation media, an IBM Storage Scale level update is required.
Stop IBM Storage Scale on the current host:
```
/usr/lpp/mmfs/bin/mmshutdown
```
Verify that IBM Storage Scale has shutdown properly:
The IBM Storage Scale state on the host must indicate down.
```
/usr/lpp/mmfs/bin/mmgetstate -a
```
Update either the IBM Storage Scale release level or IBM Storage Scale modification level. Perform one of these steps:
- To update the IBM Storage Scale release level (for example, from 3.3 to 3.4), run:
```
<DB2-image-directory>/db2/linuxamd64/gpfs/installGPFS -g
```
- To update the IBM Storage 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 Storage Scale release level or IBM Storage 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 Storage Scale on the host:
```
/usr/lpp/mmfs/bin/mmstartup
```
Verify that IBM Storage Scale has started properly.
The IBM Storage Scale state on the host must indicate active.
```
/usr/lpp/mmfs/bin/mmgetstate -a
```
Mount all IBM Storage Scale file systems:
```
/usr/lpp/mmfs/bin/mmmount all
```
Verify the IBM Storage Scale level now matches the release or efix level that is required by the Db2 installer.
Verify the IBM Storage Scale release installed on the system matches the IBM Storage 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 Storage Scale efix level installed on the system matches the IBM Storage 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.