2 - C H A P T E R -

C H A P T E R 2

Installing the J2SE, v. 1.4.0 Platform

This chapter gives step-by-step instructions for installing the software for the supported version of the J2SE platform. The supported version of the software is J2SE, v. 1.4.0_02 (hereafter referred to as the "J2SE, v. 1.4.0 platform") on all the supported platforms. The J2SE, v. 1.4.0 platform includes the Java 2 Software Development Kit, Standard Edition (Java 2 SDK) and the Java 2 Runtime Environment, Standard Edition (JRE).

Before you install the platform, you need to determine whether you have access to a supported version of the J2SE platform on your system.

Determining the Version of Your Current J2SE Platform

To use the Sun ONE Studio 4 IDE, you must have one of the following:

J2SE, v. 1.3.1 or J2SE, v. 1.4.0_02 platform installed on your system

Network access to the path in which v. 1.3.1 or v. 1.4.0_02 of the J2SE platform is installed

Note - To maximize runtime performance, the J2SE platform should be installed on and accessed from your local system.

Use the following steps to help you determine what you need to do next:

1. Identify which Java software is available to your system.

On a Microsoft Windows system, type the following in a command prompt window:

C:\>java -version

The output looks similar to the following:

C:\>java -version

java version "1.4.0"

Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)

Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

In a Solaris or Linux environment, type the following:

% java -version

The output looks similar to the following:

% java -version

java version "1.4.0"

Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)

Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

If you do have the software installed on your system, review the information on uninstalling the J2SE platform software near the end of this chapter and continue with Chapter 3.

2. If you do not have v. 1.3.1 or v. 1.4.0_02 of the J2SE platform available to your system, you must install the supported J2SE, v. 1.4.0 platform.

a. Obtain the J2SE, v. 1.4.0_02 installer from http://www.sun.com/software/sundev/jde/buy/index.html or from the Sun ONE Studio 4 update 1 companion CD.

b. Install the J2SE, v. 1.4.0 platform on your system.

Read the following sections for additional instructions for your specific system.

Determining If You Need a Solaris Patch

Even if you have previously installed the J2SE, v. 1.4.0_02 platform, you should use the solaris_patch_installer to determine if all the Solaris patches required by the IDE installed in your system.

The solaris_patch_installer is provided with the Sun ONE Studio 4 update 1 companion CD and is also available from the Sun ONE Studio 4 update 1 product download page. The installer includes the Solaris patch packages you need to install in your Solaris 8 operating environment. See Installing Patches in a Solaris 8 Operating Environment for instructions on how to use the solaris_patch_installer script.

If the J2SE, v. 1.4.0 platform is already installed on your system, install any Solaris patches that are applicable to your Solaris 8 operating environment.

If you do not have the required Solaris patches when you start the IDE, you receive a message that includes the Solaris patches you need to install on your system. Install the patches on your system or contact your system administrator before proceeding to use the IDE.

Note - For a complete list of the Solaris patches included with the solaris_patch_installer script, see Appendix A.

Installing the J2SE Platform on Microsoft Windows Systems

Note - If you are unsure about installing the J2SE, v. 1.4.0 platform on your Microsoft Windows system, contact your system administrator for assistance.

To install the J2SE, v. 1.4.0 platform on your supported Microsoft Windows system, follow these steps:

1. If you have not already done so, download the j2sdk-1_4_0_02-windows-i586.exe installer file from http://www.sun.com/software/sundev/jde/buy/index.html into j2se-directory or locate the installer on the Sun ONE Studio 4 update 1 companion CD.

Note - Ensure that the j2se-directory, in which you download the software, is located on a disk that has plenty of available space. See System Requirements for details.

Use the following information if you are accessing the installer file from the download page for the J2SE, v. 1.4.0 platform. Otherwise, proceed to Step 2.

a. In the "Before You Download" section of the http://www.sun.com/software/sundev/jde/buy/index.html download page, click "Java 2 Platform, Standard Edition, v. 1.4.0" to download the installer file for the J2SE, v. 1.4.0 platform.

The Java 2 Platform, Standard Edition, v. 1.4.0 Overview page is displayed.

b. Click "Download J2SE v. 1.4 Now!"

The Java 2 Platform, Standard Edition download page is displayed.

c. From the SDK column of the Download J2SE, v. 1.4.0 table, click DOWNLOAD for Windows (all languages, including English).

The binary code license agreement is displayed.

d. Read the binary code license agreement carefully. To proceed, accept the terms of the license agreement.

You must agree to the license to continue with the download. Once you have agreed to the license agreement, the download page is displayed.

