Upgrade Issues and Bugs

This section describes upgrade bugs. Some might occur while you are upgrading to Solaris 10 OS. Others might occur after you have completed upgrading.

lucreate and lumake Commands Fail on Non-Global Zones (6659451)

When the lucreate and lumake commands are used on non-global zones which are not in the running state, the commands might not execute successfully. The contents of the original non-global zone and the copy might differ. Users might be unable to log in to the zone's console using the zlogin command. The following error message is displayed while using the zlogin command:

zlogin: makeutx failed

The diagnostic output of the lucreate and lumake commands do not display any errors.

Workaround: Ensure that all non-global zones are in the running state before using the lucreate and lumake commands.

SPARC: Upgrading with Solaris Live Upgrade From Solaris 8 and Solaris 9 Releases Fails (6638175)

Upgrading to the Solaris 10 5/08 release using Solaris Live Upgrade, from the previous Solaris 8 and Solaris 9 releases fails. The install images compression file is now unzipped by using the 7za utility. The SUNWp7zip package is not included in the Solaris 8 and 9 releases. As a result, Solaris Live Upgrade fails.

Workaround: Choose one of the following workarounds:

• Workaround 1: To upgrade your current Solaris 9 OS to the Solaris 10 5/08 release using Solaris Live Upgrade, apply the following patches:

  • For SPARC systems– 137477-01 or later

  • For x86 systems– 137478-01 or later

• Workaround 2: To upgrade your current Solaris 10 OS to the Solaris 10 5/08 release by using Solaris Live Upgrade, apply the following patches:

  • For SPARC systems– 137321-01 or later

  • For x86 systems– 137322-01 or later

Incorrect Permissions on /tmp in Non-Global Zones After Solaris Live Upgrade (6619278)

Various processes running in non-global zones using /tmp might crash after the zone has been upgraded using Solaris Live Upgrade. The upgrade process changes permissions on the /tmp directory which leads to applications failures. Users will see drwxr-xr-x permissions instead of the correct drwxrwxrwx permissions.

Workaround: Choose one of the following workarounds:

• Workaround 1: Before activating the new boot environment, perform the following steps:

  1. Mount the disk:

     # mount /dev/dsk/c1t1d0s6 /mnt

  2. Fix the permissions:

     # chmod 1777 /mnt/zone/*/root/tmp

  3. Then unmount the disk:

     # umount /mnt

  This workaround fixes all zones at once.

• Workaround 2: If you have already booted the new boot environment, log in to the system as the root user. Halt the zone and manually set correct permissions on the /tmp directory. Type the following command:

  # chmod 1777 /path/root/tmp

  where path is the zone's zonepath.

Issues With DSR Upgrade With Zones (6616788)

Disk space reallocation (DSR) upgrade with zones fails if zones are installed in the /opt directory. Upgrade might fail during the restoration of the DSR archive. In some cases, the upgrade might be successful, but the system cannot be rebooted.

Workaround: Ensure that the root file system is not 100% full before upgrade. Remove some files before upgrade so that the root slice is less than 90% full.

Solaris Trusted Extensions Upgrade Issues (6616585)

When you upgrade Solaris Trusted Extensions from the Solaris 10 11/06 or Solaris 10 8/07 release to the current Solaris 10 5/08 release, unwanted localized Solaris Trusted Extensions packages are installed on your system. This bug occurs because the Solaris Trusted Extensions installer in the Solaris 10 11/06 or Solaris 10 8/07 releases installs localized packages by default. No error message is displayed.

Workaround: Before upgrading Solaris Trusted Extensions to the current release, remove the following localized Solaris Trusted Extensions packages:

SUNWjdtts SUNWkdtts SUNWjmgts SUNWkmgts SUNWjtsman SUNWktsu SUNWjtsu SUNWodtts SUNWtgnome-l10n-doc-ja SUNWtgnome-l10n-ui-ko SUNWtgnome-l10n-ui-it SUNWtgnome-l10n-ui-zhHK SUNWtgnome-l10n-ui-sv SUNWtgnome-l10n-ui-es SUNWtgnome-l10n-doc-ko SUNWtgnome-l10n-ui-ptBR SUNWtgnome-l10n-ui-ja SUNWtgnome-l10n-ui-zhTW SUNWtgnome-l10n-ui-zhCN SUNWtgnome-l10n-ui-fr SUNWtgnome-l10n-ui-de SUNWtgnome-l10n-ui-ru

