1 Product Installation Background

This document describes how to install and uninstall the following products as standalone applications:

The Oracle JRockit JDK optionally bundles with the Oracle JRockit Mission Control Client on all platforms and optionally bundles with the Oracle JRockit JRE on Windows platforms.

Before you install the products, you should understand some important information about the installation process, which is described in these sections:

Note:

The Oracle JRockit JDK include the Oracle JRockit JRE, and the Oracle JRockit JVM, all of which can also be installed as a part of many Oracle products. Refer to the documentation for those products for installation instructions.

1.1 Installation Modes

You can install and uninstall the products on Windows, Linux, and Solaris platforms in the following modes:

1.2 Supported Configurations

Ensure that Oracle JRockit is deployed on a supported configuration.

For information about operating systems and hardware platforms that Oracle JRockit supports, see "System Requirements and Supported Platforms for Oracle JRockit R28" at:

http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

1.3 Notation Used in this Guide

Throughout this installation guide several different placeholder variables are used to simplify the descriptions in the text. All variables used in the text are documented here with descriptions and example values.

1.3.1 Platform-Specific Variables

Table 1-1 lists the platform-specific variables.

Table 1-1 Platform Specific Variables

Variable Description

arch

The name of the installer platform architecture. arch has the following possible values: ia32 for 32-bit x86; x64 for 64-bit Xeon/AMD64; and sparcv9 for 64-bit SPARC.

os

The name of the installer platform operating system. os has the following possible values: windows for Windows platforms, linux for Linux platforms, and solaris for Solaris platforms.

platform

The name of the installer platform, formatted as os-arch. platform has the following possible values: windows-ia32 for Windows 32-bit x86, windows-x64 for Windows 64-bit Xeon/AMD64, linux-ia32 for Linux 32-bit x86, linux-x64 for Linux 64-bit Xeon/AMD64, and solaris-sparcv9 for Solaris 64-bit SPARC.

ext

The file extension on the installation platform. ext has the following possible values; exe for Windows platforms, and bin for Linux and Solaris platforms.


1.3.2 Product Name and Version Variables

Table 1-2 lists the product name and version-specific variables.

Table 1-2 Product Name and Version Variables

Variable Description

product_name

The product name in short abbreviated form. product_name has the following possible values; jrockit-jdk for Oracle JRockit JDK, and jrockit-jre for Oracle JRockit JRE.

java_version

The detailed Java developer version number, consisting of the major, minor, and micro version numbers separated by dots, and the optional update version number separated by underscore; for example 1.6.0_20.

jrockit_version

The detailed JRockit developer version number, consisting of a leading letter R and the major, minor and micro version numbers separated by dots; for example R28.2.0.

jrmc_version

The detailed JRockit Mission Control Client developer version number, consisting of the major, minor and micro version numbers separated by dots; for example 4.1.0.

product_name_version

The product name in short abbreviated form followed by the detailed developer version numbers for Java, JRockit, and optional JRockit Mission Control Client separated by dashes, formatted as java_version-jrockit_version-jrmc_version, or java_version-jrockit-version; for example jrockit-jdk1.6.0_29-R28.2.0-4.1.0, or jrockit-jre1.6.0_29-R28.2.0.


1.3.3 Product Installer Variables

product_installer denotes the name of the product installer, formatted as product_name_version-platform.ext; for example jrockit-jdk1.6.0_29-R28.2.0-4.1.0-windows-ia32.exe for Oracle JRockit JDK R28.2 for Java SE 6 with Oracle JRockit Mission Control 4.1.0 on Windows 32-bit x86. See Table 1-5 for a list of all Oracle JRockit installers by version and platform.

1.3.4 Product Installation and Uninstallation Directory Variables

Table 1-3 lists the product installer variables.

Table 1-3 Product Installation and Uninstallation Directory Variables

Variable Description

product_install_dir

The full path of the product installation directory, where the product and platform specific default value is intended unless it has been changed by the user during installation. The default top installation directory name is identical across products and platforms. The naming convention is product_name_version, while the default product installation location is platform specific: %ProgramFiles%\Java on Windows platforms and $HOME on Linux and Solaris platforms; for example C:\Program Files\Java\jrockit-jdk1.6.0_29-R28.2.0-4.1.0.