e. Click Download j2sdk-1_4_0_02-windows-i586.exe to proceed with the download of the file and specify where you want to save the file.

f. Verify that the size of the downloaded file is the same as the file size indicated on the download page.

This step ensures that you have downloaded the full and uncorrupted software bundle.

2. Uninstall any prerelease versions of the J2SE, v. 1.4.0 platform currently installed on your system.

If you have previously installed a Beta release or the Release Candidate version of the J2SE, v. 1.4.0 platform, uninstall it. Use the Microsoft Windows Add/Remove Programs utility to uninstall the previous release of the J2SE, v. 1.4.0 platform. Choose Start right arrow Settings Control Panel to access the utility.

3. Start the installation wizard by double-clicking the j2sdk-1_4_0_02-windows-i586.exe file in the j2se-directory or from the Sun ONE Studio 4 update 1 companion CD.

Note - You must have administrative permissions to install the J2SE, v. 1.4.0 platform in a Windows XP or Windows 2000 system.

4. Follow the instructions on the wizard panes to complete the J2SE, v. 1.4.0 platform installation on your Microsoft Windows system.

5. (Optional) Delete the downloaded file from the j2se-directory to recover disk space.

Continue to Chapter 3 for instructions on installing the Sun ONE Studio 4 update 1 software.

Installing the J2SE Platform in the Linux Environment

Note - If you are unsure about installing the J2SE, v. 1.4.0 platform in your Linux environment, contact your system administrator for assistance.

To install the J2SE, v. 1.4.0 platform in your supported Linux environment, follow these steps:

1. If you have not already done so, download the j2sdk-1_4_0_02-linux-i586-rpm.bin file into j2se-directory or locate the file on the Sun ONE Studio 4 update 1 companion CD.

Note - Ensure that the j2se-directory, in which you download the software, is located on a disk that has plenty of available space. See System Requirements for more information.

Use the following information if you are accessing the installer file from the download page for the J2SE, v. 1.4.0 platform. Otherwise, proceed to Step 2.

a. In the "Before You Download" section of the http://www.sun.com/software/sundev/jde/buy/index.html download page, click Java 2 Platform, Standard Edition, v. 1.4.0 to download the installer file for the J2SE, v. 1.4.0 platform.

The Java 2 Platform, Standard Edition, v. 1.4.0 Overview page is displayed.

b. Click "Download J2SE v. 1.4 Now!"

The Java 2 Platform, Standard Edition download page is displayed.

c. From the SDK column of the Download J2SE, v. 1.4.0 table, click DOWNLOAD for Linux Red Hat.

The binary code license agreement is displayed.

d. Read the binary code license agreement carefully. To proceed, accept the terms of the license agreement.

You must agree to the license to continue with the download. Once you have agreed to the license agreement, the download page is displayed.

e. Click Download j2sdk-1_4_0_02-linux-i586-rpm.bin and specify the directory, j2se-directory, where you want to save the file.

f. Verify that the size of the downloaded file is the same as the file size indicated on the download page.

This step ensures that you have downloaded the full and uncorrupted software bundle.

2. Double-click the j2sdk-1_4_0_02-linux-i586-rpm.bin file on the Sun ONE Studio 4 update 1 companion CD, or type the following commands:

$ cd j2se-directory

$ chmod a+x j2sdk-1_4_0_02-linux-i586-rpm.bin

$ j2sdk-1_4_0_02-linux-i586-rpm.bin

The script displays the binary license agreement.

3. Read the binary license agreement carefully. To proceed, accept the terms of the license agreement.

You must agree to the license to continue with the installation.

Once you have agreed to the license agreement, the install script creates the j2sdk-1_4_0_02-linux-i586-rpm file in the current directory.

4. Become a superuser (root) by typing the following in a terminal window:

$ su

Password: root-password

5. Uninstall any prerelease versions of the J2SE, v. 1.4.0 platform currently installed on your system.

If you have previously installed a Beta release or the Release Candidate version of the J2SE, v. 1.4.0 platform, uninstall it.

Note - The default installation location for the prerelease versions of the J2SE platform is /usr/java/j2sdk1.4.0. That is the same location in which the RPM package of the final version of the J2SE, v. 1.4.0 platform is installed. To clear the way for installation of the final version of the J2SE, v. 1.4.0 platform, you must first uninstall any of these previous releases that you have installed. Skip this step if you have not installed any of these previous releases.

If you are not sure if you have a prerelease version installed in your system, run the following command:

# rpm -query -a | grep j2sdk-1.4.0

