Skip to main content
Older versions of Internet Explorer will not support certain site features. Chrome, Safari, Firefox, and Edge will provide the best experience.
Spok

Install SecureLink GateKeeper On Red Hat Linux (Legacy)

Overview

This article will walk you through installing the SecureLink gatekeeper application on the Smart Suite Red Hat Linux servers that have never had SecureLink installed.

 The below installation is for installing the Legacy Gatekeepers. After October 4th 2022, a new SecureLink Gatekeeper for platform was released which requires different installation instructions

Procedure

Step 1: Gain Access to the Linux server and to the associated Customer and Gatekeeper within SecureLink
  1. For the example, our customer is "Smart Suite 5.7 Test" and the gatekeeper is "5.7 DB1"

SecureLink_Gate.PNG

Step 2: Reset the Registration Code and get the gatekeeper application on the Linux Server
  1. On the Gatekeeper within SecureLink,  click on the gatekeeper name (5.7 DB1) or click "View" to open the gatekeeper.
  2. From the next screen, toward the bottom, click "Reset Registration Code". This will give you a fresh registration code to use. Note this code for later use
  3. On the same page toward the top right you should see a link named "Linux". Open that link to bring to the next pageregistration_code_.PNG
  4. From the next page, you should see a section to download two SecureLink Components (spokclient.tar.gz and spokjava.tar.gz). Click on each to download them.download_.PNG
  5. Once downloaded, get the files on the server via SFTP or any other method as the rss user. You may have to create the rss user if ti is not already. Place these files in the rss home directory (/home/rss/)
Step 3: Install and configure the Gatekeeper application on the Linux Server
  1. On the Linux server, make sure you are logged in as the rss user.
  2. Run the following commands to extract the contents from the newly uploaded files
    1. tar zxvf ~rss/spokclient.tar.gz
    2. tar zxvf ~rss/spokjava.tar.gz
  3. A new folder should be created in the rss home called "slink" (/home/rss/slink/). 
  4. Create/Edit the "permkey.properties" in /home/rss/slink/bin/ using the following command
    1. vim ~rss/slink/bin/permkey.properties
  5. Copy the information below into the file, changing the permkey to the Registration Code that you received earlier from SecureLink and save the file
    1. #Permanent Key Properties
      permkey=16b22a10af
      scheduler.active=false
      anytimeExpiry=0
  6. Change user to root
  7. Run the following command to add the Gatekeeper application as a service
    1. install -pm 755 -o root -g root ~rss/slink/slinksc /etc/init.d/slinksc
  8. Run the following two commands to give the service the ability to Start when the system starts
    1. chkconfig --add slinksc
    2. chkconfig --level 35 slinksc on
Step 4: Start the Service and test the connection within SecureLink
  1. Still as the root user on the Linux Server, start the service using the following command
    1. service slinksc start
      1. Starting the service should look like the following
        service start.PNG
  2. Go back to SecureLink and view the Gatekeeper you were trying to update. If the connection is not yet online, wait a few seconds and then refresh the page. If the connect button is blue and the connection access is enabled, the gatekeeper is online.
  3. access_enabled.PNG
  4. Test the connection to the server via SecureLink to be sure it works
Related Defects:

N/A

 


KB44845