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
- Open ...\Program Files\IBM\AppScan Standard\Glass
box
The absolute path will depend on
where you installed AppScan.
- Locate
GB_Java_Manual_Setup.zip
and copy
it to your web server. - Extract the contents of this folder to your preferred location
on the web server.
- Define a username and password for the agent (use only
English ASCII characters):
- 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.
- Shut down Tomcat.
- Configure Tomcat to use the glass box agent:
- Locate Tomcat JVM at
...\Tomcat 7.0\bin\tomcat7w.exe
- Double-click on it and select Properties > Java tab.
- 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 ...
- Click OK.
- Restart Tomcat.