C H A P T E R  1

Preparing for Installation

This chapter includes information about the following topics:


Software Installation Overview

The following steps outline the general process you follow to install the Sun Studio 9 software, product serial number, and supporting software. See the references provided in each step for specific procedures.

Task

Description

For Instructions

  1. Verify that the system on which you are installing the Sun Studio 9 software meets the minimum requirements for this release.
  2. Determine whether you are going to display the installer locally or remotely.

  3. Verify that your system has access to the Javatrademark 2 Platform, Standard Edition technology.


  4. Choose an installation method.


  5. Locate the product serial number.


  6. Install the Sun Studio 9 software and serial number.

Using a system that meets the system requirements is recommended for proper performance.

You can install the Sun Studio software using a remote display or local display.


The Sun Studio 9 software supports the Javatrademark 2 Platform, Standard Edition technology


There are three ways to install the Sun Studio software.

 


The product does not work without a valid serial number.


 

Step through the installation information

See System Requirements.


Refer to Choosing Local Display or Remote Display of the Installer for more details.

See Installing the J2SE Platform for J2SE installation instructions, if necessary.

 

See Choosing an Installation Method for more information.

See Locating the Product Serial Number for the product serial number.

 

See Installing the Sun Studio 9 Software for J2SE installation instructions.



System Requirements

Sun Studio 9 supports the system requirements shown in TABLE 1-1.



Note - For further disk space requirements and important last minute information about this release, see the release notes for the Sun Studio 9 software on the product web site at http://wwws.sun.com/software/products/studio/index.html.



TABLE 1-1 System Requirements

Operating system

Suntrademark Java Desktop System, 2003; SuSE Linux Enterprise Server 8; RedHat Enterprise Linux 3

System

Recommended: Pentium III 1 GHz
Minimum: Pentium III 500 MHz

Memory

Recommended: 1 Gbyte
Minimum: 512 Mbytes

Swap Space*

Recommended: 2 Gbytes
Minimum: 1 Gbyte

Monitor

1024 x 768 resolution

J2SE Technology

J2SE 1.4.2_02 technology

Compilers

GCC 3.2 family


*Use the swapon -s command to display the existing swap space.


Adding Swap Space

If you want to add swap space, do the following:

1. Become a superuser (root) by typing:

% su
Password: root-password

2. Create a file in a selected directory to add swap space by typing:

# dd if=/dev/zero of=/dir/myswapfile bs=1024 count=number_blocks_needed

where dir is a directory in which you have permission to add swap space. The myswapfile is the name of the swap file you are creating. The number_blocks_needed is an amount of 1024-byte blocks you want to create.

See the dd(1) man page for more information.

3. Verify that the file was created by typing:

# ls -l /dir/myswapfile

The new file appears in the directory.

4. Initialize the new swap area by typing:

# mkswap /dir/myswapfile

See the mkswap(8) man page for more detailed information.

5. Run the swapon command to enable the new swap space for paging and swapping by typing the following:

# swapon -a /dir/myswapfile

6. Verify that the extra swap space was added by typing:

# swapon -s

The output shows the allocated swap space.


Choosing Local Display or Remote Display of the Installer

You can display the installer either locally or remotely while you are installing the Sun Studio 9 software with the graphical user interface installer or the command-line installer:

Preparing to Install Using a Remote Display

To prepare for installation using a remote display, follow these steps:

1. On the display computer, enable client access to the X server by typing the following at a command line:

% xhost + source-computer-name

Replace source-computer-name with the output of the /usr/bin/hostname command entered on the source computer, which is the computer that contains the product CD-ROM or downloaded files.

2. Log in to the source computer and become a superuser (root) by typing:

% rlogin source-computer-name -l rootname
Password: root-password

3. On the source computer, set the display to the monitor that is attached to the display computer.

If you use the C shell, type:

# setenv DISPLAY display-computer-name:0.0

If you use the GNU Bourne-Again shell, type:

# export DISPLAY=display-computer-name:0.0

If you use the Korn shell, type:

# export DISPLAY=display-computer-name:0.0

Replace display-computer-name with the output of the /bin/hostname command entered on the display computer.

Preparing to Install Using a Remote Display With an NFS-Mounted Filesystem



Note - The uninstaller resides on your local machine, so you must use that local machine to run the uninstaller if you choose to uninstall the product.



Follow the steps below to prepare for installation using a remote display from an NFS-mounted installer image. See What If the Installation Fails on an NFS-Mounted Filesystem? for troubleshooting information.

Preparing the Source Computer

1. Become a superuser (root) by typing:

% su
Password: root-password



Note - In the following examples, the CD-ROM name studio_9_linux is used. Use the name of your product CD-ROM in place of studio_9_linux. If you have electronically downloaded the product files, use the download directory name in place of studio_9_linux. If you are installing from electronically downloaded files, all files must be untarred in the source-machine/download-directory before proceeding with installation.



2. Add the following line to your /etc/exports file in order to share the product image as an NFS filesystem:

share -F nfs -o ro /cdrom/studio_9_linux

3. Verify that your source computer is an NFS server by typing:

# ps -ef | grep nfsd

If screen output that resembles the following example appears, then nfsd is running:

root 237 1 17 Jun 04 ? 0:00 [nfsd] 

If you do not see screen output like the preceding example, start nfsd. For example, on a Sun Java Desktop System, start nfsd by typing:

# /etc/init.d/nfsserver start
# ps -ef | grep nfsd

You should see screen output similar to the previous example. If not, contact your Linux system administrator.

If nfsd is running, to make the product image available, type:

# /usr/sbin/exportfs -a

4. Ensure that your source computer is exporting your product directory by typing:

# /usr/sbin/exportfs

Preparing the Display Computer

1. Enable client access to the X server by typing the following:

% /usr/X11R6/bin/xhost + source-machine-name

Replace source-computer-name with the output of the /bin/hostname command entered on the source computer.

2. Log in as superuser (root) by typing:

% su
Password: root-password

3. Create a new directory by typing:

# mkdir /install-directory

where install-directory is the directory in which you want to mount the installer image.

4. Mount the product files by typing:

# mount source-machine:/dev/cdrom/studio_9_linux /install-directory

5. Go to the directory that you created in Step 3 by typing:

# cd /install-directory

6. Set the display to the monitor you are using.

If you use the C shell, type:

# setenv DISPLAY source-computer-name:0.0

If you use the Bash shell, type:

# DISPLAY=source-computer-name:0.0
# export DISPLAY

If you use the Korn shell, type:

# export DISPLAY=source-computer-name:0.0


Locating the Product Serial Number

When you purchase the product, the serial number is listed on a card that is enclosed in the product package. The 26-character number on the card is the number that you enter in the Enter Serial Number page of the installer during installation. You can also generate a 60-day trial serial number during the installation process.


Installation Features Included in This Release

This Sun Studio 9 software release includes the following installation features:

This document includes instructions for using each of the features.