Install manually on a JBoss Service server

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

  1. On the Glass Box page of a content scan job, expand the Download glass box agent installer section.
  2. Extract the contents of Manual_Setup.zip to your preferred location on the web server.
  3. 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>
  4. Log in to the JBoss Administration Console. The default location is http://<server_name>:8080/admin-console/
  5. Click Applications > Web Application WARs, then click Add a new resource.
  6. Type in the path to the GBootStrap.war file, then click Continue.

    A message confirms that the resource was created successfully.

  7. Shut down the JBoss service.
  8. 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
  9. Restart the service.