Running Understand on a headless linux server

While we strongly recommend familiarizing yourself with the GUI first, command line functionality is very available in Understand. Projects, reports and metrics can be created using the tool und. And there are several API’s available for accessing the information programmatically. Note that generating graphs from the command line or using the APIs will still require that X11 be installed on the machine since the images are generated using X11 libraries.

To install Understand from the command line simply extract it  from the .tgz bundle into the desired location. For example


tar -xvzf Understand-5.0.953-Linux-64bit.tgz

Once extracted, license information will need to be entered using the appropriate method from below. You can test if there is a valid license by running Und in interactive mode (scitools/bin/linux64/und)

headless_server_connect no_license


Details on specifying your license from the command line are here. In most cases you can just run

scitools/bin/linux64/und -setlicensecode XXXXXXXXXX





Specifying Legacy Licenses

Eval license

Running an evaluation license of Understand without the GUI requires contacting support and requesting an evaluation key. Create a new file at scitools/conf/license/users.txt with the following content, replacing EVALCODE with the actual key received from support.

* EVALCODE # any

for example

* E035432360E5 # any

Add SDL License

If you own a Single Developer License you can enter the license key in the file scitools/conf/license/users.txt

The first field is the user account you are logged in as on linux, the second field is the actual SDL code


for example

bob AFB994317192D6EA4527 # any

Finally create a file at ~/.config/SciTools/Understand.conf with  the email address associated with the license, e.g:



Connect to Floating License

To connect the client to a license server, you can create a file named \conf\license\locallicense.dat with this single line of content, where SERVERNAME is the actual name or IP address of the license server, followed by 8 zeros and the port number:

Server: SERVERNAME 00000000 9000