System Cannot Communicate With ypbind After Upgrade (6488549)

This bug occurs during an upgrade from Solaris 10 Hardware 2 release to the current Solaris 10 5/08 release.

In the Solaris 10 Hardware 2 release, the name_service.xml file for any name service, such as NIS, NIS+, FILES, or LDAP is as follows:

# ls -l name_service.xml
lrwxrwxrwx   1 root     root     10 Apr 10 16:26 name_service.xml -> ns_files.xml

If the name service is NIS, the name_service.xml file links to ns_files.xml. However, the contents of the ns_files.xml are the same as ns_nis.xml.

  # cat /etc/release
                     Solaris 10 3/05 HW2 s10s_hw2wos_05 SPARC
           Copyright 2005 Sun Microsystems, Inc.  All Rights Reserved.
                        Use is subject to license terms.
                           Assembled 26 September 2005
  # cd /var/svc/profile
  # ls -l name_service.xml ns_files.xml ns_nis.xml
  lrwxrwxrwx   1 root   other    12 May 21 04:06 name_service.xml -> ns_files.xml
  -r--r--r--   1 root   sys     779 May 21 04:25 ns_files.xml
  -r--r--r--   1 root   sys     779 Jan 21  2005 ns_nis.xml
  #
  # diff ns_files.xml ns_nis.xml
  # diff name_service.xml ns_nis.xml

In the above output, the ns_nis.xml and ns_files.xml files are the same. This means that the name_service.xml file symbolically links to the wrong name service file. The name_service.xml file links to ns_files.xml. Instead, the name_service.xml file should link to the ns_nis.xml.

After an upgrade from Solaris 10 Hardware 2 to the current Solaris 10 5/08 release, the following message is displayed on the console or logged in the messages file:

Oct 23 12:18:45 vt2000a automount[301]: [ID 366266 daemon.error] 
can't read nis map auto_master: can't communicate with ypbind - retrying 

Also, the /network/nis/client:default service is offline.

Workaround: Choose one of the following workarounds:

• Workaround 1: Before an upgrade, remove the /var/svc/profile/name_service.xml file.

• Workaround 2: After an upgrade, change the /var/svc/profile/name_service.xml link to the correct ns_<xxx>.xml file, based on the name service.

Upgrade Fails on System With Zones That Have Been Installed But Not Booted

A non-global zone that has been installed but never booted or made ready prevents a system from being upgraded correctly. No error message is displayed.

Workaround:

If such a zone is found, the zone should be made ready and then halted prior to starting the upgrade. For example:

global# zoneadm -z myzone ready ; zoneadm -z myzone halt

Upgrading a Solaris 10 System with Non-Global Zones to the Solaris 10 5/08 Release Might Cause the Local File System Service to Fail (6428258)

Upgrading a Solaris 10 3/05 system or a Solaris 10 1/06 system to the Solaris 10 6/06, Solaris 10 8/07, or the Solaris 10 5/08 release with non-global zones might cause the SMF service that mounts local file systems to fail in the non-global zones. As a result, other services in the non-global zones might fail to start.

After upgrading a Solaris 10 system with non-global zones to the Solaris 10 6/06, Solaris 10 8/07, or the Solaris 10 5/08 release, services might be in the maintenance state. For example:

# zlogin myzone svcs -x
    svc:/system/filesystem/local:default (local file system mounts)
     State: maintenance since Wed May 24 13:18:06 2006
    Reason: Start method exited with $SMF_EXIT_ERR_FATAL.
       See: http://sun.com/msg/SMF-8000-KS
       See: /var/svc/log/system-filesystem-local:default.log
    Impact: 18 dependent services are not running.  (Use -v for list.)

Workaround:

Reboot the non-global zone from the global zone. For example:

global# zoneadm -z myzone reboot

Device ID Discrepancies After Upgrading From Solaris 9 9/04 OS

