Versions Compared

Old Version 34

changes.mady.by.user Gergana Lilkova

Saved on

compared with

New Version Current

changes.mady.by.user Kristina Gaytandzhieva

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page gives details on how to download and install the Chaos License Server for Chaos products.

Floatingpagetoc

 

...

.

...


Overview

...

The Chaos License Server is a secure way to license products online as . It is a highly-encrypted centralized online system that manages licenses for all your systems. Additionally, the Chaos License Server also provides for allows users to "borrow" licenses from their online accounts and work offline without having Internet an internet connection or a hardware dongle , for up to 14 days at a time.. For more details on how the Licensing System works, please see the License Setup page.

For instructions on creating a fail-safe for unexpected server downtime, setting up a silent installation with a predefined set of instructions, controlling the License Server through the command line, and many more, see the Advanced usage page.

The License Server is installed automatically with all Chaos products. If you need to download and install it separately, please follow this Installation Process. 


Installation Process

...

UI Text Box
typetipnote

On the Linux OS, please use your local user with the sudo command instead of the root user to run the installer.

 

...

This process follows the steps for downloading and installing the Chaos License separately from any Chaos product.

UI Steps
UI Step

Download the Installer

Download the Chaos License Server installer

...

from the Downloads section of the Chaos website

...

. Log in to access it

...

. Download the latest version of the License Server and open the file.

...

section

UI Button

columnwidth20%columnwidth60%

color

blue

newWindow

true

 

size

large

icon

download

Image Removed

Column
width20%

 

 

2) Please read over the license agreement. To continue with the installation process, click the I agree button.

 

60%20%

titleDownload the License Server
urlhttps://download.chaos.com/?platform=47&product=48


 
Section
Column
width
20%
10%


Column
width
80%
Image Removed

Image Added

Column
width
10%

 

...




UI Step

Run The Installer and Accept the EULA

...

UI Text Box
type

info
tip

On the Linux OS, please use your local user with the sudo command instead of the root user to run the installer

If you are installing for the first time, then Activate during installation option will be checked. If you have a previous version of the Chaos License Server installed and already activated, then this will be unchecked30%

.

Section
Column
width
30%
45%

Please read carefully the License Server Agreement. Click on I accept the Agreement when done. Then you can click on Install to start the installation. If you want to modify the installation, click on the Advanced button.

Image Removed
Windows Default Install path - C:\Program Files\Chaos Group\VRLService\OLS

Column
width5%
 


Column
width
50%

Image Removed
Linux Default Install path - /usr/ChaosGroup/VRLService/OLS

Column
width5%

 

Column
width30%

Image Removed
macOS Default Install path - /Applications/ChaosGroup/VRLService/OLS

 

 

...

typenote

 It is not possible to install an older version of the license server. A notification window appears if you try to do so.

...

If you however, wish to go with the older version, you need to uninstall the current license server first.

 

4) The Customize button lets you change the following options:

License server directory – You can select a license server install directory different than the default one. 

Migrate data during installation – When enabled, transfers all of your settings made with older versions of the Chaos License Server, such as enabled dongle subsystem, proxy settings, etc. Disabling this option in the Customize menu installs Chaos License Server with all settings at their defaults and any custom settings from the previous installation are lost.

...

Image Added

Panel
borderColorred
borderStylesolid

Advanced options

The Advanced installation provides the following additional options:

Destination directory – Allows you to enter a custom license server install directory. 

Add firewall exception – Enabling this option allows the default licensing port (TCP 30304) in the firewall. If you disable it at this step, you will need to

...

manually add firewall exceptions

...

 later.

...

Once you are happy with your setup, click Install to begin the installation. The Help button takes you to this documentation

UI Text Box
typetip
Section

The Cancel button aborts the installation process.

The Back button lets you go back to the previous step of the installation process20%

.


Section
Column
width30%
20%

Image Added

Windows Default Install path - C:\Program Files\Chaos\VRLService

 Image Removed

Column
width
60%
5%


Column
width
30%

 

 

5) The installation process then checks for running applications, which may take a few minutes so please be patient.

 

Image Added

Linux Default Install path - /usr/Chaos/VRLService

20%60%
Column
width
5%

 


Column
width
30%
Image Removed
Column
width20%

 

Image Added

macOS Default Install path - /Applications/Chaos/VRLService

UI Text Box
type
note

The application may appear to be non-responsive, but it should complete its search for running applications and move on to the next step.

 

...

tip

The Image Added button aborts the installation process.

The Image Added button lets you go back to the previous step of the installation process.

The Image Added button takes you to the License Setup page for Chaos Products.

