This chapter contains a list of specific error messages and general problems you might encounter when installing Solaris 9 software. The chapter also explains how to fix the problems. Start by using this list of sections to determine where in the installation process the problem occurred.
When you see the phrase “bootable media,” this means one of the installation programs: Solaris suninstall program, Solaris Web Start program, or custom JumpStart.
Unknown client “host_name”
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 name service and execute the add_install_client command again.
le0: No carrier - transceiver cable problem
The system is not connected to the network.
Solution:If this is a non-networked system, ignore this message. If this is a networked system, ensure that the Ethernet cabling is attached securely.
The file just loaded does not appear to be executable
The system cannot find the proper media for booting.
Solution:Verify that the system has been set up properly to install the Solaris 9 software from the network from an install server. For example, ensure that you specified the correct platform group for the system when you set it up.
Or, if you did not copy the images of the Solaris DVD or Solaris Software 1 of 2, Solaris Software 2 of 2, and Solaris Languages CDs to the install server, ensure the Solaris DVD or Solaris Software 1 of 2 CD is mounted and accessible on the install server.
boot: cannot open /kernel/unix(SPARC based systems only)
This error occurs when you override the location of the boot - file by explicitly setting it to /kernel/unix.
Solution:Reset the boot -file in the PROM to “ “ (blank).
Ensure that the diag-switch is set to off and to true.
Can't boot from file/device
The installation media cannot find the bootable media.
Solution:Ensure that the following conditions are met:
The DVD-ROM or CD-ROM drive is installed properly and turned on.
Solaris DVD or the Solaris Software 1 of 2 CD is inserted into the drive.
The disc is free of damage or dirt.
WARNING: clock gained xxx days -- CHECK AND RESET DATE! (SPARC based systems only)
This is an informational message.
Solution:Ignore the message and continue with the installation.
Not a UFS file system (x86 based systems only)
When Solaris 9 software was installed (either through the Solaris suninstall program or custom JumpStart), no boot disk was selected. You now must use the Solaris Device Configuration Assistant x86 Platform Edition diskette or edit the BIOS to boot the system.
Solution:Insert the Solaris Device Configuration Assistant x86 Platform Edition diskette into the system's boot diskette drive (usually drive A). For information on accessing the Solaris Device Configuration Assistant x86 Platform Edition diskette, see x86: Accessing the Solaris 9 Device Configuration Assistant and PXE.
If you cannot use the bootable media, go into the BIOS and select the BIOS to boot. See your BIOS documentation for instructions.
The Solaris Installer could not find a disk that meets the criteria found in the Install documentation. Please see the documentation for more info. (x86 based systems only)
You've tried to boot from the Solaris x86 Platform Edition Installation CD. The system does not support logical block addressing (LBA) and the Solaris Installation CD cannot be used.
Solution:Use a net image of the CD, a DVD, or the Solaris Software 1 of 2 x86 Platform Edition CD to install.
The system does not boot.
When initially setting up a custom JumpStart server, you might encounter boot problems that do not return an error message. To verify information about the system and how the system is booting, run the boot command with the -v option. When you use the -v option, the boot command displays verbose debugging information on the screen.
If this flag is not given, the messages are still printed, but the output is directed to the system logfile. For more information, see syslogd(1M).
For SPARC based systems, at the ok prompt, type the following command.
ok boot net -v - install |
b - -v install |
Boot from DVD media fails on systems with Toshiba SD—M 1401 DVD-ROM
If your system has a Toshiba SD-M1401 DVD-ROM with firmware revision 1007, the system cannot boot from the Solaris DVD.
Solution:Apply patch 111649–03, or later version, to update the Toshiba SD-M1401 DVD-ROM drive's firmware. Patch 111649–03 is included on the Solaris 9 Supplement CD.
The installation fails after booting. (x86 based systems only)
If you are installing from the Solaris Installation CD, the Solaris 9 root slice must be located within the first 1024 cylinders of the disk.
Solution:The BIOS and SCSI driver for the default boot disk must support logical block addressing (LBA). LBA enables the machine to boot beyond the 1024–cylinder limit and across Solaris disk slices. To determine if your system supports LBA, see Table 5–2. If your system does not support LBA, boot from a net image rather than the CD.
The system hangs or panics when non-memory PC cards are inserted. (x86 based systems only)
Non-memory PC cards cannot use the same memory resources used by other devices.
Solution:To correct this problem, see the instructions for your PC card and check for the address range.
The IDE BIOS primary drive on your system was not detected by the Solaris Device Configuration Assistant x86 Platform Edition diskette during the pre-booting phase. (x86 based systems only)
If you are using old drives, they might be unsupported. Check your hardware manufacturer's documentation.
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 does not matter which drive is connected to which drive connection on the cable.
If problems persist with two drives on a single controller, attach one drive at a time to verify that each drive 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 to 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.
For many systems, IDE CD-ROM drives are only recognized by MS-DOS if an MS-DOS CD-ROM driver has been installed. Try another drive.
The IDE disk or CD-ROM drive on your system was not found by the Solaris Device Configuration Assistant x86 Platform Edition diskette during the pre-booting phase. (x86 based systems only)
If disks are disabled in the BIOS, use the Solaris Device Configuration Assistant x86 Platform Edition diskette to boot from the hard disk. For information on accessing the Solaris Device Configuration Assistant, see x86: Accessing the Solaris 9 Device Configuration Assistant and PXE.
If the system has no disks, it might be a diskless client.
The system hangs before displaying the system prompt. (x86 based systems only)
You have hardware that is not supported. Check your hardware manufacturer's documentation.
WARNING: getfile: RPC failed: error 5 (RPC Timed out).
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:
Cause:Reason 1:/etc/bootparams files might exist on different servers with an entry for this install client.
Solution:Reason 1: Ensure that servers on the network do not have multiple /etc/bootparams entries for the install client. If they do have multiple entries, remove duplicate client entries in the /etc/bootparams file on all install servers and boot servers except the one you want the install client to use.
Cause:Reason 2: Multiple /tftpboot or /rplboot directory entries might exist for this install client.
Solution:Reason 2: Ensure that servers on the network do not have multiple /tftpboot or /rplboot directory entries for the install client. If they do have multiple entries, remove duplicate client entries from the /tftpboot or /rplboot directories on all install servers and boot servers except the one you want the install client to use.
Cause:Reason 3: An install client entry might exist in the /etc/bootparams file on a server and an entry in another /etc/bootparams file that enables all systems to access the profile server. Such an entry resembles the following:
* install_config=profile_server:path
A line that resembles the previous entry in the NIS or NIS+ bootparams table can also cause this error.
Solution:Reason 3: If a wildcard entry is 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. (SPARC based systems only)
This error occurs on a system that you are attempting to install from the network. The system is not set up correctly.
Solution:Ensure that you correctly set up the system to install from the network. See Adding Systems to Be Installed From the Network With a CD Image.
prom_panic: Could not mount file system(SPARC based systems only)
This error occurs when you are installing Solaris 9 from a network, but the boot software cannot locate the following:
Solaris DVD, either the DVD or a copy of the DVD image on the install server
Solaris Software 1 of 2 CD image, either the Solaris Software 1 of 2 CD or a copy of the Solaris Software 1 of 2 CD image on the install server
Ensure that the installation software is mounted and shared.
If you are installing Solaris 9 from the install server's DVD-ROM or CD-ROM drive, ensure that the Solaris DVD or Solaris 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 DVD image or Solaris Software 1 of 2 CD image on the install server's disk, ensure that the directory path to the copy is shared in the /etc/dfs/dfstab file.
See the man page, install_server.
Timeout waiting for ARP/RARP packet...(SPARC based systems only)
Reason 1: The client is trying to boot from the network, but it cannot find a system that knows about the client.
Solution:Reason 1: 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 suninstall program first looks in the NIS maps for bootparams information. If the program does not find any information, the JumpStart program or the Solaris suninstall program looks in the boot server's /etc/bootparams file.
bootparams: nis filesCause:
Reason 2: The client's Ethernet address is not correct.
Solution:Reason 2: Verify that the client's Ethernet address in the install server's /etc/ethers file is correct.
Cause:Reason 3: In a custom JumpStart installation, the add_install_client command specifies the platform group that uses a specified server as an install server. If the wrong architecture value is used when using the add_install_client, this problem occurs. For example, the machine you want to install is a sun4u, but you used sun4m instead.
Solution:Reason 3: Rerun add_install_client with the correct architecture value.
ip: joining multicasts failed on tr0 - will use link layer broadcasts for multicast (x86 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.
Solution:Ignore this error message. If multicast does not work, IP uses layer broadcasts instead and does not cause the installation to fail.
Requesting Internet address for Ethernet_Address (x86 based systems only)
The client is trying to boot from the network, but it cannot find a system that knows about the client.
Solution:Verify the system's host name is listed in the 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... (x86 based systems only)
The client is trying to boot from the network, but it cannot find a system with an entry in the /etc/bootparams file on the install server.
Solution: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 from the network.
Still trying to find a RPL server... (x86 based systems only)
The system is trying to boot from the network, but the server is not set up to boot this system.
Solution: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.
CLIENT MAC ADDR: FF FF FF FF FF FF (network installations with DHCP only)
The DHCP server is not configured correctly. This error might occur if the options or macros are not correctly defined in the DHCP Manager software.
Solution:In the DHCP Manager software, verify that the options and macros are correctly defined. Confirm that the Router option is defined, and that the value of the Router option is correct for the subnet you are using for the network installation.
The system boots from the network, but from a system other than the specified install server.
An /etc/bootparams and perhaps /etc/ethers entry exist on another system for the client.
Solution:On the name server, update the /etc/bootparams entry for the system that is being installed. The entry should conform to the following syntax:
install_system root=boot_server:path install=install_server:path
Also, ensure that only one bootparams entry is on the subnet for the install client.
After you set up an install server and configure the system to install Solaris 9 from the network, the system still does not boot. (SPARC based systems only)
The tftpd might not be running on the install server.
Solution:Be sure the tftpd daemon is running on the install server. Type the following command:
# ps -ef | grep tftpd |
If this command does not return a line that indicates that 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.
After setting up an install server and configuring the system to install from the network, the system still does not boot. (x86 based systems only)
The rpld daemon might not be running on the install server.
Solution:Be sure the rpld daemon is running on the install server. Type the following command:
# 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.
Initial installation fails
If the Solaris installation fails, you must restart the installation. To restart the installation, boot the system from the Solaris DVD, Solaris Installation CD, the Solaris Software 1 of 2, or from the network.
You cannot uninstall the Solaris software after the software has been partially installed. You must restore your system from a backup or begin the Solaris installation process again.
/cdrom/Solaris_9/SUNWxxxx/reloc.cpio: Broken pipe
This error message does not affect the installation.
Solution:Ignore the message and continue with the installation.
WARNING: CHANGE DEFAULT BOOT DEVICE (x86 based systems only)
This is an informational message. The default boot device set in the system's BIOS might be set to a device that requires you to use the Solaris Device Configuration Assistant x86 Platform Edition diskette to boot the system.
Solution:Continue with the installation and, if necessary, change the system's default boot device specified in the BIOS after you install the Solaris software to a device that does not require the Solaris Device Configuration Assistant x86 Platform Edition diskette.
IDE disk drives do not automatically map out bad blocks like other drives supported by Solaris software. Before installing Solaris 9 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.
Boot to the installation media in single-user mode.
# b -s |
Start the format program.
# format |
Specify the IDE disk drive on which you want to perform a surface analysis.
# cxdy |
Is the controller number
Is the device number
You need an fdisk partition.
If a Solaris fdisk partition already exists, proceed to Step 5.
If a Solaris fdisk partition does not exist, use the fdisk command to create a Solaris partition on the disk.
format> fdisk |
Type:
format> analyze |
Type:
analyze> config |
The current settings for a surface analysis are displayed.
Type:
analyze> type_of_surface_analysis |
Is read, write, or compare
If format finds bad blocks, it re-maps them.
Type:
analyze> quit |
Do you want to specify blocks to re-map?
If no, go to Step 10.
If yes, type:
format> repair |
Type:
quit |
The format program quits.
To restart the media in multiuser mode, type:
ok b |
No upgradable disks
A swap entry in the /etc/vfstab file is causing the upgrade to fail.
Solution:Comment out the following lines in the /etc/vfstab file:
All swap files and slices on disks not being upgraded
Swap files that are no longer present
Any unused swap slices
usr/bin/bzczt not found
Solaris Live Upgrade fails because of needing a patch cluster.
Solution:A patch is needed to install Solaris Live Upgrade. Go to http://sunsolve.sun.com for the patch.
Upgradeable Solaris root devices were found, however, no suitable partitions to hold the Solaris install software were found. Upgrading using the Solaris Installer is not possible. It might be possible to upgrade using the Solaris Operating Environment 1 of 2 CDROM. (x86 based systems only)
You cannot upgrade with Solaris x86 Platform Edition Installation CD because you do not have enough space.
Solution:To upgrade, you can either create a swap slice that is larger than or equal to 512 Mbytes or use another method of upgrading such as the following:
The Solaris Web Start program from Solaris DVD or a net installation image
The Solaris suninstall program from the Solaris Software 1 of 2 x86 Platform Edition CD
Custom JumpStart
The upgrade option is not presented even though there is a version of Solaris software that's upgradable on the system.
Reason 1: The /var/sadm directory is a symlink or it is mounted from another file system.
Solution:Reason 1: Move the /var/sadm directory into the root (/) or /var file system.
Cause:Reason 2: The /var/sadm/softinfo/INST_RELEASE file is missing.
Solution:Reason 2: Create a new INST_RELEASE file by using the following template:
OS=Solaris VERSION=x REV=0
Is the version of Solaris software on the system
Reason 3: SUNWusr is missing from /var/sadm/softinfo.
Solution:Solution 3: You need to do an initial installation. The Solaris software is not upgradable.
Couldn't shut down or initialize the md driver
If not a mirror, comment out in the vsftab file.
If a mirror, break the mirror and reinstall.
The upgrade fails because the Solaris installation program cannot mount a file system.
During an upgrade, the script attempts to mount all the file systems that are listed in the system's /etc/vfstab file on the root (/) file system that is being upgraded. If the installation script cannot mount a file system, it fails and exits.
Ensure that all file systems in the system's /etc/vfstab file can be mounted. Comment out any file systems in the /etc/vfstab file that cannot be mounted or that might cause the problem so that the Solaris suninstall program does not try to mount them during the upgrade. Any system-based file systems that contain software to be upgraded (for example, /usr) cannot be commented out.
The upgrade fails
The system does not have enough space for the upgrade.
Cause:Check Chapter 5, System Requirements and Guidelines (Planning) for the space problem and see if you can fix it without using auto-layout to reallocate space.
Problems upgrading mirrored roots
If you have problems upgrading when using Solaris Volume Manager mirrored roots, see “Troubleshooting Solaris Volume Manager (Tasks)” in Solaris Volume Manager Administration Guide.
The upgrade fails and the system cannot be soft-booted. The failure is for reasons beyond your control, such as a power failure or a network connection failure.
Reboot the system from the Solaris DVD, Solaris Installation CD, the Solaris Software 1 of 2 CD, or from the network.
Choose the upgrade option for installation.
The Solaris installation program determines if the system has been partially upgraded and continues the upgrade.
When using Solaris Live Upgrade while upgrading and running Veritas VxVM, the system panics on reboot unless you upgrade by using the following procedure. The problem occurs if packages do not conform to Solaris advanced packaging guidelines.
Create an inactive boot environment. See Creating a New Boot Environment.
Before upgrading the inactive boot environment, you must disable the existing Veritas software on the inactive boot environment.
Mount the inactive boot environment.
# lumount inactive_boot_environment_name mount_point |
For example:
# lumount solaris8 /.alt.12345 |
Change to the directory that contains the vfstab, for example:
# cd /.alt.12345/etc |
Make a copy of the inactive boot environment's vfstab file, for example:
# cp vfstab vfstab.501 |
In the copied vfstab, comment out all Veritas file system entries, for example:
# sed '/vx\/dsk/s/^/#/g' < vfstab > vfstab.novxfs |
The first character of each line is changed to #, which makes the line a comment line. Note that this comment line is different than the system file comment lines.
Copy the changed vfstab file, for example:
# cp vfstab.novxfs vfstab |
Change directories to the inactive boot environment's system file, for example:
# cd /.alt.12345/etc |
Make a copy of the inactive boot environment's system file, for example:
# cp system system.501 |
Comment out all “forceload:” entries that include drv/vx.
# sed '/forceload: drv\/vx/s/^/*/' <system> system.novxfs |
The first character of each line is changed to *, which makes the line a command line. Note that this comment line is different than the vfstab file comment lines.
Change directories to the install-db file on the inactive boot environment, for example:
# cd /.alt.12345/etc |
Create the Veritas install-db file, for example:
# touch vx/reconfig.d/state.d/install-db |
Unmount the inactive boot environment.
# luumount inactive_boot_environment_name mount_point |
Upgrade the inactive boot environment. See Chapter 36, Upgrading With Solaris Live Upgrade (Tasks).
Activate the inactive boot environment. See Activating a Boot Environment.
Shut down the system.
# init 0 |
Boot the inactive boot environment in single-user mode:
OK boot -s |
Several messages and error messages that contain “vxvm” or “VXVM” are displayed that can be ignored. The inactive boot environment becomes active.
Upgrade Veritas.
Restore the original vfstab and system files:
# cp /etc/vfstab.original /etc/vfstab # cp /etc/system.original /etc/system |
Reboot the system.
# init 6 |
If you install the Solaris 9 operating environment on a system that does not currently include a Service partition, the installation program might not create a Service partition by default. If you want to include a Service partition on the same disk as the Solaris partition, you must recreate the Service partition before you install the Solaris 9 operating environment.
If you installed the Solaris 8 2/02 operating environment on a Sun LX50 system, the installation program might not have preserved the Service partition. If you did not manually edit the fdisk boot partition layout to preserve the Service partition, the installation program deleted the Service partition during the installation.
If you did not specifically preserve the Service partition when you installed the Solaris 8 2/02 operating environment, you might not be able to recreate the Service partition and upgrade to the Solaris 9 operating environment.
If you want to include a Service partition on the disk that contains the Solaris partition, choose one of the following workarounds.
To use the Solaris Web Start installation program to install from the Solaris 9 Installation CD, follow these steps.
Delete the contents of the disk.
Before you install, create the Service partition by using the Sun LX50 Diagnostics CD.
For information on how to create the Service partition, see the Sun LX50 Server User's Manual and the Sun LX50 Knowledge Base at http://cobalt-knowledge.sun.com.
Insert the Solaris 9 Installation CD in the CD-ROM drive.
Begin installing the Solaris 9 operating environment.
When the installation program detects the Service partition, the following message is displayed.
The default layout for the bootdisk is one x86 Boot partition and a Solaris partition on the remaining space. The Service fdisk partition, if one exists, is also preserved by default. Select one of the following to continue: 1) Use the default layout 2) Run fdisk to manually edit the disk 3) Exit Please make a selection: [?] |
Type 1 to use the default layout.
The installation program preserves the Service partition and creates the x86 boot partition and the Solaris partition.
The Solaris Web Start installation program creates the x86 boot partition by removing 10 Mbytes from the Solaris fdisk partition. This utility prevents any existing fdisk partitions from being altered. Do not create this partition manually.
Complete the installation.
To install from a network installation image or from the Solaris 9 DVD over the network, follow these steps.
Delete the contents of the disk.
Before you install, create the Service partition by using the Sun LX50 Diagnostics CD.
For information on how to create the Service partition, see the Sun LX50 Server User's Manual and the Sun LX50 Knowledge Base at http://cobalt-knowledge.sun.com.
Boot the system from the network.
The Customize fdisk Partitions screen is displayed.
To load the default boot disk partition layout, click Default.
The installation program preserves the Service partition and creates the x86 boot partition and the Solaris partition.
To use the suninstall program to install from the Solaris 9 Software 1 of 2 CD or from a network installation image on a boot server, follow these steps.
Delete the contents of the disk.
Before you install, create the Service partition by using the Sun LX50 Diagnostics CD.
For information on how to create the Service partition, see the Sun LX50 Server User's Manual and the Sun LX50 Knowledge Base at http://cobalt-knowledge.sun.com.
Boot the system.
The installation program prompts you to choose a method for creating the Solaris partition.
Select the Use rest of disk for Solaris partition option.
The installation program preserves the Service partition and creates the Solaris partition.
Complete the installation.