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
- Open ...\Program Files\IBM\AppScan Standard\Glass
box
The absolute path will depend on where you installed AppScan.
- Locate
GB_Java_Manual_Setup.zip
and copy it to your web server. - Extract the contents of this folder to your preferred location on the web server.
- 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>
- Linux server: Run
- Deploy GBootStrap web application:
- Log in to the WebLogic Administration Console. The default
location is
http://<server_name>:<port_number>/console/
- In the Domain Structure pane, click Deployments, then click Install
- In the Path field, type in the path to GBootStrap.war, then click Next
- Select the Install this deployment as an application radio button, then click Next
- Verify that the text in the Name field is GBootStrap
- Click Finish, then click Save
- 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.
- Log in to the WebLogic Administration Console. The default
location is
- Shut down the WebLogic server.
- 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
- Linux server:
- Through batch/sh scripts: Pass arguments to the JVM running
WebLogic by editing the configuration scripts that are shipped with
the server:
Linux server:
- 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
- Admin server: Open
- 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"
- Save and close the file.
Windows server:
- In the WebLogic folder (usually located in
<path_to_WebLogic_folder>\bin
), openstartWebLogic.bat
- 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
- Save and close the file.
- In the WebLogic folder (usually located in
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. - Through the environmental variable: Configure WebLogic's JVM through the JAVA_OPTS
environmental variable (if it does not exist, create it), with the value:
- Restart the WebLogic server.