Installing WebLogic JRockit

WebLogic JRockit 8.1 SDK is available as either a standalone application or as part of the BEA WebLogic Platform suite. This section describes how to install WebLogic JRockit 8.1 as a standalone application. It includes information on the following subjects:

Java 2 Standard EditionTM (J2SETM) Compatibility

The JRE class files that are distributed with JRockit come directly from Sun except for a small number, which are tightly coupled to the JVM and are therefore overridden in JRockit. The class files that are overridden are in the java.lang, java.io, java.net and java.util packages. There are no omitted classes.

Platform Support

Note: For Red Hat Linux AS, the only supported versions of kernel, glibc and pthreads are the ones that ship as the defaults with RH AS 2.1.

Installing WebLogic JRockit SDK

This section explains how to install a standalone version of BEA WebLogic JRockit SDK for Windows 2000 and Windows Server 2003 EE and on the Red Hat Linux 32-bit and 64-bit platforms. The following procedure assumes that you have already downloaded the appropriate version of WebLogic JRockit SDK for your operating system.

On you local drive, locate the executable file for the version of WebLogic JRockit SDK you want to install:

If you have more than on installation of WebLogic JRockit on you computer, the Choose Installed SDK screen appears. Select the SDK you want to remove and click Next. The Uninstalling WebLogic JRockit SDK screen appears and the uninstall process commences.

As the uninstall process executes, a checklist will appear on the The Uninstalling WebLogic JRockit SDK screen, listing the uninstallation tasks as they complete. When the selected SDK is completely removed, "uninstall complete" appears.

Click Done.

You have successfully removed WebLogic JRockit SDK from your computer.

Installing and Uninstalling WebLogic JRockit SDK in the Console Mode

The console mode allows you to install and uninstall Linux versions of WebLogic JRockit SDK without using a GUI.

Installing WebLogic JRockit SDK

To install WebLogic JRockit in the console mode, do the following:

Change to the directory from which you want to install WebLogic JRockit.

At the prompt, type JRockit81_linux32.bin and press Enter.

The system responds:

Extracting 0%....................................100%

Unable to instantiate GUI, defaulting to console mode.

<------------- BEA Installer ------------->

Welcome:

The installer will guide you through the installation of WebLogic JRockit 8.1 SDK.

Type "Next" or press Enter to proceed to the next prompt.

Note: If at any time during the installation, you want to change data you previously entered, type "Previous". You can abort the installation at any time by typing "Exit".

You are prompted to accept the BEA Systems License Agreement.

Note: You must accept the license agreement to successfully install WebLogic JRockit SDK.

To accept the agreement, type Yes; to read more of the agreement, press Enter or type Next.

Once you've accepted the agreement, the Choose BEA Home Directory prompt appears.

Either select the existing BEA Home directory (BEA Home=[/dir_path/dir_name]) or, at the

Input new BEA Home Directory OR [Exit][Previous][Next]>

prompt, type a directory name (if this is a new directory, it will be created automatically).

Uninstalling WebLogic JRockit SDK

Change to the <jrockit_home> directory (or, alternately, specify the entire path to that directory) and type /uninstallJRockit.sh.

The system responds

Unable to instantiate GUI, defaulting to console mode.

<----- BEA Uninstaller - BEA JRockit Java SDK ------->

Welcome:

Welcome to the BEA Jrockit SDK uninstaller.

The installer will guide you through the process of removing a Linux version of WebLogic JRockit SDK.

Note: If at any time during the installation, you want to change data you previously entered, type "Previous". You can abort the installation at any time by typing "Exit".

To proceed with the uninstallation type Next, otherwise, type Exit to cancel.

The system responds with a list of BEA products you can uninstall; for example:

|_____jrockit81_141 (32bit) [0] x

At the prompt, enter the number that appears in brackets of the version you want to delete and press Enter.

Note: If only one product is displayed, you only need to press Enter to proceed.

The system responds by prompting you to either select the component selection or return to the component list; for example:

->1|Yes, use these component selections

2|No, return to component selection

Enter the number for your selection and press Enter.

The uninstallation process begins. As the process continues, it will display progress information by identifying the components being removed; for example:

Setting Up

Removing SDKs

Removing BEA Registry Entries

When all files have been removed and WebLogic JRockit SDK is successfully uninstalled, the system responds:

Uninstall Completed Successfully!

Uninstallation Complete

Uninstallation of selected components has completed successfully.

Installing and Uninstalling WebLogic JRockit for Red Hat Linux by Using the RPM Package

This section describes the installation procedures for WebLogic JRockit SDK for Red Hat Linux using the RPM package (recommended).

