IBM 64-bit SDK and Runtime Environment for Windows on Intel(R) Itanium(R) architecture, Java 2 Technology Edition, Version 1.4.2

Installation and Configuration User Guide


Copyright information

Note: Before using this information and the product it supports, be sure to read the general information under Notices.

This edition of the User Guide applies to the IBM 64-bit SDK for Windows on Intel Itanium architecture, Java 2 Technology Edition, Version 1.4.2 and IBM 64-bit Runtime Environment for Windows on Intel Itanium architecture, Java 2 Technology Edition, Version 1.4.2, and to all subsequent releases, modifications, and service refreshes, until otherwise indicated in new editions.

(C) Copyright Sun Microsystems, Inc. 1997, 2003, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

(C) Copyright International Business Machines Corporation, 1999, 2008. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Preface

This User Guide provides information about installing and configuring the IBM(R) 64-bit SDK for Windows(R) on Intel(R) Itanium(R) architecture, Java(TM) 2 Technology Edition, Version 1.4.2 and IBM 64-bit Runtime Environment for Windows on Intel Itanium architecture, Java 2 Technology Edition, Version 1.4.2.

All packages in this SDK are supported on Microsoft(R) Windows(R) XP 64-Bit Edition, Windows Server 2003 64-bit edition|, Windows Server |2008 64-bit edition, and Windows Vista 64-bit editions.

Technical changes made to this User Guide for Version 1.4.2, other than minor or obvious ones such as updating "1.4.1" to "1.4.2", are indicated in red when viewing in HTML or in a color-printed copy and by vertical bars to the left of the changes.

Contents

Copyright information
Preface
Notes
Setup file
Installable features
JRE feature
Where features are installed
Interactive installation
Installing the Runtime Environment as the System Java Virtual Machine
Interactive updates
Interactive uninstallation
Non-interactive installation
Unattended installations
Installing the Runtime Environment as the System JVM
Non-interactive uninstallation
Unattended uninstallations
After you install
Documentation
Obtaining the IBM build and version number
The just-in-time (JIT) compiler
Running a Java application
Notices
Trademarks

Notes

Note that:

Setup file

The setup.exe file should contain:

install.exe is the English language version of the installation file. References to install.exe apply equally to the other installation files.

Run one of the installation files. Choose the locale-specific installation file you require, and do one of the following:

Each locale specific version of install.exe should contain:

Installable features

The Windows Installer file, ibmsdk142_64.msi, contains five separate features you can install:

  1. SDK (Software Development Kit)
  2. JRE (Java Runtime Environment)
  3. JNI System Headers
  4. Java Source
  5. Demo Applets

You can install or remove features with or without a GUI interface. If you are installing or removing features without a GUI, you must specify the feature names as follows:

  1. sdk
  2. jre
  3. jni
  4. javasrc
  5. demo

JRE feature

The sdk feature includes the jre (Java Runtime Environment) feature. If you select both the sdk and the jre features, you install only one copy of the Runtime Environment.

Where features are installed

By default, all features are installed in the the C:\Program Files\IBM\Java142\ directory. When installing using the GUI interface you can specify the location of the installation using a dialog. When installing without a GUI you can specify the location by setting the JAVABASEDIR property to the directory you require. JAVABASEDIR is set within the msiexec command; see the msiexec example in Non-interactive installation.

Interactive installation

After you have extracted ibmsdk142_64.msi, either:

or

Follow the Setup Wizard's instructions to install the features you require.

Installing the Runtime Environment as the System Java Virtual Machine

When you install the Runtime Environment (either as part of the SDK feature or on its own), you are asked whether you want to install the Runtime Environment as the System Java Virtual Machine (JVM). If you do install it as the System JVM, the Installer copies java.exe and javaw.exe into the Windows System directory (Windows\system32). If java.exe or javaw.exe already exist in the Windows System directory they are overwritten. Installing these files into the Windows System directory makes this Runtime Environment the default JVM for the system.

Note: Installing the Runtime Environment as the System JVM copies only java.exe and javaw.exe into the Windows System directory; no other executables (such as javac.exe or appletviewer.exe) are copied.

Interactive updates

After you have installed ibmsdk142_64.msi you can modify what has been installed by doing one of the following:

The Setup Wizard allows you to modify the features that have been installed, that is, to install new features or remove installed features. The Setup Wizard also allows you to repair the installation or completely remove all features.

Interactive uninstallation

To uninstall, do one of the following:

Non-interactive installation

You can install all, or part of, the ibmsdk142_64.msi features quietly, that is, without any GUI interface. This can be done using msiexec.exe and the options /q /i. For example, you can type the following at the command prompt:

