IBM Support

Using GSKit on Linux generates error "version gsk8 not defined in file libgsk8cms_64.so with link time reference"

Troubleshooting


Problem

The GSKit 8 tool which is included with Planning Analytics on Linux is used for many procedures such as configuring SSL and adding certificates to the TM1 keystores, which is needed for certain integrations such as Git.
When using this tool, you might encounter an error such as the following:
/tm1/cognos/tm1_64/bin64/gsk8capicmd_64: symbol _ZTV20GSKPasswordEncryptor, version gsk8 not defined in file libgsk8cms_64.so with link time reference

Cause

The primary causes of this error are:
1) You do not have the required library file for GSKit installed (unlikely since this is included with the PA install)
2) You are missing a path to the library file in your system environment variable "LD_LIBRARY_PATH"
3) You have multiple paths set in your "LD_LIBRARY_PATH" environment variable, causing GSKit to use the incorrect one included from a non-TM1 path

Resolving The Problem

To check for case 3, you can use the command "echo $LD_LIBRARY_PATH" which will print the current setting for this environment variable to your command line. You may see paths such as:
/usr/local/ibm/gsk8_64/lib64
/usr/lib64
/tm1/cognos/tm1_64/bin64
The first one you may have installed along with an IBM JRE. The second one is a typical default path. The third one is the correct path for the library files which are installed by TM1. When using GSKit for TM1 purposes, you must use this specific library file or some functions will not work. Remove any other paths from the "LD_LIBRARY_PATH" variable except for the tm1_64 path, and try to run your GSKit command again.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSCTEW","label":"IBM Planning Analytics Local"},"ARM Category":[{"code":"a8m0z000000blxdAAA","label":"How To"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"All Versions"}]

Document Information

Modified date:
24 December 2021

UID

ibm16537088