The output displays the RPM package name of the prerelease version of the J2SE, v. 1.4.0 platform. For example, if the J2SE 1.4.0 Beta 3 version is installed, the command returns the RPM package name for Beta 3, which is j2sdk-1.4.0-beta3.

If you determine that a Beta package is installed, uninstall it using the rpm command. For example, to remove the Beta 3 version of the J2SE, v. 1.4.0 platform, type the following:

# rpm -e j2sdk-1.4.0-beta3

6. Run the rpm command to install the package for the J2SE, v. 1.4.0 platform by typing the following:

# cd j2se-directory

# rpm -iv j2sdk-1.4.0_02-linux-i586.rpm

The packages for the J2SE, v. 1.4.0 platform are installed in /usr/java/j2sdk1.4.0.

7. Exit from your superuser privileges by typing:

# exit

Continue to Chapter 3 for instructions on installing the Sun ONE Studio 4 update 1 software.

Installing the J2SE Platform in the Solaris Operating Environment

You must first install any Solaris patches required in your Solaris 8 operating environment (SPARC platform) before proceeding with the installation of the J2SE, v. 1.4.0 platform. Use the steps in the next section to guide you in the installation of the Solaris patches and the J2SE, v. 1.4.0 platform.

Note - The Solaris 9 environment is preconfigured with the J2SE, v.1.4.0 platform. To install the J2SE, v.1.4.0_02 platform, download the latest patches from http://www.java.sun.com/j2se/1.4/download.html and follow the directions provided for installing the J2SE, v.1.4.0_02 platform in a Solaris 8 operating environment.

Installing Patches in a Solaris 8 Operating Environment

Note - If you are unsure about installing Solaris patches in your Solaris environment, contact your system administrator for assistance.

These instructions describe how to install the necessary Solaris patches prior to the installation of the J2SE, v. 1.4.0 platform. These instructions are applicable only in a Solaris 8 operating environment. Refer to Appendix A for a list of the Solaris patches included with the solaris_patch_installer.

1. If you have not already done so, download the solaris_patch_installer.tar.gz file into the solaris-patches-directory from the Sun ONE Studio download web site at http://www.sun.com/software/sundev/jde/buy/index.html or from the Sun ONE Studio 4 update 1 companion CD.

Note - Ensure that the solaris-patches-directory, in which you download the software, is located on a disk that has plenty of available space. See System Requirements for details.

2. From the solaris-patches-directory, uncompress and extract the contents of the downloaded file by typing:

% cd solaris-patches-directory

% gzcat solaris_patch_installer.tar.gz | tar xvf -

Note - The gzcat utility can be found in the /usr/bin directory in the Solaris 8 operating environment.

The solaris_patch_installer file and the patches directory are extracted in the solaris-patches-directory. The patches directory contains several subdirectories for each of the required Solaris patches.

3. (Optional) To recover disk space, remove the downloaded file by typing:

% rm -rf solaris_patch_installer.tar.gz

4. Become a superuser (root) by typing the following in a terminal window:

% su

Password: root-password

5. Go to the solaris-patches-directory and run the solaris_patch_installer script:

# cd solaris-patches-directory

# ./solaris_patch_installer

The solaris_patch_installer determines which patches that are necessary for the installation of the J2SE, v. 1.4.0 platform have already been applied and which patches still need to be installed.

You see output similar to the following:

# ./solaris_patch_installer

Solaris Patch Installer for J2SE, v.1.4.0

Installing 109147-14...already applied

Installing 108434-06...successfully installed

Installing 108435-06...successfully installed

Installing 111293-04...attempting to patch a package that is not installed

Installing 112334-01...already applied

6. (Optional) After the patch installation is complete, look at the /var/tmp/solaris_patch_installer.log file for more details about the installation.

Note - Some Solaris patches require that you reboot your system after installation has completed. The installer prompts you to reboot, if necessary.

7. When prompted, reboot your system by typing y:

# Certain patches installed on your system require that you reboot your machine.

Do you want to REBOOT your machine now? (y/n)

8. If you are not prompted to reboot, exit from your superuser privileges by typing:

# exit

9. (Optional) After you log back on to your system, remove the solaris-patches-directory and its contents to recover disk space. Type the following:

% rm -rf solaris-patches-directory

Installing the J2SE, v. 1.4.0 Platform in a Solaris 8 Environment

Note - If you are unsure about installing Solaris packages or the J2SE, v. 1.4.0 platform in your Solaris environment, contact your system administrator for assistance.

