Typically you'll want be root and extract the TGZ file into /usr/local though that's not a strict requirement. If you install into somewhere other than /usr/local/hlserver, you'll need to change the HEADUS_HOME variable in the hlserver startup files.

Previous Linux installs of HLServer extracted to /usr/local/headus, and were split across the etc and lib sub-directories, but now all files are in the single hlserver directory. If you are upgrading, copy your old config and keys file to the new directory, and update or replace your init.d hlserver.run script.

HLServer uses /usr/tmp to save a PID file when running. If /usr/tmp doesn't exist, then HLServer may start, but will exit soon after. Creating a symbolic link from /tmp to /usr/tmp will fix this problem.

The following files make up the Linux license server installation:

hlserver 

This is the server application. It need not be run with any special privileges unless the PORT used (see below) is under 1027.

hlserver.conf 

The contents of this file, explained in detail below, controls the behavior of the server.

hlserver.log 

This is a series of date stamped log messages from the server showing, amongst other things, who is grabbing which licenses.

hlserver.redhat 

This is a RedHat/Fedora script that can be used to start the server on 'init' based boots, and stop it on shutdown. Installation instructions are in the file.

hlserver.service 

This can be used to start the server on 'systemd' based boots. Installation instructions are in the file.

hlserver.debian 

Start/stop script for Debian/Ubuntu based systems. Installation instructions are in the file.

hlmanager 

This is the manager application. See "The Manager" chapter for details.

.keys 

This file holds the floating license keys.

Running under Linux

The install file comes with a couple of sample start-up scripts, one for Redhat based systems, and another for Debian flavors. You will need root access on the server host to do this; read the appropriate script file for full installation instructions.

Copy sample-hlserver.conf into hlserver.conf and edit to suit your network setup. You should at least change the IP range for the lan group.

Run 'hlserver' from the command line when first installed. You'll get a "License not found" type error, and 5 rows of hex numbers; email these to your vendor to get your license strings.