Installing the Gatekeeper on Linux

On Linux, you download and install the Gatekeeper separately from the Connection Manager. You can install the Linux version of the Gatekeeper on the same host as the Connection Manager, or on a remote Linux host that has access to the Connection Manager.

Before you begin

The Gatekeeper is a Java application. A compatible version of a Java Runtime Environment (JRE) must be installed to run the Gatekeeper. You can download a version of the Gatekeeper package that includes a compatible JRE.

About this task

To manage a Connection Manager that is installed on Linux, you can run the Gatekeeper from a Linux, AIX®, or Windows host. If you decide to run Gatekeeper from an operating system other than Linux, download and install the Gatekeeper version for that operating system.

Procedure

Download the Linux version of the Gatekeeper installation image from IBM® PassPort Advantage, or from the Recommended Maintenance page of the IBM Mobile Connect Support site. For example, download IMC-<version_number>-LinuxGK-yyyymmdd if you want to install the Gatekeeper only or IMC-<version_number>-LinuxJREGK-yyyymmdd to install the Gatekeeper and the JRE. After the download completes, the file wgcfg.linux.i386.61*.yyyymmdd.tar or wgcfg.linux.i386.jre.61*.yyyymmdd.tar is saved to the download directory.
Log in as root on the computer where you want to install the Gatekeeper.
If you are replacing an earlier version of Gatekeeper that communicated with the access manager over a secure TLS connection, you must back up the existing certificates. Use ikeyman to export the existing certificates to a temporary directory. After you complete the installation, restore the certificates to the new version, as described in Step 8.
Uninstall any earlier version of Gatekeeper. For more information, see Removing the Gatekeeper.
Extract the downloaded Gatekeeper image and specify where you want to save the contents of the archive. After you extract the image, the directory pkglinux is created in the location that you specified. The directory contains the Gatekeeper package file, and if you downloaded the image that includes the JRE, the JRE package file. For example, it might contain package files with names similar to IBMwgcfg-<version_number>.i386.rpmand ibm-java-i386-jre-<version_number>.i386.rpm.
If want to install the IBM JRE that is included with the download, type the rpm -ivh command, followed by the name of the JRE package file. For example, type the following command:
```
rpm -ivh ibm-java-i386-jre-7.0-7.1.i386.rpm 
```
After the Java installation completes, from the same directory, type the rpm -ivh command again, followed by the name of the Gatekeeper package file. For example, type the following command:
```
rpm -ivh IBMwgcfg-6.1-5.x.i386.rpm
```
Gatekeeper is installed to the directory of /opt/ibm/Gatekeeper. The installation also creates links in the /usr/bin directory for the following scripts:
- wgcfg
- wgcfgikeyman
- wgcfgnewjvm
- wgcfgnewwin
If you are not logged in as root, permission is denied. If a compatible Java version is not found, the installation fails.
If you are upgrading from an earlier version and you backed up certificates to a temporary directory in Step 3, use ikeyman to restore the previously used certificates. Add the certificates to the new Gatekeeper trusted.jks file, or to a jks file that you create.