Install manually on a Tomcat Service server

This section describes how to manually install the glass box agent on a Tomcat Service/Daemon server.

About this task

When AppScan® is installed, the files needed for installing the server agent are saved in a dedicated folder on your machine. To perform this task you will need access to this folder, and to your application server.

Procedure

  1. Open ...\Program Files\IBM\AppScan Standard\Glass box

    The absolute path will depend on where you installed AppScan.

  2. Locate GB_Java_Manual_Setup.zip and copy it to your web server.
  3. Extract the contents of this folder to your preferred location on the web server.
  4. Define a username and password for the agent (use only English ASCII characters):
    • Linux server: Run AgentCredentials.sh <username> <password>
      Note: AgentCredentials.sh must have execution permissions.
    • Windows server: Run AgentCredentials.bat <username> <password>
  5. Deploy GBootStrap web application:
    • Log in to Tomcat Manager. The default location is http://<server_name>:<port_number>/manager/html
    • In Deploy table > War file to deploy, click Choose file.
    • Locate GBootStrap.war (in the glass box folder you extracted), and click Open.
    • Click Deploy and verify that GBootStrap has been added the applications list.
  6. Shut down Tomcat.
  7. Configure Tomcat to use the glass box agent:
    1. Locate Tomcat JVM at ...\Tomcat 7.0\bin\tomcat7w.exe
    2. Double-click on it and select Properties > Java tab.
    3. In the Java Options area, add the following as a new line: -javaagent:<path_to_gbAgent.jar>/gbAgent.jar
      Note: If there are other Java agents defined on the web server, you can add the glass box agent to the Java Options area (the exact path will depend on your installation):
      ... -javaagent:c:\...\otherAgent.jar -javaagent:c:\glassbox\gbAgent.jar ...
    4. Click OK.
  8. Restart Tomcat.