Install manually on a WebLogic server

This section describes how to manually install the glass box agent on a WebLogic 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 WebLogic Administration Console. The default location is http://<server_name>:<port_number>/console/.
    2. In the Domain Structure pane, click Deployments, then click Install.
    3. In the Path field, type in the path to GBootStrap.war, then click Next.
    4. Select the Install this deployment as an application radio button, then click Next
    5. Verify that the text in the Name field is GBootStrap.
    6. Click Finish, then click Save.
    7. In the Domain Structure pane, click Deployments, and verify that GBootStrap has been added, and that it has a green checkmark icon in the Health column.
  5. Shut down the WebLogic server.
  6. Configure WebLogic to always use the glass box agent by doing one of the following actions:
    • Through the environmental variable: Configure WebLogic'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 WebLogic by editing the configuration scripts that are shipped with the server:

      Linux server:

      1. In the WebLogic folder (usually located in <path_to_Weblogic_folder>\bin), open startWebLogic.sh
      2. Locate a line that begins with JAVA_OPTIONS and add the following line below it:
        export JAVA_OPTIONS = $JAVA_OPTIONS -javaagent:<path_to_Weblogic_folder>
      3. Save and close the file.

      Windows server:

      1. In the WebLogic folder (usually located in <path_to_WebLogic_folder>\bin), open startWebLogic.bat
      2. Locate a line that begins with set JAVA_OPTIONS and add the following line below it:
        set JAVA_OPTIONS = %JAVA_OPTIONS% -javaagent:<path_to_gbAgent.jar>
      3. Save and close the file.
    Important: Ensure that JAVA_OPTIONS is initialized only once, and prior to the lines above, so that other JAVA_OPTIONS assignments do not overwrite -javaagent.
    Note: To add arguments to JAVA_OPTIONS, use the %JAVA_OPTIONS% / $ JAVA_OPTIONS convention.
  7. Restart the WebLogic server.