Floating license server v2.0
============================

Introduction
============

The Objective Systems Floating License Server was built 
to be run on a Windows, or Linux platform. 



Installation
============

The package is provided as a gzipped tar file (.tar.gz) 
that may be installed anywhere on the target platform.

For example, on a linux system, unzip and untar 
using the following commands:

   gunzip lsv200lnx.tar.gz
   tar xvf lsv200lnx.tar

The .tar file can be deleted at this point.



Running the Server Program
==========================

The server's license file osyslic.txt should be copied to the bin/
subdirectory. The server program is an executable that 
must be executed in a long running process to handle all 
license requests from clients. This is normally done by 
executing the program in the background as follows:

   licServer &

Note that the directory in which the program is stored 
will need to be in the PATH environment variable for the 
operating system to find it. It is also possible to store 
the program or a symbolic to the program in one of the 
standard bin directories in the PATH (for example /opt/bin).  

To stop the server process, the kill system command 
can be used. The process ID must first be determined 
which can be done by executing the ps ef and looking 
for the name licServer. Then execute kill <pid> where 
<pid> would be replaced with the PID of the process.  

The server creates a log file named licServer.log 
that contains information on errors and warnings. 
You can change the log file name by using option 
-log <logfile>. The log file can be viewed at any time 
by using the cat or tail system commands.  If debugging 
is necessary, the server can be run in verbose mode 
by using the -v option: 

   licServer -v &

This will cause much more diagnostic information to be 
written to the licServer.log file. The server should 
only be run for short periods of time in this mode 
as the log file will grow at a very fast rate.



Running the Client Program
==========================

To run a client program like ASN1VE, you must put a 
client's license file (osyslic.txt) in the same location 
as the client executable. 

Log Files
=========

The server creates two log files named err.log and 
licServer.log. File err.log contains error information 
when the server exits at startup time. File licServer.log 
contains information on errors and warnings generated 
during the server operation.