Install on WebSphere
- WebSphere Version 8.5.5.7
- Start the WebSphere server using the Windows/Linux start menu or using the command line: For example
Windows: c:\WebSphere61\AppServer\bin\startserver server1
Linux:<WebSphere-Home>/AppServer/bin/startServer.sh server1 - Open the Administrative Console through the graphical user interface or use the URL http://localhost:9045/ibm/console (when accessing the server remotely, specify the machine´s hostname rather than of localhost; the given port is the default for the first profile, at installation it is specified by WC_adminhost_secure).
- Enter your user ID and Password. Then log in
- Navigate to: Servers -> Server Types -> Application WebSphere application servers -> server1 -> Java and Process Management -> Process Definition definition -> Java Virtual Machine
- In the text field Generic JVM arguments add: -Dinspectit.config=C:\inspectit\agent\config
Windows: -Xbootclasspath/p:C:\inspectit\agent\inspectit-agent.jar -javaagent:C:\inspectit\agent\inspectit-agent.jar -Dinspectit.repository=[REPOSIOTRY_IP]:[REPOSITORY_PORT] -Dinspectit.agent.name=[AGENT_DISPLAY_NAME]
Linux:-Xbootclasspath/p:<PATH_TO_INSPECTIT>/inspectit-agent.jar -javaagent:<PATH_TO_INSPECTIT>/inspectit-agent.jar -Dinspectit.repository=[REPOSIOTRY_IP]:[REPOSITORY_PORT] -Dinspectit.agent.name=[AGENT_DISPLAY_NAME] - Apply the changes, save the configuration, and restart the server
Configure Java 2 Security
To use the inspectit-agent.jar file inside your WebSphere environment, the jar file must be given appropriate privileges.
For an individual application server, you have to change the server.policy (<WebSphere-Home>/AppServer/profiles/<AppServer>/properties/server.policy) file:
Code Block | ||
---|---|---|
| ||
grant codeBase "file:<PATH_TO_INSPECTIT>/agent/inspectit-agent.jar" {
permission java.security.AllPermission;
}; |
For all application servers, you have to change the java.policy (<WebSphere-Home>/AppServer/java/jre/lib/security/java.policy) file:
Code Block | ||
---|---|---|
| ||
grant codeBase "file:<PATH_TO_INSPECTIT>/agent/inspectit-agent.jar" {
permission java.security.AllPermission;
}; |
- Restart the server
Info | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
With IBM JVM 1.7.0 and WebSphere 8.5.5.7 the creation of the Platform Sensor failed. Please, see:
|
Warning | ||
---|---|---|
| ||
Please make sure that the server configuration is properly saved. Please make sure that you execute OK on each configuration page until you reached the Server > Application servers page. WebSphere may additionally ask to save current configuration to the global configuration after each page, so please do so. If there are any problems with starting the WebSphere with inspectIT, please make sure that the configuration is correct. |
...