Installing online fix pack updates to a higher code level in a HADR environment

In an HADR environment, install online fix pack updates on members and cluster caching facilities (CFs) one at a time to update a Db2® pureScale® instance to a fix pack or special build with a higher code level while the instance remains available.

Before you begin

Ensure that you meet all of the requirements before you install a fix pack. For more details, see Preparing to install a fix pack.
Ensure that you have root user authority and instance owner authority.

Ensure that online fix pack updates are supported between the Db2 version that is installed on your Db2 pureScale instance and the Db2 version of the fix pack or special build by issuing the installFixPack -show_level_info command. The following text displays the command output:

Code level         =  Version:10 Release:5 Modification:0 Fixpack:4
Architecture level =  Version:10 Release:5 Modification:0 Fixpack:4
Section level      =  Version:10 Release:5 Modification:0 Fixpack:4

Supports online update = Yes

Minimum committed code level required for online install =
   Version:10 Release:5 Modification:0 Fixpack:1

The execution completed successfully.

For more information see the Db2 installation log at "/tmp/installFixPack.log.8541".
DBI1070I  Program installFixPack completed successfully.

About this task

In an HADR environment, you can update one or more members or cluster caching facilities (CFs) while the remaining members and CFs continue to process transactions. You must update all members and CFs in both the primary and standby clusters before you can commit the changes and update the Db2 pureScale instance.

Procedure

To install an online fix pack update on a Db2 pureScale instance in a HADR environment:

Install the online fix pack update on each of the members in the standby cluster:
1. Log on to the member server in the standby cluster as root user.
2. Extract the fix pack or special build image in a directory that is accessible to the instance owner and root user.
  
  To reduce interruption to standby log replay, install the online fix pack update on all members except the current replay member. Then install the online fix pack update on the current replay member.
3. Issue the installFixPack command as follows:
```
media-dir/installFixPack -p FP-install-path -online -I instance-name -l log-file-name -t /tmp/trace-file-name 
```
  Where FP-install-path is the directory where you want to install the fix pack and media-dir is the directory where you extracted the fix pack image. FP-install-path must be the same on all hosts.
Install the online fix pack update on the secondary CF server in the standby cluster:
1. Log on to the secondary CF server in the standby cluster as root user.
2. Extract the fix pack or special build image in a local directory that is accessible to the instance owner and root user.
3. Issue the installFixPack command as follows:
```
media-dir/installFixPack -p FP-install-path -I instance-name -online -l log-file-name -t /tmp/trace-file-name 
```
  Where FP-install-path is the directory where you want to install the fix pack and media-dir is the directory where you extracted the fix pack image. FP-install-path must be the same on all hosts. The -online parameter is the default and can be omitted.
Install the online fix pack update on the primary CF in the standby cluster:
1. Ensure that the secondary CF in the standby cluster is in PEER state by issuing the following command as the instance owner:
```
db2instance –list
```
  The secondary CF must be in PEER state before you update the primary CF.
2. Log on to the primary CF server in the standby cluster as root user.
3. Extract the fix pack or special build image in a local directory that is accessible to the instance owner and root user.
4. Issue the installFixPack command as follows:
```
media-dir/installFixPack -p FP-install-path -online -I instance-name -l log-file-name -t /tmp/trace-file-name
```
  Where FP-install-path is the directory where you want to install the fix pack and media-dir is the directory where you extracted the fix pack image. FP-install-path must be the same on all hosts.
Determine whether the online fix pack update was successful in all members and CFs in the standby cluster by issuing the following command:
```
media-dir/installFixPack -check_commit -I instance-name
```
If the command output shows any problems, fix them before you continue with the next step.
Install the online fix pack update on each of the members in the primary cluster:
1. Log on to the member server in the primary cluster as root user.
2. Extract the fix pack or special build image in a directory that is accessible to the instance owner and root user.
3. Issue the installFixPack command as follows:
```
media-dir/installFixPack -p FP-install-path -online -I instance-name -l log-file-name -t /tmp/trace-file-name
```
  Where FP-install-path is the directory where you want to install the fix pack and media-dir is the directory where you extracted the fix pack image. FP-install-path must be the same on all hosts.
