Installation and Setup Guide

This chapter includes information about the following topics:

• The software installation overview
• System requirements
• Adding swap space
• Choosing local display or remote display of the installer

---

Software Installation Overview

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

After following the instructions in this manual, you are ready to use your Sun Studio 8 software.

---

System Requirements

This Sun Studio 8 release supports the Solaris operating system (SPARC^® Platform Edition) versions 7, 8, and 9; and the Solaris operating system (x86 Platform Edition) versions 7, 8, and 9.

TABLE 1-1 lists the system requirements.

---

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:

mkfile number[m|k|b] /directory/swap-file-name

where number is an amount of swap space, followed by either m for megabyte, k for kilobyte, or b for block. The directory is a directory in which you have permission to add swap space. The swap-file-name is the name of the swap file you are creating.

For example, to create a 16-megabyte swap file named 16mswap in the foo directory, type the following:

# mkfile 16m /foo/16mswap

See the mkfile(1M) man page for more information.

3. Verify that the file was created by typing:

# ls -l /directory/swap-file-name

The new file appears in the directory. For example:

# ls -l /foo/16mswap -rw------T 1 root other 16777216 Dec 12 14:24 /foo/16mswap

4. Run the swap command to specify the additional swap space by typing:

# swap -a /directory/swap-file-name

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

#swap -s

The output shows the allocated swap space. For example:

#swap -s total: 289336k bytes allocated + 27008k reserved = 316344k used, 298336k available

---

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 8 software with the graphical user interface installer or the command-line installer:

• Local display. The source computer and the display computer are the same computer. The installer window or command-line installer is displayed on the same computer that contains the product CD-ROM or downloaded files and runs the installer. Continue to Chapter 2.
• Remote display. The source computer and the display computer are different computers. The source computer contains the product CD-ROM or downloaded files and runs the installer. The display computer displays the installer window or command-line installer. To install using a remote display, follow the instructions in Preparing to Install Using a Remote Display or Preparing to Install Using a Remote Display With an NFS-Mounted Filesystem.

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 Bourne shell, type:

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

If you use the Korn shell, type:

# export DISPLAY=display-computer-name:0.0

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

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

You can install using a remote display if you have write permission on the NFS-mounted filesystem. See What If the Installation Fails on an NFS-Mounted Filesystem? of Chapter 5 for troubleshooting information.

Follow the steps below to prepare for installation using a remote display with an NFS-mounted filesystem.

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.

Installing from Electronic Download Files

If you obtained your files through electronic download, you can find complete instructions for downloading and extracting the downloaded files on the download page of the product web site at http://www.sun.com/software/products/studio/index.html. Follow the instructions in the Download Instructions before you proceed with product installation.

Preparing the Source Computer

1. Become a superuser (root) by typing:

% su Password: root-password

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

share -F nfs -o ro /cdrom/studio_8_sol_sparc

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 /usr/lib/nfs/nfsd -a 16

If you do not see screen output like the preceding example, start nfsd by typing:

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

You should see screen output similar to the previous example. If not, contact your system administrator or your Sun authorized service provider.

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

# /usr/sbin/shareall

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

# /usr/sbin/dfshares

Screen output that resembles the following example appears:

RESOURCE SERVER ACCESS TRANSPORT server-name:product-location server-name - -

Preparing the Display Computer

1. Enable client access to the X server by typing the following at a command line:

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

Replace source-computer-name with the output of the /usr/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 install the product.

4. Mount the product files by typing:

# mount source-machine:/cdrom/studio_8_sol_sparc /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 Bourne shell, type:

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

If you use the Korn shell, type:

# export DISPLAY=source-computer-name:0.0

---

Features Included in This Release

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

• Graphical user interface installation
• Command-line installation
• Batch installation
• Solaris JumpStart installation (for the Solaris 9 operating system only)
• Serial number installation tool (snit)
• J2SE software installation
• Graphical user interface uninstallation
• Command-line uninstallation
• Batch uninstallation

This document includes instructions for using each of the features.

Installation and Setup Guide

817-5074-10

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.