Installing the glass box agent
This section describes how to set up the server-side glass box agent, to enable glass box scanning.
The AppScan® glass box agent must be installed on your application server (or servers), by copying certain files from the AppScan installation to the server.
Note: The glass box agent installs and uses a dedicated
Java agent (
gbAgent.jar
) to function. If there are
other Java™ agents defined on
the web server, you can add the glass box agent to the application
server command line (the exact path will depend on your installation):java ... -javaagent:c:\otherAgent\otherAgent.jar
-javaagent:c:\glassbox\gbAgent.jar ...
System requirements
The following platforms and technologies are supported.
Software |
Details |
---|---|
JRE |
Versions 6 and 7 are supported. JRE 8 is not supported. |
Operating System |
Supported Microsoft Windows™ systems (both 32-bit and
64-bit editions):
Supported Linux™ systems:
Supported UNIX™ systems:
|
Java EE container |
JBoss AS 6, 7; JBoss EAP 6.1; Tomcat 6.0, 7.0; WebLogic 10, 11, 12; WebSphere 7.0, 8.0, 8.5, 8.5.5 |
Before you start
It will save you time if
you have the following information ready before starting to install.
You may need to consult your web application server administrator
to get the information.
- Your server's operating system (Windows, Linux, Unix)
- Your Java EE application server (WebSphere®, WebLogic, Tomcat, JBoss), and the mode in which it is installed (standard or as an operating system service)
- The web applications deployment location of your Java EE application server (for example:
D:\apache-tomcat-6.0.32\webapps)
- The location of the Java runtime used by your Java EE
application server (for example:
C:\Program Files (x86)\Java\jre6)
- The credentials for your Java EE application server administration (for the purpose of deploying a new web application)
Note: If the server will be running in secure mode, you must
add special permissions. See Permissions needed to work in secure mode
Logs
Glass box logs are saved to:
[Installation folder]\instrumentation.log