Install manually on a WebSphere server
This section describes how to manually install the glass box agent on a WebSphere® 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 WebSphere's Integrated Solutions
console.
The default location is
http://<server_name>:<port_number>/ibm/console/
Note: If more then one profile has been defined, log into the appropriate one. - Select New Applications > New Enterprise Application.
- In the Path to the new application area, add the full path to the GBootStrap.war file.
-
In the Context root field, type
in
GBootStrap
, then click Next.The Install New Application wizard opens.
- Unless you want to change any default options,
simply
click Next until the wizard completes. If you
are asked to save the configuration, do so. When you have completed the wizard,
GBootstrap.war
will appear in the list of applications. A red X or a green arrow icon in the Application Status column indicate whether or not it is active. If it is not active (red X), select it and click Start. A green arrow indicates that GBootstrap.war is active.
- Log in to the WebSphere's Integrated Solutions
console.
The default location is
- Now select Servers > Application Servers.
- In the right pane, click your server's name.
- Click the Configuration tab to bring it to the front.
- Under Server Infrastructure, click Java and Process Management > Process Definition.
- Under Additional Properties click Java Virtual Machine.
- Add the following argument
to the Generic JVM Arguments:
-javaagent:c:/path/to/gbAgent.jar
(the example is for Windows operating systems; for other systems the path should be adjusted appropriately).Note: The path should not contain any spaces.Note: If there are other Java™ agents defined on the web server, you can add the glass box agent to the Generic JVM Arguments area (the exact path will depend on your installation):... -javaagent:c:\otherAgent\otherAgent.jar -javaagent:c:\glassbox\gbAgent.jar ...
- Click Apply, and save the configuration if asked.
- Restart WebSphere.