Installation and Startup

On Windows, installation can be done via the Windows Installer file (*.msi) or the tarball (*.tar.gz). On Linux, only the tarball method is available. It is a TODO item to distribute create a RPM file for MJP.

Procedure 2.1. Windows Installer Installation

  1. Double click on the MJP Windows Installer file (*.msi) and follow the instructions.

  2. Select Mike's Java Profiler from the Windows Start menu.

Procedure 2.2. Tarball Installation

Note

In the instructions below, MJP_HOME is a place-holder for the root directory of where you installed MJP.

  1. Unpack the tar-ball into a location of your choosing.

  2. Add MJP_HOME/bin to your PATH environment variable. Besides making it easier to execute MJP from the command line, this is required on Windows for the Java Virtual Machine to find the MJP profiler agent DLL.

  3. If you're operating system is Linux, set the environment variable LD_LIBRARY_PATH to MJP_HOME/lib. This is required on Linux for the Java Virtual Machine to find the MJP profiler agent.

  4. Do either of the following:

    • Procedure 2.3. Wrapper script method

      1. Set the MJP_HOME environment variable to the root directory where you installed MJP. On some operating systems the MJP wrapper scripts can guess MJP_HOME (UNIX dialects and Windows NT/2000) - but it is better to not rely on this behavior.

      2. Set the JAVA_HOME environment variable to the location of a JRE version 1.4 or newer.

      3. If you operating system is Windows, execute MJP_HOME/bin/mjp.exe. If your operating system is Linux, execute MJP_HOME/bin/mjp

    • Procedure 2.4. JAR file method (Windows only)

      1. Ensure that a JRE version 1.4 or newer is installed in your Windows system directory (e.g. C:/WINNT/system32).

      2. In Windows Explorer, double-click on MJP_HOME/lib/mjpgui.jar.

Example Installations

Example 2.1. Windows Installation

Assume MJP is installed in C:/mjp and a JAVA JDK 1.4.0 is installed in C:/j2sdk1.4.0. 
	  set MJP_HOME=C:\mjp
	  set JAVA_HOME=C:\j2sdk1.4.0
	  set PATH=%MJP_HOME%\bin;%PATH%

Example 2.2. Linux Installation

Assume MJP is installed in /opt/mjp and a JAVA JDK 1.4.0 is installed in /usr/java/j2sdk1.4.0. 
	  export MJP_HOME=/opt/mjp
	  export JAVA_HOME=/usr/java/j2sdk1.4.0
	  export PATH=$MJP_HOME/bin:$PATH
	  export LD_LIBRARY_PATH=$MJP_HOME/lib:$LD_LIBRARY_PATH

Example 2.3. Cygwin Installation

Assume MJP is installed in C:/cygwin/usr/local/mjp and a JAVA JDK 1.4.0 is installed in C:/j2sdk1.4.0. 
	  export MJP_HOME=C:/cygwin/usr/local/mjp
	  export JAVA_HOME=C:/j2sdk1.4.0
	  export PATH=/usr/local/mjp/bin:$PATH