Install manually on a WebSphere server

This section describes how to manually install the glass box agent on a WebSphere® 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. Deploy GBootStrap web application:
    1. Log in to the WebSphere's Integrated Solutions console. The default location is http://<server_name>:<port_number>/ibm/console/
      Note: If more then one profile has been defined, log into the appropriate one.
    2. Select New Applications > New Enterprise Application.
    3. In the Path to the new application area, add the full path to the GBootStrap.war file.
    4. In the Context root field, type in GBootStrap, then click Next.

      The Install New Application wizard opens.

    5. Unless you want to change any default options, simply click Next until the wizard completes. If you are asked to save the configuration, do so.
      When you have completed the wizard, GBootstrap.war will appear in the list of applications. A red X or a green arrow icon in the Application Status column indicate whether or not it is active. If it is not active (red X), select it and click Start. A green arrow indicates that GBootstrap.war is active.
  5. Now select Servers > Application Servers.
  6. In the right pane, click your server's name.
  7. Click the Configuration tab to bring it to the front.
  8. Under Server Infrastructure, click Java and Process Management > Process Definition.
  9. Under Additional Properties click Java Virtual Machine.
  10. Add the following argument to the Generic JVM Arguments:
    -javaagent:c:/path/to/gbAgent.jar (the example is for Windows operating systems; for other systems the path should be adjusted appropriately).
    Note: The path should not contain any spaces.
    Note: If there are other Java™ agents defined on the web server, you can add the glass box agent to the Generic JVM Arguments area (the exact path will depend on your installation): 
    ... -javaagent:c:\otherAgent\otherAgent.jar -javaagent:c:\glassbox\gbAgent.jar ...
  11. Click Apply, and save the configuration if asked.
  12. Restart WebSphere.