C H A P T E R 5

Troubleshooting

This chapter describes how to fix problems that can occur during Sun trademark Studio 9 software installation and uninstallation.

Log Files and Serial Number Files

When you install the Sun Studio software, log files that contain a record of the installation are automatically generated.

How Can I View the Installation Log Files?

To troubleshoot installation problems by viewing the log files, do the following:

1. Go to the logs directory by typing at the prompt:

% cd /var/tmp/

2. View the file by typing:

% more Sun_Studio_Software_install.A03200125

The file extension varies for each log file.

How Do I Find the Installed Serial Number?

You need the serial number to register the product. You can find the serial number by using the snit tool.

To find and view the contents of the serial.dat file, type the following:

% /install-directory/sunstudio9/bin/snit -d -f /install-directory/sunstudio9/prod/lib/serial.dat

For more information, see the snit(1) man page. If snit is not recognized as a command, set your PATH environment variable, as described in Setting Up Access to the Developer Tools and Man Pages.

What Can I Do If I Lose My Serial Number?

If you lose your serial number and cannot view the contents of the serial.dat file or display your serial number with the snit command, contact customer support at http://wwws.sun.com/software/sundev/suncc/support.html

Installing With a Remote Display Installation

The following topics include problems that can occur during a remote display installation.

What If the Installation Fails on an NFS-Mounted Filesystem?

If the installation fails on an NFS-mounted filesystem, ensure that you have write permission on that filesystem. You can check for write permission by following the instructions below. See Choosing Local Display or Remote Display of the Installer for more information about installing on an NFS-mounted filesystem.

1. Check for write permission by typing:

% touch /net/remote-system/opt/testfile

If you receive an error message, then you do not have write permission. For example:

% touch /net/harker/opt/testfile

touch: /net/harker/opt/testfile cannot create

2. Choose another installation directory on which you have write permission, or contact your system administrator to change the filesystem permissions.

What Can I Do If the Batch Installer Stalls?

If you enter an invalid parameter when you start the batch installer, the installer stalls and does not complete the installation. Some common errors include typing an incorrect serial number, including two different directory names, or invoking the installer when you do not have enough disk space.

Follow these steps to restart the batch installer:

1. View the log files for any error messages by typing:

% cd /var/tmp/

% more Sun_Studio_Software_install.A03200125

2. To stop the installer, press Control+C.

3. To install the product using the batch installer, see Using the Batch Installer of Chapter 2.