Install manually on a JBoss server or a JBoss Service server
Learn how to manually install the glass box agent on a JBoss server or JBoss Service 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 runAgentCredentials.sh <username> <password>
- For a Windows™ server:
Run
AgentCredentials.bat <username> <password>
- For a Linux™ server:
Add execution permissions to
- Log in to the JBoss Administration Console.
The default
location is
http://<server_name>:8080/admin-console/
- Click Applications > Web Application WARs, 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 server/service.
-
Supply the Java agent gbAgent.jar (found in the folder you extracted) as a JVM argument by
doing one of the following actions:
- Through the environmental variable: Configure JBoss's JVM through the JAVA_OPTS
environmental variable (if it does not exist, create it), with the value:
-javaagent:<path_to_gbAgent.jar>
. - Through batch/sh scripts: Pass arguments to the JVM running JBoss by editing the
configuration scripts that are shipped with the server:
Linux server:
- In the JBoss folder (usually located in
<path_to_JBoss_folder>/bin
), openrun.conf
- Locate a line that begins with
JAVA_OPTS
and add the following line below it:export JAVA_OPTS = $JAVA_OPTS -javaagent:<path_to_gbAgent.jar>
- Save and close the file.
Windows server:
- In the JBoss folder (usually located in
<path_to_JBoss_folder>\bin
), openrun.conf.bat
- Locate a line that begins with
set JAVA_OPTS=
and add the following line below it:set JAVA_OPTS = %JAVA_OPTS% -javaagent:<path_to_gbAgent.jar>
- Save and close the file.
- In the JBoss folder (usually located in
Important: Ensure that JAVA_OPTS is initialized only once, and prior to the lines above, so that other JAVA_OPTS assignments do not overwrite-javaagent
.Note: To add arguments to JAVA_OPTS, use the %JAVA_OPTS% / $ JAVA_OPTS convention. - Through the environmental variable: Configure JBoss's JVM through the JAVA_OPTS
environmental variable (if it does not exist, create it), with the value:
- Restart the JBoss server/service.