IBM GSKit requirements

The encryption capabilities of the Cipher adapter require IBM Global Security Kit (GSKit). By default, Transformation Extender installs GSKit locally. A locally installed GSKit enables Transformation Extender to run a specific version of GSKit that is automatically used by Transformation Extender executable programs. Products that Transformation Extender integrates with might use their own local version of GSKit. When you run Transformation Extender with other products that are configured to use GSKit, you can configure the environment to use the latest or most appropriate version.

To use the Cipher adapter in an API or RMI environment, ensure that the library and executable path of your platform points to the local GSKit drivers by running the dtxcommon.bat file (on Windows) or the setup script (on UNIX) before you run a map. In an Integrated Server environment, you must manually adjust the paths to point to the GSKit drivers.

To prevent Transformation Extender from using its locally installed version of GSKit, rename the tx_install_dir\GSKit directory to any other name. At runtime, Transformation Extender automatically detects the missing GSKit directory and searches the platform-specific environment path for the GSKit modules.

When you have a globally installed version of GSKit on the same system due to the requirements of another product, renaming the tx_install_dir\GSKit directory ensures that the Transformation Extender local GSKit is bypassed. The global version is managed by the GSKit installation program, and makes the security modules available on a system-wide basis.