IBM Security Key Lifecycle Manager Version 2.6.0 -- Distributed Platforms Fix Pack 2 README


Abstract

Readme documentation for IBM® Security® Key Lifecycle Manager for Distributed Platforms, Version 2.6.0 Fix Pack 2 including installation-related instructions, prerequisites and corequisites, and a list of fixes.  All IBM Security Key Lifecycle Manager for Distributed Platforms fix packs are cumulative.  

Fix pack publication date: 31 May 2016

Last modified date: 28 May 2016


Contents

Platform support
Download locations
Prerequisites and corequisites
Known issues
Known limitations

Installation information
Installing the IBM Security Key Lifecycle Manager fix pack
Prior to fix pack installation
Performing the necessary tasks after fix pack installation
Uninstalling the IBM Security Key Lifecycle Manager along with fix pack
List of fixes and features
Copyright and trademark information
Document change history


Platform support

IBM Security Key Lifecycle Manager, Version 2.6.0 platforms supported

AIX Version 6.1 64-bit

AIX Version 7.1 64-bit

Red Hat Enterprise Linux Version 6 update 6 on x86 64-bit in 32-bit mode

Red Hat Enterprise Linux Version 7 on x86 64-bit in 32-bit mode

Red Hat Enterprise Linux Version 6 update 6 (System z) on x86 64–bit mode

Red Hat Enterprise Linux Version 7 (System z) on x86 64–bit mode

SuSE Linux Enterprise Server Version 10 on x86 64–bit

SuSE Linux Enterprise Server Version 11 on x86 64–bit mode

SuSE Linux Enterprise Server Version 11 (System z) on x86 64–bit mode

Windows Server 2012 (64-bit in 32-bit mode for all Intel and AMD processors) Standard Edition

Windows Server 2012 R2 (64-bit in 32-bit mode for all Intel and AMD processors) Standard Edition

IBM Security Key Lifecycle Manager Version 2.6.0 has been certified to run on the following virtual environments. The platform running within the virtual machine must be supported by the virtual platform server and Security Key Lifecycle Manager Version 2.6.0 (see "Platform support" table).

IBM Security Key Lifecycle Manager Version 2.6.0 virtual platforms supported

VMWare ESX/ESXi Server Versions 4.0, 5.0, 5.1 and 5.5

Red Hat Enterprise Virtualization/Kernel-Based Virtual Machine (RHEV/KVM) Version 5.4

 

Download location

Download IBM Security Key Lifecycle Manager, Version 2.6.0 fix pack from IBM Fix Central

1.      Go to IBM Fix Central home page: http://www.ibm.com/support/fixcentral/

2.      For the Product Group, select "Security Systems"

3.      For the Product, select "IBM Security Key Lifecycle Manager".

4.      For Installed Version, select your system's appropriate version level, ie. 2.6.0.

5.      For Platform, select the appropriate platform. Choose "Continue".

6.      At the Identify Fixes page, select the "Browse for Fixes" radio button (default) and choose "Continue".

7.      At the Select Fixes page, choose Fix Pack "2.6.0-ISS-SKLM-FP0002". Choose "Continue".

8.      You might be prompted to "Sign In".  If you do not have an ID, click on the "register now" link and follow the registration steps as appropriate.

9.      At the Download Options page, choose a download method (default is "Download using Download Director").

10.  Select the associated files and README for Fix Pack 2.6.0-ISS-SKLM-FP0002 and select "Download now".

Platforms updated by this Fix Pack

Product/Component Name

Platform

File Name

IBM Security Key Lifecycle Manager version 2.6.0 Fix Pack - 2.6.0-ISS-SKLM-FP0002

AIX

2.6.0-ISS-SKLM-FP0002-AIX.tar.gz

IBM Security Key Lifecycle Manager version 2.6.0 Fix Pack - 2.6.0-ISS-SKLM-FP0002

Linux

2.6.0-ISS-SKLM-FP0002-Linux.tar.gz

