How do I check out and check in a roaming license?

Roaming is not a function inherent to your floating-cached licenses, it is an additional service and needs to be added by the HighTec sales team. If you want to use the roaming function and do not already have one, you can contact us at: sales@hightec-rt.com.

The roaming time is defined in the server license file. The value is defined and signed by HighTec and can not be changed without the need for HighTec’s validation. The default value is 30 days, if no maximum roaming time is set in the license file.

To enable roaming, a separate roaming license is also needed. Each client machine that wishes to roam needs a copy of that roaming license. For those client machines, you also have to extend the environment variable RLM_LICENSE to include the path to the roaming license.

How to manually check out a roaming license

  1. Set RLM_LICENSE=<host_name>@<port_number>;C:\HighTec\Licenses\hightec_roam.lic (or, your user-defined directory where the roaming license is located).

  2. Set RLM_ROAM=1 (The number of days you want to roam)

  3. Do a simple compile command to check out the license

    1. E.g., clang -march=tc162 test.c

  4. Set RLM_LICENSE=C:\HighTec\Licenses\hightec_roam.lic (or, your user-defined directory where the roaming license is located).

You should now be able to use the compiler without being connected to the license server.

How to manually check in a roaming license

  1. Set RLM_LICENSE=<host_name>@<port_number>;C:\HighTec\Licenses\hightec_roam.lic (or, your user-defined directory where the roaming license is located).

  2. Set RLM_ROAM=-1

  3. Do a simple compile command for checking in the license

    1. E.g., clang -march=tc162 test.c.

How to verify your roaming status

To verify the roaming status, you can open a terminal in the license server directory. Set RLM_LICENSE=<host_name>@<port_number> and call rlmutil rlmstat -a.

You will then see that one license is in use, for example:

        hightec-rt license pool status on localhost (port 6004) +
        tricore-llvm v2023.06, pool: 1 +
                count: 1, # reservations: 0, inuse: 1, exp: 31-dec-2022