Installing the Sentinel RMS License Manager on Windows

The Sentinel Rights Management System (RMS) License Manager enforces and manages licenses for Uniface in multi-user environments.

Before you begin:

  • It is useful to have the Sentinel license file or license code, or the email from Uniface with your Entitlement ID (EID). It is also possible to configure the license after installing the RMS License Manager.
  • You will need administrator privileges to install the RMS License Manager and Cloud Plug-in.

To install the RMS:

  1. Download the installation package onto your system. It is a self-extracting zip file.
  2. If you have a license file, also download it onto your system and take note of the directory location—you will need it later.

    Alternatively, you can manually upload the license after completing the installation. For more information, see Configuring a License File Manually.

  3. Double-click the downloaded package to extract and run it, and click OK in the subsequent dialog box.
  4. Choose where you want to extract the files; by default, this is the current directory. Click Unzip.

    Note: The option to automatically execute the PowerShell installation script is selected by default.

    If you want to run this later, clear the checkbox, click OK to extract the files, then click Close.

    To run the installation script non-interactively, run the installrms.bat from the command line. For more information on how to do this, see Silently Installing the RMS License Manager on Windows

  5. At the first prompt, press Enter to continue.
  6. Read and accept the Thales RMS license agreement. You can choose to enter D to display it on screen, or view the RMS-EULA.txt file included in the extracted contents of the installation package.
    • D—display the License Agreement on screen. This is the default should you not choose any prompts. Page through the License Agreement on screen using the space bar or Enter key, and quit using Q.
    • Y—accept the terms and continue with the installation.
    • N—reject the terms and stop the installation.
  7. Enter the path where you want the RMS installed, or press Enter to accept the default path: C:\Program Files (x86)\Common Files\SafeNetSentinel
  8. When prompted, choose the type of license you will be using:
    • Cloud Served License—both the RMS License Manager and Sentinel Cloud Plug-in will be installed. You need an internet connection when executing this option.
    • License File or License Code—only the RMS License Server will be installed.
    • Install RMS and I will configure the license later—the RMS License Manager and Sentinel Cloud Plug-in will be installed but not started.
  9. For a cloud-served license, provide details to configure the Cloud Service Plug-in and proxy server:
    1. Enter your Entitlement ID (EID). You can copy and paste this from the email you received from Uniface containing license activation information.
    2. You can choose to enter an additional Entitlement ID or press Enter to continue. You can enter as many Entitlement IDs as required.
    3. Enter a friendly name to register your machine, or press Enter to use the default machine name.

      The friendly name is a human-readable fingerprint used to uniquely identify your machine in the EMS customer portal. You can change this to something that is meaningful to you. The friendly name is restricted to 30 characters, containing letters, digits, underscores, and hyphens.

      Note: If you use cloud-served licenses on more than one machine, ensure that you choose a friendly name that is not already used on another machine. Otherwise, this will interfere with the cloud license of both machines.

    4. You can now choose to configure a proxy server, if you use one.
      • No proxy will be used—proceed to the next step. This is the default option.
      • A proxy server needs to be configured—at the subsequent prompts, provide the proxy server's host name (mandatory), its port number (optional), a proxy user name (optional), and the password of that user (optional). If you leave the proxy user name blank, it will use the default system credentials of the application.
      • Automatic—the script will automatically search for a PAC file from the Windows Registry and use this to auto-configure the proxy server. If it cannot find a PAC, it will use the default PAC file.
      • If no proxy server is chosen, the installer tries to contact the Sentinel Cloud server before continuing. If it cannot be reached, the script will ask you to check your connection or firewall settings. Select yes (Y) to retry, or no (N) to exit the script and cancel the installation.

  10. For a license file, enter the full path to the license file, or press Enter to configure the license later. For example: C:\Users\User\Desktop\lservrc

    If you do not have a license file yet, or you have a license code, or if you wish to upload your license later, press Enter. Information is displayed about how to do this.

    The installer now proceeds to:

    • Install the Sentinel RMS License Manager in the specified location or the default location C:\Program Files (x86)\Common Files\SafeNetSentinel.
    • Install and start the service Sentinel RMS License Manager.
    • Install related Sentinel tools.
    • Register the fingerprint for your Entitlement ID, if a cloud-served license was used.
    • Install and start the service Sentinel Cloud Plug-in Service for unifacebv if a cloud-served license was used. It also creates a cloud configuration file in C:\Program Files (x86)\Common Files\SafeNet Sentinel\SentinelCloudPlugin.

    The installer reports this information, as well the settings to be added to the assignment file of the Uniface application that will connect to this RMS Server.

  11. You can now remove extracted installation files.
  12. To connect a Uniface application to the Sentinel RMS License Manager, specify the location of the RMS license server in the application assignment file:

    $license_options = LM_LICENSE_FILE = RmsServerHostMachine

Configuring a License File Manually

To configure a license later, you can do one of the following:

  • Copy your license file to C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT, then restart the Sentinel RMS License Manager service.
  • Use the Sentinel RMS License Manager Administration tool (WlmAdmin.exe) to configure your license.
  • Activate your cloud-served network license using the Uniface License Management utility (ulic). For more information, see Configuring Cloud-Served Network Licenses.

The RMS tools are located in C:\Program Files (x86)\Common Files\SafeNet Sentinel\Tools.

Note: If you start the RMS License Manager or Sentinel Cloud Plug-in before configuring your license, restart these services once your license is configured.

Troubleshooting

The RMS installation script checks that the RMS server and the Cloud Plug-in (if applicable) are running. If one of them is not running, it will report that it failed to start.

  • If the RMS server failed to start, examine its log file:

    C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT\rms.log

  • If the Cloud Plug-in failed to start, examine its log file:

    C:\Program Files (x86)\Common Files\SafeNet Sentinel\SentinelCloudPlugin\scp.log

  • If both started correctly, but after waiting for 10 seconds, a license file still has not been downloaded, examine the Cloud Plug-in log file for errors:

    C:\Program Files (x86)\Common Files\SafeNet Sentinel\SentinelCloudPlugin\scp.log

  • If you have entered an incorrect Entitlement ID, or if the proxy settings are incorrect, you do not have to run the installation script again. Instead, you can directly edit the cloud configuration XML file that resides in C:\Program Files (x86)\Common Files\SafeNet Sentinel\SentinelCloudPlugin.

    After correcting them in this file, stop and start the service using the Windows Services tool. After a few seconds your license file should appear in your installation directory (lservrc).

If you encounter errors or unexpected messages when installing the RMS License Manager, examine the installation log install-DateTime.log in the current directory. When contacting support, please supply the installation log file.