Solaris 8 Advanced Installation Guide

Chapter 12 Troubleshooting

This chapter contains a list of specific error messages and general problems you might encounter when installing Solaris 8 software and explains how to fix the problems. Start by using this list of sections in this chapter to determine where in the installation process the problem occurred.

Setting Up Network Installations


Error: Unknown client "host_name"
 

Problem 

How to fix the problem 

The host_name argument in the add_install_client command is not a host in the name service.

Add the host host_name to the NIS or NIS+ name service and execute the add_install_client command again.

Booting a System

Error Messages


le0: No carrier - transceiver cable problem
 

Problem 

How to fix the problem 

The system is not connected to the network. 

If this is a non-networked system, ignore this message. If this is a networked system, make sure the Ethernet cabling is attached securely. 


The file just loaded does not appear to be executable
 

Problem 

How to fix the problem 

The system cannot find the proper media for booting. 

Verify that the system has been set up properly to install Solaris 8 over the network from an install server. For example, make sure you specified the right platform group for the system when you set it up. Also, if you did not copy the images of the CDs labeled Solaris 8 Software 1 of 2, Solaris 8 Software 2 of 2, and Solaris 8 Languages to the install server, make sure the CD labeled Solaris 8 Software 1 of 2 is mounted and accessible on the install server. 


boot: cannot open /kernel/unix
 

Problem 

How to fix the problem 

SPARC based systems only

This error occurs when you override the location of the boot file by explicitly setting it to /kernel/unix. In Solaris 2.6 and subsequent releases, the kernel is no longer located in /kernel/unix, but in /platform/arch/kernel/unix.

Reset the boot file in the PROM to " " (blank). 


Can't boot from file/device                                        
 

Problem 

How to fix the problem 

JumpStart or the Solaris 8 Interactive Installation Program can't find the CD labeled Solaris 8 Software 1 of 2 for your platform in the system's CD-ROM drive. 

Make sure the: 

  • CD-ROM drive is installed properly and turned on

  • CD labeled Solaris 8 Software 1 of 2 is inserted into the CD-ROM drive


WARNING: clock gained xxx days -- CHECK AND RESET
DATE!
 

Problem 

How to fix the problem 

SPARC based systems only

This is an informational message. 

Ignore the message and continue with the installation. 


Not a UFS filesystem
 

Problem 

How to fix the problem 

IA based systems only

When Solaris 8 software was installed (either through the Solaris 8 Interactive Installation Program or custom JumpStart), the default boot drive was not selected. When an alternate boot disk is selected, you must use the diskette labeled Solaris 8 Device Configuration Assistant Intel Platform Edition to boot the system from that point on. 

Insert the diskette labeled Solaris 8 Device Configuration Assistant Intel Platform Edition into the system's boot diskette drive (usually the A: drive). 

General Problems

Problem 

How to fix the problem 

IA based systems only

The system hangs or panics when non-memory PC cards are inserted. 

Non-memory PCs cannot use the same memory resources used by other devices. To correct this problem, use a DOS debugger to identify device memory usage, then manually reserve memory resources for the PC card device using the following instructions: 

  1. Boot the system using the diskette labeled Solaris 8 Device Configuration Assistant Intel Platform Edition.

  2. Go to the Device Tasks menu.

  3. Select Review/Edit Devices.

  4. Select Add Device.

  5. Select Define Device.

  6. Enter a unique name following the EISA ID naming conventions (for example, ITD4001), and select Continue.

  7. Select Memory Address from the list of resources, and select Continue.

  8. Enter the address range to reserve (for example, CA800-CFFFF), and select Continue.

  9. Return to the Device Tasks menu and select Save Configuration.

  10. Reboot the system.

Problem 

How to fix the problem 

IA based systems only

