SPARC: Installing Solaris Software
  Search only this book
Download this book in PDF

Troubleshooting

E

This appendix describes problems you may encounter when installing Solaris software, and suggests possible solutions.
The following table shows common error messages and the page number where you can find causes and possible solutions.
boot: cannot open /kernel/unixpage 171
Error: Unknown client "host_name"page 170
le0: No carrier - transceiver cable problempage 170
No network boot server. Unable to install the system. See installation instructions.page 170
pkgrm: ERROR: class action script did not complete successfully.Removal of <SUNWuodte> failed.page 171
prom_panic: Could not mount filesystempage 171
The file just loaded does not appear to be executablepage 171
Timeout waiting for ARP/RARP packet...page 172
WARNING: clock gained xxx days -- CHECK AND RESET DATE!page 172
WARNING: getfile: RPC failed: error 5 (RPC Timed out).page 173

Specific Installation Errors


  Error: Unknown client "host_name"  

Reason Error OccurredHow to Fix the Problem
The host_name argument in theAdd the host host_name to the NIS or NIS+ name service. (Either update the
add_install_client command must NIS maps or populate the NIS+ tables.) Try executing the
be a host in the name service.add_install_client command again.
le0: No carrier - transceiver cable problem
Reason Error OccurredHow to Fix the Problem
This system is not connected to theIf this is a non-networked system, ignore this message. If this is a networked
network.system, make sure the Ethernet cabling is attached securely.
No network boot server. Unable to install the system.
Reason Error OccurredHow to Fix the Problem
This error occurs on a system that youThe system administrator must set up an install server to be used for custom
are attempting to install using customJumpStart installation (see Creating an Install Server on page 22). Otherwise,
JumpStart. The system could not find ayou must do an interactive installation, as documented in Chapter 8,
local Solaris CD or an install server on"Booting and Installing Solaris: Interactive."
the network.

  pkgrm: ERROR: class action script did not complete successfully.Removal of  
  <SUNWuodte> failed.  

Reason Error Occurred........How to Fix the Problem
Problem in Solaris 2.4 and early 2.5 with Ignore the message.
building the package.

  prom_panic: Could not mount filesystem  

Reason Error Occurred........How to Fix the Problem
This error occurs when you are doing a Make sure that the installation software is mounted and shared.
network installation, but the bootIf installing from the install server's CD-ROM drive, make sure the Solaris
software cannot locate the SolarisCD is inserted in the CD-ROM drive, is mounted, and shared in the
installation image (either the Solaris CD /etc/dfs/dfstab file. If installing from a copy of the Solaris CD on the
or a copy of the Solaris CD on the install install server's disk, make sure the directory path to the copy is shared in
server).the /etc/dfs/dfstab file.
boot: cannot open /kernel/unix
Reason Error OccurredHow to Fix the Problem
This error occurs when you override the Reset the boot file in the PROM to " " (nothing).
boot file location by explicitly setting it to /kernel/unix. In Solaris 2.5, the kernel no longer resides in /kernel/unix, but in /platform/<arch>/kernel/unix.

  The file just loaded does not appear to be executable  

Reason Error OccurredHow to Fix the Problem
This message cannot find the properVerify that you are using the correct boot command for your system. If
media for booting.installing from a CD-ROM drive, make sure the Solaris CD is in the CD-ROM drive and that the CD-ROM drive is mounted. See the table for boot commands on page 128.
Timeout waiting for ARP/RARP packet...
Reason Error OccurredHow to Fix the Problem
The client is trying to boot over theVerify the system's host name is in the NIS or NIS+ name service. Also,
network, but it cannot find a system that verify the bootparams search order in the /etc/nsswitch.conf file. For
knows about it.bootparams: nis filesexample, the following line in the /etc/nsswitch.conf file indicates the software will first look in the NIS maps for bootparams information. If not found there, software will look in the /etc/bootparams file.
WARNING: clock gained xxx days -- CHECK AND RESET DATE!
Reason Error OccurredHow to Fix the Problem
This is an informational message.Ignore the message and continue with the installation.

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

Reason Error Occurred........How to Fix the Problem
This error occurs when you have two or Examine the network setup:
more servers on a network responding to an install client's boot request. The install

· Ensure that servers on the network do not have multiple

client connects to the wrong boot server,/etc/bootparams entries for the install client. If they do, remove
and the installation hangs. The followingduplicate client entries in the /etc/bootparams file on all install and
specific problems may cause this error:boot servers except the one you want the install client to use.
  • · There may be /etc/bootparams files · Ensure that servers on the network do not have multiple /tftpboot or

    on different servers with an entry for../rplboot directory entries for the install client. If they do, remove

    this install client............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.

  • · There may be multiple /tftpboot or /rplpboot directory entries for this

    install client..............(for example, * install_config=), delete it and add it to the /etc/bootparams file on the boot server.

    · If there's a wildcard entry in the name servicebootparams map or table

  • · There may 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 would look like this: * install_config=profile_server:path
A line like this in the NIS or NIS+ bootparams table would also cause this error.

General Installation Problems

ProblemHow 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.

ProblemHow to Fix the Problem
After you set up an install server andBe sure the tftpd daemon is running on the install server. Type the
configure the system to install over thefollowing command and press Return:
network, the system still does not boot.
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.
ProblemHow to Fix the Problem
OpenWindows is not available toThe /usr/openwin may be on a separate, mounted file system. This
diskless and dataless clients.directory is not automatically shared by admintool. The /usr/openwin file system must be manually added to the server's /etc/dfs/dfstab file and the file system must be shared. The entry looks like this:
share -F nfs /usr/openwin

Also, an explicit mount of the file system must be made in the client's /etc/vfstab file using the following:
server_name:/usr/openwin - /usr/openwin nfs - yes -

ProblemHow to Fix the Problem
Several processes that normally run when booting the system are not run when the system boots from the CD. (This is done to enable the system to boot and the Solaris installation program to run with only 16 Mbytes of memory.)To boot from the CD to do disaster recovery (that is, restoring the root file system), you need to add functionality normally provided when booting. To provide this functionality, a script is provided, /sbin/setup_cd, which can be run to perform the additional setup that might be needed to do disaster recovery. setup_cd does the following tasks:

- Finishes setting up the device file system for tapes and ports - Enables routing - Enables multicast - Invokes the statd(1M) daemon - Invokes the lockd(1M) daemon - Starts the automounter

Note that if setup_cd is run on a 16 Mbyte system, it may not be possible to run suninstall or other programs that need more memory. If a disk with a swap partition is available, the system administrator could avoid this problem by using the swap(1M) command to add swap space to the system before invoking setup_cd.

When booting from the CD during disaster recovery, it is possible to boot the system in single user mode from the CD. For example:

boot cdrom -s

Problem...............How to Fix the Problem
An installation using the upgrade option 1. Reboot the system from the Solaris CD or from the network.
fails for reasons beyond your control, 2. Choose the upgrade option for installation.
such as a power failure or a network...The Solaris installation program will determine if the system has been
connection failure. The system may be in partially upgraded and will continue the upgrade.
an unbootable state.