Prior to installing the J2SE, v. 1.4.0 platform, you must ensure that you have installed the full set of required patches needed to support v. 1.4.0 of the J2SE platform in your Solaris 8 environment. See Installing Patches in a Solaris 8 Operating Environment for more information.

To install the 64-bit J2SE, v. 1.4.0 platform in your 64-bit Solaris 8 environment, you must follow a two-step procedure:

1. Install the 32-bit J2SE, v. 1.4.0 platform in your 64-bit Solaris 8 environment.

Follow the instructions in the next section for more information.

2. Install the J2SE, v. 1.4.0 supplemental release for 64-bit operation in your 64-bit Solaris 8 environment.

Use the instructions in Installing the J2SE, v. 1.4.0 Supplemental Release for 64-bit Operation in a Solaris 8 Environment for more information.

Installing the J2SE, v. 1.4.0 Platform in a 32-bit Solaris 8 Environment

Note - If you are unsure about installing Solaris packages or the J2SE, v. 1.4.0 platform in your Solaris environment, contact your system administrator for assistance.

Follow these steps to install the J2SE, v. 1.4.0 platform in your supported Solaris operating environment using the pkgadd command:

1. If you have not already done so, download the j2sdk-1_4_0_02-solaris-sparc.tar.Z file into the j2se-directory. You can also obtain the file from the Sun ONE Studio 4 update 1 product CD.

Note - Ensure that the j2se-directory, in which you download the software, is located on a disk that has plenty of available space.

If you are accessing the installer file from the Sun ONE Studio 4 update 1 product CD, skip to Step e.

The Java 2 Platform, Standard Edition, v. 1.4.0 Overview page is displayed.

b. Click "Download J2SE v. 1.4 Now!"

The Java 2 Platform, Standard Edition download page is displayed.

c. From the SDK column of the Download J2SE, v. 1.4.0 table, click DOWNLOAD for Solaris SPARC 32-bit tar.Z.

The binary code license agreement is displayed.

d. Read the binary code license agreement carefully. To proceed, accept the terms of the license agreement.

You must agree to the license to continue with the download. Once you have agreed to the license agreement, the download page is displayed.

e. Click Download j2sdk-1_4_0_02-solaris-sparc.tar.Z from the product download page or obtain the file on the Sun ONE Studio 4 update 1 product CD, and save the file to the j2se-directory.

f. Verify that the size of the downloaded file is the same as the file size indicated on the download page or from the Sun ONE Studio 4 update 1 product CD.

This ensures that you have downloaded the full and uncorrupted software bundle.

2. From the j2se-directory, uncompress and extract the contents of the downloaded installer file by typing the following at the command line:

% cd j2se-directory

% zcat j2sdk-1_4_0_02-solaris-sparc.tar.Z | tar xvf -

This action creates several packages (SUNWj3dmo, SUNWj3dev, SUNWj3man, SUNWj3rt, plus SUNWj3jmp for Japanese man pages) along with the product license, readme file, and other release documentation.

3. Become a superuser (root) by typing the following in a terminal window:

% su

Password: root-password

4. Uninstall your previous installation of the J2SE platform, if needed.

Note - The default installation location for versions 1.3.0, 1.3.1, and the previous 1.4.0 Beta release of the J2SE platform is /usr/j2se. That is the same location in which J2SE, v. 1.4.0 is installed. To clear the way for installation of the J2SE, v. 1.4.0 platform, you must first uninstall any of these previous releases that you have installed. Skip this step if you have not installed any of these previous releases or if you intend to install J2SE, v. 1.4.0 in a nondefault location.

If you have previously installed the packages for J2SE versions 1.3.0, 1.3.1, or 1.4.0 prereleases, remove them by using the pkgrm command:

# pkgrm SUNWj3dmo SUNWj3man SUNWj3dev SUNWj3rt

If you have previously installed packages SUNWlj3dv and SUNWlj3rt for localization support in version 1.3.0, remove them by using the following command:

# pkgrm SUNWlj3dv SUNWlj3rt

If you have previously installed the Japanese man page packages for the Java 2 SDK v. 1.3.0 or v. 1.3.1, remove them by using the following command:

# pkgrm SUNWjej3m SUNWjpj3m SUNWjuj3m

If your /usr/java symbolic link was pointing to the Java 2 SDK v. 1.2.2 installation at /usr/java1.2, you might want to update it to point to /usr/j2se, which is the location where the Java 2 SDK v. 1.4.0 will be installed.

5. Run the pkgadd command to install the packages:

# cd j2se-directory

# pkgadd -d . SUNWj3rt SUNWj3dev SUNWj3man SUNWj3dmo

