Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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: 
    Windows: -Dinspectit.config=C:\inspectit\agent\config -Xbootclasspath/p:C:\inspectit\agent\inspectit-agent.jar -javaagent:C:\inspectit\agent\inspectit-agent.jar
    Linux:-Xbootclasspath/p:<PATH_TO_INSPECTIT>/inspectit-agent.jar -javaagent:<PATH_TO_INSPECTIT>/inspectit-agent.jar -Dinspectit.config=<PATH_TO_INSPECTIT>/agent/config
  • 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
titleserver.policy
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
titlejava.policy
grant codeBase "file:<PATH_TO_INSPECTIT>/agent/inspectit-agent.jar" {
  permission java.security.AllPermission;
};
  • Restart the server

 

Info
titleCreation of the Platform Sensor Info Provider for IBM virtual machine failed.

With IBM JVM 1.7.0 and WebSphere 8.5.5.7 the creation of the Platform Sensor failed. Please, see:

Jira Legacy
serverJIRA (inspectit-performance.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId025b869f-b613-3685-8211-0d54499d8708
keyINSPECTIT-2013

Warning
titleMake sure configuration is saved

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.

...