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.




Versions 6 and 7 are supported. JRE 8 is not supported.

Operating System

Supported Microsoft Windows™ systems (both 32-bit and 64-bit editions):
  • Microsoft® Windows Server 2012
  • Microsoft Windows Server 2012 R2
  • Microsoft Windows Server 2008 R2
Supported Linux™ systems:
  • Linux RHEL 5, 6, 6.1, 6.2, 6.3, 6.4
Supported UNIX™ systems:
  • UNIX AIX® 6.1, 7.1
  • UNIX Solaris (SPARC) 10, 11

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


Glass box logs are saved to:
[Installation folder]\instrumentation.log