How do I activate my license for Hololight Stream Runtime?

Hololight Stream Runtime need to be activated in order to work. You can follow the steps below to activate Hololight Stream Runtime.

In order for Hololight Stream Runtime to activate, it needs access to the internet. It does this through network port 5053 and 5054. If you’re having trouble activating Hololight Stream Runtime, make sure the necessary ports are open on the network the computer is connected to.

Choose a valid Hololight Stream Runtime license file

Once you receive a license file from Hololight, you are ready to activate Hololight Stream Runtime. Save the license file to a location on the Windows-based machine that will host your application and has Hololight Stream Runtime installed.

Open the Hololight Stream Runtime utility.
Select Licensing.
Under License > Set License File, select Browse.
Go to the folder with your license file, select it, and select Open.

Under License > License File, you should now see the message License file found, indicating that a license file has been successfully selected.

At this point, you will not see any information under LIcense Information. This information only updates when you open an application that uses OpenXR, which then uses Hololight Stream Runtime.

Set your Hololight Stream Runtime license mode

When using Hololight Stream Runtime there are two different license modes, floating and roaming. You need to set one of these to activate Hololight Stream Runtime.

Under License Mode > Mode, select either Floating or Roaming.

Once you’ve selected the best license type for your situation, you are ready to activate Hololight Stream Runtime.

When to use the floating license mode

Floating license mode lets you use Hololight Stream Runtime as long as your license is valid. However, your machine always needs to stay connected to the internet in order to use Hololight Stream Runtime with this license mode.

When to use the roaming license mode

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

When you switch to roaming, you need to connect Hololight Stream Client to the application at least one time while connected to the internet to activate the roaming license mode. After that you can use Hololight Stream Runtime for 13 days without connecting to the internet.

To release a seat checked out in roaming mode, just switch to Floating mode.

Update Hololight Stream Runtime license information

With a valid license file set, a license mode set, open an OpenXR-supported application.
Connect to the application using Hololight Stream Client.

After connecting to the application, you can see more information about your license under License Information. These details only update after switching tabs or selecting the refresh button.

Each Hololight Stream license has a number of seats. When you open an OpenXR-supported application, that application will use one of the license’s seats. Two computers each running one OpenXR-supported application, use two seats.
If on the same computer you run three OpenXR-supported applications, they will each use a seat from the license, consuming a total of three seats.

License information

The license information helps you with information to understand and manage your license. The license information only updates when you run an application that supports OpenXR while Hololight Stream Runtime is installed and you select Refresh in on the Hololight Stream Runtime utility license screen.

**License information**
Setting	Description
Last updated	This is the last time an OpenXR compatible application was opened with Hololight Stream Runtime installed and checked the license server
Status	If and how a seay from the license is being used
Current mode	The license mode currently set
Start date	The date the license activates
Expiration date	The date the license expires

**License status**
Status	Meaning
Checked out	Hololight Stream Runtime is active and running.
Expired	The license associated with the selected license file is expired.
Invalid	The selected license file is incorrect.
Not set	You have not selected a license file.
Released	Hololight Stream Runtime is not using a seat assigned to the license.
Saturated	All seats assigned to the license are already taken. Hololight Stream Runtime can’t activate.

If you encounter issues activating Hololight Stream Runtime, you can check a log that keeps track of licensing events. You can find this at "%APPDATA%/Holo-Light GmbH/Hololight Stream Runtime/license_error.log" on your computer.