Install manually on a WebLogic Service server

This section describes how to manually install the glass box agent on a WebLogic 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. 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 (only English characters and numbers can be used):
    • 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
      Note: If the Install option is disabled (grayed out), you may need to change the Lock & Edit mode setting to enable it.
    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 service.
  7. Configure WebLogic to use the glass box agent by locating the registry key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<WEBLOGIC_SERVICE> and editing the value of CmdLine to include -javaagent:<path_to_gbAgent.jar>/gbAgent.jar
  8. Restart the service.