product_uninstall_dir

The full path of the product uninstallation directory, available on Windows platforms. The top uninstallation directory naming convention is product_name_version-arch, while the product uninstallation location is %SystemRoot%\Installer\Oracle; for example C:\WINDOWS\Installer\Oracle\jrockit-jdk1.6.0_29-R28.2.0-4.1.0-ia32 for Oracle JRockit JDK for Java SE 6 with Oracle JRockit Mission Control 4.1.0 on Windows 32-bit x86.


1.3.5 Oracle Universal Installer Central Inventory Variables

The product_home_name variable denotes the name used when registering the installation in the Central Inventory by using Oracle Universal Installer, where the name is expected to be unique between all Oracle products installed on the same host and can for example be obtained from the name of the default top installation directory by replacing dashes with underscores, removing dots in version numbers, and attaching the name of the architecture; for example jrockit_jdk160_29_R2820_410_ia32 for Oracle JRockit JDK for Java SE 6 with Oracle JRockit Mission Control 4.1.0 on Windows 32-bit x86..

1.3.6 Windows Start Menu Variables

Table 1-4 lists the Windows Start menu variables.

Table 1-4 Start Menu Variables

Variable Description

public_product_name

The public product name; for example Oracle JRockit JDK, or Oracle JRockit JRE.

public_product_name_jrmc

The public Oracle JRockit Mission Control Client name when bundled with the Oracle JRockit JDK; for example JRMC.

public_jrmc_name

The public Oracle JRockit Mission Control Client name; for example Oracle JRockit Mission Control.

public_jrockit_version

The public JRockit version number, identical to the detailed JRockit developer version number, unless the micro version number is identical to zero in which case it is omitted; for example R28.2.

public_java_version

The public Java platform name and version; for example Java SE 5.0, or Java SE 6.

public_jrmc_version

The public JRockit Mission Control Client version number, identical to the detailed JRockit Mission Control Client developer version number, unless the micro version number is identical to zero, in which case it is omitted; for example 4.0.

public_arch_bits

The word size in bits of the installer platform architecture enclosed in parenthesises; for example (32-bit) for Windows 32-bit x86, and (64-bit) for Windows 64-bit Xeon/AMD64.

public_product_name_version

The public product name and version listed in the Start menu on Windows platforms after installation. The format of the menu entry when the Oracle JRockit Mission Control Client is bundled with the product is public_product_name public_jrockit_version for public_java_version with public_product_name_jrmc public_jrmc_version public_arch_bits, otherwise the format is public_product_name public_jrockit_version for public_java_version public_arch_bits; for example Oracle JRockit JDK R28.2 for Java SE 6 with JRMC 4.1.0 (32-bit), or Oracle JRockit JRE R28.2 for Java SE 6 (32-bit).

public_jrmc_name_version

The public Oracle JRockit Mission Control Client name and version when listed in the Start menu on Windows platforms after installation of a product in which it is bundled. The format of the entry is public_jrmc_name public_jrmc_version; for example Oracle JRockit Mission Control 4.1.0.


1.4 Product Installers

Table 1-5 lists the JRockit installers. Installers whose filename starts with jrockit-jdk install the Oracle JRockit JDK, while the optional bundling of the Oracle JRockit Mission Control Client is denoted by inclusion of -jrmc_version.

Table 1-5 JRockit Installers by Platform

Platform... Use...

Windows 32-bit x86

product_name_version-windows-ia32.exe

Windows 64-bit Xeon/AMD64

product_name_version-windows-x64.exe

Linux 32-bit x86

product_name_version-linux-ia32.bin

Linux 64-bit Xeon/AMD64

product_name_version-linux-x64.bin

Solaris 64-bit SPARC

product_name_version-solaris-sparcv9.bin


1.5 Special Note About Installing on Linux or Solaris

If you are installing the product on either a Linux or Solaris machine, please note the information in this section.

1.5.1 Ensure the Installer is Executable

If you install the product 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.

1.5.2 Acquire Root Access for System Wide Installation

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

1.5.3 Default Location of System Preferences

When installing the product on Linux and Solaris, the default location for system preferences is product_install_dir/jre/.systemPrefs, unless the user is root, in which case it will be /etc/.java/.systemPrefs.