IBM Security Key Lifecycle Manager version 2.6.0 Fix Pack - 2.6.0-ISS-SKLM-FP0002

zLinux (System z)

2.6.0-ISS-SKLM-FP0002-zLinux.tar.gz

IBM Security Key Lifecycle Manager version 2.6.0 Fix Pack - 2.6.0-ISS-SKLM-FP0002

Windows

2.6.0-ISS-SKLM-FP0002-Windows.zip

For current version 2.6.0 installations: This fix pack can be installed on systems with IBM Security Key Lifecycle Manager Version 2.6.0 GA. or any of the fix packs publised earlier for example; 2.6 FP 1 must be installed

 

Prerequisites and corequisites

IBM Security Key Lifecycle Manager Version 2.6.0 GA or any of the fix packs publised earlier for example; 2.6.0 Fix Pack 1 must be installed.

Known issues

Known limitations

Installing the IBM Security Key Lifecycle Manager fix pack

Prior to fix pack installation

1.      Ensure that IBM Security Key Lifecycle Manager is not in use before installing the fix pack. If your facility has a "service maintenance outage" process, consider installing this fix pack during an arranged service outage.

2.      A backup of your IBM Security Key Lifecycle Manager server should be performed prior to installing this fix pack. Follow the steps Backing up critical files in the Administering section of the IBM Security Key Lifecycle Manager Product Manuals.

Backup WebSphere Application Server files on Windows operating system

Instruction

Command

Open a command prompt.

Click the Start button, click Run, type cmd, and click the OK button.

Stop the WebSphere Application Server.

<WAS_HOME>\bin\stopServer.bat server1 -username <WAS_ADMIN> -password <WAS_PASSWORD>

Make a temporary directory.

mkdir <WAS_BACKUP_DIRECTORY>
Example: mkdir c:\wasbackup

Change to the temporary directory.

cd c:\wasbackup

Copy the files from the directory where WebSphere Application Server is installed.

xcopy /y /e /d <WAS_HOME> c:\wasbackup

Start the WebSphere Application Server.

<WAS_HOME>\bin\startServer.bat server1
Where:
<WAS_HOME> is the directory where WebSphere Application Server is installed
(default:C:\Program Files (x86)\IBM\WebSphere\AppServer).

 

Backup WebSphere Application Server files on AIX and Linux operating systems

Instruction

Command

Open a ksh or bash shell.

If your default shell is not ksh or bash, run "exec ksh" or "exec bash".

Stop the WebSphere Application Server.

<WAS_HOME>/bin/stopServer.sh server1 -username <WAS_ADMIN> -password <WAS_PASSWORD>

Make a temporary directory.

mkdir <WAS_BACKUP_DIRECTORY>
Example: mkdir /tmp/wasbackup

Change to the temporary directory.

cd /tmp/wasbackup

Archive the files from the directory where WebSphere Application Server is installed.

