Skip Headers
Oracle® JRockit Upgrade Guide
Release R28.0

Go to Table of Contents
Go to Feedback page
Contact Us

  View PDF

Oracle® JRockit

Upgrade Guide

Release R28.0


June 2010

This document contains information to help you upgrade to the Oracle JRockit JDK R28.0, which is a new, major release of the Oracle JRockit JDK.

This document contains the following topics:

1 Supported Configurations

Ensure that the Oracle JRockit JVM is deployed on a supported configuration.

For information about operating systems and hardware platforms that the Oracle JRockit JDK supports, see Oracle JRockit JDK Supported Configurations at

2 Java Version Dependencies

Oracle JRockit JDK R28.0 supports the following Java versions. Ensure that your application complies with the Java specification corresponding to the JRockit JDK release that you use.

Oracle JRockit JDK Release Supported Java Version Java API Specification
Oracle JRockit JDK 5.0 R28.0 J2SE 5.0
Oracle JRockit JDK 6 R28.0 Java SE 6

For information about the Java version updates supported by the Oracle JRockit JDK, see the Oracle JRockit Release Notes.


Oracle JRockit JDK R28.0 does not support J2SE 1.4.2 and earlier Java versions.

So before upgrading to R28.0 from any of the following releases, ensure that the application is compatible with either J2SE 5.0 or Java SE 6.

  • Oracle JRockit JDK 1.4.2 R27

  • Oracle JRockit JDK 1.4.2 R26

  • Oracle JRockit JDK 1.4.2 R24

  • Oracle JRockit JDK 8.1

  • Oracle JRockit JDK 7.0 SP6 R23

3 Upgrade-Related Tasks

This section describes tasks that you must perform when upgrading to JRockit JVM R28.

3.1 Verify the JVM Release Number After Installation

After installing the Oracle JRockit JDK, verify the JVM release number by using the java -version command.

The JRockit JDK release number consists of two elements:

  • The JRockit JVM release number (for example, R28.0.0)

  • The Java version number (for example, 1.6.0_17)

3.2 Ensure Compatibility of JVM Startup Options

Consider using as few JVM startup options as possible. For the startup options that you decide to use, make sure that you understand how they work by reading about them in the Oracle JRockit Command Line Reference.

The Oracle JRockit JDK R28.0 release includes several new -XX command-line options (see "New Command-Line Options in Oracle JRockit R28.0"), some of which are equivalents for deprecated options ("Deprecated Command-Line Options in Oracle JRockit R28.0").

If your application startup command contains any of the deprecated options, modify the startup command to use equivalent other options.

3.3 Test the Application in a Staging Environment

Before upgrading the production environment, test the application in a controlled staging environment. The staging environment should be as similar as possible to the required production environment. This includes hardware, software, usage patterns, and load.

Applications are sometimes sensitive to timing. A JRockit JVM upgrade can sometimes expose errors in your application; for example, dependencies on unspecified behavior or APIs. Timing differences introduced when upgrading the JVM may, for instance, expose erroneous synchronization.

4 Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit or visit if you are hearing impaired.

Oracle JRockit Upgrade Guide Release R28.0


Copyright © 2007, 2010, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.