# Installation Guide

# Installing Oracle JRockit Real Time

This section describes how to install Oracle JRockit Real Time as a standalone application. It includes information on the following subjects:

- Supported Configurations
- Notation Used in this Guide
- Installing and Uninstalling JRockit Real Time
- Installing and Uninstalling JRockit Real Time in Console Mode
- Installing and Uninstalling JRockit Real Time in Silent Mode
- Special Note About Installing on Linux or Solaris

Note: | JRockit Real Time can be used by any application and does not interact with or create an Oracle registry.

## Note on Oracle JRockit Real Time Installation

This document shows how to install Oracle JRockit Real Time only. The Oracle JRockit JVM is installed as a part of many Oracle products. Refer to the documentation for those products for installation instructions.

## Supported Configurations

For a complete list of supported configurations, please visit:

http://download.oracle.com/docs/cd/E13188_01/jrockit/jrdocs/suppPlat/supp_plat.html

## Notation Used in this Guide

Throughout this document, JRockit Real Time versions are defined with the following notation:

`jrrt-<jrrt_version>-<java_version>`

For example:

`jrrt-3.0.0-1.6.0`

In this example, the product is JRockit Real Time 3.0 for Java SE 6.

## Installing and Uninstalling JRockit Real Time

This section explains how to install and uninstall a standalone version of JRockit Real Time in GUI mode for the following platforms:

- Microsoft Windows 32-bit x86 and 64-bit Xeon/AMD64.
- Red Hat Linux 32-bit x86 and 64-bit Xeon/AMD64.
- Sun Solaris on 64-bit SPARC.

Note: | If you are installing on Linux and Solaris, please refer to Identify the Default Location of System Preferences for information on where to fnd the system preferences.

### Installing JRockit Real Time

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 Real Time. The executables for this release of JRockit Real Time are listed in Table 1.

Table 1 JRockit Real Time Installers by Version and Platform
On... | For Java SE version... | Use...
--- | --- | ---
Windows 32-bit x86 | 1.4.2 | `jrrt-3.0.0-1.4.2-windows-ia32.exe`
5.0 | `jrrt-3.0.0-1.5.0-windows-ia32.exe`
6 | `jrrt-3.0.0-1.6.0-windows-ia32.exe`
Windows 64-bit Xeon/AMD64 | 5.0 | `jrrt-3.0.0-1.5.0-windows-x64.exe`
6 | `jrrt-3.0.0-1.6.0-windows-x64.exe`
Red Hat Linux 32-bit x86 | 1.4.2 | `jrrt-3.0.0-1.4.2-linux-ia32.bin`
5.0 | `jrrt-3.0.0-1.5.0-linux-ia32.bin`
6 | `jrrt-3.0.0-1.6.0-linux-ia32.bin`
Red Hat Linux 64-bit Xeon/AMD64 | 5.0 | `jrrt-3.0.0-1.5.0-linux-x64.bin`
6 | `jrrt-3.0.0-1.6.0-linux-x64.bin`
Sun Solaris on 64-bit Sparc | 1.4.2 | `jrrt-3.0.0-1.4.2-solaris-sparcv9.bin`
5.0 | `jrrt-3.0.0-1.5.0-solaris-sparcv9.bin`
6 | `jrrt-3.0.0-1.6.0-solaris-sparcv9.bin`

#### To install JRockit Real Time

1. Make sure you have downloaded the appropriate version of JRockit Real Time for your operating system (see Table 1).
2. On your local drive, locate the executable file for the version of JRockit Real Time you want to install.

Note: | If you install JRockit Real Time on Linux or Solaris please refer to Ensure the Installer is Executable.

3. Run the installer.

The install process begins and the Oracle installer window appears, followed by the Welcome window.

4. Click Next.

The Choose Product Installation Directory window appears (see Figure 1-2).

Figure 1-2 Choose Product Installation Directory Window

5. Click Next if you are satisfied with the suggested installation directory.

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 Reset, you set the selection back to the default directory.

6. Click Next (the installation starts immediately after you click Next).

The Oracle Installer window appears and the installation process continues, as indicated on the progress meter in the lower right corner of the window (see Figure 1-3).

Figure 1-3 Oracle Installer Window with Progress Meter

When the installation is complete, the Installation Complete window appears.

7. Click Done.

JRockit Real Time is now installed.

#### To start JRockit Real Time (Windows x86)

If you have installed JRockit Real Time you can start Oracle JRockit Mission Control 3.0.3 from the Start menu.

#### Adding JRockit Real Time to Your Path

