==============================================================================
|                     How to setup ETA license server                        |
==============================================================================

Revision History =============================================================

08/30/11 (Build 1463)
   - Add license processing information in server log file
   - Write the closest error messages into server log file
     from all licenses rather than the error from the last 
     licenses. For example, "all licenses are in use" will
     appear in server log file even this license is not
     the last sitecode in the license file.
   - Only updated on Windows and Linux


09/14/07 (Build 1456)
   - Support query in server manager or command line

11/16/06 (Build 1453)
   - Support downward version number. For example,  
     DYNAFORM 5.5 can run with DYNAFORM 6.0 license.
   - Two scripts, eta_start_sh and eta_stop_sh,are provided 
     for UNIX/LINUX users to run or stop server in command mode. 

01/10/06
   - Module option is written in the server log
   - The server stability is improved in extensive usage

10/26/05
   - Server manager (eta_mgr) is available for UNIX/LINUX.
     Please use the server manager to start/stop license
     server. The instruction for PC license server manager 
     (PC/readme_manager.txt) can be used for the UNIX/LINUX 
     manager except "Install/Uninstall" issues. 

01/12/05
   - Only one license is counted on server for the same user 
     requesting the same software from the same machine.
   - Server will notify the client programe of current users
     and machines if all licenses are in use. Only updated 
     client program can display this information.
   - The scripts/commands are provded to start/stop server
     on UNIX/LINUX machine.
   - The server build date is added.

02/20/2004
   - The License server on MS Windows is changed into service.
   - A server manager program is provided to manage it and the
     license usage is available in the manager as well. 
   - User can log out now after start the license server within
     the server manager.

01/30/2002 
   - Initial record

SERVER SIDE ==================================================================

OS requirement for license server: 
	Windows	:	NT/2000/XP/Vista/7 
	UNIX	:	AIX, HPUX, IRIX and SunOS
	LINUX	:	RedHat 9.0

1 Edit the host name and socket number
Usually, there is one line in the license file(eta.lic) like below.
...
!license_server(SERVER_HOST,11234)
...

To enable this license file to work as a server license, you need to 
uncomment this line and change "SERVER_HOST" to the name or IP address
of the server machine. Following the host name is the socket number. The 
default socket number is 11234, it should work in most cases. You can 
specify any unused socket number if 11234 is used. Here are some examples.

license_server(pc5.eta.com, 11234)
	Use complete name as host name 

license_server(pc5, 11234)
	use machine name without domain name

license_server(192.132.21.65, 3354)
	Use IP address and socket 3354


The license can be configured for specified users and hosts
by defining "user_group" and "host_group", respectively.

Note 1: The user name and host name are case sensitive !!!
Note 2: If you are not sure the user name and host name, you can
        run the server without user/host restricition. Then check
        the log file to find out the user name and host name.

Following is an example of how to apply the restriction on user and host.
(Define group)
user_group(John Doe,engineers)
user_group(dave,engineers)

host_group(sgi1,engineers)
host_group(sgi2,engineers)
host_group(PC156,engineers)

site_code(7JUYFF-M2TSM5-KQ5N7X-7V582Y-7LD3PA-2LDT-C7BAFF9-32,engineers)

Following is an example configuration with no restriction.
(use "nill" as group name)
site_code(7JUYFF-M2TSM5-KQ5N7X-7V582Y-7LD3PA-2LDT-C7BAFF9-32,nill)


2 Use license server
A server manager is provided to control the license server for both 
PC and UNIX/LINUX now. It provides the license usage information
as well. Please refer the readme_manager.txt for more details.

Note 1 If you wish to run license server in command mode, two shell 
       scripts (eta_start_sh and eta_stop_sh) can do the job. Please 
       edit the path in these shell script files accordingly if they 
       will be executed from other location. 


CLIENT SIDE ==================================================================

OS requirement for license client: 
	Windows	:	98/NT/2000/XP/Vista/7
	UNIX	:	AIX, HPUX, IRIX and SunOS
	LINUX	:	RedHat 7.3/8.0/9.0

1 Edit license file
Copy the modified license file from the server machine to the installation 
directory on the client machine. Comment or delete the "sitecode" line. 

Start the license server.  After a 30 second period the license server 
should be able to license the client.


TROUBLESHOOTING ===============================================================

The license server will show license acitivites in the server.log.
Be sure to check this information if the client program does
not start normally. Listed below are some common problems.

1 "All licenses in use ..."
  -All the license tokens have been used by other users.
   A list of current users and machines will be given.

2 "Server is still coming up ..."
  -Server needs one minute to warm up. 
   Try again one minute later.

3 "Server is not responding"
  -Make sure the license files on server side and client side use 
   the same host name and socket number.
  -Make sure you can ping server from client machine. Otherwise, 
   make the network work first.
  -Make sure the firewall on client side or/and server side does not 
   block the application or license server. This is a very common 
   problem nowadays as more and more firewall are running on PCs.

4 A demo license CANNOT be used for a license server.

For any other problems or comments please mail it to support@eta.com

