Use network licenses from outside the HZB network

If you want to use licensed software outside of the HZB intranet, for which our license servers grant network licenses, you can only do this via an existing SSH tunnel connection.

The external use described here is only possible for the following programs:

  • Origin
  • IDL
  • MatLab
  • Mathematica

The requirement for such connection is an additional remote password for the personal HZB IT account. The password must be set (once) via this web application before the first use.

The use of software licensed by HZB on private devices is not permitted.

Preparations

We recommend the use of Putty to establish the SSH connection. The program is freely available and can be downloaded from the manufacturer's website.

Depending on the program (Origin, IDL, MatLab, Mathematica) further preparations must be made and the connection with Putty must be configured accordingly.

Origin

If you do not already have Origin installed on your computer, you can download the demo installation file here and then install it yourself (requires administrator rights). Contact the helpdesk to learn how to convert the demo version to a network version.

After installing a network version of OriginLab, create a file named use_server.lic with the following content:

SERVER localhost ANY 27002
USE_SERVER

 

Save the file in the folder C:\ProgramData\OriginLab\License

 

Open putty and create a new configuration with following settings:

 

1. Category: Session

Hostname: display.helmholtz-berlin.de

Port: 22

 

2. Category: SSH -> Tunnels

Source Port: 27002 Destination: dilic.basisit.de:27002

Source Port: 61617 Destination: dilic.basisit.de:61617

 

Hint: Save these settings for the next use in SESSION with the "Save" button.

 

When all settings have been made as specified above, open the SSH tunnel by pressing the "Open" button. A terminal window will open where you have to enter your account and the external password you set previously. After a successful connection the following line should appear in the terminal window: display /home/xyz>

Now you can start Origin as usual.

After using Origin, Putty can be closed with the exit command.

MatLab

Requirement for the use is an already installed network version of MatLab on the local device.

Create a file named license_net.lic with the following content:

SERVER 127.0.0.1 005056385605 2700
USE_SERVER
DAEMON MLM PORT=52002

 

Save this file to any location. Here in this example:  D:\Matlab\license_net.lic

Find the desktop icon (shortcut) of MatLab. Create a copy of the icon and rename this copy to "Matlab external". Then open the properties of the new icons (context menu, right mouse click) and add the command

-c D:\Matlab\license_net.lic (if the file is located somewhere else, adjust the path)

 

Open putty and create a new configuration with following settings:

 

1. Category: Session

Hostname: display.helmholtz-berlin.de

Port: 22

 

2. Category: SSH

Protocol options: Enable compression - YES

 

3. Category: SSH -> Tunnels

Source Port: 2700 Destination: divlicense:2700

Source Port: 52002 Destination: divlicense:52002

 

Hint: Save these settings for the next use in SESSION with the "Save" button.

 

When all settings have been made as specified above, open the SSH tunnel by pressing the "Open" button. A terminal window will open where you have to enter your account and the external password you set previously. After a successful connection the following line should appear in the terminal window: display /home/xyz>

Now you can open Matlab via the Matlab extern icon. Due to the tunnel, starting the application takes longer than usual. Please be patient.

After using Matlab, Putty can be closed with the exit command.

Mathematica

Precondition for use is an already installed network version of Mathematica on the local device.

Create a file named mathpass with the following content:

!127.0.0.1

 

Save the file in the folder:  D:\profiles\\Application data\Mathematica\Licensing

Open putty and create a new configuration with the following settings:

 

1. Category: Session

Hostname: display.helmholtz-berlin.de

Port: 22

 

2. Category: SSH -> Tunnels

Source Port: 16286 Destination: divlicense:16286

 

Hint: Save these settings for the next use in SESSION with the "Save" button.

 

When all settings have been made as specified above, open the SSH tunnel by pressing the "Open" button. A terminal window will open where you have to enter your account and the external password you set previously. After a successful connection the following line should appear in the terminal window: display /home/xyz>

Now you can start Mathematica as usual.

After using Mathematica, Putty can be closed with the exit command.

Once you're back in the office you will have to rename or delete the file mathpath.

IDL

A precondition for use is an already installed network version of IDL on the local device.

Create a file named license_net.lic with the following content:

SERVER localhost 005056385605 2700
USE_SERVER
DAEMON idl_lmgrd PORT=52001

 

Save this file to any location. Here in the example: D:\IDL\license_net.lic

Set an environment variable pointing to this file. You can find these option by looking for the term "environment variable" in the windows search.

Variable name: LM_LICENSE_FILE
Variable value: D:\IDL\license_net.lic (if the file is located somewhere else, adjust the path)

 

Open putty and create a new configuration with the following settings:

 

1. Category: Session

Hostname: display.helmholtz-berlin.de

Port: 22

 

2. Category: SSH -> Tunnels

Source Port: 2700 Destination: divlicense:2700

Source Port: 52001 Destination: divlicense:52001

 

Hint: Save these settings for the next use in SESSION with the "Save" button.

 

When all settings have been made as specified above, open the SSH tunnel by pressing the "Open" button. A terminal window will open where you have to enter your account and the external password you set previously. After a successful connection the following line should appear in the terminal window: display /home/xyz>

Now you can start IDL as usual.

After using IDL, Putty can be closed with the exit command.