Installing reprise license server

This documentation is relevant for license administrators, and is needed if your organization chooses to use floating licenses (the other option is to use node-locked licenses). In this case, a license server has to be set up, and users of the software should connect to the server in order to check out a license. Follow the instructions below to make floating licenses operational:

  1. Obtain the MAC address of the server, and send it to Luceda Photonics.

  2. Configure and start the license server.

  3. Install the license on the client (end-user) computers.

Obtaining server information and send it to Luceda Photonics

In order to create the user licenses, we need to know the MAC address of the server hosting the license and whether or not the license server is a virtual machine. When you are in the process of obtaining a license, you will be asked for

  • The MAC address of the license server.

  • Whether or not the license server is a virtual machine.

Once we have that information, Luceda will send you a email containing your license.

Configuring the license server

  1. Download the RLM License Administration Bundle behind the following “https://reprisesoftware.com/support/admin/license-administration-bundle/”

  2. Install (Windows) or extract (Linux) the RLM License Administration Bundle to a folder on the license server.

  3. Inside the license file (.lic) replace “myserver.mycompany.com” with the server hostname. This file uses standard ASCII encoding, make sure not to change it. The hostname can be found using the command ‘hostname’ in a command window or terminal. The server should be accessible by everybody that wants to check out the license. See also Configuring a floating license

  4. Optionally, on the same line in the license file, modify the server port number 5053 by the port number you want to use to access the license server.

  5. Copy the luceda.set (received together with the license file) file to the folder where the RLM License Administration Bundle is installed. Do not edit or open this file, as doing so can corrupt it. The folder should contain rlm.exe (Windows) or rlm (Linux).

  6. Copy the modified license file to the folder where the RLM License Administration Bundle is installed. This folder contains rlm.exe (Windows) or rlm (Linux).

  7. Do either one of the following, This is necessary or the license server will shut down after 10 minutes.: a. Run rlm.exe, a file called rlm.pw will appear. Edit the rlm.pw file to replace the existing user with one or more new users with a blank password. This means having one or more lines in the file written in the following format: ‘username::all’. The username cannot contain a ‘:’ character. Then, you should open a browser and enter the URL ‘localhost:5054’. This will open the RLM web server interface. Click “Change Password”, login with the user(s) that you have created and change their password(s) to new ones. For more advanced uses of the rlm.pw file see the rlm documentation. b. Open a command prompt (Windows) or a terminal (Linux) and navigate to directory where you have installed RLM. Then, run rlm.exe -nows (Windows) or rlm -nows (Linux). This will run the license server without a web server.

  8. We recommend installing the server as a service according to the rlm documentation on server as a service). Alternatively start the license server by running rlm.exe (Windows) or rlm (Linux).

  9. The license server should start properly.

Installing the license on user computer

  • Install IPKISS using the installer.

  • Open the Luceda Control Center.

  • Click on the Product License tab.

  • Drag and drop the modified license on the Product License window in the Luceda Control Center.

  • The products activated by the license will be marked as valid.

Alternative ways of setting the license on the user computer.

If problems arise in the installation on the license on the user computer their are alternative ways of pointing to the license server.

  1. (RECOMMENDED) Set luceda_LICENSE environmental variable to port@host. (user does not need a license file as long as the server is running)

  2. Put the modified license file (with .lic extension) in the Luceda software binary directory

  • C:\luceda\luceda_2024091\envs\ipkiss3 or equivalent folder (WINDOWS)

  • ~/miniconda/envs/ipkiss3 or equivalent folder (LINUX)

  1. Set luceda_LICENSE environmental variable to the {license_file_path} (user can store the license anywhere on his PC).

Configuration of your firewall

Sometimes you’ll have to configure the firewall of your server or company to make sure that your client can contact the license server. This configuration will heavily depend on your internal infrastructure. The following webpage is a great starting point : http://www.reprisesoftware.com/blog/2012/10/using-rlm-across-a-firewall/.

FAQ

If your license does not work please try the following.

  1. From a command window/terminal try to ping the license server ping server_name. (server_name is the same as in the license file)

  2. Have you included luceda.set file along the license file on the license server?

  3. Restart the license server.

  4. Check if the license server does not prompt an error message while starting. Normally you should see something similar to the following:

09/16 10:57 (luceda) Server started on USER_NAME (hostid: mac_address) for: 09/16 10:57 (luceda) ipkiss circuit physical oascript ipkisseda 09/16 10:57 (luceda)

09/16 10:57 (luceda) 09/16 10:57 (luceda) License files: 09/16 10:57 (luceda) path_to_licence.lic

  1. Contact support@lucedaphotonics.com