This chapter describes problems that relate to the installation of the Solaris 10 Operating System.
Some of the issues and bugs in this chapter have been fixed in subsequent Solaris 10 releases. If you have upgraded your Solaris software, certain issues and bugs in this chapter might no longer apply. To see which bugs and issues no longer apply to your specific Solaris 10 software, refer to Appendix A, Table of Integrated Bug Fixes in the Solaris 10 Operating System.
This section provides general information such as behavior changes in Solaris 10 OS.
Beginning with the Solaris 10 7/07 HW release, all x86 based systems must now have at least 256 Mbytes of RAM to run the Solaris software.
Although the Solaris 10 software has been tested for compatibility with previous releases, some third-party applications might not be fully ABI compliant. Contact the supplier of these applications directly for information about compatibility.
Your system might run both a Solaris OS and other products that are not part of the Solaris software. These products might be supplied by either Sun or another company. If you upgrade this system to the Solaris 10 release, make sure that these other products are also supported on the Solaris 10 OS. Depending on the status of each of these products, you can perform one of the following options:
Verify that the existing version of the product is supported on the Solaris 10 software.
Install a new version of the product that is supported on the Solaris 10 release. You might need to remove the previous version of the product prior to upgrading to the Solaris software. See the product documentation for more details.
Remove the product prior to upgrading to the Solaris 10 software.
This section contains critical installation issues that you need to be aware of before installing or upgrading to Solaris 10 OS. These issues might have an impact that would prevent installation or upgrades from completing successfully. If bugs in this section apply to your system, you might need to perform the recommended workarounds before you install or upgrade.
When you are installing the Solaris OS, the Companion DVD is not available to be installed with the Solaris installation program. Use the pkgadd(1M) command to install the Solaris Companion DVD. For detailed installation instructions, see the README file on the Companion DVD.
When you install the Solaris 10 7/07 HW release and you wish to access longer key lengths for use with data encryption, you must use the Solaris Data Encryption Supplement packages that corresponds to Solaris 10. The supplement is delivered in the SUNWcry and SUNWcryr packages that are available for download from:
To bring these packages up to the same patch level as your current update, you will have to install the appropriate patch:
Patch ID 118562-05 or a later revision for SPARC based systems
Patch ID 118563-04 or a later revision for x86 based systems
To determine your current patch level, use showrev -p.
The following patches are applied to resolve problems that were reported in CR 6277164 and CR 6214222:
Patch ID 119366-05 for SPARC based systems
Patch ID 119367-05 for x86 based systems
The sections that follow provide further steps that you must perform to completely resolve the reported problems.
Perform this procedure before you use the GNOME Display Manager (GDM) as your login program, or if you have already enabled GDM as your login program. Otherwise, you can skip this procedure.
When applying the patch, load new values into the GDM configuration files. Then restart the GDM application.
To load the new values into the configuration file, choose one of the following options.
Copy the /etc/X11/gdm/factory-gdm.conf file to the /etc/X11/gdm/gdm.conf file.
Perform this step if you have not made any modifications to the gdm.conf file. Then you can start the GDM application.
Manually merge the differences in the factory-gdm.conf file into the gdm.conf file.
Perform this step if you have modified the gdm.conf file and want to retain your modifications.
When merging files, copy the values for the following commands from the factory-gdm.conf file to the gdm.conf file. These commands enable you to obtain the best OS performance.
RebootCommand
HaltCommand
SuspendCommand
DefaultPath
RootPath
GraphicalTheme
To restart GDM, perform the following steps:
Become superuser.
Issue the following command:
# svcadm disable application/gdm2-login |
In the console that is now displayed, press Return to display a command prompt.
To restart GDM, issue the following command:
# svcadm enable application/gdm2-login |
The SUNWCXall software metacluster must be installed on a Sun Fire V250 Server.
Solaris 10 OS uses NFS Version 4 (NFSv4) as the default distributed file system mechanism. In NFSv4, file user and group attributes are exchanged as strings of the form “user@domain” and “group@domain,” respectively.
The domain portion of the string should be common between client and server. This information is automatically derived from the system's name service domain name. However, in certain cases, the derived domain might not match between client and server. This mismatch might typically occur in environments where either of the following circumstances is true:
The DNS TXT record is not used.
Multiple administrative domain boundaries are crossed.
If domain information between client and server does not match, NFSv4-accessed files might appear to be owned by “nobody.”
To ensure proper configuration, on the first system boot the system now prompts you for a domain to use for NFSv4. Answer “no” to this prompt if one of the following configurations describes your deployment:
Your deployment utilizes the DNS TXT record to configure the NFSv4 domain.
Your deployment has a single (flat) administrative domain.
Environments that use the Custom JumpStartTM method to perform unattended system installations require minimal tuning to suppress the first boot prompts.
A sample script, set_nfs4_domain, is provided in the Solaris 10 distribution media and is located in the ${CDrom_mnt_pt}/Solaris_10/Misc/jumpstart_sample directory. A copy of this script should be modified to set the NFS4_DOMAIN variable to site-specific needs and be called from within JumpStart's finish script. The target system's NFSv4 domain is therefore preconfigured as part of the JumpStart finish phase, and thus suppresses any first boot prompts.
Follow these steps to perform unattended installations:
Create a copy of the set_nfs4_domain script in the same directory as your JumpStart's finish.sh scripts.
Edit the script and set the NFS4_DOMAIN variable to your specific needs.
Edit your finish.sh script and append a call to set_nfs4_domain.
Perform the JumpStart installations as usual.
For further details, refer to the sysidconfig(1M), sysidtool(1M), nfsmapid(1M), and nfs(4) man pages. See also the System Administration Guide: Network Services.
The default size of the /var file system might be insufficient for the Extra Value products in the following situations:
If you install any of the Extra Value products that are provided on the Solaris 10 DVD or CDs
If the /var file system is located on a separate slice
You must manually specify a larger slice size for the /var file system.
If the /var file system is not on a separate slice or partition, this problem does not occur.
Workaround: Choose one of the following workarounds.
If you are using the Solaris installation program GUI, follow these steps.
Begin the installation.
From Select Type of Install, select Custom Install.
The Solaris installation program displays several screens that enable you to customize the software localizations, products, and disk layout that you want to install.
From Lay Out File Systems, select Modify.
The disk layout screen is displayed.
Type /var in the File System column for a specific slice, then click Apply.
The installation program suggests a default size for the /var file system.
Edit the Size column entry for the /var file system to twice the disk space size.
For example, if the installation program assigns 40 Mbytes of space, change the Size value to 80.
Complete the installation.
If you are using the Solaris installation program's text installer, follow these steps.
Begin the installation.
From Select Type of Install, select Custom Install.
The Solaris installation program displays several screens that enable you to customize the software localizations, products, and disk layout that you want to install.
From Lay Out File Systems, select Auto Layout.
The disk layout screen is displayed.
Type /var in the File System column for a specific slice.
The installation program suggests a default size for the /var file system.
Press F4_Customize to customize the size of the /var file system.
Edit the Size column entry for the /var file system to twice the disk space size.
For example, if the installation program assigns 40 Mbytes of space, change the Size value to 80.
Complete the installation.
If you are using the custom JumpStart program, use the filesys profile keyword to set the size of the /var file system. The following example sets the size of the /var file system on slice 5 to 256 Mbytes.
filesys c0t0d0s5 256 /var |
On SPARC based systems, Solaris 10 OS runs in 64–bit mode only. Some Sun4UTM systems might need to be updated to a higher level of OpenBootTM firmware in the flash PROM to run the OS in 64-bit mode. The following systems might require a flash PROM update:
UltraTM 2
Ultra 450 and Sun EnterpriseTM 450
Sun Enterprise 3000, 4000, 5000, and 6000 systems
The following table lists the UltraSPARC systems and the minimum firmware versions that are required to run the 64–bit Solaris 10 OS. 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 2–1 Minimum Firmware Versions Required to Run 64–Bit Solaris Software on UltraSPARC Systems
System Type From uname -i |
Minimum Firmware Version From prtconf -V |
---|---|
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, the system does not need a flash PROM update.
See any edition of the Solaris 8 Sun Hardware Platform Guide at http://docs.sun.com for instructions to perform a flash PROM update.
Solaris Management Console 2.1 software is not compatible with Solaris Management Console 1.0, 1.0.1, or 1.0.2 software. If you are upgrading to the Solaris 10 release, 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 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, use the /usr/bin/prodreg command to 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 10 release, you must first remove all Solaris Management Console 1.0, 1.0.1, or 1.0.2 packages. Use the pkgrm command for package removal instead of the prodreg command. Carefully follow the order of package removal. Complete the following steps:
Become superuser.
Type the following command:
# pkginfo | grep “Solaris Management Console“ |
If the description does not start with “Solaris Management Console 2.1,” the package names in the output identify a Solaris Management Console 1.0 package.
Use the pkgrm command 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 its 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 the pkgrm command to remove both packages. Remove the original package. Then, remove 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 the SUNWmcman package and then remove the SUNWmcman.2 package. Do not use the prodreg command.
# 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 |
The Solaris Management Console 2.1 software should now function properly. For future maintenance, or if the Solaris Management Console 2.1 software does not function properly, remove the Solaris Management Console 2.1 software. Reinstall the software by completing the following steps:
Use the pkgrm command 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 the prodreg command.
# 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 10 Software - 4 CD into your CD-ROM drive. Type the following in a terminal window:
# # cd /cdrom/cdrom0/Solaris_10/Product # pkgadd -d . SUNWmccom SUNWmcc SUNWmc SUNWwbmc SUNWmcex SUNWmcdev \ SUNWmgapp SUNWmga SUNWdclnt SUNWlvmr SUNWlvma SUNWlvmg SUNWpmgr \ SUNWrmui |
All previous Solaris Management Console versions are removed. The Solaris Management Console 2.1 software is now functional.
Starting with the current Solaris release, a Solaris Flash archive cannot be properly created when a non-global zone is installed. The Solaris Flash feature is not currently compatible with the Solaris containers (zones) feature.
Do not use the flar create command to create a Solaris Flash archive in these instances:
In any non-global zone
In the global zone if there are any non-global zones installed
If you create a Solaris Flash archive in such an instance, the resulting archive might not install properly when the archive is deployed.
Workaround: None.
The following bugs might occur during or after the installation of Solaris 10 OS.
For the Solaris OS, the keyboard layout information must be received during the installation either automatically from the keyboard hardware identification or from the user's preconfiguration. The keyboard layout information might not be received as the symbolic link to the file etc/default/kbd is missing. No error message is displayed.
Workaround: If the keyboard layout information is not received during the installation, the sysidkbd tool prompts the keyboard layout list for configuration in the first boot.
The NFSMAPID_DOMAIN domain name is commented out in the etc/default/nfs file. If you try to access files that are commented out, the file owner is displayed as nobody. See the following example:
bash> cd /net/line2-w1100z/export/home/rw /net/line2-w1100z/export/home/rw bash> ls -lia total 1 5824 drwxrwxrwx 2 nobody 512 Apr 19 15:50 ./ 5824 dr-xr-xr-x 2 root 2 Apr 19 16:08 ../ 5825 -rw-r--r-- 1 nobody 0 Apr 19 15:23 dingfile 5827 -rw-r--r-- 1 nobody 0 Apr 19 15:50 line2-ultra45 5826 -rw-r--r-- 1 nobody 0 Apr 19 15:26 line3-sb2k bash> |
No error message is displayed.
Workaround: Edit the /etc/default/nfs file so that NFSMAPID_DOMAIN domain name has the correct value.
If Linux is installed on your disk and you installed the Solaris OS on a separate partition, the Linux partition does not display on the GRUB menu. No error message is displayed.
Workaround: Edit the GRUB menu's menu.lst file to add Linux to the GRUB menu. Perform the following steps:
Boot the Solaris OS.
Edit the menu.lst file at /boot/grub/menu.lst. For more information, see the System Administration Guide: Basic Administration.
If you use the flarcreate command to create a Solaris Flash archive and use the -L pax option, the installation of the archive hangs on a Sun4v system. The archive failure occurs during the retrieval of the archive. This failure affects the both the T1000 and T2000 models.
The following error message is displayed.
/pci@7c0/pci@0: Device 1c Nothing there /pci@7c0/pci@0: Device 1d Nothing there /pci@7c0/pci@0: Device 1e Nothing there /pci@7c0/pci@0: Device 1f Nothing there Probing I/O buses Sun Fire T200, No Keyboard Copyright 2006 Sun Microsystems, Inc. All rights reserved. OpenBoot 4.20.4, 8184 MB memory available, Serial #000000. Ethernet address 0:13:3f:3d:b3:13, Host ID: 000db914. Rebooting with command: boot Boot device: disk File and args: Loading ufs-file-system package 1.4 04 Aug 1995 13:02:54. FCode UFS Reader 1.12 00/07/17 15:48:16. Loading: /platform/SUNW,Sun-Fire-T200/ufsboot Loading: /platform/sun4v/ufsboot ERROR: Last Trap: Memory Address not Aligned [Exception handlers interrupted, please file a bug] [type 'resume' to attempt a normal recovery] {0} ok (This hangs and will never complete) |
Workaround: Create the archive by using the cpio copy option. The cpio option is the default. See the following example:
# flarcreate -n test.flar.sun4v.cpio -c /net/server/export1/rw/test.flar.sun4v.cpio |
Solaris OS is not sending Process Login (PRLI) data to the tape device during a path recovery sequence.
No error message is displayed to the user, but the problem can be identified from:
Regular system log messages indicates a path issue, such as offline or online.
Cfgadm -al command. This command shows the failed condition for the tape device.
I/O to a tape device has ceased.
Workaround:
To recover from this situation, use the luxadm forcelip command to the FC host bus adapter. For example:
luxadm -e forcelip /dev/cfg/c99
c99 is the specific controller that is being used to communicate with the tape transport.
If you install the Solaris 10 software by using the Solaris installation program, some of the information and exit panels for the SunSM Remote Services (SRS) Net Connect software might not display properly.
The installation panel frame and Cancel button are displayed, but the installation panel content is missing.
This problem might also occur during a Solaris installation of other software products that are included in this Solaris OS release.
Workaround: Follow these steps:
Bypass the SRS Net Connect installation by clicking the Cancel button when the empty installation panel is displayed.
After the installation of the Solaris 10 software has completed, manually install the SRS Net Connect software from the Solaris 10 Operating System DVD or Solaris 10 Software - 2 CD.
Installing the SRS Net Connect software after the initial Solaris 10 software installation has completed ensures that all panels are displayed properly.
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. |
Or:
Warning: 1 sector(s) in last cylinder unallocated |
The warning occurs when the size of the file system that you created does not equal the space on the disk that is being used. This discrepancy can result in unused space on the disk that is not incorporated into the indicated file system. This unused space is not available for use by other file systems.
Workaround: Ignore the warning message.
This section describes issues that are related to the installation of the Solaris OS.
The smosservice add command does not install any packages that are designated ARCH=all in the root (/) or /usr file systems. There is no error message indicating these packages were skipped. This problem exists in all Solaris OS versions, and applies to both SPARC® based and x86 based clients.
Note that the list of missing packages varies, depending on the Solaris release that you are running.
Workaround: Locate and install the missing ARCH=all packages.
For step-by-step instructions on locating and installing missing packages, see How to Locate and Install Missing ARCH=all Packages in System Administration Guide: Basic Administration.
The following patches are applied to the Solaris OS to resolve StarOfficeTM problems that were reported in CR 6234855 and CR 6262830:
For SPARC based systems
Patch ID 119412-06
Patch ID 119906-03
For x86 based systems:
Patch ID 119413-06
Patch ID 119907-03
To completely resolve the reported problems, perform the following steps after applying the patches. These steps enable you to use StarOffice 7 Product 5 software to open, for example, those OpenDocument files that were created in StarOffice 8 software.
Become superuser.
Issue the following command:
# update-mime-database /usr/share/mime |
Log out of the system and then log in again.
When you install Solaris 10 OS, either the StarOffice or the StarSuiteTM software is also automatically installed, depending on which language you select. The languages and the corresponding software that these languages support are listed as follows:
Selected Language |
Supported Software |
---|---|
Chinese, Japanese, Korean |
StarSuite |
Other languages |
StarOffice |
StarOffice and StarSuite cannot coexist in the same system. If you want to replace a software that you accidentally installed, follow these steps.
Insert the Solaris 10 Software - 3 CD or Solaris 10 Operating System DVD in the drive.
Become superuser.
Change to the Product directory, for example, /cdrom/cdrom0/Solaris_10/Product.
Replace the software.
To replace StarOffice with StarSuite, use the following commands:
# pkgrm SUNWsogm SUNWsom # pkgadd -d . SUNWsoagm SUNWsoam |
To replace StarSuite with StarOffice, use the following commands:
# pkgrm SUNWsoagm SUNWsoam # pkgadd -d . SUNWsogm SUNWsom |
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 Solaris 7 or 8 software, you must first install two patches.
Workaround: For instructions on how to install these patches, see the Solaris Documentation Important Information file on Solaris 10 OS Documentation DVD. This file is located in the following directory:
mount-point/README/locale/install_ locale.html |
When you select a locale for your installation, additional related locales might also be installed. This change in behavior occurs in the Solaris 10 release 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.