The IDE BIOS primary drive on your system was not detected by the Solaris 8 Device Configuration Assistant during the pre-booting phase. 

  • If you are using old drives, they might be unsupported. Check the Solaris 8 (Intel Platform Edition) Hardware Compatibility List.

  • Make sure the ribbon and power cables are plugged in correctly. Check the manufacturer's documentation.

  • If only one drive is attached to the controller, designate the drive as the master drive by setting jumpers. Some drives have different jumper settings for a single master, as opposed to a master operating with a slave. Connect the drive to the connector at the end of the cable to reduce signal ringing that occurs when an unused connector is dangling at the end of the cable.

  • If two drives are attached to the controller, jumper one drive as the master (or as a master operating with a slave), and jumper the second drive as a slave.

  • If one drive is a hard disk and the second a CD-ROM drive, designate one drive as the slave drive by setting jumpers. It doesn't matter which drive is plugged into which drive connection on the cable.

  • If there are persistent problems with two drives on a single controller, attach one drive at a time to verify that each works. Jumper the drive as master or single master, and use the drive connector at the end of the IDE ribbon cable to attach the drive. Verify that each drive works, then jumper the drives back into a master and slave configuration.

  • If the drive is a disk drive, use the BIOS setup utility to ensure that the drive type (which indicates the number of cylinders, heads, and sectors) is configured correctly. Some BIOS software might have a feature that automatically detects the drive type.

  • If the drive is a CD-ROM drive, use the BIOS setup screen to configure the drive type as a CD-ROM drive, provided the BIOS software offers this capability.

  • If MS-DOS does not recognize the drive, there is probably a hardware or BIOS configuration problem. For many systems, IDE CD-ROM drives are only recognized by MS-DOS if an MS-DOS CD-ROM driver has been installed.

Problem 

How to fix the problem 

IA based systems only

The IDE disk or CD-ROM drive on your system was not found by the Solaris 8 Device Configuration Assistant in the pre-booting phase. 

  • If disks are disabled in the BIOS, use the Solaris 8 Device Configuration Assistant Intel Platform Edition to boot from the hard disk.

  • If the system has no disks, it might be a diskless client.

Problem 

How to fix the problem 

IA based systems only

The system hangs before displaying the system prompt. 

See the Solaris 8 (Intel Platform Edition) Hardware Compatibility List.

Booting a System Over the Network

Error Messages


WARNING: getfile:
RPC failed: error 5 (RPC Timed out).
 

Problem 

How to fix the problem 

This error occurs when you have two or more servers on a network responding to an install client's boot request. The install client connects to the wrong boot server, and the installation hangs. The following specific reasons might cause this error to occur: 

 

Reason 1: There might be /etc/bootparams files on different servers with an entry for this install client.

Solution for Reason 1: Make sure that servers on the network do not have multiple /etc/bootparams entries for the install client. If they do, remove duplicate client entries in the /etc/bootparams file on all install and boot servers except the one you want the install client to use.

Reason 2: There might be multiple /tftpboot or /rplboot directory entries for this install client.

Solution for Reason 2: Make sure that servers on the network do not have multiple /tftpboot or /rplboot directory entries for the install client. If they do, remove duplicate client entries from the /tftpboot or /rplboot directories on all install and boot servers except the one you want the install client to use.

Reason 3: There might be an install client entry in the /etc/bootparams file on a server and an entry in another /etc/bootparams file enabling all systems to access the profile server. Such an entry looks like this:

* install_config=profile_server:path

A line like this in the NIS or NIS+ bootparams table can also cause this error.

Solution for Reason 3: If there's a wildcard entry in the name service bootparams map or table (for example, * install_config=), delete it and add it to the /etc/bootparams file on the boot server.


No network boot server. Unable to install the system.
 See installation instructions.
 

Problem 

How to fix the problem 

SPARC based systems only

This error occurs on a system that you are attempting to install over the network. The system is not set up correctly. 

Make sure you correctly set up the system to install over the network (see "Setting Up Systems to Be Installed Over the Network").


prom_panic: Could not mount filesystem
 

Problem 

How to fix the problem 

SPARC based systems only

This error occurs when you are installing Solaris 8 over a network, but the boot software cannot locate the Solaris 8 Software 1 of 2 CD image (either the CD labeled Solaris 8 Software 1 of 2 or a copy of the Solaris 8 Software 1 of 2 CD image on the install server). 

Make sure that the installation software is mounted and shared.  

If you are installing Solaris 8 from the install server's CD-ROM drive, make sure the CD labeled Solaris 8 Software 1 of 2 is inserted in the CD-ROM drive, is mounted, and is shared in the /etc/dfs/dfstab file. If installing from a copy of the Solaris 8 Software 1 of 2 CD image on the install server's disk, make sure the directory path to the copy is shared in the /etc/dfs/dfstab file.