60%20%
UI Step

Complete the Installation

Section
Column
width
20%
45%

If any applications associated with the License Server are open, the installation wizard will close them before attempting installation. Please wait patiently for this process to complete; it might take a few minutes.

After that, the wizard completes the installation. Click Finish.

 

Column
width
5%

Image Removed


Column
width
50%

 

...

Image Added

...


The application is now registered as a service

...

on your machine

...

. You can nowStart, Stop, and Manage Chaos License Server from your system. To access these functions:


Fancy Bullets
typecircle
  • For Windows:  you can use the Start Menu shortcuts, located in the Start Menu > All Apps > Chaos

  • For Linux: go to Terminal and move to the directory of your vrlservice.service file. By default, it is located at /usr/Chaos/VRLService/bin. To start the license server, use sudo systemctl start vrlservice.service. To stop or check the status of the service, replace the start command with stop or status.

  • For macOS: 

 

Section
Column
width30%

For Windows, use the Services window

Image Removed

Column
width5%

 

Column
width30%

For Linux, use SystemV, Upstart or systemd

Column
width5%

 

Column
width30%
For macOS,

  • use sudo launchctl load /Library/

LaunchDaemons

  • LaunchAgents/com.chaos_group.vrol.plist to start the service

or

  • and sudo launchctl unload /Library/

LaunchDaemons

  • LaunchAgents/com.chaos_group.vrol.plist to stop the service.

The

  • These commands are

executed

  • entered in

the

  • Terminal

.app

  • and will prompt you to

use

  • enter your

mcOS

  • macOS user password.

 

...


Anchor
stepThree
stepThree

UI Step

Activate the License

Section
Column
width45%

The wizard will automatically prompt you to activate. Enter your Chaos credentials. In case you have forgotten your password, click on theForgot your password? link

...

and it redirects you to a webpage where you can create a new password. The Other Sign in options link redirects you to the

...

 Chaos login page, where you can log in using a Google account, a Trimble account, or a corporate email.

If you don't want to activate the license right now, you can click Skip and activate it through your browser later. Keep in mind that you cannot access Chaos products without an active license.

The Help button redirects you to this documentation.

 

Section
20%
Column
width20%
 Image Removed

Column
width
60%
5%


Column
width
50%

 

 

9) The installation process is then complete.

...

Image Added



 If you are installing for the first time and you deselected the Activate during

...

installation option, a browser window of the Chaos License Server interface opens. Click the

...

Sign in from the Online licensing menu. You are then prompted to enter your username/email and password. Once the activation is successful, you will be able to see the list of your available licenses on the Chaos License Server home page.


Image Added


You can always access the License Server activation page by typing 127.0.0.1:30304 in your web browser or through the Manage Chaos License Server application

 

Section
Column
width20%

 

Column
width60%

Image Removed

Column
width20%

 

UI Text Box
typetip
If you close your browser window, an easy way to reopen the license server page is from the Manage Chaos License Server link

installed with the rest of your

Application shortcuts

service functions (e.g. Windows Start Menu

), which directs you to http://127.0.0.1:30304/

 

...

)

...

.

...

 

...

 

For more details on how the Licensing System works, please see the License Setup page.

 

Run Chaos License Server installer safely on macOS Catalina and later

...

In macOS Catalina and later, when an app fails to install because it hasn’t been notarized or is from an unidentified developer, it will appear appears in System Preferences > Security & Privacy, under the General tab.

Click Open Anyway to confirm your intent to open or install the app. 


Section
 
Column
width30%


Column
width40%

 
Column
width30%

 



The warning prompt reappears, and you can click on Open.* 


Section
 
Column
width30%


Column
width40%

Column
width30%

 

...



The app is now saved as an exception to your security settings. From then on, and you can open it in the future app by double-clicking it, just as you can like any authorized app.

For more information, see Apple's How to open an app that hasn’t been notarized or is from an unidentified developer article.

 


Silent Installation

...

A silent installation allows you to complete the Chaos License Server installation without running the installer's GUI. To complete a silent installation, run the installer with the following via command line:

Code Block
cgls_win_56.30.0.exe -auto

This installs the license server with the automatic preferences and accepts the EULA. 


If you want to specify a custom installation directory or choose not to add firewall exceptions, run the installer with the following command:

Code Block
cgls_win_56.30.0.exe -gui=0 -quiet=1

...


The -quiet=1 argument argument automatically accepts the EULA. You can then select an installation directory and choose whether to include firewall exceptions.
 
...

Image Added

Troubleshooting
...
If you are having any difficulty installing or running the Chaos License Server, please refer to the Troubleshooting page.