The following files make up the OS X license server installation:

hlserver 

This is the server application.

hlserver.conf 

The contents of this file, explained in detail in the Server Config chapter, 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.

setup 

Installation script.

uninstall 

Removal script.

hlmanager 

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

.keys 

This file holds the floating license keys.

Setup

Double click the setup script to start the installation.

1. First you'll be asked to check the config file. The "GROUP lan" IP range will have been set already to match your local network, but this may need to be adjusted if you have a more complicated setup (e.g. multiple sub-nets in a larger campus network). Save the file, kill the window, then re-run the setup script to continue.
   
   
2. Initially you wont have license keys, so at the "Do you have the keys" question type n followed by Enter to generate the code strings. Email the 5 code strings to your vendor to get your license keys.
   
   
3. When you get your license keys, re-run the setup script and answer y to the "Do you have the keys" question, then type Enter to continue and the keys file will open up in the text editor. Cut'n'paste your license keys in, save the file, kill the window, then re-run the setup script to continue.
   
   
4. At the "Do you have updated license keys" question, answer n and then you'll be asked for an installation location. By default the script will want to put the binaries and config files into /usr/local/hlserver, but you can type in a different path at the prompt if you wish.

If the setup script runs smoothly, hlserver will be started and hlmanager is run as a final check. You should see something like the following as output ...

 Waiting for HLServer to start ... 10 9 8 
 Trying HLManager ...
 Trying architec@localhost ...
 Server localhost up 4 seconds
 <--------- Licenses ---------->  <------------------------- Users ------------------------->
 Name        Status    Free Used  Id Hostname        User     App           Age       Idle   
 uvlayoutv2  29 days      4    0

hlserver will be automatically restarted whenever the system is rebooted, and you can stop and start it via the launchctl command.

We recommend that you keep the hlserver folder in case you need to re-run the setup script. It can be moved if you dont want to leave it on your Desktop or in the Downloads folder.

Update

If you need to update your keys file (e.g. replacing temp keys with permanent ones) then re-run the setup script and answer y to the "Do you have updated keys" question. Type Enter to edit the keys file, cut'n'paste in the new keys, then save the file, kill the window, and re-run the setup script to restart HLServer and check the results with HLManager.