Timeout waiting for ARP/RARP packet...
 

Problem 

How to fix the problem 

SPARC based systems only

The client is trying to boot over the network, but it cannot find a system that knows about the client. 

Verify the system's host name is in the NIS or NIS+ name service. Also, verify the bootparams search order in the boot server's /etc/nsswitch.conf file.

For example, the following line in the /etc/nsswitch.conf file indicates that JumpStart or the Solaris 8 Interactive Installation Program first looks in the NIS maps for bootparams information. If not found there, JumpStart or the Solaris 8 Interactive Installation Program looks in the boot server's /etc/bootparams file.

bootparams: nis files


ip: joining multicasts failed on tr0 - will use link layer broadcasts for multicast
 

Problem 

How to fix the problem 

IA based systems only

This error message is displayed when you boot a system with a token ring card. Ethernet multicast and token ring multicast do not work the same way. The driver returns this error message because an invalid multicast address was provided to it.

Ignore this error message. If multicast doesn't work, IP uses layer broadcasts instead and it won't cause the installation to fail. 


Requesting Internet address for Ethernet_Address
 

Problem 

How to fix the problem 

IA based systems only

The client is trying to boot over the network, but it cannot find a system that knows about the client.  

Verify the system's host name is listed in the NIS or NIS+ name service. If the system's host name is listed in the NIS or NIS+ name service, and the system continues to print this error message, try rebooting. 


RPC: Timed out
No bootparams (whoami) server responding; still trying...
 

Problem 

How to fix the problem 

IA based systems only

The client is trying to boot over the network, but it cannot find a system with an entry in the /etc/bootparams file on the install server.

Use add_install_client on the install server. Using this command adds the proper entry in the /etc/bootparams file, enabling the client to boot over the network.


Still trying to find a RPL server...
 

Problem 

How to fix the problem 

IA based systems only

The system is trying to boot over the network, but the server is not set up to boot this system. 

On the install server, execute add_install_client for the system to be installed. The add_install_client command sets up an /rplboot directory, which contains the necessary network boot program.

General Problems

Problem 

How to fix the problem 

The system boots over the network, but from a system other than the specified install server.

On the name server, update the /etc/bootparams entry for the system being installed. The entry should conform to the following syntax:

install_system root=boot_server:path install=install_server:path

Also, ensure there is only one bootparams entry on the subnet for the install client.

Problem 

How to fix the problem 

SPARC based systems only

After you set up an install server and configure the system to install Solaris 8 over the network, the system still does not boot. 

Be sure the tftpd daemon is running on the install server. Type the following command and press Return:


# ps -ef | grep tftpd