tar -cvf wasbackup.tar <WAS_HOME>/*

Start the WebSphere Application Server.

<WAS_HOME>/bin/startServer.sh server1
Where:
<WAS_HOME> is the directory where WebSphere Application Server is installed (default: /opt/IBM/WebSphere/AppServer).

 

Before fix pack installation

Instruction

Steps

Make a repository directory.

  1. Open a command prompt.
  2. Make a repository, i.e. a directory where you extract the update installer.

Windows

Default repository directory is C:\sklminstall_windowsfp
mkdir C:\sklminstall_windowsfp

Unix

Default repository directory is /sklminstall_linuxfp
mkdir /sklminstall_linuxfp

Change directory to the directory created.

Windows

cd C:\sklminstall_windowsfp

Unix

cd /sklminstall_linuxfp

Download the fix pack into the repository directory.

Link to fix pack download table

Extract the downloaded file.

Windows

Extract the downloaded file: 2.6.0-ISS-SKLM-FP0002-Windows.zip

Unix

Extract the downloaded file: 2.6.0-ISS-SKLM-FP0002-Linux.tar.gz

 

Steps for installing fix pack for IBM Security Key Lifecycle Manager, Version 2.6.0 on Windows and Unix operating systems in GUI mode

Instruction

Steps

Stop the WAS server, update Java SDK and then start Installation Manager in GUI mode.

Windows

  1. Open a command window, and change to the repository directory. Example:
    C:\sklminstall_windowsfp
  2. Run the following command.
    updateSKLM.bat <IM_INSTALL_LOCATION> <WAS_HOME> <WAS_ADMIN> <WAS_PASSWORD>

Example:
updateSKLM.bat "c:\Program Files\IBM\Installation Manager" "c:\Program Files (x86)\IBM\WebSphere\AppServer" wasadmin wasadminpwd

Unix

  1. Open a command window, and change to the repository directory. Example: /sklminstall_linuxfp
  2. Run the following commands.

chmod +x ./updateSKLM.sh

./updateSKLM.sh <IM_INSTALL_LOCATION> <WAS_HOME> <WAS_ADMIN> <WAS_PASSWORD>

Example:
updateSKLM.sh /opt/IBM/InstallationManager /opt/IBM/WebSphere/AppServer wasadmin wasadminpwd

Where:

<IM_INSTALL_LOCATION> refers to the installation root directory for IBM Installation Manager. Default value on Windows system is “c:\Program Files\IBM\Installation Manager”. For Linux system: “/opt/IBM/InstallationManager”

<WAS_HOME> refers to installation root directory for WebSphere Application Server (WAS). Default value on Windows system is "c:\Program Files (x86)\IBM\WebSphere\AppServer". For Linux system: /opt/IBM/WebSphere/AppServer

<WAS_ADMIN> refers to the ID for the WAS Administrator.

<WAS_PASSWORD> refers to the password for the WAS Administrator.

Select the IBM Security Key Lifecycle Manager, Version 2.6 software package group.

1.      Select the base offering software package group (IBM Security Key Lifecycle Manager, Version 2.6).

2.      Click Next.

3.      In the Update Packages updates panel, select Version 2.6.0.2, and click Next.

Provide credentials for
WAS admin user
(default:wasadmin)
SKLM admin user
(default:SKLMAdmin) and DB2 user
(default:sklmdb26).

  1. In the Update Packages Configuration for IBM Security Key Lifecycle Manager v2.6.0.2 panel:
    • Enter Username and Password for Application Server Administrator.
    • Enter Username and Password for IBM Security Key Lifecycle Manager Application Administrator.
    • Enter Username and Password for IBM DB2 user.
  2. Click the Validate Credentials button.
    Validation might take few minutes, wait till the Next button gets enabled.
  3. Click Next.

Click the Update button.

In the Update Packages > Summary panel, review the software packages that you want to install and click Update.
After Installation Manager successfully updates the fix pack for the services that you select, it displays a message.

 

Steps for installing a fix pack for IBM Security Key Lifecycle Manager, Version 2.6.0 on Windows and Unix operating systems in silent mode

Instruction

Steps

Installation Manager utility to encrypt the passwords for users as required.

  1. Open a command window.
  2. Change to the <IM_INSTALL_LOCATION>/eclipse/tools directory.

Windows

Run the following command to generate an encrypted password:
imcl.exe encryptString <password_to_encrypt>

Unix

Run the following command to generate an encrypted password:
./imcl encryptString <password_to_encrypt>

Make a backup of the response file.

Create a backup of original response file SKLM_Silent_Update_<platform>_Resp.xml by renaming it.
For example: SKLM_Silent_Update_<platform>_Resp_original.xml

This file will be located in the sklm sub-folder under the repository directory where fix pack is extracted.

Edit the response file.

Windows

Edit the silent response file "SKLM_Silent_Update_<platform>_Resp.xml".

  1. Edit the repository location to point to current location of installables.
    (Sample:
    <repository location='C:\sklminstall_windowsfp\sklm'/>)
  2. Edit WASAdmin username and password (Password need to be encrypted).
    (Sample:
    <data key='user.WAS_ADMIN_ID,com.ibm.sklm.win32>value='wasadmin'/>
    <data key='user.WAS_ADMIN_PASSWORD,com.ibm.sklm.win32>value='zN39fpCc9SqIryGJM7+02A=='/>)
  3. Edit SKLMAdmin username and password (Password need to be encrypted).
    (Sample:
    <data key='user.SKLM_ADMIN_ID,com.ibm.sklm.win32>value='sklmadmin'/>
    <data key='user.SKLM_ADMIN_PASSWORD,com.ibm.sklm.win32>value='94FrH/Ll220hVIYc9TflNQ=='/>)
  4. Edit DB user username and password (Password need to be encrypted).
    (Sample:
    <data key='user.DB_ADMIN_USER,com.ibm.sklm.win32' value='sklmdb26'/>
    <datadata key='user.DB_ADMIN_PASSWORD,com.ibm.sklm.win32' value='SwIhGBTDHcJok80Ux4Sb3g=='/>)

Unix

Edit the silent response file "SKLM_Silent_Update_<platform>_Resp.xml".

  1. Edit the repository location to point to current location of installables.
    (Sample for Linux:<repository location='/sklminstall_linuxfp/sklm'/>)
  2. Edit WASAdmin username and password (Password need to be encrypted).
    (Sample:
    <data key='user.WAS_ADMIN_ID,com.ibm.sklm.Linux>value='wasadmin'/>
    <data key='user.WAS_ADMIN_PASSWORD,com.ibm.sklm.Linux>value='zN39fpCc9SqIryGJM7+02A=='/>)
  3. Edit SKLMAdmin username and password (Password need to be encrypted).
    (Sample:
    <data key='user.SKLM_ADMIN_ID,com.ibm.sklm.Linux>value='sklmadmin'/>
    <data key='user.SKLM_ADMIN_PASSWORD,com.ibm.sklm.Linux>value='94FrH/Ll220hVIYc9TflNQ=='/>)
  4. Edit DB user username and password (Password need to be encrypted).
    (Sample:
    <data key='user.DB_ADMIN_USER,com.ibm.sklm.linux' value='sklmdb26'/>
    <data key='user.DB_ADMIN_PASSWORD,com.ibm.sklm.linux' value='SwIhGBTDHcJok80Ux4Sb3g=='/>)

Install the fix pack.

Windows

  1. Open a command window, and change to the repository directory.

Example: C:\sklminstall_windowsfp

  1. Run the following command:

silent_updateSKLM.bat <IM_INSTALL_LOCATION> <WAS_HOME> <WAS_ADMIN> <WAS_PASSWORD>

Example:

silent_updateSKLM.bat "c:\Program Files\IBM\Installation Manager" "c:\Program Files (x86)\IBM\WebSphere\AppServer" wasadmin wasadminpwd

Unix

  1. Open a command window, and change to the repository directory.

Example: /sklminstall_linuxfp

  1. Run the following commands:

chmod +x ./silent_updateSKLM.sh

./silent_updateSKLM.sh <IM_INSTALL_LOCATION > <WAS_HOME> <WAS_ADMIN> <WAS_PASSWORD>

Example:

./silent_updateSKLM.sh /opt/IBM/InstallationManager /opt/IBM/WebSphere/AppServer wasadmin wasadminpwd.

Where:

IM_INSTALL_LOCATION refers to the installation root directory for IBM Installation Manager. Default value on Windows system is “c:\Program Files\IBM\Installation Manager”. For Linux system: “/opt/IBM/InstallationManager”

<WAS_HOME> refers to installation root directory for WebSphere Application Server (WAS). Default value on Windows system is "c:\Program Files (x86)\IBM\WebSphere\AppServer". For Linux system: /opt/IBM/WebSphere/AppServer

WAS_ADMIN refers to the ID for the WAS Administrator.

WAS_PASSWORD refers to the password for the WAS Administrator.

Check logs for fix pack installation success.

View the log file output produced for successful fix pack installation.
Log files are located at: <Installation_Manager_Home>/logs/native



  Performing the necessary tasks after fix pack installation

1.      Verify Installation - Run the wsadmin AdminTask.tklmVersionInfo() command.

Unix users:

Open a shell (ksh or bash).

Type: cd <WAS_HOME>/bin/

Type: ./wsadmin.sh -lang jython -username <sklmadminUserID> -password <sklmadminPassword>

Example: ./wsadmin.sh -lang jython -username sklmadmin -password sklmpassword

At the wsadmin> prompt, type: print AdminTask.tklmVersionInfo()

Windows users:

Open a command prompt.

Type: cd <WAS_HOME>\bin

Type: wsadmin -lang jython -username <sklmadminUserID>-password <sklmadminPassword>

Example: wsadmin.bat -lang jython -username sklmadmin -password sklmpassword

At the wsadmin> prompt, type: print AdminTask.tklmVersionInfo()

Check the output of the tklmVersionInfo command:

IBM Security Key Lifecycle Manager Version = 2.6.0.2

IBM Security Key Lifecycle Manager Build Level = 201605280424

WebSphere Application Server Version = 8.5.5.7

DB2 Version = 10.5.0.6

Java Version = JRE 1.7.0 IBM J9 VM 2.7

2.      A backup of your IBM Security Key Lifecycle Manager server must be performed after installing this fix pack. Follow the steps Backing up critical files in the Administering section of the IBM Security Key Lifecycle Manager Product Manuals.


Uninstalling the IBM Security Key Lifecycle Manager along with fix pack

Note: This will uninstall the entire product package i.e. IBM Security Key Lifecycle Manager, IBM DB2 and WebSphere Application Server, and all your data will be lost. Please take backup before uninstalling.

Steps for uninstalling IBM Security Key Lifecycle Manager version 2.6.0 along with fix pack on Windows and Unix operating systems in GUI mode

Instruction

Steps

Before you begin.

Stop WebSphere Application Server before you uninstall IBM Security Key Lifecycle Manager.

Start uninstalling the ISKLM in GUI mode.

Windows

  1. Browse to <IM_INSTALL_LOCATION>\eclipse and double-click IBMIM to start IBM Installation Manager in GUI mode.
  2. In IBM Installation Manager, click Uninstall. The Uninstall Packages window opens.
  3. Select the check boxes to uninstall IBM Security Key Lifecycle Manager, DB2, and the WebSphere Application Server.
  4. Click Next. Type the WebSphere Application Server Administrator user ID and the password.
  5. Click Next. The Summary panel window opens.
  6. Review the software packages to be uninstalled and their installation directories; click Uninstall.

Unix

  1. Browse to <IM_INSTALL_LOCATION>/eclipse and run IBMIM.
  2. In IBM Installation Manager, click Uninstall. The Uninstall Packages window opens.
  3. Select the check boxes to uninstall IBM Security Key Lifecycle Manager, DB2, and the WebSphere Application Server.
  4. Click Next. Type the WebSphere Application Server Administrator user ID and the password.
  5. Click Next. The summary panel opens.
  6. Review the software packages to be uninstalled and their installation directories.
  7. Click Uninstall.

Steps for uninstalling IBM Security Key Lifecycle Manager version 2.6.0 along with fix pack on Windows and Unix operating systems in Silent mode

Instruction

Steps

Go to the repository directory.

1.      Go to the repository directory
Example:
Windows: c:\sklminstall_windowsfp
Linux: /sklminstall_linuxfp

2.      Backup the original response file SKLM_Uninstall_<platform>_Resp.xml by renaming it to SKLM_Uninstall_<platform>_Resp_original.xml

3.      Edit the silent response file "SKLM_Uninstall_<platform>_Resp.xml".
Edit WASAdmin username and password (Password need to be encrypted).
Windows:
(Sample:
<data key='user.WAS_ADMIN_ID,com.ibm.sklm.win32' value='wasadmin'/>
<data key='user.WAS_ADMIN_PASSWORD,com.ibm.sklm.win32' value='zN39fpCc9SqIryGJM7+02A=='/>)
Unix:
(Sample:
<data key='user.WAS_ADMIN_ID,com.ibm.sklm.linux' value='wasadmin'/>
<data key='user.WAS_ADMIN_PASSWORD,com.ibm.sklm.linux' value='zN39fpCc9SqIryGJM7+02A=='/>

Start uninstalling ISKLM in silent mode.

Windows

  1. Open a command prompt.
  2. Change to <IM_INSTALL_LOCATION>\eclipse\tools directory.
  3. Execute the following command:
    imcl.exe -input <PATH_TO_UNINSTALL_RESPONSE_FILE> -silent
Example:
imcl.exe -input "c:\sklminstall_windowsfp\SKLM_Uninstall_Win32_Resp.xml" -silent

Unix

  1. Open terminal.
  2. Change to <IM_INSTALL_LOCATION>/eclipse/tools directory.
  3. Execute the following command:
    ./imcl -input <PATH_TO_UNINSTALL_RESPONSE_FILE> -silent
Example:
./imcl -input /sklminstall_linuxfp/SKLM_Uninstall_Linux_Resp.xml -silent

Where:

<IM_INSTALL_LOCATION> refers to the installation root directory for IBM Installation Manager. Default value on Windows system is “c:\Program Files\IBM\Installation Manager”. For Linux system: “/opt/IBM/InstallationManager”

<PATH_TO_UNINSTALL_RESPONSE_FILE> refers to the uninstallation response file provided or bundled with the update installer.

<platform> refers to the Operating system where the fix pack is being installed / uninstalled. For example: SKLM_Uninstall_<platform>_Resp.xml on Linux would be SKLM_Uninstall_Linux_Resp.xml


List of fixes and features

New features provided by version 2.6.0.1

Added support for IBM JDK 1.71 SR3 FP10

Added support for SafeNet Luna SA 6.1 cryptography cards

http://www-01.ibm.com/support/docview.wss?uid=swg21976408

APAR fixes included in Fix Pack 2

APAR No.

Sev.

Abstract

IV83119

2

IN SKLM 2.6, REQUIRESHA2SIGNATURES REVERTS BACK TO FALSE AFTER SKLM RESTART.

IV84005

1

TRYING TO USE CERTIFICATE RESTORED FROM EKM BACKUP JAR IN 2.6 RESULTS IN JAVAX.CRYPTO.BADPADDINGEXCEPTION

IV83425

2

COM.IBM.TKLM.COMMON.EXCEPTION.KLMEXCEPTION: ERROR WHILE TAKING THE BACKUP. OCCURS WHEN GPFS END POINT VALUE >= 1

APAR fixes included in Fix Pack 1

APAR No.

Sev.

Abstract

IV80931

1

IBM Security Key Lifecycle Manager, Version 2.6 backup utility failed during backup of previous version of IBM Security Key Lifecycle Manager (TKLM).

IV79948

2

Session time out immediately after login if the session management "No timeout" option is set.

IV81143

2

Unable to login to IBM Security Key Lifecycle Manager UI after fix pack upgrade on LDAP configured IBM Security Key Lifecycle Manager.


Copyright and trademark information

http://www.ibm.com/legal/copytrade.shtml

Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:

Document change history

Change Date

Reason

Modified by

23 May 2016

Created initial draft for 2.6.0-ISS-SKLM-FP0002

AP

31 May 2016

Incorporated review comments from the team

AP



End of Document