msiexec /q /i c:\installer\ibmsdk142_64.msi
msiexec /q JAVABASEDIR=c:\testdir    ADDLOCAL=sdk,jaas 
           /i ibmsdk142_64.msi)
msiexec /q  MAKESYS=YES /i c:\installer\ibmsdk142_64.msi

This first example installs all features to C:\Program Files\IBM\Java142\. It uses the ibmsdk142_64.msi found in the C:\Installer directory. The second example installs the sdk and jaas features to the C:\testdir directory. It uses the ibmsdk142_64.msi found in the current directory. Neither of these examples installs the Runtime Environment as the System JVM. The third example installs all features to the Program Files folder and makes the Runtime Environment the System JVM.

Note: There is sometimes a slight delay between the msiexec command returning and the appearance of new directories or files or both.

Unattended installations

Unattended installations can be done from a command file which invokes msiexec.exe with the options /q /i.

Installing the Runtime Environment as the System JVM

When you install either the sdk or jre quietly, you can specify that the Runtime Environment is installed as the System JVM. This means that the Installer copies java.exe and javaw.exe into the Windows System directory (WINDOWS\system32). If java.exe or javaw.exe already exist in the Windows System directory they are overwritten. Installing these files in the Windows System directory makes this Runtime Environment the default JVM for the system. For example:

    msiexec /q MAKESYS=YES ADDLOCAL=jre,systemjvm /i 
               c:\installer\ibmsdk142_64.msi

This example installs the jre to the C:\Program Files\IBM\Java142\ directory and makes the Runtime Environment the System JVM; that is, copies java.exe and javaw.exe to the WINDOWS\system32 directory.

Note: You cannot install the system jvm feature separately from the sdk or jre features.

Non-interactive uninstallation

Quiet uninstalls can be done using msiexec.exe with the options /q /x. For example:

    msiexec /q /x c:\installer\ibmsdk142_64.msi

This example uninstalls ibmsdk142_64.msi. It uninstalls all features, including the system jvm; that is, it removes java.exe and javaw.exe from the Windows System directory (WINDOWS\system32).

To uninstall one feature only, use the /i option (not the /x option) with the REMOVE property set to the features you want to remove. For example:

    msiexec /q REMOVE=demo,jni /i c:\installer\ibmsdk142_64.msi

This example uninstalls the demo and jni features only.

Unattended uninstallations

Unattended uninstalls can be done from a command file which invokes msiexec.exe with the options /q /x.

After you install

The following sections provide basic information about using the SDK.


Documentation

To view the User Guides that describe the SDK:

  1. Launch Windows Explorer
  2. Navigate to C:\Program Files\IBM\Java142\docs\
  3. Open the file startHere.htm, and choose the language in which you want to view the guides.

Obtaining the IBM build and version number

To obtain the IBM build and version number, at a command prompt type:

java -version

The just-in-time (JIT) compiler

The just-in-time (JIT) compiler (jitc.dll) dynamically generates machine code for frequently used bytecode sequences in Java applications and applets while they are running.

The SDK for Windows includes the JIT (jitc.dll), which is enabled by default. You can disable the JIT to help isolate a problem with a Java application, an applet, or the compiler itself.

To disable the JIT, at a command prompt in the window where you will run the application, type:

    set JAVA_COMPILER=NONE

To enable the JIT, type at a command prompt:

    set JAVA_COMPILER=jitc

To verify whether or not the JIT is enabled, type at a command prompt:

    java -version

If the JIT is in use, a message is displayed that includes:

(JIT enabled: jitc)

If the JIT is not in use, a message is displayed that includes:

(JIT disabled)

Running a Java application

To run a Java application, type at a command prompt:

    java classname

where classname is the name of the Java class file (Java application) that you want to run.

Note: If you did not install this sdk or jre as the System JVM, you must first set the path to include the appropriate directories. To update the path, type the following at a command prompt:

    set path=javadir\bin;javadir\jre\bin;%path%

where javadir is the directory where you installed the sdk or jre.

If you are developing Java applications, see the SDK User Guide for more detailed information about setting the PATH and the CLASSPATH. The file is in the docs subdirectory of the directory where you installed the SDK package. The file name is sdkguide.win64.htm.

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

Trademarks

IBM and developerWorks are trademarks or registered trademarks of International Business Machines Corporation in the United States, or other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

This product is also based in part on the work of the FreeType Project. For more information about Freetype, see http://www.freetype.org.

This product includes software developed by the Apache Software Foundation http://www.apache.org/.