HOW-TO upgrade RLKS Shared Service from 1.0.0.0 to 1.0.1.0

Before you begin

Let’s assume that you’ve already: * Have permissions to deploy and manage shared service instances on IBM Pure Application System or IBM Workload Deployer; * Have an instance of Rational License Key Server Shared Service v1.0; * Uploaded several license key files to the shared service;

Procedure

1. Prepare SSH access to the existing instance of License Key Share Service 1.0.0.0

For security reason, you only allowed to access the virtual machine behind the shared service instance using account virtuser via SSH key-based connection with an RSA key pair. If you didn’t set the SSH public key during the deployment, please refer to “Managing virtual application instances” > “Configuring SSH key-based access” topic in the PureApplication™ System information center. After done, follow the commands below to navigate to the home directory of RLKS in 1.0:

1. Open a Terminal.
2. Type ssh virtuser@ and press Enter.
3. Type cd /opt/IBM/RationalRLKS and press Enter.

2. Backup license key files

2.1 Different types of license key file

There are mainly two kinds of license key files, one works for single server node only and the other one can work on multiple servers. If you open one license key file using any text editor like vi, you may found the following text in the head:

SERVER this_host ANY 27000

This indicates that the license key file is wild opened and can be used on other license key server nodes. And if you see some text like this:

SERVER 27000

This means the license key file can only works on specified host and may not work on new instances of RLKS Shared Service because the hostname, IP or host ID can possibly change during deploy new instances. In this case, you need to request new license key files for new instances.

2.2 Locate the license key files and do the backup