-b 

Run as a background daemon process. This is recommended. Applicable to IRIX/Linux installation only.

-c,<filename> 

Use this config file.

-l,<num>,<days>,<log> 

Number of log files, how many days between switches, and filename format string. A typical value for this argument would be -l,4,7,hlserver-%d.log, meaning use 4 log files, switching after a week, and cycle between hlserver-0.log, hlserver-1.log, hlserver-2.log and hlserver-3.log.

Running the Server - IRIX/Linux

The install file comes with a sample start-up script, etc/hlserver.run, that can be copied into /etc/init.d. You will need root access on the server host to do this; read the script file for full installation instructions.

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 your vendor to get your license strings.

Running the Server - Windows NT/2K/XP

After running the ihlserver.exe file to install the software, you'll need to perform the following steps to get the server going:

1. Copy sample-hlserver.conf into hlserver.conf and edit to suit your network setup.
   
   
2. Copy sample-hlserver.ini into hlserver.ini and edit the command line args to suit your setup (see explanation of command line args above). Most people should be able to get by with the defaults.
   
   Note: if you don't move hlserver.conf from the installation directory, then you don't need to define a '-c' config file location.
   
   
3. Run Start -> Programs -> headus License Server -> 1) Install service; the first time you do this you'll get a "License not found" type error. Email the 5 rows of hex numbers to your vendor to get your license strings.
   
   
4. Once you get your licenses, run 1) Install service again, and answer "y" to the edit keys file question. Paste the license keys provided into the keys.txt file, and save it.
   
   
5. Run 1) Install service one more time, but this time you should get a "service installed" message.
6. Error creating thumbnail: convert: unable to open image `/home/headus/headus.com/doc/images/0/04/HLServer-serv1.jpg': No such file or directory @ error/blob.c/OpenBlob/2924. convert: no images defined `/home/headus/headus.com/doc/images/thumb/0/04/HLServer-serv1.jpg/180px-HLServer-serv1.jpg' @ error/convert.c/ConvertImageCommand/3229.

   Figure 43. Services Control Panel
   Run 2) Start service to open up the Services control panel (see Figure 43).
7. Error creating thumbnail: convert: unable to open image `/home/headus/headus.com/doc/images/d/d1/HLServer-serv2.jpg': No such file or directory @ error/blob.c/OpenBlob/2924. convert: no images defined `/home/headus/headus.com/doc/images/thumb/d/d1/HLServer-serv2.jpg/180px-HLServer-serv2.jpg' @ error/convert.c/ConvertImageCommand/3229.

   Figure 44. headus Floating License Server
   Double click on headus Floating License Server to bring up the Service window (see Figure 44) and select Automatic, then OK, so that hlserver restarts whenever the system is rebooted.
   
   
8. Click on the Start button to start hlserver.
   
   
9. Run 3) Run HLManager to check that hlserver is running OK, and that the licenses have loaded correctly. See The Manager for details.

Users should now be able to access the license server from others systems on the local network.

Updating the Server - Windows NT/2K/XP

If you already have hlserver installed, but need to install a newer version, follow these steps:

1. If hlserver is currently running, first inform your users that you are stopping the floating license server, and that they should save all their work. Applications using floating licenses will exit when hlserver is stopped.
   
   
2. Run 4) Stop service to open up the Services control panel; right click on headus Floating License Server and select Stop to stop hlserver.
   
   Note: If you have an old version of HLServer, with no Start menu options, use "Start->Programs->Administrative Tools->Services" to open up the Services control panel.
   
   
3. Run 5) Remove service and you should get a "service removed" message.
   
   Note: If you have no Start menu options for HLServer, open a command shell window and remove the service by running hlserver -remove
   
   
4. Run 6) Uninstall software to remove the old executables, leaving your config files untouched.
   
   Note: If you have no Start menu options for HLServer, use the system control panel's "Add/Remove Programs" to uninstall the old version. You will most likely have to move your old config and keys files into the new install directory too; by default its different to the older installs of HLServer.
   
   
5. Run the new ihlserver.exe file to install the new software.
   
   
6. Run 1) Install service and 2) Start service to get the hlserver service installed and running.

Users should now be able to access the new license server.