|
|
This document describes how to install Oracle JRockit Mission Control as a standalone application. It includes information on the following subjects:
| Note: | JRockit Mission Control can be used by any application and does not interact with or create an Oracle registry. |
This document shows how to install JRockit Mission Control, which includes the Oracle JRockit JDK. The Oracle JRockit JVM is installed as a part of many Oracle products. Refer to the documentation for those products for installation instructions.
For a complete list of supported configurations, please visit:
http://edocs.bea.com/jrockit/jrdocs/suppPlat/supp_plat.html
Throughout this document, JRockit Mission Control versions are defined with the following notation:
jrmc-<jrmc_version>-<java_version>
jrmc-3.0.3-1.6.0
In this example, the product is JRockit Mission Control 3.0.3 for Java SE 6.
This section explains how to install and uninstall a standalone version of JRockit Mission Control in GUI mode for the following platforms:
| Note: | If you are installing on Linux and Solaris, please refer to Default Location of System Preferences for information on where to fnd the system preferences. |
In the following procedure you will run the self-installing executable (Windows) or the self-extracting binary (Solaris and Linux). The screen shots are taken from a Windows installation of JRockit Mission Control. Table 1 lists the installers.
| Note: | If you install JRockit on Linux or Solaris please refer to Ensure the Installer is Executable. |
The install process begins and the Oracle installer window appears, followed by the Welcome window.
The Choose Product Installation Directories window appears (see Figure 1).
| Note: | If you want a different location for the installation you can pick one by clicking Browse or type a new directory into the Product Installation Directory field. By clicking Discard Changes, you set the selection back to the default directory. |
The Install Public JRE window appears.
If you selected Yes to the Install Public JRE prompt, the Choose Product Installation Directories window reappears, this time showing the default installation directory for the Public JRE. You can change the installation directory, if you want or leave the default.
The installation process continues, as indicated on the progress meter in the lower right corner of the window (see Figure 3).
When the installation is complete, the Installation Complete window appears.
JRockit Mission Control is now installed.
You can start Oracle JRockit Mission Control 3.0.3 from the Start menu.
Once you have installed JRockit Mission Control, you need to add it to your path.
Use this command for Windows platforms:
| Note: | This example assumes that you are using the Windows Command Prompt (DOS) or compatible command shell and have selected the default product installation directory. |
set PATH=%ProgramFiles%\Java\jrmc-<jrmc_version>-<java_version>\bin;%PATH%
Use this command for Linux and Solaris platforms:
| Note: | This example assumes that you are using the UNIX bash shell or compatible command shell and have selected the default product installation directory. |
export PATH=$HOME/jrmc-<jrmc_version>-<java_version>/bin:$PATH
This section describes how to uninstall the Windows, Linux, and Solaris versions of JRockit Mission Control.
To uninstall JRockit Mission Control, do the following:
JRockit Mission Control is removed from your computer.
To uninstall JRockit Mission Control from the command line, run the following command from a console window:
%SystemRoot%\Installer\Oracle\jrmc-<jrmc_version>-<java_version>-<arch>\uninstall.exe
To uninstall Linux and Solaris versions of JRockit Mission Control, do the following:
JRockit Mission Control is removed from your computer.
This section describes how to install JRockit Mission Control using console mode, rather than from a GUI.
To install JRockit Mission Control in console mode, do the following:
| Note: | If you install JRockit on Linux or Solaris please refer to Ensure the Installer is Executable. |
jrmc-<jrmc_version>-<java_version>-<platform>.<ext> -mode=console
where ext is the file name extension, which is exe on Windows and bin on Linux and Solaris.
Extracting 0%....................................100%
Once the extraction process is complete, the system will prompt you through the installation, replicating the procedures described in Installing and Uninstalling JRockit Mission Control.
| Note: | If you don’t specify -mode=console at the command line, the installer will revert to GUI mode, as described in Installing and Uninstalling JRockit Mission Control. |
To uninstall Windows versions, use one of the methods described in Uninstalling Windows Versions and Uninstalling Windows Versions from the Command Line.
To uninstall Linux and Solaris versions, use the method described in Uninstalling Linux and Solaris Versions from the Command Line.
The silent installation mode lets you set installation configurations only once and then use those configurations to duplicate the installation on many machines. During installation in silent mode, the installation program reads installation options from an XML file that you create prior to beginning the installation (see The silent.xml File). The installation program does not display any configuration options during the installation process. For more information on silent mode, please refer to “What Is Silent-Mode Installation?” in the Oracle WebLogic Server Installation Guide.
For a silent mode installation to be successful, you will need to create the file silent.xml and store it on your computer. This file contains the values you want included in your setup; for example, whether or not you want the public JRE installed. Listing 1 shows an example of a silent.xml file for JRockit Mission Control 3.0.3 for Java SE 6.
<?xml version="1.0" encoding="UTF-8" ?>
<domain-template-descriptor>
<input-fields>
<!--
Installation directory
This option is valid for all platforms and Oracle JRockit Mission Control products
-->
<data-value name="USER_INSTALL_DIR" value="c:\Program Files\Java\jrmc-3.0.3-1.6.0
<!--
Install Public JRE
This option is available for Oracle JRockit Mission Control installers on Windows
-->
<data-value name="INSTALL_PUBLIC_JRE" value="true" />
<!--
Installation directory for Public JRE
This option is available for Oracle JRockit Mission Control installers on Windows
-->
<data-value name="PUBLIC_JRE_INSTALL_DIR" value="c:\Program Files\Java\jrockit-R27.6.0-jre1.6.0_05" />
</input-fields>
</domain-template-descriptor>
To install JRockit Mission Control in silent mode, do the following (this procedure assumes that silent.xml is stored in the same directory as the JRockit Mission Control installer):
| Note: | If you install JRockit on Linux or Solaris please refer to Ensure the Installer is Executable. |
jrmc-<jrmc_version>-<java_version>-<platform>.<ext> -mode=silent -silent_xml="silent.xml”
where <ext> is the file name extension, which is exe on Windows and bin on Linux and Solaris.
You will receive a message advising that files are being extracted and no other confirmation.
If you want to confirm installation on Windows, click Start > Programs. If the installation is successful, you will see Oracle JRockit Mission Control [version] for [Java SE version] in your Program menu.
| Note: | If you want to create an install log, add the option -log=log.log at the end of the command. |
To uninstall Windows versions, use one of the methods described in Uninstalling Windows Versions and Uninstalling Windows Versions from the Command Line.
To uninstall Linux and Solaris versions, use the method described in Uninstalling Linux and Solaris Versions from the Command Line.
If you are installing JRockit Mission Control on either a Linux or Solaris machine, please note the information in this section.
If you install JRockit Mission Control on Linux or Solaris by using the .bin file, you need to ensure the file is executable. You can use chmod +x <filename> to make the file executable.
If you choose to install JRockit Mission Control on Linux or Solaris into a system-wide location such as /usr/local, you must first become the root user to gain the necessary permissions. If you do not have root access, simply install JRockit Mission Control into a directory where you have permission to write, for example, your home directory.
When installing on Linux and Solaris, the default location for system preferences will be:
where <JAVAHOME>=<INSTALLDIR>/jre.
unless the user is root, in which case it will be /etc/.java/.systemPrefs.
|