In this Solaris 10 release, Solaris Volume Manager displays device ID output in a new format. Solaris 9 9/04 OS, which introduced device ID support in disk sets, does not recognize the new format. When you upgrade to Solaris 10 OS from the Solaris 9 9/04 release, device IDs that are associated with existing disk sets are not updated in the Solaris Volume Manager configuration. If you need to revert to Solaris 9 9/04 OS, configuration changes made to disk sets after the upgrade might not be available to Solaris 9 9/04 OS. For more information, see Chapter 25, Troubleshooting Solaris Volume Manager (Tasks), in Solaris Volume Manager Administration Guide.

x86: Adding Driver Updates Might Cause Failure of Network Configuration (6353146)

Installation of the Solaris 10 OS might fail while you are adding Driver Updates (DU), which are also known as Install Time Updates (ITU). This error occurs if you are using the GUI to install the Solaris 10 software. The following message is displayed:

Unable to run cmd: /usr/sbin/sysidput

Workaround: Use either of the following workarounds.

• Workaround 1: Configure the installation to use DHCP to gather network configuration information.

• Workaround 2: Use a text-based installation method.

  • If you are performing the text-based installation in a desktop session, follow these steps.

    1. After you have finished adding ITUs, type Ctrl-c instead of typing e.

    2. Choose option 3.

  • If you specify a serial console to use during the installation, follow these steps.

    1. After you have finished adding ITUs, type Ctrl-c instead of typing e.

    2. Choose option 4.

x86: Cannot Delete the Solaris Live Upgrade Boot Environment That Contains the GRand Unified Bootloader Menu (6341350)

When you use Solaris Live Upgrade to create boot environments, one of the boot environments in the system hosts the GRand Unified Bootloader (GRUB) menu. This boot environment cannot be removed with the ludelete command.

If you attempt to remove the boot environment, the following error message is displayed:

ERROR: The boot environment name-of-boot-environment contains the GRUB menu.
ERROR: You are not allowed to delete this BE.
Unable to delete boot environment.

Workaround: Use either the lumake command or the luupgrade command to reuse this boot environment. Make the boot environment that contains the GRUB menu the last boot environment to be deleted.

Solaris Live Upgrade luupgrade Command Missing the Progress Bar (6239850)

The upgrade progress bar does not appear when you use the Solaris Live Upgrade software in the following manner:

• You use the Solaris 10 5/08 CD media to upgrade the OS.

• You upgrade a boot environment by using the luupgrade command with the following options:

  • -i to install from the CD media

  • -O “-nodisplay -noconsole” to run the installer on the second CD in text mode and without user interaction

• You are upgrading to the Solaris 10 5/08 software from the following releases:

  • Solaris 9 release

  • Solaris 10 release

For example, if you run the following command, the progress bar should be displayed after you see the following output:

Running installer on BE s10u1.

However, the bar fails to appear.

# luupgrade -i -n s10u1 -s /net/installsrv/export/s10u1 -O "-nodisplay -noconsole"


Validating the contents of the media /net/installsvr/export/s10u1.
The media is a standard Solaris media.
The media contains a standard Solaris installer.
The media contains Solaris 3 version 10.
Mounting BE s10u1.
Running installer on BE s10u1.

No error message is displayed.

Workaround: Use the prstat command. This command enables you to watch the progress while packages are being added during the installation.

SPARC: Upgrading From Solaris 9 Releases With Recommended Patch Cluster Partially Succeeds (6202868)

For a system that is running a Solaris 9 release with the recommended patch cluster installed, upgrading to Solaris 10 OS only partially succeeds. This problem affects systems that are running the following releases with the Solaris 9 recommended patch cluster installed.

• Solaris 9 release

• Solaris 9 9/02 release

• Solaris 9 12/02 release

• Solaris 9 4/03 release

• Solaris 9 8/03 release

• Solaris 9 12/03 release

• Solaris 9 4/04 release

When you upgrade to the Solaris 10 release, the SUNWcti2x package is not successfully removed from the system.

Workaround: Choose one of the following workarounds.

• To avoid this problem, apply patch ID 117426-03, or a later version, to the system before you upgrade to the Solaris 10 OS.

  To download this patch, go to http://sunsolve.sun.com.

