Versions Compared

Old Version 3

changes.mady.by.user Elias Schreiner

Saved on

compared with

New Version Current

changes.mady.by.user Ivan Senic

Saved on

Key

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

This guide helps you setup inspectIT with your system to be diagnosed.

...

Warning
titleNo 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

...

The following requirements are necessary in order to install inspectIT

Component

Requirement

Agent

  • Java 1.5 or higher (Java 1.4 is only supported with inspectIT up to 1.3 - there is still a release of this version if you for some reasons need to analyze Java 1.4 applications)
  • Supported platforms:
    • Sun JDK
    • IBM JDK
    • Bea JRockit support is dependent on the version of the JVM

CMR

  • The bundled Java 7 is required (inspectIT download already packages the Java version)
  • Suitable amount of Memory for the in-memory Buffer (for small single user environments 500MB might be appropriate)
  • 250 MB hard disc space for the installation files of inspectIT
  • Suitable amount of disc space for longtime storages (for starters 5GB might suffice)

  • Supported OS: 
    • Any platform that can run Java applications
    • Bundled Java version included for Linux and Windows.

UI

  • The bundled Java 7 is required (inspectIT download already packages the Java version)
  • Supported OS:
    • Linux 
    • Windows
    • Mac OS

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.

...

The inspectIT agent integrates in the JVM of the system under diagnosis. This integration is done using JVM startup options. To configure these, open the console and insert the following code. Depending on the used java version the integration is slightly different:

java 

Java version

Integration

1.4

5 and higher

java [...]

 

-

Xbootclasspath/p

javaagent:[YOUR_PATH_TO]/inspectit-agent.

jar 

jar -Dinspectit.

config

repository=[

YOUR_PATH_TO_CONFIG] [...]

5 and higher

java [...] -javaagent:[YOUR_PATH_TO]/inspectit-agent.jar -Dinspectit.config=[YOUR_PATH_TO_CONFIG

REPOSITORY_IP]:[REPOSITORY_PORT] -Dinspectit.agent.name=[AGENT_DISPLAY_NAME] [...]

[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\REPOSITORY_IP] = The IP of the CMR repository.

[REPOSITORY_PORT] = The port of the CMR repository. By default the CMR is using port 9070 for the communication with the agent, so in most cases this would be the correct value.

[AGENT_DISPLAY_NAME] = The name of the agent. This name will be seen in the user interface of inspectIT once the agent is connected.

Tip
titleDo 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.

...