Learn how to manually install the glass box agent on a
JBoss 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
- On the Glass Box
page of a content scan job, expand the Download glass box agent
installer section.
- Extract the contents
of Manual_Setup.zip to your preferred location on the web server.
- Define a username and password for the agent (only English
characters and numbers can be used):
- For a Linux™ server:
Add execution permissions to
AgentCredentials.sh
,
then run AgentCredentials.sh <username> <password>
- For a Windows™ server:
Run
AgentCredentials.bat <username> <password>
- Log in to the JBoss Administration Console. The default
location is
http://<server_name>:8080/admin-console/
- Click , then click Add
a new resource.
- Type in the path to the
GBootStrap.war
file,
then click Continue. A
message confirms that the resource was created successfully.
- Shut down the JBoss service.
- Configure JBoss to use the glass box agent through batch/sh
scripts, by doing the following:
Pass arguments to
the JVM running JBoss by editing the run.conf.bat / run.conf
scripts
that are shipped with it. Locate a line similar to set JAVA_OPTS=
(in Windows), and insert -javaagent:c:/path/to/gbAgent.jar
(in Windows; or equivalent for other
operating systems) right after the equals (=) sign.
Note: If there are other Java™ agents
defined in the environmental variable, you can
add the glass
box agent. Windows OS example
(the exact path will depend on your installation):
set JAVA_OPTS = %JAVA_OPTS% -javaagent:c:\glassbox\gbAgent.jar
- Restart the service.