When an application is run, and if no local key is found, the license server is contacted. If no local or floating licenses are available, the application will not start and the headus licensing GUI will start up.

If you ever need to start the licensing GUI directly, use one of the following ways:

1. Run headus from the command line (Linux or OS X only).
2. Run Start->Programs->Application->License (Windows only).

Fig 1. Setting Server

To get the application to talk to the license server, click on the Common Preferences button (see Fig 1). Enter host into the HLServer field (where host is the hostname or IP address of your license server), and hit the Enter key to set the value. Quit and restart the application to check that the floating licenses have been found.

Note: Normally the host port number can be left off if you use the default of "PORT 11668" in hlserver.conf. If a different port has been used, or you are using older client applications, then it needs to be added to the hostname with a colon, as in host:port (e.g. "server:11668").

Note: If you are a systems admin testing a HLServer setup, we recommend you don't run the client application on the server itself. Unless you have specifically added it to hlserver.conf, client connections from localhost are blocked.

Application Restore

The link between the license server and applications is via connected TCP/IP sockets. This means that a connection has to be maintained at all times during the life of an application. If the connection is dropped, then the application loses its license, and the default action is for it to exit without warning.

Possible reasons for a broken connection are:

1. Server crash/reboot. The server that allocates the floating licenses crashes, loses power, or is rebooted for some other reason.
   
   
2. HLServer crash/restart. The floating license software, running on the server, crashes or is restarted for some other reason. Note: HLServer doesn't need to be restarted to activate changes made to the config or keys files; the hlmanager "reload" command should be used for this.
   
   
3. HLServer boot. A user with hlmanager access has "booted" the license.

Fig 2. Setting Restore Directory

The restore function allows users to define a directory where all current work is saved when a license is lost, and the application can be restarted from this save point. Note: Currently only CySlice and associated products (.i.e PlyEdit, CySize, UVLayout) support the restore function.

To set the restore directory, each user needs to run the headus licensing GUI using one of the following ways:

1. Run the application, click About, click Run Licensing GUI.
2. Run headus from the command line (Linux or OS X only).
3. Run Start->Programs->Application->License (Windows only).

Once the licensing GUI is running, click on the Common Preferences button (see Fig 2). A directory name can then be entered into the Restore Dir text field; hit <Enter> to save the change.

The restore directory should be on a local drive, not a networked drive/share, in case the loss of license is through a network problem or server reboot. The selected directory should also be one that's maintained through a reboot of the local system; RAM drives and temporary areas that are cleaned out on reboot shouldn't be used.

Fig 3. Application Restore Window

Once the restore directory has been defined, applications run from then on are protected by the restore function. If a license is lost, the application dies as per usual, but a restore window will then appear (see Fig 3).

If a user sees this window, they should first talk to a systems administrator to determine the cause of the loss of the license. If a server is down, they will need to wait until that is rebooted before trying to restore the application. If HLServer is down, that will need to be restarted.

When all services have been restored, the user can click on the Restore button; the application they were running will be restarted, and all saved work is reloaded. Once all that is up and running, the restore files can be removed with the Delete Files button.

If for some reason the restore window is killed before the user is able restore the application, they still have one more chance to recover all their work. Open up the most recent restore*.txt file in the assigned restore directory, and look for the "Can restore with ..." line; follow the instructions to manually run the restore function. And if that fails for any reason, the data files themselves will also still be in the restore directory; the application can be started as it normally is, and these file manually loaded to recover the lost work.