Installing the SafeLinx Administrator on Linux

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

Before you begin

The SafeLinx Administrator requires OpenJDK8, which is available from https://adoptopenjdk.net. Verify that you have Open JDK8 installed on the same machine that you plan to install the SafeLinx Admin Client

About this task

To manage a SafeLinx Server that is installed on Linux, you can run the SafeLinx Administrator from a Linux or Window host. If you decide to run SafeLinx Administrator from an operating system other than Linux, download and install the SafeLinx Administrator version for that operating system.

Procedure

  1. Download the Linux version of the SafeLinx Administrator installation image from the My HCLSoftware Portal.
    For example, download SafeLinx-<version_number>-LinuxGK-yyyymmdd if you want to install the SafeLinx Administrator only or SafeLinx-<version_number>-LinuxJREGK-yyyymmdd to install the SafeLinx Administrator 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.
  2. Log in as root on the computer where you want to install the SafeLinx Administrator.
  3. If you are replacing an earlier version of SafeLinx Administrator that communicated with the access manager over a secure TLS connection, you must back up the existing certificates. Copy the *.kdb and *.sth files to a temporary directory.
    After you complete the installation, restore the certificates to the new version, as described in Step 7.
  4. Uninstall any earlier version of SafeLinx Administrator. For more information, see Removing the SafeLinx Administrator.
  5. Extract the downloaded SafeLinx Administrator 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 SafeLinx Administrator 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 wgcfg-<version_number>.i386.rpmand hcl-java-i386-jre-<version_number>.i386.rpm.
  6. After the Java installation completes, from the same directory, type the rpm -ivh command again, followed by the name of the SafeLinx Administrator package file.
    For example, type the following command:
    rpm -ivh wgcfg-1.0.0.x.i386.rpm
    SafeLinx Administrator is installed to the directory of /opt/hcl/SafeLinx Administrator. The installation also creates links in the /usr/bin directory for the following scripts:
    • wgcfg
    • wgcfgnewjvm
    • wgcfgnewwin
    If you are not logged in as root, permission is denied. If a compatible Java version is not found, the installation fails.
  7. If you are upgrading from an earlier version and you backed up certificates to a temporary directory in Step 3, use the GSKit to restore the previously used certificates. Add the certificates to the new SafeLinx Administrator trusted.jks file, or to a jks file that you create.