Getting Started
      Back to home
      1. Knowledge Base Hololight
      2. Hololight Space
      3. Getting Started

      How can I activate my Hololight Space License?

      Two Ways of Licensing: Cloud Based & Private On-Premise

      Getting Your Hololight Space License File

      There are two ways to get a Hololight Space license file. Depending on your organization’s needs, you can use cloud-based licensing or generate your own licenses on a private licensing server.

      • Cloud-Based Licensing
        With Hololight Space cloud-based licensing, you will receive your licensing file directly from Hololight. Once you have your license file, you can continue on to activating Hololight Space.

      • Private On-Premises Licensing Server
        If your organization requires Hololight Space to be used within a private network isolated from the internet, you will need to set up a private licensing server.

      Cloud-Based Licensing

      In order to use the full version of Hololight Space you need to install, configure, and activate the license. You can then deactivate your license by releasing it. If you received a license file from Hololight make sure your PC is connected to the internet. If you generated your own license file, make sure that your PC is connected to the same network as your private licensing server

      Installing the License File

      1. Open Hololight Space.

      2. On the menu on the left, select “Licensing”.

      3. On the “Hololight Space License” panel, scroll down to “Select New License File” and select the browse button.

      4. Browse to the folder where you saved your license file. Select it and open it. Hololight Space will then automatically move the file to the correct location. You can alternatively place the file in the correct folder yourself, located here:

      5. Alternatively, manually place the .lic file in the following directory:
        C:\Users\user1\3d objects\Hololight Space\Licensing

      Configuration

      Before activating the license you need to select a license type on the “Hololight Space License” panel under “License Type”. Different license types have different advantages, allowing you to flexibly and easily control access to the license as best fits your needs.

      When to use a roaming license

      A roaming license lets you use Hololight Space for up to 13 days without needing to connect to the internet. After 13 days the machine running Hololight Space needs to reactivate the license while connected to the internet. You can then use Hololight Space with your license for another 13 days before having to repeat the activation.

      When to use a floating license

      A floating license lets you use Hololight Space as long as your license is valid. However, your machine always needs to stay connected to the internet in order to use Hololight Space with this type of license.

      Activate your license

      Once you’ve installed your license file and chosen your license type, you can activate your license. If a valid license already exists in the correct folder, Hololight Space will activate the license automatically.

      1. To activate your license select the “Activate” button.
      2. If the activation is successful, a green “Server Reachable” icon will appear. You can now use Hololight Space with your License.

      Release your license

      Sometimes it is necessary to release a license. You might want to change the license type before reactivating or maybe allow someone else to use the license.

      1. To the release a license, select the “Release” button on the “Hololight Space License” panel.
      2. When the green “Server Reachable” icon disappears, the license is free.

      Private On-Premises Licensing Server

      Installing your Licensing Server

      1. When you’ve decided to use a private licensing server to activate Hololight Space, the process will begin with Hololight sending you a package or installer with the necessary files.
      2. Transfer the file package or installer to a folder on the server machine you will use to generate your licenses. The destination folder should be appropriate for files you will store permanently on the server machine. We recommend using the “C:” drive.
      3. Extract the files from the ZIP file or run the provided installer. A new folder will appear. Rename the new folder to “RLM” if it isn’t named that already.
      4. Open the start menu and type “Powershell” in the search bar. Then select the application in the results.
      5. Using Windows Powershell, navigate to the “RLM” folder you set up earlier.
        cd c:\rlm
      6. Once in the "RLM" folder run:
        .\rlmutil.exe rlmhostid uuid

      7. Once the program finishes, Windows Powershell will display the machine’s UUID. This will look like the example below. The long sequence of seemingly random letters and numbers is the UUID.

        Hostid of this machine:  uuid=57c8eba5-46a1-457f-87b7-16734692fe49
      8. Send the UUID back to your Hololight Contact.

      Running your Licensing Server

      1. Hololight will do some configuration on their end. Then they will send you the following file:

        ServerAdmin_FloatingSeats.lic

        Download this file and place it in your “RLM” folder, the same folder set up earlier which contains “rlm.exe”.

      2. In the “RLM” folder, double-click “rlm.exe”. A window will appear. Select “More info” then select the button “Run anyway”. A Command Prompt window will then appear, showing that the server is running. The server will only run for 10 minutes before you need to restart it again. Once you’ve changed the admin password for the server this will no longer be the case. We will do that soon though. Do not close the Command Prompt window.

      3. Open a web browser. In the address bar type:

        localhost:5054

        If the server is running correctly, you should see the “Reprise License Server Administration” panel in your browser.

        userguide_hololight_space_licensing_server_00

      4. On the left side menu sign in with the following temporary credentials.

        • Username: admin

        • Password: admin

      5. Now we will change the password to both improve security and make sure that the server can run for more than 10 minutes at a time. Having signed in with the temporary credentials, select the “Change Password” button on the left side menu.

        userguide_hololight_space_licensing_server_01

      6. On the page that appears, enter your new password into the two fields and select “CHANGE PASSWORD”. Be sure to remember this password for future use.

        userguide_hololight_space_licensing_server_02

        With that done, once you start the server it will continue to run until you decide to stop it or power off the machine.

      Installing the Service

      You are able to run your private licensing server, but every time you shut down and restart the machine you will need to start the server again this same way. By installing a service the server will run automatically when Windows starts.

      1. Open the start menu, type “cmd” in the search bar, right-click “Command Prompt”, and then select “Run as administrator.”

      2. Use the cd command to navigate to your “RLM” folder.

        cd c:\rlm

      3. Now you can install the service. Take care that the path for the log matches your “RLM” folder.

        rlm -install_service -dlog +C:\RLM\server.log

      4. If you are successful, you will just see a new blank line. Now you can start the service.

        sc start rlm

      Details about the service will appear, along with a “START_PENDING” status as the “STATE”. You should see “RLM” in your Windows Services.

      Now the licensing server will start automatically every time your start the server machine.

      Creating Hololight Space license files

      Your licensing server is running, but to activate Hololight Space you need to create a license file. You can copy and share this license file with members of your organization that will use Hololight Space on your server’s network. For each seat purchased with your license, a single instance of Hololight Space can run on your server machine’s network, verified by the server you set up earlier.

      1. Hololight will send you a file named “HoloLightSpace_To_OnPremiseSever_Template.lic”. This is a template for creating a license file. Open this template using a text editing application like “Notepad.exe”.

        userguide_hololight_space_licensing_server_03

      2. Open the start menu, type “cmd” in the search bar, and select “Command Prompt”. Type and run the following command:

        ipconfig

        Command prompt will output a series of data. The IP address is the number next to “IPv4 Address”.

      3. Back in Notepad, in the last line of the template file, replace the text “YOUR_SERVER_ADDRESS” with the IP Address from Command Prompt. The last line should look like this:
        SERVER 192.168.123.132 ANY

        If you need to restrict the ports, replace “ANY” with the port number you want to use.

      You now have a Hololight Space license file. You can rename it, but remember to keep the “.lic” extension. Copy this file and share it with anyone who will use Hololight Space on your private network.