This chapter describes problems that relate to the installation of the Solaris 9 operating environment.
The following installation bug descriptions have been added to this chapter since this document was published on the Solaris 9 Documentation CD and in the Installation Kiosk on the Solaris 9 Installation CD.
"Media With UFS or UDFS File Systems Do Not Mount When Media Is Inserted Multiple Times (4638163)"
"Cannot Access Storage Area Networks Through SUNWsan With Solaris 9 Operating Environment"
"Uninstall Mode of Solaris 9 Documentation CD uninstaller Utility Does Not Work Properly (4675797)"
"Solaris 9 Documentation 2 of 2 CD Installs Simplified Chinese Documentation By Default (4673521)"
"English and European ISO-15 Locales Might Not Install Correctly (4645678)"
"Installing Only Some European Locales Causes Characters to Not Display in UTF-8 Locale (4634077)"
The Solaris 9 operating environment requires a memory size of 128 Mbytes or greater.
The Solaris 9 operating environment is now available on DVD. To install or upgrade from DVD, insert the Solaris 9 DVD into the DVD-ROM drive and boot the system from the ok prompt with the following command.
ok boot cdrom |
If you use the Solaris 9 Software DVD to install additional software, the additional software might not be installed. This problem might occur under the following conditions.
You use the command line mode to install from the Solaris 9 Software DVD.
During the installation, you indicate that you do not want the system to eject the DVD automatically.
You install optional software, such as the SunScreen 3.2 application, products on the Solaris 9 Software Supplement CD, or products on the Solaris Software Companion CD.
If this problem occurs, the following error message displays.
The disc you inserted is not the correct CD/DVD for optional-software-name. Please try again. |
Workaround: Choose one of the following workarounds.
To avoid this problem, select Yes (the default setting) when the installation program asks you if you want to eject the DVD automatically.
If you receive the previous error message, and if the machine has remote login access, follow these steps.
Remote login to the machine.
Become superuser.
Eject the DVD by typing the following command.
# eject cdrom |
Continue with the installation. When the installation program prompts you, reinsert the Solaris 9 Software DVD in the machine you are installing.
If you receive the previous error message, manually install the optional software. Follow these steps.
When you receive the error message, select the Skip This Disc option. Select this option to skip all the remaining optional software installations.
Complete the installation.
After the system reboots, log in to the system and manually run the installers for the optional software. Choose the appropriate installer command.
To install the SunScreen 3.2 product, insert the Solaris 9 Software DVD and type the following command.
# /dvd-mount-point/s0/Solaris_9/ExtraValue/CoBundled/SunScreen_3.2/install \ -nodisplay |
To install Solaris 9 Software Supplement products, insert the Solaris 9 Software DVD and type the following command.
# /dvd-mount-point/s0/SW_Supp_CD/installer -nodisplay |
To install the Solaris Software Companion CD, insert the CD and type the following command.
# /cd-mount-point/installer -nodisplay |
If your system has a Toshiba SD-M1401 DVD-ROM drive with firmware revision 1007, the system cannot boot from the Solaris 9 DVD.
Workaround: 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 in the following directory.
DVD_Firmware/Patches |
See the README file in this directory for instructions on installing the patch. Be sure to read and follow all the cautions and warnings in this README file before you install the patch.
CD or DVD media that is formatted with UFS or UDFS file systems might not mount on systems with certain media drives under the following conditions.
The system is running the Solaris 9 operating environment.
Volume Management (vold) is running on the system.
You insert, remove, and reinsert the media.
A mount: I/O error message might display on the system console. The file system on the media is not mounted, and the File Manager graphical user interface for the media is not displayed.
Workaround: In the /etc/rmmount.conf file, add the following line before the line that reads mount * hsfs udfs ufs -o nosuid.
mount cdrom* hsfs udfs ufs -o nosuid ro |
You must enter this line before the line that reads mount * hsfs udfs ufs -o nosuid. After you add this line, the mount section of the /etc/rmmount.conf file should read as follows.
mount cdrom* hsfs udfs ufs -o nosuid ro mount * hsfs udfs ufs -o nosuid |
If your system is running the Solaris 2.6 or Solaris 7 operating environment, Volume Management incorrectly mounts the Solaris 9 DVD. The Solaris 9 DVD can be mounted, but the data is inaccessible. As a result, you cannot set up an install server, perform a Live Upgrade, or access any data on the media.
Workaround: Choose one of the following workarounds.
Apply the patches appropriate for your system.
Table 1-1 DVD patches for the Solaris 2.6 and Solaris 7 Operating Environments
Release |
Patch ID |
---|---|
Solaris 2.6 operating environment |
107618-03 |
Solaris 7 operating environment |
107259-03 |
Manually mount the Solaris 9 DVD. Do not use Volume Management to mount the Solaris 9 DVD. Follow these steps.
Become superuser.
Stop Volume Management.
# /etc/init.d/volmgt stop |
Manually mount the DVD.
# mkdir /mnt1 # mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /mnt1 |
Verify that the DVD is mounted and the data is accessible.
# cd /mnt1 # ls |
The system returns the following information if the DVD is correctly mounted.
Copyright Solaris_9 |
If you install or upgrade to the Solaris 9 operating environment on a system with multiple network interfaces, the system recognizes all system interfaces as usable. Interfaces that are not plugged in to the network or that are not intended for use appear in the output of the ifconfig -a command. Additionally, interfaces with identical ethernet addresses might be assigned to identical IP addresses. The following error message is displayed.
ifconfig: setifflags: SIOCSLIFFLAGS: qfe3: Cannot assign requested address |
This problem also occurs on systems that have the local-mac-address
PROM variable set to false. The problem occurs because all interfaces are configured with the same IP address.
Workaround: Choose one of the following workarounds.
To plumb only the configured interface, reboot the system after the initial boot.
To assign a different IP address to each network interface, set the local-mac-address
PROM variable to true in one of the following ways.
At the ok prompt, type the following command.
ok setenv local-mac-address? true |
In a terminal window, type the following command as superuser.
# eeprom local-mac-address?=true |
If you use the default Solaris JumpStartTM profile on the Solaris 9 media to install multiple locales on a system with a small disk, the installation might fail. This problem might occur under the following conditions.
You use the default Solaris JumpStart profile to install any locale other than the C locale on a system with a 2.1 Gbyte disk
You use the default Solaris JumpStart profile to install two or more locales on a system with a 4 Gbyte disk
When a file system is created during installation, one of the following warning messages might be displayed.
Warning: inode blocks/cyl group (87) >= data blocks (63) in last cylinder group. This implies 1008 sector(s) cannot be allocated. |
Warning: 1 sector(s) in last cylinder unallocated |
Workaround: Ignore the warning message.
If your Solaris 8 system is connected to storage area networks (SANs), check with your support engineer before you upgrade to the Solaris 9 operating environment. Solaris 8 systems with the SUNWsan package installed might require special procedures to upgrade to the Solaris 9 operating environment. To find out if the SUNWsan package is installed on the system, type the following command in a terminal window.
# pkginfo SUNWsan |
If the SUNWsan package is installed, the following information is displayed.
system SUNWsan SAN Foundation Kit |
If you want to upgrade to the Solaris 9 operating environment and you have Solaris Management Console 1.0, 1.0.1, or 1.0.2 software installed, you must first uninstall the Solaris Management Console software before you upgrade. Solaris Management Console 2.1 software is not compatible with Solaris Management Console 1.0, 1.0.1, or 1.0.2 software. Solaris Management Console software might exist on your system if you installed the SEAS 2.0 overbox, the SEAS 3.0 overbox, or the Solaris 8 Admin Pack.
Workaround: Choose one of the following workarounds.
Before you upgrade, run /usr/bin/prodreg and perform a full uninstall of Solaris Management Console software.
If you did not uninstall Solaris Management Console 1.0, 1.0.1, or 1.0.2 software before you upgraded to the Solaris 9 operating environment, you must remove all Solaris Management Console 1.0, 1.0.1, or 1.0.2 packages. You must use pkgrm for package removal instead of prodreg, and you must carefully follow the order of package removal. Follow these steps.
Become superuser.
In a terminal window, type the following command.
# pkginfo | grep "Solaris Management Console" |
The package names in the output identify a Solaris Management Console 1.0 package if the description does not start with "Solaris Management Console 2.1."
Use pkgrm to remove all instances of Solaris Management Console 1.0 packages in the following order.
Do not remove any package that has "Solaris Management Console 2.1" in the description. For example, SUNWmc.2 might indicate Solaris Management Console 2.1 software.
If the pkginfo output displays multiple versions of Solaris Management Console 1.0 packages, use pkgrm to remove both packages. Remove the original package and then the package that has been appended with a number. For example, if the SUNWmcman and SUNWmcman.2 packages appear in the pkginfo output, first remove SUNWmcman and then SUNWmcman.2. Do not use prodreg.
# pkgrm SUNWmcman # pkgrm SUNWmcapp # pkgrm SUNWmcsvr # pkgrm SUNWmcsvu # pkgrm SUNWmc # pkgrm SUNWmcc # pkgrm SUNWmcsws |
In a terminal window, type the following command.
# rm -rf /var/sadm/pkg/SUNWmcapp |
Solaris Management Console 2.1 software should now function. For future maintenance, or if Solaris Management Console 2.1 software does not function properly, remove Solaris Management Console 2.1 software and reinstall it by following the next steps.
Use pkgrm to remove all Solaris Management Console 2.1 packages and dependent packages in the following order.
If your installation has multiple instances of Solaris Management Console 2.1 packages, such as SUNWmc and SUNWmc.2, first remove SUNWmc, and then SUNWmc.2. Do not use prodreg.
# pkgrm SUNWpmgr # pkgrm SUNWrmui # pkgrm SUNWlvmg # pkgrm SUNWlvma # pkgrm SUNWlvmr # pkgrm SUNWdclnt # pkgrm SUNWmga # pkgrm SUNWmgapp # pkgrm SUNWmcdev # pkgrm SUNWmcex # pkgrm SUNWwbmc # pkgrm SUNWmc # pkgrm SUNWmcc # pkgrm SUNWmccom |
Insert the Solaris 9 Software (SPARC Platform Edition) 1 of 2 CD into your CD-ROM drive and type the following in a terminal window.
# cd /cdrom/sol_9_sparc/s0/Solaris_9/Product # pkgadd -d . SUNWmccom SUNWmcc SUNWmc SUNWwbmc SUNWmcex SUNWmcdev \ SUNWmgapp SUNWmga SUNWdclnt SUNWlvmr SUNWlvma SUNWlvmg SUNWpmgr SUNWrmui |
All previous Solaris Management Console versions are now removed and Solaris Management Console 2.1 software is functional.
In the Solaris 9 operating environment, the Kerberos Version 5 global mechanism includes privacy support, and the Kerberos domestic mechanism is not needed. If you installed the Kerberos domestic mechanism (located in /usr/lib/gss/do/mech_krb.so.1) on a Solaris 8 system, it is recommended that you remove the Kerberos domestic mechanism before you upgrade the system to the Solaris 9 operating environment.
Workaround: Follow these steps before you upgrade to the Solaris 9 operating environment.
Type the following command to check to determine if the Kerberos domestic mechanism is installed on the system.
% pkginfo | fgrep ' SUNWk5' |
If the output of this command includes any SUNWk5 package names, the Kerberos domestic mechanism is installed on the system. Go to step 2.
If the output does not include any SUNWk5 package names, the Kerberos domestic mechanism is not installed on the system. Skip the rest of these steps and upgrade the system.
Back up the /etc/nfssec.conf and /etc/gss/qop files by typing the following command.
% tar -cf /var/tmp/krb_config_files.tar /etc/nfssec.conf /etc/gss/qop |
Verify that the files are backed up by typing the following command.
% tar -tf /var/tmp/krb_config_files.tar |
Remove each package listed in the output of step 1.
% pkgrm package-name package-name package-name |
Upgrade to the Solaris 9 operating environment.
The upgrade program updates the global Kerberos mechanism code and enables Kerberos privacy support.
In a text editor, change the following lines in the /etc/gss/mech file.
Uncomment the following line.
kerberos_v5 1.2.840.113554.1.2.2 gl/mech_krb5.so gl_kmech_krb5 |
If necessary, add the previous line to the /etc/gss/mech file.
Remove the following line.
kerberos_v5 1.2.840.113554.1.2.2 do/mech_krb5.so do_kmech_krb5 |
Restore the /etc/nfssec.conf and /etc/gss/qop files by typing the following command.
% tar -xf /var/tmp/krb_config_files.tar |
If you upgrade to the Solaris 9 operating environment on a system that is running a third party Secure Shell (for example, OpenSSH) from the /etc/init.d/sshd daemon, the upgrade disables the existing Secure Shell daemon. During an upgrade, the Solaris 9 upgrade software overwrites the contents of /etc/init.d/sshd.
Workaround: Choose one of the following workarounds.
If you do not want the Secure Shell protocol server program on your system, do not install the SUNWsshdr and SUNWsshdu packages during the upgrade.
If you do not want the Secure Shell protocol server or client programs on your system, do not install the Secure Shell Cluster (SUNWCssh) during the upgrade.
If the /export directory is near full capacity and you upgrade to the Solaris 9 operating environment, the space requirements for /export are miscalculated and the upgrade fails. The problem commonly occurs if a diskless client is installed, or if third-party software is installed in /export. The following message is displayed:
WARNING: Insufficient space for the upgrade. |
Workaround: Before you upgrade, choose one of the following workarounds.
Temporarily rename the /export directory until the upgrade is completed.
Temporarily comment out the /export line in the /etc/vfstab file until the upgrade is completed.
If /export is a separate file system, then unmount /export before you perform the upgrade.
If your system currently supports diskless clients that were installed with the AdminSuite 2.3 Diskless Client tool, you must first delete all existing diskless clients that are the same Solaris version and architecture as the server. Then, install or upgrade to the Solaris 9 operating environment. For specific instructions, see System Administration Guide: Basic Administration.
If you attempt to install the Solaris 9 operating environment over existing diskless clients, the following error message might appear:
The Solaris Version (Solaris version-number) on slice <xxxxxxxx> cannot be upgraded. There is an unknown problem with the software configuration installed on this disk. |
In this error message, version-number refers to the Solaris version that is currently running on your system. <xxxxxxxx> refers to the slice that is running this version of the Solaris operating environment.
If you are upgrading from the Solaris 8, Solaris 8 6/00, or Solaris 8 10/00 operating environments to the Solaris 9 operating environment (Solaris WBEM Services 2.5), you must convert any proprietary custom Managed Object Format (MOF) data to the new Reliable Log repository format that is used with Solaris WBEM Services 2.5. Failure to convert the data results in data loss.
See "Upgrading the CIM Object Manager Repository" in Solaris WBEM Services Administration Guide for specific instructions on how to convert your WBEM data.
If your system is already running 64-bit ready firmware, then the flash PROM update is not required.
If you want to run the 64-bit Solaris operating environment on an UltraSPARC system, you might need to update its flash PROM firmware. The Solaris 9 installation programs enable you to add 64-bit support. This 64-bit support is selected by default when you install on Sun UltraSPARCTM systems. A 64-bit system only boots in the 64-bit mode by default if it has a CPU speed of 200 MHz or greater.
If you choose to run the 32-bit Solaris operating environment on any SunTM or UltraSPARC system, the flash PROM update is not needed.
The following table lists the UltraSPARC (sun4uTM) systems that are affected and the minimum firmware versions that are needed. System type is the equivalent of the output of the uname -i command. You can determine which firmware version you are running by using the prtconf -V command.
Table 1-2 Minimum Firmware Versions Required to Run 64-Bit Solaris Operating Environment on UltraSPARC Systems
System Type From uname -i |
Minimum Firmware Version From prtconf -V |
---|---|
SUNW,Ultra-1-Engine |
3.10.0 |
SUNW,Ultra-1 |
3.11.1 |
SUNW,Ultra-2 |
3.11.2 |
SUNW,Ultra-4 |
3.7.107 |
SUNW,Ultra-Enterprise |
3.2.16 |
If a system is not listed in the previous table, it does not need a flash PROM update.
For instructions on performing the flash PROM update by using the Solaris CD, refer to the Solaris 9 on Sun Hardware Collection. If you do not have this manual, you can obtain it at http://docs.sun.com.
Some localized documentation collections in PDF format have package names that are longer than nine characters. To install these PDF collections on servers that are running the Solaris 7 or 8 operating environment, you must first install two patches.
No patches exist at the time of this release for Solaris 2.6 servers.
Workaround: For instructions on how to install these patches, see the Solaris Documentation Important Information file on the documentation media (Solaris 9 Documentation CD 1 of 2, 2 of 2, or DVD.) This file is located in the following directory:
mount-point/README/locale/install_locale.html |
For example, the English file on the Solaris 9 Documentation CD 1 of 2 is located in the following directory:
sol_9_doc_1of2/README/C/install_C.html |
If you run the Solaris 9 Documentation CD uninstaller in Uninstall All mode, the uninstaller only removes those documentation packages that are installed by default.
Workaround: Run the uninstaller in Uninstall Partial mode, and select the specific packages you want to uninstall.
If you use the Solaris 9 Installation CD with certain locales, the installation program does not prompt you to install packages from the Solaris 9 Documentation 2 of 2 CD. This problem occurs for the following locales.
ja_JP.PCK
ja_JP.UTF-8
ko.UTF-8
zh.GBK
zh.UTF-8
zh_CN.18030
zh_HK.BIG5HK
zh_HK.UTF-8
zh_TW.BIG5
zh_TW.UTF-8
Workaround: To install collections from the Solaris 9 Documentation 2 of 2 CD, run the installer utility directly from the Solaris 9 Documentation 2 of 2 CD.
If you install the Solaris 9 Documentation CD 2 of 2 in the zh_HK.BIG5HK or zh_HK.UTF-8 locale, Simplified Chinese Documentation is installed by default.
Workaround: During the Solaris 9 Documentation 2 of 2 CD installation, select Custom Install, and then select the Traditional Chinese documentation you want to install.
If you use the Solaris 9 Documentation CD installer program with the -nodisplay option, the verify panel might not page correctly.
Workaround: Do not specify the -nodisplay option with the Solaris 9 Documentation CD installer program. Use the graphical user interface (GUI) mode to install the Solaris 9 Documentation CD.
When you select a locale for your installation, additional related locales might also be installed. This change in behavior occurs in the Solaris 9 operating environment because all full locales (with message translations) and the Asian and Japanese partial locales (locale enabler) have been repackaged based on language support for locales. Other partial locales are still packaged and installed based on geographic region, such as Central Europe.
If you select an English or European ISO-15 locale to use during an interactive installation from the Solaris 9 Software DVD, the ISO-15 and corresponding ISO-1 locale might not be installed. This problem occurs because the English or European ISO-15 locale you specify in the Select a Locale screen might not be selected automatically on the Select a Geographic Region screen.
Workaround: If you want to install the English or European ISO-15 locale you use during the installation, follow these steps.
In the Select a Locale screen, select the English or European ISO-15 locale to use during the installation.
In the Select a Geographic Region screen, select the appropriate English or European ISO-15 and ISO-1 locale you want to install on the system.
If you do not check the Select a Geographic Region screen to make sure the appropriate English or European ISO-15 and ISO-1 locale is selected for installation, the locale might not be installed.
If you upgrade to the Solaris 9 operating environment on a system running the Solaris 9 Beta Refresh operating environment with Simplified Chinese or Traditional Chinese locale support, the upgrade does not complete successfully. The Simplified Chinese and Traditional Chinese CDE font localization packages (SUNWcdft or SUNWhdft) do not upgrade to the appropriate Solaris 9 packages. The following error message is displayed.
Removing package SUNWcdft: /a/var/sadm/pkg/SUNWcdft/install/postremove: /a/usr/dt/config/xfonts/zh_CN.EUC: does not exist /a/var/sadm/pkg/SUNWcdft/install/postremove: /a/usr/dt/config/xfonts/zh_CN.GBK: does not exist /a/var/sadm/pkg/SUNWcdft/install/postremove: /a/usr/dt/config/xfonts/zh_CN.UTF-8: does not exist pkgrm: ERROR: postremove script did not complete successfully |
Workaround: Before you upgrade to the Solaris 9 operating environment, remove the appropriate Solaris 9 Beta Refresh postremove files.
# rm /var/sadm/pkg/SUNWcdft/install/postremove # rm /var/sadm/pkg/SUNWhdft/install/postremove |
If you upgrade to the Solaris 9 operating environment on a system running the Solaris 8 operating environment with the Solaris 8 Language Supplement CD installed, several invalid Thai, Russian, Polish, and Catalan locale packages remain on the system. These locale packages have an ARCH=sparcall value, and are not removed during the upgrade to the Solaris 9 operating environment.
Workaround: Before you upgrade to the Solaris 9 operating environment, use the Solaris Product Registry application to remove the Solaris 8 Languages Supplement CD packages.
If you install one or more of a specific set of European locales, the system might not display any characters outside of the English or European character set in the UTF-8 codeset of the locale. This problem occurs under the following conditions.
You install one or more of the following locales.
Middle East/Israel (ISO8859-8)
Northern Africa/Egypt (ISO8859-6)
Eastern Europe/Russia (ISO8859-5)
Eastern Europe/Turkey (ISO8859-9)
South America/Brazil (ISO8859-1)
Central Europe/Poland (ISO8859-2)
You install no other locales on the system.
Workaround: Choose one of the following workarounds.
During the installation, install both the en_US.UTF-8 North America/U.S.A. locale and the European locale you want on the system.
After the installation is completed, use the pkgadd utility to add the following packages to your system.
SUNW5ttf -- Traditional Chinese BIG5 True Type Fonts Package
SUNWcttf -- Simplified Chinese (EUC) True Type Fonts
SUNWiiimr -- Internet/Intranet Input Method Framework Package (Root)
SUNWiiimu -- Internet/Intranet Input Method Framework Package (Usr)
SUNWinleu -- Indic Locale Environment User Files
SUNWinlex -- Indic Language Environment user files (64-bit)
SUNWinttf -- Indic True Type Fonts
SUNWjxcft -- Japanese Required TrueType Font
SUNWkttf -- Korean True Type Fonts
SUNWtleu -- Thai Locale Environment User Files
SUNWtleux -- Thai Language Environment user files (64-bit)
These packages are available from the Solaris_9/Product directory on the Solaris 9 Software 1 of 2 CD or CD image.
For example, if you install the Solaris 9 operating environment from the Solaris 9 Software 1 of 2 CD, type the following commands.
# cd /cdrom/cdrom0/Solaris_9/Product # pkgadd -d . SUNW5ttf # pkgadd -d . SUNWcttf |
Repeat this pkgadd command for each package in the previous list.