DB2 Version 9.7 for Linux, UNIX, and Windows

Upgrading clients (Linux and UNIX)

Upgrading existing clients to Version 9.7 requires that you install a Version 9.7 client copy and then upgrade your existing client instances to retain your client configuration and to connect to all your previously cataloged databases.

About this task

Restrictions

You can only upgrade from a Version 8 DB2 Administration Client, Version 8 DB2 Application Development Client, Version 9.1 DB2 Client, or Version 9.5 Data Server Client to a Version 9.7 Data Server Client.
You can only upgrade from a Version 8 DB2 Run-Time Client, Version 8 DB2 Run-Time Client Lite, Version 9.1 DB2 Runtime Client, or Version 9.5 Data Server Runtime Client to a Version 9.7 Data Server Runtime Client.
On Linux and UNIX except for Linux on x64, your existing 32-bit or 64-bit client instances are upgraded to Version 9.7 64-bit client instances. The bit size of the client instance is determined by the operating system where you install the Version 9.7 client. Refer to Table 1 for details.
On Linux and UNIX operating systems, you must not set up the instance environment for the root user. Running the db2iupgrade or the db2icrt command when you set up the instance environment is not supported.

Before you begin

Ensure that you have root user authority.
Ensure that you have SYSADM, SYSCTRL, or SYSMAINT authority and root access to run the db2iupgrade and the db2icrt commands.
Ensure that you meet the installation requirements for DB2® database products. Some operating systems require a 64-bit kernel.
Review supported connectivity between clients and DB2 database servers in Upgrade essentials for clients.
Perform pre-upgrade tasks for clients. Refer to Pre-upgrade tasks for clients.

Procedure

To upgrade existing clients to Version 9.7 clients:

Install the appropriate Version 9.7 client as a new copy by running the db2setup command and select Install New on the Install a Product panel:
- If you are upgrading from a Version 8 DB2 Administration Client, Version 8 DB2 Application Development Client, Version 9.1 DB2 Client, or Version 9.5 Data Server Client, install a new Version 9.7 Data Server Client.
- If you are upgrading from a Version 8 DB2 Run-Time Client, Version 8 DB2 Run-Time Client Lite, Version 9.1 DB2 Runtime Client, or Version 9.5 Data Server Runtime Client, install a new Version 9.7 Data Server Runtime Client copy.
Log on to the system with root user authority.
Upgrade your existing client instances by running the db2iupgrade command:
```
$DB2DIR/instance/db2iupgrade InstName
```
where
- DB2DIR is set to the location that you specified during the Version 9.7 client installation. The default installation path for UNIX is /opt/IBM/db2/V9.7 and for Linux is /opt/ibm/db2/V9.7.
- InstName is the login name of the client instance owner.
Optional: You can also create a new Version 9.7 client instance instead of upgrading the existing client instance. You only need to create a new Version 9.7 client instance when you want to keep multiple client copies running on the same machine. To create a new Version 9.7 client instance, run the db2icrt command with the option -s:
```
$DB2DIR/instance/db2icrt -s client InstName
```
where
- DB2DIR is set to the location that you specified during the Version 9.7 client installation.
- InstName is the login name of the instance owner.
To create the same client connectivity environment you had, including the database manager configuration parameter and DB2 profile registry settings, run the db2cfimp command with the configuration profile that you backed up in the pre-upgrade tasks.
Compare the upgraded database manager configuration parameter values with the pre-upgrade values to ensure the changed values are compatible with your database applications.

What to do next

After upgrading your client, perform the recommended post-upgrade tasks for clients, especially verifying upgrade for clients to ensure that your client upgrade was successful. Refer to Post-upgrade tasks for clients and Verifying your client upgrade.