Installation Guide
This guide helps you setup inspectIT with your system to be diagnosed.
Upgrading
No backward compatibility guaranteed
inspectIT releases do not offer any backward compatibility whatsoever.
- Install the new CMR, agent and UI release
- The old database of the CMR might not work with the new CMR release
- Using different versions for the client and server might pose problems
Requirements
The following requirements are necessary in order to install inspectIT
Component | Requirement |
---|---|
Agent |
|
CMR |
|
UI |
|
Installing the CMR
The CMR is the central repository for the measurements collected by the inspectIT agent. This component is also responsible for storing the data and for aggregating and transforming the data for the user analysis. Thus the system should have enough memory (Sizing the CMR heapsize) and enough CPU power.
Installing the CMR on the same machine as the system that should be analyzed can pose problems. The problem is, that the CMR uses system resources that otherwise could be used to run the application and thus reduces the possible performance of the application. For best measurements the CMR should be installed on a separate machine. For diagnosis in an development environment installing the CMR on the same computer is possible. The agent communicates to the CMR by means of RMI. As the communication between the agent and the server might be quite high, it is also best to choose a machine for the CMR that is "near" (in terms of network) to the application itself.
Installation process:
- Download the CMR release
- Extract the CMR release
- The CMR release automatically provides start scripts for linux and windows that can be directly used
Installing the UI
- Unzip the release archive
- Start the inspectIT start script (provided for linux and windows)
Installing the inspectIT agent
The inspectIT agent integrates in the JVM of the system under diagnosis. This integration is done using JVM startup options. Depending on the used java version the integration is slightly different:
Java version | Integration |
---|---|
1.4 | java [...] -Xbootclasspath/p:[YOUR_PATH_TO]/inspectit-agent.jar -Dinspectit.config=[YOUR_PATH_TO_CONFIG] [...] |
5 and higher | java [...] -javaagent:[YOUR_PATH_TO]/inspectit-agent.jar -Dinspectit.config=[YOUR_PATH_TO_CONFIG] [...] |
[YOUR_PATH_TO] = This is the Directory where the agent ist installed.
[YOUR_PATH_TO_CONFIG] = This is the Directory which includes your inspectit-agent.cfg file. Wrong: D:\inspectit_agent\config\inspectit-agent.cfg, Korrekt: D:\inspectit_agent\config\
Do not refer to the inspectit-javaagent.jar
Note that you refer to the agent.jar archive by means of the javaagent option, do not refer to the inspectit-javaagent.jar. The inspectit-javaagent.jar only provides the implementation of the javaagent, the agent.jar also provides all additional classes and dependencies the agent needs.
The inspectIT documentation provides a best practice documentation of how to integrate inspectIT with different application servers and platforms. Please have a look if your environment is listed here for a quick start:
Adding the license
A license can be added by using the inspectIT user interface. Simply start up your CMR and connect to this CMR using the inspectit user interface. Within the user interface you can select to import a license. Select the license and the license is transferred to the CMR.
GA enabled