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
About this task
Procedure
-
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.
- Log in as root on the computer where you want to install the SafeLinx Administrator.
-
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.
- Uninstall any earlier version of SafeLinx Administrator. For more information, see Removing the SafeLinx Administrator.
-
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.
-
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. - 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.