If you do not have root access already, become root by running the su command and entering the super-user password.

Run the rpm command to install the packages:

rpm -ivh jrockit-j2se1.4.1-8.1-1.i686.rpm

This will install WebLogic JRockit SDK to the directory /opt/bea.

Note: While /opt/bea remains the default directory for WebLogic JRockit SDK, you can relocate it if you want to use the extra RPM installer options to override it at installation, as described in Overriding the Default Installation Path with RPM.

Exit the root shell.

Overriding the Default Installation Path with RPM

While the BEA download site only distributes WebLogic JRockit packages using the BEA installer, if you are subscribed to Red Hat Network, you can obtain WebLogic JRockit binaries in RPM format from the Red Hat Enterprise Linux AS channel. The Red Hat files you can download are:

Linux 32-bit: jrockit-j2se1.4.1-8.1-1.i686.rpm

Linux 64-bit: jrockit-j2se1.4.1-8.1-1.ia64.rpm

If you do obtain the WebLogic JRockit RPMs, you can relocate them from the default directory (/opt/bea/jrockit81_141; Listing 1) to a directory you specify. If you want to override the default installation path for WebLogic JRockit 8.1 (/opt/bea/jrockit81_141), you must add the arguments --prefix /mydir1/mydir2 as shown in Listing 2 (these examples show the Linux 32-bit version of the install files).

Listing 1 Example of Default Install

$ rpm -ivh jrockit-j2se1.4.1-8.1-1.i686.rpm

...

$ /opt/bea/jrockit81_141/bin/java -version

...

Listing 2 Example of Relocated Install

$ rpm -ivh --prefix /mydir1/mydir2 jrockit-j2se1.4.1-8.1-1.i686.rpm

...

$ /mydir1/mydir2/bin/java -version

...

For example, to install in the directory /usr/jrockit/8.1/1.4.1, just add --prefix /usr/jrockit/8.1/1.4.1.

Using RPM to Uninstall WebLogic JRockit

Uninstalling Older Versions of WebLogic JRockit

If you are upgrading from WebLogic JRockit 8.0 to version 8.1, you can automatically uninstall version 8.0 after installing version 8.1 by replacing the option -ivh in the above example with -Uvh, as shown here:

$ rpm -Uvh --prefix /mydir1/mydir2 jrockit-j2se1.4.1-8.1-1.i686.rpm

...

Note: Older versions of WebLogic JRockit, for example, WebLogic JRockit 7.0.x must be manually uninstalled after installing version 8.1

Uninstalling the Current Version of WebLogic JRockit

To uninstall the current version of WebLogic JRockit by using RPM, enter the following command:

$ rpm -e jrockit-j2se1.4.1-8.1-1

Assuming the installation directory was /mydir1/mydir2 this will remove the directory /mydir1/mydir2 and everything below it; that is, equal to rm -rf /mydir1/mydir2.

If you have relocated the installation directory to, for example, /usr/jrockit/8.1/1.4.1, and uninstalled WebLogic JRockit, the directories /usr/jrockit/8.1 will remain and you might need to remove them manually.

Extracting the JRE from the SDK

The WebLogic JRockit 8.1 JVM is a component of Java Runtime Environment included in the WebLogic JRockit 8.1 SDK. In instances where you want to exploit the full power of the JVM without dealing with the overhead of the entire SDK, you can extract the JRE from the SDK and run it separately. If you choose to install WebLogic JRockit 8.1 JVM in this manner, you will have the JVM but no access to its other developer tools in the complete SDKs (for information on the contents of the WebLogic JRockit 8.1 SDK, please refer to What's in the WebLogic JRockit 8.1 SDK?). Additionally, if you want to use the Management Console, you will need to attach it to a JRockit session running within the JRE.

Extracting the JRE

To extract the JRE from the SDK, do the following:

Locate the folder /jre under the <jrockit-install-directory> (for example, jrockit81).

Cut or copy this file from <jrockit-install-directory> and paste at the necessary file level (for example, the root level).

Once the JRE is extracted from the SDK, ensure that you have the following directory set in your PATH environment variable:

jre/bin (for Linux)

jre\bin (for Windows)

Starting WebLogic JRockit 8.1 JVM from the Extracted JRE

To start the JVM, at the command line enter on of the following:

java

Include any tuning or configuration options you want to use. These options are described in Tuning WebLogic JRockit.

Special Note About Root Access

If you choose to install the JRockit Java 2 Runtime Environment into a system-wide location such as /usr/local, you must first become the root in order to gain the necessary permissions. If you do not have root access, simply install the JRockit Java 2 Runtime Environment into your home directory or a subdirectory to which you have permission to write.