
Agitar License Gateway Server

=============================

Introduction

------------

The Agitar License Gateway Server acts as a proxy to Agitar's public license server. It is needed in environments where developers' workstations do not have access to the Internet.

System Requirements

-------------------

Operating System: Windows 2000/XP, Linux, Solaris

Memory: 512 MB

Disk Space: 50 MB

Java JDK 1.3.1 or greater



Installation

------------

The Gateway Server must be accessible from each developer's workstation via HTTP on port 8008. The Gateway Server must be able to access license.agitar.com on port 80.

If the JDK is not installed, install the JDK from sun.com and define the environment variable JAVA_HOME to point to your Java JDK installation.

Unzip agitar-license-server.zip (You can use WinZip on Windows or 'jar xvf' on Unix.)

On Unix, run these commands to make the script executable:

cd agitar-license-server/web/bin

chmod +x *.sh



Starting the Gateway

--------------------


On Windows:

cd agitar-license-server\web\bin

run startup.bat


On Unix:

cd agitar-license-server/web/bin

./startup.sh


Verification

------------

In a web browser go to http://[host name or ip]:8008/ils/ilslogin.jsp (example: http://thumb:8008/ils/ilslogin.jsp)

You should see the administration login screen.

Start Agitator.

Select Help/Register Agitator.

Click Advanced. Enter the Gateway Server name and port.

Agitate a class, to verify that the setup worked. 



Advanced

--------

The Agitar License Gateway Server is based on the industry-standard Tomcat Web server.

  1. Changing the port Tomcat uses for the Gateway Server:

     a. Find agitar-license-gateway/web/conf/server.xml

     b. Replace 8008 with another port in the following XML segment:

     <Connector
     className="org.apache.catalina.connector.http.HttpConnector"

     port="8008" minProcessors="5" maxProcessors="75"

     enableLookups="false" redirectPort="8443"

     acceptCount="10" bufferSize="32768" TcpNoDelay="false" debug="0" />

  2. Working through a proxy:
  
    	Set the environment variable called JAVA_OPTS before running startup.sh (bat)

        For SOCKS proxy:
        
        JAVA_OPTS=-DsocksProxyHost=<hostname> -DsocksProxyPort=<port>
	-DproxyUsername=<proxy_username> -DproxyPassword=<proxy_user_password>
	
	For HTTP proxy:
	
	JAVA_OPTS=-Dhttp.proxyHost=<hostname> -Dhttp.proxyPort=<port> -Dhttp.proxySet=true
	-DproxyUsername=<proxy_username> -DproxyPassword=<proxy_user_password>