• If you encounter this problem during the upgrade, follow these steps.

  1. In a text editor, comment out the following line in the /var/sadm/pkg/SUNWcti2x/install/preremove file.

     rem_drv -b ${BASEDIR} sc_nct || EXIT=1

  2. Remove the SUNWcti2x package.

     # pkgrm SUNWcti2x

Obsolete Uninstallers Not Removed When You Use Solaris Live Upgrade to Upgrade From Previous Solaris Releases (6198380)

If you use Solaris Live Upgrade to upgrade from the Solaris 8 or Solaris 9 releases to Solaris 10 OS, obsolete uninstaller programs are not removed. These uninstaller programs from the previous OS remain in the system's /var/sadm/prod directory.

The following obsolete uninstallers are not removed.

uninstall_Alternate_Pathing_2_3_1.class
uninstall_CDRW_1_1.class o uninstall_CDRW_1_0.class
uninstall_Bonus_Localization_-_Catalan_CDE_Desktop.class
uninstall_Bonus_Localization_-_Polish_CDE_Desktop.class
uninstall_Bonus_Localizations_-_Russian_CDE_Desktop.class
uninstall_Capacity_on_Demand_1_0.class
uninstall_Java3D_1_3_1.class
uninstall_Java3D_1_3.class
uninstall_Java3D_1_2_1_04.class
uninstall_Java3D_1_2_1_03.class
uninstall_Lights_Out_Management_2_0.class
uninstall_Man_Page_Supplement.class
uninstall_OpenGL_1_3.class
uninstall_OpenGL_1_2_3.class
uninstall_Netra_ct_Platform_1_0.class
uninstall_Netra_t11xx_Alarms_2_0.class
uninstall_Netscape_6_2_3.class
uninstall_Netscape_6_2_1_Beta.class
uninstall_PC_launcher_1_0_2.class
uninstall_PC_launcher_1_0_1_PCfileviewer_1_0_1.class
uninstall_RSC_2_2_2.class
uninstall_RSC_2_2_1.class
uninstall_RSC_2_2.class
uninstall_ShowMeTV_1_3.class
uninstall_Solaris_9_French_Localization.class
uninstall_Solaris_9_German_Localization.class
uninstall_Solaris_9_Hong_Kong_Traditional_Chinese_Localization.class
uninstall_Solaris_9_Italian_Localization.class
uninstall_Solaris_9_Japanese_Localization.class
uninstall_Solaris_9_Korean_Localization.class
uninstall_Solaris_9_Simplified_Chinese_Localization.class
uninstall_Solaris_9_Spanish_Localization.class
uninstall_Solaris_9_Swedish_Localization.class
uninstall_Solaris_9_Traditional_Chinese_Localization.class
uninstall_Solaris_On_Sun_Hardware_Documentation.class
uninstall_Sun_Hardware_AnswerBook.class
uninstall_SunATM_5_0.class
uninstall_SunATM_5_1.class
uninstall_SunFDDI_PCI_3_0.class
uninstall_SunFDDI_SBus_7_0.class
uninstall_Sun_Fire_880_FC-AL_Backplane_Firmware_1_0.class
uninstall_Sun_Fire_B10n_Load_Balancing_Blade_1_1.class
uninstall_SunForum_3_1.class
uninstall_SunForum_3_2.class
uninstall_SunHSI_PCI_3_0.class
uninstall_SunHSI_SBus_3_0.class
uninstall_SunScreen_3_2.class
uninstall_SunVTS_5_1_PS6.class
uninstall_SunVTS_5_1_PS5.class
uninstall_SunVTS_5_1_PS4.class
uninstall_SunVTS_5_1_PS3.class
uninstall_SunVTS_5_1_PS2.class
uninstall_SunVTS_5_1_PS1.class
uninstall_SunVTS_5_0.class
uninstall_System_Management_Services_1_4.class
uninstall_System_Management_Services_1_3.class
uninstall_System_Management_Services_1_2.class
uninstall_System_Service_Processor_3_5.class
uninstall_WBEM_DR_1_0.class
uninstall_Web_Start_Wizards_SDK_3_0_2.class
uninstall_Web_Start_Wizards_SDK_3_0_1.class
uninstall_Web_Start_Wizards_SDK.class
uninstall_XML_Libraries_2_4_12.class