Once you have installed JRockit Real Time, 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%\JRockit Real Time\jrrt-<jrrt_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/jrrt-<jrrt_version>-<java_version>/bin:$PATH`

### Uninstalling JRockit Real Time

This section describes how to uninstall the Windows, Linux, and Solaris versions of JRockit Real Time.

#### Uninstalling Windows Versions

To uninstall JRockit Real Time, do the following:

1. Click Start and open the All Programs menu.
2. Select Oracle JRockit Real Time [version]>Uninstall Oracle JRockit Real Time [version].

The Oracle Uninstaller confirmation message appears.

3. Click OK.

- The Oracle Uninstaller appears and the uninstall process commences.

4. Click OK.

JRockit Real Time is removed from your computer.

#### Uninstalling Windows Versions from the Command Line

To uninstall JRockit Real Time from the command line, run the following command from a console window:

    %SystemRoot%\Installer\Oracle\jrrt-<jrrt_version>-<java_version>-<arch>\uninstall.exe

#### Uninstalling Linux and Solaris Versions from the Command Line

To uninstall Linux and Solaris versions of JRockit Real Time, do the following:

1. Ensure you are one step below the appropriate JRockit Real Time product directory.
2. At the command line, enter:

    rm -rf jrrt-<jrrt_version>-<java_version>

JRockit Real Time is removed from your computer.

## Installing and Uninstalling JRockit Real Time in Console Mode

This section describes how to install JRockit Real Time using console mode, rather than from a GUI.

### Installing JRockit Real Time in Console Mode

To install JRockit Real Time in console mode, do the following:

1. Make sure you have downloaded the appropriate version of JRockit Real Time for your operating system (see Table 1).
2. On your local drive, locate the executable file for the version of JRockit Real Time you want to install:

Note: | If you install JRockit Real Time on Linux or Solaris please refer to Ensure the Installer is Executable.

3. Open a command window or console on your computer.
4. Change to the directory from which you want to install JRockit Real Time.
5. At the command line, enter:

    jrrt-<jrrt_version>-<java_version>-<platform>.<ext> -mode=console

where ext is the file name extension, either `exe` on Windows and `bin` on Linux and Solaris.

The system responds:

    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 Real Time.

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 Real Time.

### Uninstalling JRockit Real Time in Console Mode

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.

## Installing and Uninstalling JRockit Real Time in Silent Mode

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.

### The silent.xml File

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. Listing 1 shows an example of a `silent.xml` file for JRockit Real Time 3.0 for Java SE 6.

Listing 1 Example of a silent.xml File

    <?xml version="1.0" encoding="UTF-8" ?>
    <domain-template-descriptor>
     <input-fields>
      <!--
        Installation directory
          This option is valid for all platforms and Oracle JRockit Real Time products
      -->
      <data-value name="USER_INSTALL_DIR" value="C:\Program Files\JRockit Real Time\jrrt-3.0.0-1.6.0" />
      <!--
     </input-fields>
    </domain-template-descriptor>

### Installing JRockit Real Time in Silent Mode

To install JRockit Real Time in silent mode, do the following (this procedure assumes that silent.xml is stored in the same directory as the JRockit Real Time installer):

1. Make sure you have downloaded the appropriate version of JRockit Real Time for your operating system (see Table 1).
2. On your local drive, locate the executable file for the version of JRockit Real Time you want to install:

Note: | If you install JRockit Real Time on Linux or Solaris please refer to Ensure the Installer is Executable.

3. Open a command window or console on your computer.
4. Change to the directory from which you want to install JRockit Real Time.
5. At the command line, enter:

    jrrt-<jrrt_version>-<java_version>-<platform>.<ext> -mode=silent -silent_xml="silent.xml"

where ext is the file name extension, either `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 the installation on Windows, click Start > Programs. If the installation is successful, you will see Oracle JRockit Real Time 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.

### Uninstalling JRockit Real Time in Silent Mode

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.

## Special Note About Installing on Linux or Solaris

If you are installing JRockit Real Time on either a Linux or Solaris machine, note the following information.

### Ensure the Installer is Executable

If you install JRockit Real Time 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.

### Acquire Root Access for System Wide Installation

If you choose to install JRockit Real Time 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 Real Time into a directory where you have permission to write, for example, your home directory.

### Identify the Default Location of System Preferences

When installing on Linux and Solaris, the default location for system preferences will be:

    <JAVAHOME>/.systemPrefs

where `<JAVA_HOME>`=`<INSTALLDIR>/jre.`

unless the user is root, in which case it will be `/etc/.java/.systemPrefs`.