Gatekeeper Automatic Registration

Use automatic registration to register a Gatekeeper without opening the Gatekeeper interface at localhost:4680. You supply the registration code when you install. When the Gatekeeper service starts, it contacts the PAS server, registers itself, and comes online with no further steps.

Automatic registration is useful when you deploy many Gatekeepers with scripts or software distribution tools, or when the host has no local browser.

Requirements

To complete the silent installation and automatic registration you must meet the following requirements:

  • Gatekeeper or Gateway's Gatekeeper: Each host needs its own Gatekeeper or Gateway Instance, and each has a unique registration code. Each Gateway and Gatekeeper registration code pairing is unique.

  • Long Registration Code: This process requires that you use the long registration code. Short registration code or validation words are not available for this.

Read the Gatekeeper Installation Guide and the Gateway Installation Guide for more information on requirements.

Windows Registration

The Windows installer accepts two command-line options:

Option Description
/S Runs the installer silently. The S must be uppercase.
/regcode=<code> Sets the long registration code that the Gatekeeper uses to register automatically.

To install and register a Gateway or Gatekeeper from a Command Line:

  1. Copy the installer to the target host.

  2. Open a Command Prompt with Run as administrator.

  3. Use the following command to move to the folder that contains the installer:

    cd %USERPROFILE%\Downloads

  4. Run the followng command with both installer options:

    {filename.exe} /S /regcode=<LONG_REGISTRATION_CODE>

    1. Replace filename.exe with the name of the file you downloaded.

    2. Replace <LONG_REGISTRATION_CODE> with the long registration code as a single, unbroken string.

Linux and Unix Registration

On Linux and Unix, you provide the long registration code in a file named auto_install.properties. Create this file in the Gatekeeper's bin directory before the Gatekeeper starts.

  1. Install the Gatekeeper files by following the steps for your distribution in the Gatekeeper Installation Guide. Stop before the Register the Gatekeeper step.

  2. Switch to the user that runs the Gatekeeper (normally rss):

    $ su - rss

  3. Create the auto_install.properties file in the bin directory:

    $ cd ~rss/slink/bin

    $ echo "autoRegCode=<LONG_REGISTRATION_CODE>" > auto_install.properties

    The file must contain exactly one line: autoRegCode= followed by the long registration code.

    If you installed the Gatekeeper in a different directory, create the file in that installation's slink/bin directory.

    NOTE:

    If you create the file as root, change its owner so the Gatekeeper can remove it after registration:

    # chown rss:rss ~rss/slink/bin/auto_install.properties

  4. Start the Gatekeeper, or restart it if it is already running. The Gatekeeper reads the file only when it starts.

Use the following table for command reference

Platform Command
RedHat, CentOS, Linux ARM, and other Linux distributions using slinksc $ sh ~rss/slink/slinksc restart
Ubuntu # /etc/init.d/slinksc.ubuntu restart
SUSE 9 $ sh ~rss/slink/slinksc.suse restart
SUSE 15 $ sudo systemctl restart universal-gatekeeper-suse-15
SUSE Micro 6 $ sudo systemctl restart universal-gatekeeper-suse-micro-6