Install the online fix pack update on the secondary CF server in the primary cluster:
1. Log on to the secondary CF server in the primary cluster as root user.
2. Extract the fix pack or special build image in a local directory that is accessible to the instance owner and root user.
3. Issue the installFixPack command as follows:
```
media-dir/installFixPack -p FP-install-path -I instance-name -online -l log-file-name -t /tmp/trace-file-name
```
  Where FP-install-path is the directory where you want to install the fix pack and media-dir is the directory where you extracted the fix pack image. FP-install-path must be the same on all hosts. The -online parameter is the default and can be omitted.
Install the online fix pack update on the primary CF server in the primary cluster:
1. Ensure that the secondary CF in the primary cluster is in PEER state by issuing the following command as the instance owner:
```
db2instance –list
```
  The secondary CF must be in PEER state before you update the primary CF.
2. Log on to the primary CF server in the primary cluster as root user.
3. Extract the fix pack or special build image in a local directory that is accessible to the instance owner and root user.
4. Issue the installFixPack command as follows:
```
media-dir/installFixPack -p FP-install-path -online -I instance-name -l log-file-name -t /tmp/trace-file-name
```
  Where FP-install-path is the directory where you want to install the fix pack and media-dir is the directory where you extracted the fix pack image. FP-install-path must be the same on all hosts.
Determine whether the online fix pack update was successful in all members and CFs in the primary cluster by issuing the following command:
```
media-dir/installFixPack -check_commit -I instance-name
```
If the command output shows any problems, fix them before you continue with the next step.
Commit the online fix pack update in the standby cluster so that your Db2 pureScale instance is updated to the new fix pack level by issuing the following command:
```
media-dir/installFixPack -commit_level -I instance-name -l log-file-name -t /tmp/trace-file-name
```

Verify that your instance and databases show the new committed fix pack level in the standby cluster by issuing the following command:

db2pd -ruStatus

For example, if you are updating the fix pack level from Db2 Version 10.5 Fix Pack 1 to Db2 Version 10.5 Fix Pack 3, the following text displays the command output.

ROLLING UPDATE STATUS:  Disk Value                                         Memory Value

   Record Type        = INSTANCE
   ID                 = 0
   Code Level         = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     Not Applicable
   Architecture Level = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     Not Applicable
   State              = [NONE]
   Last updated       = 2013/11/14:04:38:47


   Record Type        = MEMBER
   ID                 = 0
   Code Level         = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   CECL               = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   Architecture Level = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   CEAL               = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   Section Level      = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   State              = [NONE]
   Last updated       = 2013/11/13:03:39:33

coralpib19c.torolab.ibm.com: db2pd -rustatus -localhost ... completed ok

   Record Type        = MEMBER
   ID                 = 1
   Code Level         = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   CECL               = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   Architecture Level = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   CEAL               = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   Section Level      = V:10 R:5 M:0 F:0 I:0 SB:0 (0x0A05000300000000)     V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)
   State              = [NONE]
   Last updated       = 2013/11/13:00:20:02

coralpib19d.torolab.ibm.com: db2pd -rustatus -localhost ... completed ok

   Record Type        = CF
   ID                 = 128
   Code Level         = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     Not Applicable
   Architecture Level = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     Not Applicable
   State              = [NONE]
   Last updated       = 2013/11/13:03:39:34

   Record Type        = CF
   ID                 = 129
   Code Level         = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     Not Applicable
   Architecture Level = V:10 R:5 M:0 F:3 I:0 SB:0 (0x0A05000300000000)     Not Applicable
   State              = [NONE]
   Last updated       = 2013/11/13:00:20:03

In the command output, V:10 R:5 M:0 F:3 specifies the updated fix pack level namely Db2 Version 10.5 Fix Pack 3.

Commit the online fix pack update in the primary cluster so that your Db2 pureScale instance is updated to the new fix pack level by issuing the following command:
```
media-dir/installFixPack -commit_level -I instance-name -l log-file-name -t /tmp/trace-file-name
```
Verify that your instance and databases show the new committed fix pack level in the primary cluster by issuing the following command:
```
db2pd -ruStatus
```
The command output displays text that is similar to the example provided in step 10.
If you want to use capabilities specific to the fix pack, update the system catalog objects in your databases in the primary cluster:
1. Log on as the instance owner.
2. For each database in the instance, issue the db2updv115 command as follows:
```
db2updv115 -d db-name
```