Workaround: After you upgrade the system, manually remove the obsolete uninstallers in the /var/sadm/prod directory.

Configuration File pam.conf Not Automatically Updated After an Upgrade (5060721)

This Solaris 10 release introduces changes in pam_ldap functionality. When you upgrade to the current release, pam_ldap configurations in your existing pam.conf configuration file are not updated to reflect these changes. If pam_ldap configuration is detected, the CLEANUP file that is generated at the end of the upgrade contains the following notification:

/etc/pam.conf please examine/update the pam_ldap configuration 
because its functionality has changed, 
refer to pam_ldap(5) documentation for more information

Workaround: After the upgrade, examine /etc/pam.conf. If necessary, modify this file manually to be compatible with the new functionalities of pam_ldap. The modifications involve password prompting such as the use_first_pass and try_first_pass options as well as password updates. For more information about updating pam.conf, refer to the pam_ldap(5) man page and documentation.

Installer Text Display Problem When Using Solaris Live Upgrade (4736488)

When using the Solaris Live Upgrade luupgrade(1M) command with the -i option to complete an upgrade of an inactive boot environment, the text that the installers display might be unreadable in some languages. The text is corrupted when the installers request fonts that do not exist on the older release that is on the current boot environment.

Workaround: Choose one of the following workarounds:

• Use a combined network installation image to do the installation.

• Enable the C locale by setting the environment variable on your system.

  • If you are using the Bourne shell or Korn shell, follow these steps:

    1. Set the C locale.

       # LANG=C; export LANG

    2. Begin the installation.

  • If you are using the C shell, follow these steps:

    1. Type the following:

       # csh

    2. Set the C locale.

       # setenv LANG C

    3. Begin the installation.

SPARC: Removal of SUNWjxcft Package Records Error During Upgrade (4525236)

When you upgrade from the Solaris 8 software to the Solaris 10 release, a problem is encountered when the SUNWjxcft package is removed. The following error message is recorded in the upgrade_log file:

Removing package SUNWjxcft: 
Can't open /a/usr/openwin/lib/locale/ja/X11/fonts/TTbitmaps/fonts.upr 
Can't open /a/usr/openwin/lib/locale/ja/X11/fonts/TTbitmaps/fonts.scale 
Can't open /a/usr/openwin/lib/locale/ja/X11/fonts/TTbitmaps/fonts.alias 
Can't open /a/usr/openwin/lib/locale/ja/X11/fonts/TT/fonts.upr 
Can't open /a/usr/openwin/lib/locale/ja/X11/fonts/TT/fonts.scale 
Can't open /a/usr/openwin/lib/locale/ja/X11/fonts/TT/fonts.alias 
Removal of <SUNWjxcft> was successful

Workaround: Ignore the error message.

Upgrading to Solaris 10 Release Might Disable Existing Secure Shell Daemon (sshd) (4626093)

If you upgrade to the Solaris 10 release on a system that is running a third-party Secure Shell, such as OpenSSH from the /etc/init.d/sshd daemon, the upgrade disables the existing Secure Shell daemon. During an upgrade, Solaris 10 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.

Upgrade Fails if /export Directory Is Near Capacity (4409601)

If the /export directory is near full capacity when you upgrade to the Solaris 10 release, space requirements for /export are miscalculated. The upgrade then fails. This problem commonly occurs if a diskless client is installed. Another instance of when the problem occurs is when third-party software is installed in the /export directory. The following message is displayed:

WARNING: Insufficient space for the upgrade.

Workaround: Before you upgrade, choose one of the following workarounds:

• Rename the /export directory temporarily, 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.

Upgrading Diskless Client Servers and Clients (4363078)

If your system currently supports diskless clients that were installed with the Solstice AdminSuite 2.3 Diskless Client tool, you must perform the following two steps:

1. Delete all existing diskless clients that are the same Solaris version and architecture as the server.

2. Install or upgrade to the Solaris 10 release.

For specific instructions, see the System Administration Guide: Basic Administration.

If you attempt to install the Solaris 10 software over existing diskless clients, the following error message might be displayed:

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