Install manually on a WebLogic server
This section describes how to manually install the glass box agent on a WebLogic server.
Procedure
- On the Glass Box page of a content scan job, expand the Download glass box agent installer section.
- Extract the contents of Manual_Setup.zip to your preferred location on the web server.
- 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 runAgentCredentials.sh <username> <password>
- For a Windows™ server:
Run
AgentCredentials.bat <username> <password>
- For a Linux™ server:
Add execution permissions to
- 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.
-
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:
- In the WebLogic folder (usually located in
<path_to_Weblogic_folder>\bin
), openstartWebLogic.sh
- 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>
- 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>
- 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.