The J2SE v. 1.4.0 packages are installed into /usr/j2se. Refer to the pkgadd(1) and admin(4) man pages for information on installing the J2SE, v. 1.4.0 in a nondefault location.

6. (Optional) Remove the j2se-directory to recover disk space:

# rm -rf j2se-directory

7. Exit from your superuser privileges by typing:

# exit

If you need to install the J2SE, v. 1.4.0 supplemental release platform, continue to the next situation for more information.

Otherwise, continue to Chapter 3 for instructions on installing the Sun ONE Studio 4 update 1 software.

Installing the J2SE, v. 1.4.0 Supplemental Release for 64-bit Operation in a Solaris 8 Environment

Note - If you are unsure about installing Solaris packages or the J2SE, v. 1.4.0 platform in your Solaris environment, contact your system administrator for assistance.

Follow these steps to install the 64-bit supplemental release of the J2SE, v. 1.4.0 platform in your Solaris 8 environment:

1. If you have not already done so, download the j2sdk-1_4_0_02-solaris-sparcv9.tar.Z file into the j2se-64bit-directory. You can also obtain the file from the Sun ONE Studio 4 update 1 companion CD.

Note - Ensure that the jse-64bit-directory, in which you download the software, is located on a disk that has plenty of available space.

If you are accessing the installer file from the Sun ONE Studio 4 update 1 companion CD, skip to Step e.

The Java 2 Platform, Standard Edition, v. 1.4.0 Overview page is displayed.

b. Click "Download J2SE v. 1.4 Now!"

The Java 2 Platform, Standard Edition download page is displayed.

c. From the SDK column of the Download J2SE, v. 1.4.0 table, click DOWNLOAD for Solaris SPARC 64-bit tar.Z.

The binary code license agreement is displayed.

d. Read the binary code license agreement carefully. To proceed, accept the terms of the license agreement.

You must agree to the license to continue with the download. Once you have agreed to the license agreement, the download page is displayed.

e. Click Download j2sdk-1_4_0_02-solaris-sparcv9.tar.Z from the product download page or obtain the file from the Sun ONE Studio 4 update 1 companion CD, and specify where you want to save the file.

f. Verify that the size of the downloaded file is the same as the file size indicated on the download page or from the Sun ONE Studio 4 update 1 companion CD.

This step ensures that you have downloaded the full and uncorrupted software bundle.

2. From the j2se-64bit-directory, uncompress and extract the contents of the downloaded installer file by typing the following at the command line:

% cd j2se-64bit-directory

% zcat j2sdk-1_4_0_02-solaris-sparcv9.tar.Z | tar xvf -

This action creates several packages (SUNWj3dvx, SUNWj3rtx, and SUNWj3dmx) that contain 64-bit support for the J2SE, v. 1.4.0 platform.

3. Become a superuser (root) by typing the following in a terminal window:

% su

Password: root-password

4. Uninstall your Beta installation of the 64-bit packages for the J2SE, v.1.4.0, if needed.

If you have previously installed the Beta release of packages SUNWj3dvx, SUNWj3rtx, and SUNWj3dmx for 64-bit support, remove them by using the pkgrm command:

# pkgrm SUNWj3rtx SUNWj3dvx SUNWj3dbx

5. Run the pkgadd command to install the packages:

# cd j2se-64bit-directory

# pkgadd -d . SUNWj3rtx SUNWj3dvx SUNWj3dmx

This action installs the files for 64-bit support into the J2SE v. 1.4.0 installation at /usr/j2se.

6. (Optional) Remove the j2se-64bit-directory to recover disk space:

# rm -rf j2se-64bit-directory

7. Exit from your superuser privileges by typing:

# exit

Continue to Chapter 3 for instructions on installing the Sun ONE Studio 4 update 1 software.

Uninstalling the J2SE, v. 1.4.0 Platform

Use the following information to uninstall the J2SE, v. 1.4.0 platform:

In a Microsoft Windows system, use the Add/Remove Programs utility in the Control Panel to uninstall the J2SE, v. 1.4.0 platform from your system.

For a Linux environment, use the rpm command to uninstall the J2SE, v. 1.4.0 platform from your system.

For Solaris operating environments, use the pkgrm and patchrm commands to uninstall the J2SE, v. 1.4.0 platform and associated Solaris patches from your system.

Caution - Removing the J2SE, v. 1.4.0 software and related Solaris patches can cause regressive behavior on your system. Contact your system administrator if you are unsure of how to remove the Solaris, J2SE v. 1.4.0 platform and associated Solaris patches from your system.

Refer to the pkgrm and patchrm man pages for additional information on these commands.