Install manually on a WebLogic server

This section describes how to manually install the glass box agent on a WebLogic 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. Open ...\Program Files\IBM\AppScan Standard\Glass box

    The absolute path will depend on where you installed AppScan.

  2. Locate GB_Java_Manual_Setup.zip and copy it to your web server.
  3. Extract the contents of this folder to your preferred location on the web server.
  4. Define a username and password for the agent (use only English ASCII characters):
    • Linux server: Run AgentCredentials.sh <username> <password>
      Note: AgentCredentials.sh must have execution permissions.
    • Windows server: Run AgentCredentials.bat <username> <password>
  5. 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.
  6. Shut down the WebLogic server.
  7. Supply the Java agent gbAgent.jar (found in the folder you extracted) as a JVM argument by doing one of the following:
    • Through the environmental variable: Configure WebLogic's JVM through the JAVA_OPTS environmental variable (if it does not exist, create it), with the value:
      • Linux server: -javaagent:<path_to_gbAgent.jar>/gbAgent.jar
      • Windows server: -javaagent:<path_to_gbAgent.jar>\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 the startup file in an editor:
        • Admin server: Open DOMAIN_NAME/bin/startWebLogic.sh
        • Managed server: Open DOMAIN_NAME/bin/startManagedWebLogic.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_gbAgent.jar>/gbAgent.jar"
      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>/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.
  8. Restart the WebLogic server.