If this command does not return a line indicating the tftpd daemon is running, edit the /etc/inetd.conf file and remove the comment (#) character from the following line:

# tftp dgram udp
wait root /usr/sbin/in.tftpd
in.tftpd -s /tftpboot

After making this change, try booting the system again. 

Problem 

How to fix the problem 

IA based systems only

After setting up an install server and configuring the system to install over the network, the system still does not boot. 

Be sure the tftpd daemon is running on the install server. Type the following command and press Enter:


# ps -ef | grep rpld

If this command does not return a line indicating the rpld daemon is running, execute the following command:

 


# /usr/sbin/rpld

After making this change, try booting the system again. 

Installing Solaris 8 (Initial)


/cdrom/Solaris_2.x/SUNWxxxx/reloc.cpio: Broken pipe

Problem 

How to fix the problem 

Bug ID: 1212370 

This error message does not affect the installation. 

Ignore the message and continue with the installation. 

Problem 

How to fix the problem 

IA based systems only

IDE disk drives do not automatically map out bad blocks like other drives supported by Solaris software. Before installing Solaris 8 on an IDE disk, you might want to perform a surface analysis on the disk.

To perform surface analysis on an IDE disk, follow this procedure: 

  1. Start the Solaris 8 Interactive Installation Program, as described in "IA: Using the Solaris 8 Interactive Installation Program". The Solaris 8 Interactive Installation Program starts either a graphical user interface (GUI) or a character user interface (CUI), depending on whether you have a graphics or non-graphics monitor.

  2. When either the GUI or CUI program starts, enter information and select Continue on the first few screens.

  3. When you see the Installing Solaris - Initial screen, select Exit and exit the installation.

  4. If you are using the GUI version of the Solaris 8 Interactive Installation Program, open a command tool window for the remaining steps in this procedure.

    If you are using the CUI version of the Solaris 8 Interactive Installation Program, use the system shell for the remaining steps in this procedure.

  5. Start the format program by typing format.

  6. Specify the IDE disk drive on which you want to perform a surface analysis.


Note -

IDE drives do not include a target number. The IDE drive naming convention is cxdy, where cx is the controller number and dy is the device number.


 
  1. At the format> prompt, type fdisk. Use the fdisk command to create a Solaris 8 partition on the disk. (If a Solaris 8 fdisk partition already exists, leave it alone.)

  2. At the format> prompt, type analyze.

  3. At the analyze> prompt, type config. The current settings for a surface analysis are displayed. If you want to change settings, type setup.

  4. At the analyze> prompt, type read, write, or compare for the type of surface analysis to be performed. If format finds bad blocks, it re-maps them.

  5. At the analyze> prompt, type quit.

  6. Do you want to specify blocks to re-map?

    If no, go to the next step. If yes, at the format> prompt, type repair.

  7. Type quit.

    The format program quits.

  8. Choose Restart Install on the Workspace menu to resume the GUI installation, or type suninstall to resume the CUI installation.

Installing Solaris 8 (Upgrade)

General Problems

Problem 

How to fix the problem 

The upgrade fails because the Solaris 8 Interactive Installation Program could not mount metadevices on the system. 

Metadevices cannot be upgraded automatically. Instructions are provided in "Upgrading to Other Solaris Versions" in the Solstice DiskSuite 4.2 Reference Guide.

Problem 

How to fix the problem 

The upgrade fails for reasons beyond your control, such as a power failure or a network connection failure, and the system cannot be soft-booted.

  1. Reboot the system from the CD labeled Solaris 8 Software 1 of 2 for your platform or from the network.

  2. Choose the upgrade option for installation.

The Solaris 8 Interactive Installation Program determines if the system has been partially upgraded and continues the upgrade. 

Problem 

How to fix the problem 

The upgrade fails because the Solaris 8 Interactive Installation Program cannot mount a file system. During an upgrade, the script attempts to mount all the file systems listed in the system's /etc/vfstab file on the root (/) file system being upgraded. If the installation script cannot mount a file system, it fails and exits.

Make sure all file systems in the system's /etc/vfstab file can be mounted. Comment out any file systems in the /etc/vfstab file that can't be mounted or that might cause the problem so the Solaris 8 Interactive Installation Program doesn't try to mount them during the upgrade.


Note -

Any system-based file systems that contain software to be upgraded (for example, /usr) cannot be commented out.


Problem 

How to fix the problem 

There is not enough space on the system for the upgrade. Check the following reasons for the space problem and see if you can fix it without using auto-layout to reallocate space:

 

Reason 1: Since the automounter is not active during an upgrade, the Solaris 8 Interactive Installation Program installs any package's files or directories that are symbolic links to automounted file systems. If a symbolic link is overwritten, the upgrade might fail because of insufficient disk space.


Note -

The /var/mail and /var/news directories, which are usually located on an automounted file system, are not affected by an upgrade.


Solution for Reason 1: During the upgrade, delete software packages in the Customize Software screen that create files or directories on the automounted file systems. Then the Solaris 8 Interactive Installation Program does not overwrite the symbolic link with a package's files or directories.

Reason 2: New software has been added to the software group that you are upgrading or some of the existing software has increased in size. During an upgrade, the Solaris 8 Interactive Installation Program installs any new software that is part of the software group previously installed on the system, and it also upgrades any existing packages on the system.

Solution for Reason 2: During the upgrade, delete software packages in the Customize Software screen that install into the file systems that need more space. Especially look for any new packages that have been added to the Solaris release that the system doesn't need.

Problem 

How to fix the problem 

During an upgrade, a message is displayed regarding some of the packages (including SUNWolrte, SUNWoldcv, SUNWoldte, SUNWolaud).

An example of this message is:  

Doing pkgadd of SUNWolrte to /

This message indicates an attempt to install the same architecture and version of a package that is already installed.  

Installation of SUNWolrte was successful...

No action is required; this message is informational only.