This chapter describes runtime issues that are known to be problems.
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.
The following bugs in Solaris 10 OS apply to the Common Desktop Environment (CDE).
The Firefox 2.0.0.1 web browser and derived products contain several flaws. Severe impacts of these flaws include enabling a remote attacker to execute arbitrary actions, or causing denial of service. For more information, see http://secunia.com/advisories/24205/. No error message is displayed.
Workaround: Upgrade to Firefox 2.0.0.3.
The name service switch enhancements feature causes the papiPrintersList() command to fail. This command is used by many GNOME applications to populate the print dialog with queue names.
No error message is displayed.
Workaround: None.
The Java DS menu bar and some applications, like Evolution, incorrectly display Chinese date. The incorrect date is displayed in the %-m M %-d D format where M and D are the month and date in Chinese respectively.
Workaround: Perform the following steps:
Backup the /usr/share/locale/LC_MESSAGES/gnome-panel*.mo file.
Download gnome-panel.gnome-2-16.zh_CN.po from http://l10n.gnome.org/POT/gnome-panel.gnome-2-16/gnome-panel.gnome-2-16.zh_CN.po and save it under the /tmp directory.
Edit the file gnome-panel.gnome-2-16.zh_CN.po and replace all occurrences of %-m with %Om, and %-d with %e.
Generate a new gnome-panel.gnome-2-16.zh_CN.po file.
msgfmt -v -o gnome-panel.gnome-2-16.zh_CN.mo /tmp/gnome-panel.gnome-2-16.zh_CN.po |
Copy the file back to the /usr/share/locale/LC_MESSAGES/ directory.
Log out of the system and re-login.
The Group permissions in the Permissions tab should be the same as the Mask permissions in the Access Tab, but on some occasions they appear out of sync.
Workaround: Click the Close button, and then click Reload. View the file properties again. The Group permissions and the Mask permissions will now be in sync again. The permissions are set to what you changed the Mask to in the previous step.
This bug affects management of SolarisTM Trusted Extensions by using the SMC. When the SMC command line with the -B toolbox option is used to pass in the Trusted Extensions options, the command is not executed. This failed execution prevents the use of the SMC CLI to manage Solaris Trusted Extensions. The following error message is displayed:
There was an unrecognized extended, nonstandard option specified with the -x option. Please refer to man pages for additional information and correct syntax usage |
Workaround: Use the SMC GUI for administration of users, roles, and profiles.
When you drag the dtfile icon, the icon and the the mouse pointer might not be displayed. No error message is displayed.
Workaround: Add the following lines to the /usr/dt/config/<locale>/sys.resources file , under #if EXT_SUN_TS OL:
!! DragNDrop protocol. Other styles cause policy violation. *DragInitiatorProtocolStyle: DRAG_DYNAMIC *DragReceiverProtocolStyle: DRAG_DYNAMIC |
When the SMC is used to manage network security templates, the /etc/s ecurity/tsol/tnrhdb file is updated but the tndb cache is not updated. Network security definitions do not take effect. No error message is displayed.
Workaround: After you modify a network entry in the SMC, manually refresh the tndb cache with one of the following commands:
Modify an entry in the file scope:
# /usr/sbin/tnctl -H /etc/security/tsol/tnrhdb |
Modify an entry in the LDAP scope:
# /usr/sbin/tnctl -H <hostname> |
The login fails when you log in to the Solaris Trusted Extensions Java Desktop Systems (Java DS) by using GDM. This failure is caused by the PAM configuration. The pam.conf(4) file does not contain the required entries for GDM.
On login, the following error message is displayed:
The system administrator has disabled access to the system temporarily |
Workaround: Add the following two lines to the /etc/pam.conf file:
gdm account requisite pam_roles.so.1 gdm account required pam_unix_account.so.1 |
For information about the file format, see the pam.conf(4) man page.
When you type the /usr/X11/bin/xrander -s command to set a smaller screen resolution, Trusted Stripe is no longer displayed. This affects the Trusted CDE Desktop but not the Trusted Java DS Desktop. No error message is displayed.
Workaround: After the resolution changes, restart the Workspace Manager. Select windows -> Restart Workspace Manager from the CDE workspace menu and click OK.
The Secure Attention key or hot key, Alt+Break, on PC keyboards does not work on x86 systems. No error message is displayed.
Workaround: None.
On your Java Desktop System software, you cannot set up the following:
Full-screen magnification
Keyboard accessibility features
Workaround: Perform the following steps:
Open the /etc/X11/gdm/gdm.conf file.
Depending on your system's platform, perform the following:
On SPARC based systems:
Look for the line in the file that begins as follows:
command=/usr/openwin/bin/Xsun |
Append the following modification to the line:
+kb +accessx -dev framebuffer1 -dev framebuffer2 |
For example:
+kb +accessx -dev /dev/fbs/pfb1 -dev /dev/fbs/pfb0 |
On x86 based systems:
Look for the line in the file that begins as follows:
command=/usr/X11R6/bin/Xorg |
Append the following modification to the line:
+kb +accessx |
The Removable Media auto run capability in the CDE desktop environment has been temporarily removed from the Solaris 10 software.
Workaround: To use the auto run function for a CD-ROM or another removable media volume, you must do one of the following:
Run the volstart program from the top level of the removable media file system.
Follow the instructions that are included with the CD for access from outside of CDE.
After you delete the last item from the desktop, the item is restored from the handheld device to the desktop when you synchronize your handheld device. Examples of items that you might delete, and then have restored, are the last appointment in your Calendar or the last address in the Address Manager.
Workaround: Manually delete the last entry from the handheld device prior to synchronization.
The following Documentation DVD bugs apply to the Solaris 10 release.
If you remove the SUNWsdocs package, then try to remove other documentation packages, the removal fails. This problem occurs because the SUNWsdocs package is installed with any collection and provides the browser entry point.
Workaround: If you removed the SUNWsdocs package, reinstall the SUNWsdocs package from the documentation media and then remove the other documentation packages.
On systems that are running the current Solaris 10 release, PDF documents on the Solaris 10 Documentation DVD are not accessible in the following European locales:
de (German)
es (Spanish)
fr (French)
it (Italian)
sv (Swedish)
Workaround: Choose one of the following workarounds.
On x86 based platforms, set the environment variable LC_ALL to C acroread. For example, in the C shell, type the following command in a terminal window:
% env LC_ALL=C acroread |
On SPARC based systems, upgrade to Adobe Acrobat Reader 5.0 or a later version.
The following file system bugs apply to the Solaris 10 release.
If a non-global zone is initially configured with a ZFS file system to be mounted with the `add fs subcommand and specifies mountpoint=legacy, the subsequent zone installation fails. The following error message is displayed.
ERROR: No such file or directory: cannot mount </zones/path/root/usr/local> in non-global zone to install: the source block device or directory </path/local> cannot be accessed |
Workaround: Add access to a ZFS file system after installing the non-global zone.
A zpool scrub or resilver operation of large amounts of data might lead to a system hang or panic. No error message is displayed.
Workaround: If the system hangs or panics, perform the following steps:
Reboot the system.
Continue the resilver or scrub operation.
Do not stress the system with additional load until the resilver or scrub operation completes.
ZFS is designed to be a POSIX compliant file system and in most situations, ZFS is POSIX compliant. However, two edge case conditions exist when ZFS does not meet the POSIX compliance tests:
Updating ZFS files system capacity statistics.
Modifying existing data with a 100 percent full file system.
Related CRs:
6362314
6362156
6361650
6343113
6343039
Adding ZFS patches to a Solaris 10 7/07 HW system causes spurious warning messages from the patchadd command because the ZFS packages are being added to the system for the first time. The following error message is displayed:
The following requested patches have packages not installed on the system: Package SUNWzfskr from directory SUNWzfskr in patch 122641-03 is not installed on the system. Changes for package SUNWzfskr will not be applied to the system. |
Workaround:
Ignore the spurious messages from the patchadd command.
If you use the fdisk -E command to modify a disk that is used by a ZFS storage pool, the pool becomes unusable and might cause an I/O failure or system panic.
Workaround:
Do not use the fdisk command to modify a disk that is used by a ZFS storage pool. If you need to access a disk that is used by a ZFS storage pool, use the format utility. In general, disks that are in use by file systems should not be modified.
The following are the issues with the Veritas NetBackup and Brightstor ARCserve Backup products.
The Veritas NetBackup product can be used to back up ZFS files, and this configuration is supported. However, this product does not currently support backing up or restoring NFSv4-style ACL information from ZFS files. Traditional permission bits and other file attributes are correctly backed up and restored.
If a user tries to back up or restore ZFS files, the NFSv4-style ACL information from ZFS files is silently dropped. There is no error message indicating that the ACL information from ZFS files has been dropped.
Support for ZFS/NFSv4 ACLs is under development and is expected to be available in the next Veritas NetBackup release.
Workaround 1:
As of the Solaris 10 7/07 HW release, both the tar and cpio commands correctly handle ZFS files with NFSv4-style ACLs.
Use the tar command with the -p option or the cpiocommand with the -P option to write the ZFS files to a file. Then, use the Veritas NetBackup to back up the tar or cpio archive.
Workaround 2:
As an alternative to using Veritas NetBackup, use the ZFS send and receive commands to back up ZFS files. These commands correctly handle all attributes of ZFS files.
The BrightStor ARCserve Backup (BAB) Client Agent for UNIX (Solaris) can be used to backup and restore ZFS files.
However, ZFS NFSv4-style ACLs are not preserved during backup. Traditional UNIX file permissions and attributes are preserved.
Workaround: If you want to preserve ZFS files with NFSv4-style ACLs, use the tar command with the -p option or the cpio command with the -P option to write the ZFS files to a file. Then, use BAB to backup the tar or cpio archive.
If you add the SUNWzfsg package from a Solaris 10 7/07 HW release to a system that runs a pre-Solaris 10 6/06 release, which does not have the embedded_su patch, the ZFS Administration application wizards are not fully functional.
If you attempt to run the ZFS Administration application on a system without the embedded_su patch, you will only be able to browse your ZFS configuration. The following error message is displayed:
/usr/lib/embedded_su: not found |
Workaround:
Add the embedded_su patch (119574-02) to the system that runs a pre-Solaris 10 6/06 release.
If a host panics with file system I/O occurring to a target, which is connected by using the Solaris iSCSI software initiator, the I/O might not be able to flush or sync to the target device. This inability to flush or sync might cause file system corruption. No error message is displayed.
Workaround:
Use the journaling file system like UFS. Starting with Solaris 10, UFS logging is enabled by default. For more information about UFS, see What’s New in File Systems? in System Administration Guide: Devices and File Systems.
NFSv4 Access Control List (ACL) functions might work improperly if clients and servers in the network are installed with different previous Solaris 10 releases. The affected ACL functions and command-line utilities that use these functions are the following:
acl()
facl()
getfacl
setfacl
For more information about these functions and utilities, see their respective man pages.
For example, errors might be observed in a network that includes the following configuration:
A client that is running Solaris 10 Beta software
A server that is running Solaris 10 software
The following table illustrates the results of the ACL functions in client-server configurations with different Solaris 10 releases.
Operation |
Client S10 OS |
Server S10 OS |
Result |
---|---|---|---|
get ACL |
S10 Beta |
S10 OS |
fabricated ACL * |
get ACL |
S10 OS |
S10 Beta |
works ok |
set ACL |
S10 Beta |
S10 OS |
works ok |
set ACL |
S10 OS |
S10 Beta |
Error: EOPNOTSUP |
Workaround: For the NFSv4 ACL functionality to work properly, perform a full installation of the Solaris 10 OS on both the server and the client.
In the current Solaris 10 version, Solaris implementation of NFSv4 Access Control Lists (ACL) is now compliant with RFC 3530 specifications. However, errors occur for NFSv4 clients that use the Solaris 10 Beta 2 or Beta 1 versions. These clients cannot create files in the NFSv4 servers that are using the current Solaris 10 release. The following error message is displayed:
NFS getacl failed for server_name: error 9 (RPC: Program/version mismatch) |
Workaround: None.
The mkfs command might be unable to create a file system on disks with a certain disk geometry and whose sizes are greater than 8 Gbytes. The derived cylinder group size is too large for the 1-Kbyte fragment. The large size of the cylinder group means that the excess metadata cannot be accommodated in a block.
The following error message is displayed:
With 15625 sectors per cylinder, minimum cylinders per group is 16. This requires the fragment size to be changed from 1024 to 4096. Please re-run mkfs with corrected parameters. |
Workaround: Use the newfs command instead. Or, assign a larger fragment size, such as 4096, when you use the mkfs command.
Creating a UFS file system with the newfs command might fail under the following conditions:
The size of the slice is small, approximately less than 4 Mbytes.
The size of the disk exceeds 8 Gbytes.
The error is caused by the large-size requirement of the file system for metadata. The following warning message is displayed:
Warning: inode blocks/cyl group (295) >= data blocks (294) in last cylinder group. This implies 4712 sector(s) cannot be allocated. /dev/rdsk/c0t0d0s6: 0 sectors in 0 cylinders of 48 tracks, 128 sectors 0.0MB in 0 cyl groups (13 c/g, 39.00MB/g, 18624 i/g) super-block backups (for fsck -F ufs -o b=#) at: # |
Workaround: As superuser, perform one of the following workarounds:
Workaround 1: Specify the number of tracks when you use the newfs command. Follow these steps.
Use the format command to find out the number of tracks to assign. For example:
# format Searching for disks...done AVAILABLE DISK SELECTIONS: 0. c0t0d0 <SUN18G cyl 7506 alt 2 hd 19 sec 248> /pci@1f,4000/scsi@3/sd@0,0 Specify disk (enter its number): |
In the example, the number of tracks is 19.
Assign the number to the file system that you create with the newfs command. For example:
# newfs -v -t 19 /dev/dsk/c0t0d0s6 newfs: construct a new file system /dev/rdsk/c0t0d0s6: (y/n)? y mkfs -F ufs /dev/rdsk/c0t0d0s6 4712 -1 19 8192 1024 16 10 167 2048 t 0 -1 8 128 n mkfs: bad value for nsect: -1 must be between 1 and 32768 mkfs: nsect reset to default 32 Warning: 152 sector(s) in last cylinder unallocated /dev/rdsk/c0t0d0s6: 4712 sectors in 8 cylinders of 19 tracks, 32 sectors 2.3MB in 1 cyl groups (16 c/g, 4.75MB/g, 2304 i/g) super-block backups (for fsck -F ufs -o b=#) at: 32, # |
Workaround 2: Specify the number of bytes per inode (nbpi) in the newfs command to reduce the inode density in the file system. For example:
# newfs -i 4096 /dev/dsk/c0t0d0s6 newfs: construct a new file system /dev/rdsk/c0t0d0s6: (y/n)? y Warning: 1432 sector(s) in last cylinder unallocated /dev/rdsk/c0t0d0s6: 4712 sectors in 1 cylinders of 48 tracks, 128 sectors 2.3MB in 1 cyl groups (16 c/g, 48.00MB/g, 11648 i/g) super-block backups (for fsck -F ufs -o b=#) at: 32, # |
The system cannot generate a dump on a partition that is equal to or greater than 1 Tbyte in size. If such a device is on a system, the following might occur after the system boots subsequent to a system panic:
The system does not save the dump.
The following message is displayed:
0% done: 0 pages dumped, compression ratio 0.00, dump failed: error 6 |
Workaround: Configure the size of your system's dump device to less than 1 Tbyte.
If you use the smosservice command to add OS services to a UFS file system, a message that there is insufficient disk space available is displayed. This error is specific to UFS file systems on EFI-labeled disks.
Workaround: Complete the following workaround.
Apply the SMI VTOC disk label.
Re-create the file system.
Rerun the smosservice command.
The following hardware–related issue and bugs apply to the Solaris 10 release.
ZFS can potentially allocate kernel memory across all system boards on systems with very large memory configurations. One free system board is required for dynamic memory reconfiguration so that the memory from the board to be dynamically reconfigured can be copied to the free board. The dynamic memory reconfiguration means that you cannot dynamically reconfigure memory on systems with very large memory configurations that have ZFS running. High-end SunFireTM servers can relocate kernel pages so that this issue is avoided. These servers must have kernel page relocation (KPR) enabled for domains with more than 32 cores. No error message is displayed
Workaround: Reduce the amount of kernel memory that ZFS can allocate by setting the zfs_arc_max parameter in the /etc/system file. The following example sets the maximum size to 512 Mbytes.
set zfs_arc_max = 0x20000000 |
This bug affects all existing PCI platforms with hot-pluggable slots when the customer tries to hot-plug and configure a card making a 64-bit MEM request, for example, the Crystal 2R Fibre Channel card.
No error message is displayed. However, the configuration fails and the card is not usable.
Workaround: None. Reboot the system with the card inserted in the slot, and the card is configured and ready for operation.
The mpathadm show logical-unit subcommand lists the load balancing global configuration value for the Current Load Balance property. However, entries in the csi_vhci.conf that change the load-balance type for a specific product are not reflected in the mpathadm output even when the setting is active.
If the background processes for the registration tool are left running, the Elite3D and Creator3D framebuffers stop power management. This failure reduces the power savings when the system is in a power-managed state. Under certain conditions, sys-suspend might also hang. No error message is displayed. The system might hang during a system suspend or resume operation.
Workaround:
Run the following command approximately 60 seconds after each login:
# pkill -f basicreg.jar # pkill -f swupna.jar |
A new cryptographic framework is provided in Solaris 10 OS. However, versions 1.0 and 1.1 of the Sun Crypto Accelerator 4000 board's software and firmware do not utilize this framework. Consequently, these versions are not supported in the Solaris 10 OS.
The 2.0 release uses the new framework. This release is available as a free upgrade to current Sun Crypto Accelerator 4000 users who plan to use Solaris 10 OS. Because the Sun Crypto Accelerator 4000 is an export-controlled product, you must contact Sun Enterprise Services or your local sales channel to obtain the free upgrade. Additional information is available on the Sun Crypto Accelerator 4000 web page at Sun's products site.
Support for certain USB 2.0 controllers has been disabled because of incompatibilities between these devices and the EHCI driver. The following message is displayed:
Due to recently discovered incompatibilities with this USB controller, USB2.x transfer support has been disabled. This device will continue to function as a USB1.x controller. If you are interested in enabling USB2.x support please refer to the ehci(7D) man page. Please refer to www.sun.com/io for Solaris Ready products and to www.sun.com/bigadmin/hcl for additional compatible USB products. |
For the latest information about USB devices, see http://www.sun.com/io_technologies/USB-Faq.html.
This Solaris release supports both USB 1.1 and USB 2.0 devices. The following table is a summary of USB devices that work in specific configurations. Connection types can either be direct to the computer or through a USB hub. Note that USB 1.1 devices and hubs are low speed or full speed. USB 2.0 devices and hubs are high speed. For details about ports and speeds of operation, see the System Administration Guide: Devices and File Systems.
Table 3–1 USB Devices and Configurations
USB Devices |
Connection Types |
---|---|
USB 2.0 storage devices |
Direct, USB 1.1 hub, USB 2.0 hub |
USB 1.1 devices except audio |
Direct, USB 1.1 hub, USB 2.0 hub |
USB 1.1 audio devices |
Direct, USB 1.1 hub |
USB 2.0 audio devices |
Not supported |
Power management of interactive devices such as removable media is linked with power management of your monitor and the graphics card that drives your monitor. If your screen is active, devices such as the CD-ROM drive and diskette remain at full-power mode. These devices might switch to low-power mode on a system without a monitor. To restore power to the CD or diskette, type volcheck to obtain the latest status from each removable device.
Alternatively, you can disable power management on your system by using the Dtpower GUI. By disabling power management, these devices are constantly at full power.
Sun Expert3D or Sun Elite3D cards in Sun BladeTM 1000 or Sun Blade 2000 workstations normally switch to low-power mode after an idle period. However, if these cards are set as the primary head in the Xserver, power management does not work. The affected cards remain at full power and no power savings are realized. No error message is displayed.
Workaround: None.
The jfca driver for the following host bus adapters (HBAs) might cause system panics or I/O failures when these HBAs are connected to tape devices:
SG-PCI1FC-JF2
SG-PCI2FC-JF2
The jfca driver for these HBAs is prone to race conditions when certain operations are being run, and thus causes the errors. The operations are the following:
Link reset
Loop reset
Switch reset
Repeated link failures
Error messages similar to the following examples might be displayed:
I/O failure messages
jfca: [ID 277337 kern.info] jfca4: Sequencer-detected error. Recover immediately. last message repeated 18376 times jfca: [ID 716917 kern.notice] jfca4: ExgWarning: SendVerify(1): SHOULD ABORT THE ORIG I/O PKG=30007520bd8! scsi: [ID 107833 kern.warning] WARNING: /pci@1e,600000/SUNW,jfca@3,1/fp@0,0/st@w2100001086108 628,1 (st3): SCSI transport failed: reason 'timeout': giving up |
System panic message
panic[cpu1]/thread=2a100497cc0: BAD TRAP: type=31 rp=2a1004978d0 addr=a8 mmu_fsr=0 occurred in module "jfca" due to a NULL pointer dereference |
Workaround: Do not connect tape devices to either the SG-PCI1FC-JF2 or SG-PCI2FC-JF2 HBA.
A bus contention occurs if Quad Fast-Ethernet (QFE) cards share the same bus with any of the following adapters:
Sun GigaSwift adapter
Sun Dual Gigabit Ethernet and Dual SCSI/P adapter
Sun Quad Gigaswift Ethernet adapter
The infinite-burst parameter of the ce driver that is used by these adapters is enabled by default. Consequently, little or no bus time is available for the QFE ports that share the same bus.
Workaround: Do not place QFE cards on the same bus as the network adapters in the list.
The hat_getkpfnum() DDI function is obsolete. Developers should update their device drivers to not use the hat_getkpfnum() DDI interface. If drivers are using hat_getkpfnum,() warnings similar to the following example are displayed:
WARNING: Module mydrv is using the obsolete hat_getkpfnum(9F) interface in a way that will not be supported in a future release of Solaris. Please contact the vendor that supplied the module for assistance, or consult the Writing Device Drivers guide, available from http://www.sun.com for migration advice. --- Callstack of bad caller: hat_getkpfnum_badcall+93 hat_getkpfnum+6e mydrv_setup_tx_ring+2d mydrv_do_attach+84 mydrv_attach+242 devi_attach+6f attach_node+62 i_ndi_config_node+82 i_ddi_attachchild+4a devi_attach_node+4b devi_attach_children+57 config_immediate_children+6e devi_config_common+77 mt_config_thread+8b |
To determine if a driver is using hat_getkpfnum(), consult the driver source code, or examine the driver's symbols by using nm(). Using the driver mydrv as an example, type the following syntax:
% nm /usr/kernel/drv/mydrv | grep hat_getkpfnum |
For guidance about migrating drivers away from hat_getkpfnum(), refer to Appendix B, Summary of Solaris DDI/DKI Services, in Writing Device Drivers.
The default timeout value for the SCSI portion of the SunSwiftTM PCI Ethernet/SCSI host adapter (X1032A) card does not meet the timeout requirements of Sun's SCSI DVD-ROM drive (X6168A). With marginal media, the DVD-ROM occasionally experiences timeout errors. The only exceptions are Sun Fire 6800, 4810, 4800, and 3800 systems. These systems overwrite the SCSI timeout value by means of OpenBoot PROM.
Workaround: For other platforms, use the on-board SCSI interfaces or DVD-ROM compatible SCSI adapters, such as the following examples:
X1018A (SBus: F501-2739-xx)
X6540A (PCI: F375-0005-xx)
This section provides important information for users of iPlanetTM Directory Server 5.1 who are upgrading to the new Solaris 10 release.
Sun Java System Directory Server 5 2005Q1 replaces iPlanet Directory Server 5.1 that was integrated in the Solaris 9 Operating System. In Solaris 10 OS, this new Directory Server can be installed as part of the Sun Java Enterprise System.
For information about the Sun Java System Directory Server 5 2005Q1, refer to the documentation for the Sun Java System at http://docs.sun.com.
Solaris 10 OS continues to support Directory Server 5.1. You might need to install Directory Server 5.1 under the following circumstances:
You need to recover Directory Server 5.1 data.
You want to migrate your data to Directory Server 5 2005Q1.
In Solaris 10 release, you install the Directory Server 5.1 manually. Follow these steps:
Insert the Solaris 10 Software - 4 CD into your CD-ROM drive.
Become superuser.
In a terminal window, install the Directory Server.
# cd /cdrom/cdrom0/Solaris_10/Product/ # pkgadd -d . IPLTnls IPLTnspr IPLTnss IPLTjss IPLTpldap \ IPLTdsr IPLTdsu IPLTadmin IPLTcons IPLTadcon IPLTdscon \ IPLTadman IPLTdsman |
To install Simplified Chinese localization packages, issue the following additional command:
# pkgadd -d . IPLTcdsu IPLTcadmin IPLTccons IPLTcadcon \ IPLTcdscon IPLTcadman IPLTcdsman |
To install Japanese localization packages, issue the following additional command:
# pkgadd -d . IPLTjdsu IPLTjadmin IPLTjcons IPLTjadcon \ IPLTjdscon IPLTjadman IPLTjdsman |
After installation is complete, configure iPlanet Directory Server 5.1. Refer to Chapter 11, Sun ONE Directory Server Configuration, in System Administration Guide: Naming and Directory Services (DNS, NIS, and LDAP) .
The database formats of the two Directory Server versions are incompatible. Thus, if you are a Directory Server 5.1 user, Sun recommends that you migrate your database to a database that is formatted for the Sun Java System Directory Server 5 2005Q1.
To perform a migration, both versions of the Directory Server must exist in the system that has been upgraded to the Solaris 10 OS. If you are a DS 5.1 user, but are using the compressed archive (.tar.gz) delivery format, you can skip immediately to the migration instructions in Step 2.
On a terminal window, check whether iPlanet Directory Server 5.1 packages are present in your system.
$ pkginfo | grep IPLT |
If the following packages appear as output, then you can go to Step 2 to proceed with the migration. The output indicates that the iPlanet Directory Server 5.1 packages are in the system.
system IPLTadcon Administration Server Console system IPLTadman Administration Server Documentation system IPLTadmin Administration Server system IPLTcons Console Client Base system IPLTdscon Directory Server Console system IPLTdsman Directory Server Documentation system IPLTdsr Directory Server (root) system IPLTdsu Directory Server (usr) system IPLTjss Network Security Services for Java system IPLTnls Nationalization Languages and Localization Support system IPLTnspr Portable Runtime Interface system IPLTnss Network Security Services system IPLTpldap PerLDAP $ |
If the packages do not exist, then install the iPlanet Directory Server 5.1 packages first. Refer to the 4-step procedure in the preceding section Installing Directory Server 5.1. After installation is complete, go to Step 2 to proceed with the migration.
Migrate your iPlanet Directory Server 5.1 database to the current version. For instructions, refer to the documentation collection for the Sun Java System Directory Server at http://docs.sun.com/coll/DirectoryServer_05q1.
After migrating your data, make sure you continue to back up directory data in the same way as you backed up directory data before migration. Future disaster recovery might require the migrated database.
The following issues involve the kernel debugger.
The dbx debugger terminates with a memory access failure while processing certain 64-bit executable files and libraries. However, the problem does not affect the normal use of these 64-bit objects. An error message similar to the following example is displayed:
dbx: internal error: signal SIGBUS (invalid address alignment) |
Workaround: Use either the mdb debugger or the Solaris Dynamic Tracing facility instead. These alternatives can diagnose processes that use the 64-bit objects.
A system that is running the Solaris kernel debugger to debug a live system might loop with incomplete error messages. This loop occurs when the OpenBoot PROM's master CPU is changed. A system reset restores the system to operation. However, the traces of the original failure are lost. Consequently, you cannot perform a diagnosis of the fatal reset.
Workaround: When the system is at the PROM level, the OpenBoot's ok prompt is displayed. In a system with multiple CPUs, the ok prompt is preceded by a number that is enclosed in curly braces. This number indicates the active CPU in the system. To run your debug session while at the PROM level, use the following steps.
Raise pil to f by typing the following command:
{0} ok h# 0f pil! |
Use the switch-cpu command to selectively switch from the currently active CPU to different CPUs. For example, to switch from CPU #0 to CPU #1, type the following command:
(0) ok 1 switch-cpu |
The ok prompt is now preceded by the number of the CPU to which you switched.
{1} ok |
Run your debugger.
At the end of your debugger session, issue a reset-all command to return the system to normal use.
Make sure that you upgrade the system to the latest version of the OpenBoot PROM.
This section describes localization issues that apply to Solaris 10 OS.
When you log in to the Trusted Java DS with UTF-8 or Asian locales, the Input Method Switcher application, iiim-panel, appears per label by default. Thus in multiple label environment, multiple iiim-panel appears, which could be confusing to the user.
No error message is displayed.
Workaround: Stop using the iiim-panel. Perform the following steps:
Right-click on iiim-panel and select Preference. The Input Method Preference Editor, iiim-properties, is displayed.
Select None or Attach to Each Application from the Input Method Status and Switcher Placement list in the General tab.
Press Apply or Click the OK buttton.
When Attach to each application is selected, language switcher list will not be displayed for GTK applications. You can switch input language through non-GTK applications or by running GTK applications with X Input Method instead of IIIM. For example:
% env GTK_IM_MODULE=xim gedit |
Wnn8 Japanese Input method cannot be used if the Wnn8 servers are not enabled.
Workaround: Enable the Wnn8 servers:
# svcadm enable wnn8/server |
In addition, select Wnn8 as the Japanese Language engine by running the iiim-properties command.
The keyboard shortcuts in Mozilla 1.7 are ambiguous in the Spanish (Es) locale. For example, you can use Ctrl-S to copy or to save. No error message is displayed.
Workaround: Use the shortcut keys assigned to user actions from the product menu.
This bugs affects how you uninstall Solaris Trusted Extensions by using prodreg in locales other than C, POSIX, or any English locale. Strings are not displayed correctly in these locales when you uninstall by using prodreg.
No error message is displayed. The uninstaller shows placeholder strings, and buttons do not display correctly.
Workaround: Before you uninstall with prodreg, run the following commands:
# cd <Solaris_installation_media>/Solaris_10/ExtraValue/CoBundled/Trusted_Extensions # cp -rp locale /var/sadm/tx |
Then uninstall with prodreg.
A user who has the Primary Administrator right can not use the input method for specific locales which prevents that user from entering characters normally. The input method status is not displayed in the workspace. No error message is displayed.
Workaround: Add the following lines to the /etc/security/exec_attr file:
Primary Administrator:solaris:cmd:::/usr/bin/csh:uid=0;gid=0 Primary Administrator:solaris:cmd:::/usr/bin/ksh:uid=0;gid=0 Primary Administrator:solaris:cmd:::/usr/bin/sh:uid=0;gid=0 |
For information about the file format, see the exec_attr(4) man page.
When you upgrade the OS to the Solaris 10 6/06 or Solaris 10 11/06 release, the input method framework and individual input methods get upgraded from rev.10 to rev.12. However, ChuYin is not in the list of supported input methods. Also, you cannot use the function keys F2 and F3 to switch methods
Workaround: Use PinYin to type traditional Chinese characters with Hanyu PinYin. Use Ctrl+Shift to switch input methods.
The AltGr key does not work as a mode switcher for the Russian Xsun layout inru_RU.KOI8-R and ru_RU.ANSI1251 locales.
Workaround 1: Switch to the ru_RU.UTF-8 or the ru_RU.ISO8859-5 locale.
Workaround 2: Use IIIMFTM instead of the Russian keyboard layout.
The Arabic6.kt keytable does not contain any Arabic symbols.
Workaround: Use IIIMF. Set the Arabic input through the gimlet switcher instead of switching to Arabic by using the Altgr key.
If your x86 system is using Xorg as the default Xserver, the Arabic font (iso7759-6) does not appear in the ar locale. This error does not occur if you are using XSun instead of XOrg.
Workaround: Follow these steps.
As superuser, edit /usr/dt/config/Xservers.
Uncomment or add the following line:
:0 Local local_uid@console root /usr/openwin/bin/Xsun :0 -nobanner -defdepth 24 |
Comment out the following line:
:0 Local local_uid@console root /usr/X11/bin/Xorg :0 |
Reboot the system.
Alternatively, you can log in to ar_EG.UTF-8 or other UTF-8 locales.
If you exchange multibyte data between a PDA device and Solaris CDE, the data might be corrupted in both environments.
Workaround: Back up your data on your personal computer with the PDA backup utility before you run the Solaris PDASync application. If you accidentally exchange multibyte data and corrupt that data, restore your data from the backup.
The function to add regions in the localeadm command no longer works if you create a new configuration file. The Language CD is not detected when you add the following regions:
Southern Europe
North America
Northern Europe
The following error message is displayed:
No langcd image has been found in /cdrom/sol_10_1005_x86_4/Solaris_10/Product No langcd image has been found in /cdrom/sol_10_1005_x86_4 /cdrom/sol_10_1005_x86_4 /cdrom/sol_10_1005_x86_4 /cdro m/sol_10_1005_x86_4 /cdrom/sol_10_1005_x86_4 Please enter the path to this image/disk, or enter 'q' to quit: |
Workaround: When you are prompted to create a new configuration file, select No. Instead, use the configuration file that was installed in the system.
When the Locale_config configuration file is created using the DVD/net image, using the Locale_config file to add locales leaves many unlocalized messages on the Gnome Desktop. No error message is displayed.
Workaround 1:
Login as superuser and do the following:
Change to the location of the localeadm Locale_config file.
# cd /usr/sadm/lib/localeadm/ |
Revert to the existing Locale_config file bundled with the localeadm utility.
# mv Locale_config_S10.txt.old Locale_config_S10.txt |
Workaround 2:
Re-create the Locale_config file by using the CD images.
Keycode 50 is not working for European keyboard layouts. This problem occurs with all European *6.kt keytable files. All keytables assign some symbols to keycode 50, but the key does not work. No error message is displayed.
Workaround:
Edit the *6.kt files in the /usr/openwin/share/etc/keytables directory. Duplicate keycode 50 for keycode 49 in the affected *6.kt file. For example, add the following entry for keycode 49 to the affected keytable file:
49 RN XK_numbersign XK_asciitilde
In GNOME when you select certain Arabic fonts, the characters do not display. This problem appears when you select fonts for applications, the desktop, or the window title using the GNOME font properties menu. The affected fonts include:
Akhbar MT (Regular, Bold)
Shayyal MT (Regular, Bold)
Naskh MT (Regular, Bold)
No error message is displayed.
Workaround:
Use any of the newly delivered Kacst family of fonts to display Arabic characters in GNOME applications.
Multiple language input is supported in UTF-8 locales, but the language switch is not working with session-saved applications where mouse button 1 is clicked first after login. This problem occurs with the Java Desktop System (Java DS). No error message is displayed.
Workaround:
Click mouse button 1 on the backgroundworkspace or Launch Menu before clicking any application.
The keyboard shortcuts in Mozilla 1.7 are unusual, especially in Spanish locale. For example, Ctrl-S is being used for copying as well as for saving. No error message is displayed.
Workaround:
Identify the shortcut keys assigned to user actions from menu in the product.
When migrating to UTF-8 locales, the files affect the method that you use to import or export data.
Microsoft Office files are encoded in Unicode. StarOffice applications can read and write the Unicode encoded files.
HTML files authored using HTML editors such as Mozilla Composer, or HTML files saved by a web browser, usually contain a charset encoding tag. After exporting or importing, you can browse such HTML files with the Mozilla Navigator web browser, or edit the files with Mozilla Composer, according to the encoding tag in the HTML file.
Some HTML files might be displayed in garbage characters. This problem is typically due to the following reasons:
The charset encoding tag is incorrect.
The charset encoding tag is missing.
To find the charset encoding tag in the HTML file, perform the following actions:
Open the file with Mozilla.
Press Ctrl-i, or click View to open the View menu.
Click Page Info.
The charset information is in the bottom of the General tab, for example:
Content-Type text/html; charset=us-ascii |
If the string charset=us-ascii does not match the actual encoding of the file, the file might appear broken. To edit the encodings of the HTML file, perform the following actions:
Open the file with Mozilla Composer.
Open the File menu.
Select Save as Charset.
Choose the correct encoding. Mozilla Composer automatically converts the encoding and the charset tag as appropriate.
Modern mails are tagged with the MIME charset tag. The Email and Calendar application accepts MIME charset tags. You do not need to perform any encoding conversion.
Plain text files do not have a charset tag. If the files are not in UTF-8 encoding, encoding conversion is needed. For example, to convert a plain text file encoded in Traditional Chinese big5 to UTF-8, execute the following command:
iconv -f big5 -t UTF-8 inputfilename > outputfilename |
You can also use the File System Examiner for the encoding conversion.
You can use the Text Editor to read and write character encoding text automatically or by specifying an encoding explicitly when opening or saving a file.
To start Text Editor, click Launch, then choose Applications->Accessories->Text Editor.
If file names and directory names using multibyte characters are not in UTF-8 encoding, encoding conversion is needed. You can use File System Examiner to convert file and directory names and the contents of plain text files from legacy character encodings to UTF-8 encoding. Refer to the online Help for File System Examiner for more information.
To start File Systems Examiner, click Launch, then choose Applications->Utilities->File System Examiner.
When you access non-UTF-8 file or directory names on Microsoft Windows via SMB using File Manager, you can access the non-UTF-8 file or directory names without encoding conversion.
For applications that are not ready to migrate to Unicode UTF-8, you can create a launcher on a front panel to start the application in legacy locales. You can also launch the applications directly from the command line. Perform the following steps to create a launcher for an application.
Right-click on the panel where you want to place the launcher.
Choose Add to Panel->Launcher.
Use the following format to type the entry in the Command field in the Create Launcher dialog:
env LANG=locale LC_ALL= locale application name |
For example, if you want to launch an application called motif-app from /usr/dt/bin in the Chinese Big5 locale, enter the following text in the Command field of the Create Launcher:
env LANG=zh_TW.BIG5 LC_ALL=zh_TW.BIG5 /usr/dt/bin/motif-app |
Click OK to create the launcher on the panel.
When you need to run CLI (command line interface) applications which are specific to a legacy locale, open a Terminal window in the legacy locale first and then run the CLI applications in the same Terminal window. To open a Terminal window in a legacy locale, enter the following command:
eng LANG=locale LC_ALL=locale GNOME-TERMINAL –disbable-factory. |
Instead of opening a new Terminal window in a legacy locale, you can switch the locale setting from UTF-8 to a legacy locale in the current Terminal window by changing the encoding the Set Character Encoding menu in the Terminal window. Then you must also set the LANG and LANG environment variables to the current shell.
Software support for three additional keyboard layouts has been added to the Solaris OS: Estonian keyboard Type 6, French Canadian keyboard Type 6, and Polish programmers keyboard Type 5.
This software gives users in Estonia, Canada, and Poland greater flexibility for keyboard input by modifying standard U.S. keyboard layouts to their own language needs.
Currently, no hardware is available for the three additional keyboard layout types.
Workaround: To take advantage of this new keyboard software, modify the /usr/openwin/share/etc/keytables/keytable.map file in one of the following ways:
For the Estonian Type 6 keyboard, make the following changes:
Change the US6.kt entry to Estonia6.kt in the /usr/openwin/share/etc/keytables/keytable.map file. The modified entry should read as follows:
6 0 Estonia6.kt |
Add the following entries to the /usr/openwin/lib/locale/iso8859-15/Compose file:
<scaron> |
: "/xa8" |
scaron |
<scaron> |
: "/xa6" |
scaron |
<scaron> |
: "/270" |
scaron |
<scaron> |
: "/264" |
scaron |
Reboot the system for the changes to take effect.
For the French Canadian Type 6 keyboard, make the following changes:
Change the US6.kt entry to Canada6.kt in the /usr/openwin/share/etc/keytables/keytable.map file. The modified entry should read as follows:
6 0 Canada6.kt |
Reboot the system for the changes to take effect.
If you are using the existing Polish Type 5 keyboard layout, make the following changes:
Change the Poland5.kt entry to Poland5_pr.kt in the /usr/openwin/ share/etc/keytables/keytable.map file. The modified entry should read as follows:
4 52 Poland5_pr.kt |
If you are using a keyboard with dip-switches, make sure the switches are set to the correct binary value for the Polish keytable entry (binary 52) before rebooting the system.
If you are using a standard U.S. Type 5 keyboard, change the US5.kt entry to Poland5_pr.kt in the /usr/openwin/share/etc/keytables/keytable.map file. The modified entry should read as follows:
4 33 Poland5_pr.kt |
Reboot the system for the changes to take effect.
On all locales, the Document Viewer cannot print localized files that are in Portable Document Format (PDF).
Workaround: Choose one of the following workarounds:
On SPARC based systems, use the Acrobat Reader to print localized PDF files.
On x86 based systems, use StarOffice to create and then print PDF files.
Special keys on the left of the keyboard do not work on European keyboard mappings. This problem affects all European locales.
Workaround: Use shortcut keys instead of the special keyboard keys. The following example lists shortcut keys and the corresponding functions:
Ctrl-Z - Undo
Ctrl-C - Copy
Ctrl-V - Paste
Alt-Tab allows you to switch between windows.
On all locales, the Alt key and the Shift key might not function as modifier keys when you use the Internet/Intranet input method. For example, the Shift-arrow key combination might not allow you to select text. Instead, the combination might insert Latin characters.
Workaround: Use a different input method, for example, Default. To switch input methods, right-click on an object and select Input method.
The postscript printer does not bundle Chinese or Korean fonts. Consequently, in Chinese or Korean locales, if you attempt to print from the Mozilla browser, the characters are printed within a box. The Common UNIX Printer System (CUPS) needs to convert the Mozilla postscript fonts before a file can be printed.
Workaround: Perform the following steps.
Click Launch => Preferences => Printers.
Right-click the PostScript printer icon, then select Properties.
Click the Advanced tab.
Set the Ghostscript pre-filtering to Convert to PS level 1.
The sort capability in the European UTF-8 locales does not work properly.
Workaround: Before you attempt to sort in a FIGGS UTF-8 locale, set the LC_COLLATE variable to the ISO–1 equivalent.
# echo $LC_COLLATE > es_ES.UTF-8 # LC_COLLATE=es_ES.IS08859-1 # export LC_COLLATE |
Then start sorting.
The following networking bugs apply to the Solaris 10 release.
The symbolic link between /lib/libmd.so and /lib/libmd.so.1 is missing.
The following error message is displayed:
libmd.so: not found |
Workaround: Log in as a superuser. Type the following command on the command line to manually add the symbolic link:
ln -s /lib/libmd.so.1 /lib/libmd.so |
If an iSCSI target or an array returns more than one IP address as part of its send target response, the initiator takes into account only the last address in the list and not the first one, as it used to prior to this release. As a result, if the last IP address is bad or invalid, the connection to this target fails.
Workaround: Return the different target portal group tags (TPGT) for each entry in its send target response. The initiator tries to establish a connection to all the IP addresses so that the connection succeeds.
The system Domain of Interpretation (DOI) is not configurable. When the SMC is used to create a new trusted network template, the SMC sets the DOI to 0 and Solaris Trusted Extensions does not function correctly. Various error messages are displayed.
Workaround: Set the DOI to 1 using the SMC.
Memory leak in NSS with ECC and RSA cipher suites might cause a system hang or system panic. The out of memory error message is displayed.
Workaround: Install the following patches:
Patch ID 119213-09 for SPARC based systems.
Patch ID 119214-09 for x86 based systems.
The Solaris iSCSI software initiator does not support logical units with a LUN greater than 255. No error message is displayed.
Workaround:
Change the logical unit numbers of the target device to less than 255.
When you register to a Solaris 10 7/07 HW OS for remote update management using the Sun Update Connection, your system information is displayed. If your system has more than one Ethernet card, the same MAC address is displayed for all the Ethernet cards. No error message is displayed.
Workaround: None.
Sixty-four-bit programs that create PF_ROUTE sockets and parse the contents of RTM_IFINFO messages in the if_msghdr_t structure might work incorrectly unless they are recompiled.
In this Solaris release, IP forwarding is disabled by default. This setting applies to both IPv4 and IPv6 regardless of other system configurations. Systems with multiple IP interfaces that formerly forwarded IP packets by default no longer have this automatic feature. To enable IP forwarding in multihomed systems, administrators must manually perform additional configuration steps.
Workaround: The command routeadm enables IP forwarding. The configuration changes that are the result of routeadm usage persist across system reboots.
To enable IPv4 forwarding, type routeadm -e ipv4-forwarding .
To enable IPv6 forwarding, type routeadm -e ipv6-forwarding .
To apply the enabled IP-forwarding configuration to the currently running system, type routeadm -u.
For more information about IP forwarding, see the routeadm(1M) man page.
The Generic LAN Driver Version 3 (GLDv3) incorrectly sets the field length of Logical Link Control (LLC) frames. Consequently, protocols such as AppleTalk that are dependent on LLC do not function correctly. No error message is displayed. The problem affects the following network interface controllers:
bge
e1000g
xge
Workaround: None.
A zone can be configured so that the zone's IP address becomes part of an IP Network Multipathing (IPMP) group. The configuration process is documented in How to Extend IP Network Multipathing Functionality to Shared-IP Non-Global Zones in System Administration Guide: Solaris Containers-Resource Management and Solaris Zones.
If all the network interfaces in the IPMP group fail, a zone does not boot if it has an IP address that is part of the IPMP group.
The following example illustrates the result if you attempt to boot the zone.
# zoneadm -z my-zone boot zoneadm: zone 'my-zone': bge0:1: could not set default interface for multicast: Invalid argument zoneadm: zone 'my-zone': call to zoneadmd failed |
Workaround: Repair at least one network interface in the group.
Internet SCSI (iSCSI) targets might report cyclic redundancy check (CRC) errors if DataDigests are enabled. User applications that update input/output buffers after transmitting to the iSCSI initiator might cause a miscalculation of the CRC. When the target responds with a CRC error, the iSCSI Initiator retransmits the data with the correct DataDigest CRC. Data integrity is maintained. However, data transfer performance is affected. No error message is displayed.
Workaround: Do not use the DataDigest option.
During system boot, multiple instances might not connect to their LAN Emulation (LANE) instance if more than eight LANE instances are on a single adapter. This bug does not appear at multiuser level.
Workaround: To reinitialize your SunATM network, perform the following steps:
Verify the problem by issuing a lanestat -a command.
Instances that are not connected have Virtual Circuit Identifier (VCI) values of 0 to the LAN Emulation Server (LES) and Broadcast and Unknown Address Server (BUS).
Stop and restart your SunATM network.
# /etc/init.d/sunatm stop # /etc/init.d/sunatm start |
Reset netmasks or any other network setup for the SunATM interfaces.
If you configure multiple IP tunnels between two IP nodes, and enable ip_strict_dst_multihoming or other IP filters, packet loss might result.
Workaround: Choose one of the following:
First, configure a single tunnel between the two IP nodes. Add addresses to the tunnel by using the ifconfig command with the addif option.
Do not enable ip_strict_dst_multihoming on tunnels between two IP nodes.
The following security issues applies to the Solaris 10 release.
After the account management PAM module for LDAP (pam_ldap) is enabled, users must have passwords to log in to the system. Consequently, nonpassword-based logins fail, including those logins that use the following tools:
Remote shell (rsh)
Remote login (rlogin)
Secure shell (ssh)
Workaround: None.
A Sun StorEdgeTM T3 system might panic if an application uses the HTTP interface to send tokens with out-of-range parameters.
This section describes issues that involve the Service Management Facility of Solaris 10 OS. For more information about this new feature in the Solaris OS, see Solaris Service Manager in Solaris 10 7/07 HW What’s New.
When a host has no local printers configured, two print services, ipp-listener and rfc1179, are set to offline by default. These services are automatically moved to online after local printers are configured on the host. The default offline settings of these services do not indicate an error. Therefore, no user intervention is required.
Workaround: None.
On systems that do not use Network Information Service (NIS) or NIS+ name service, the NFS and autofs services are disabled. The failure is due to these services' dependency on the keyserv daemon. The keyserv daemon relies on the RPC domain name, which is not set on systems that do not use NIS or NIS+. Consequently, the failure of the keyserv daemon causes the NFS and autofs services to become disabled.
Workaround: To enable the services, perform the following steps:
Become superuser.
Issue the following commands:
# svcadm disable network/rpc/keyserv # svcadm disable -t network/nfs/client:default # svcadm enable network/nfs/client:default # svcadm disable -t network/nfs/server:default # svcadm enable network/nfs/server:default # svcadm disable -t network/rpc/gss:ticotsord # svcadm enable network/rpc/gss:ticotsord |
During system startups, sometimes the login services such as console or ssh logins start before remote file systems and naming services become available. Consequently, the user name might not be recognized or the user's home directory might not be available.
Workaround: If the error occurs, wait for a few seconds and then log in again. Alternatively, log in from a local account to view the system state.
The following Smart Card bugs apply to Solaris 10 OS.
If ocfserv terminates and the display is locked, the system remains locked even when a smart card is inserted or removed.
Workaround: Perform the following steps to unlock your system:
Perform a remote login to the machine on which the ocfserv process was terminated.
Become superuser.
Kill the dtsession process by typing the following in a terminal window.
# pkill dtsession |
ocfserv restarts and smart card login and capability are restored.
The Edit Config File menu item in the Smartcards Management Console does not edit smart card configuration files that are located in /etc/smartcard/opencard.properties . If the menu item is selected, a warning is displayed which indicates not to continue unless requested by technical support.
Workaround: Do not use the Edit Config File menu item in the Smartcards Management Console. For information on smart card configuration, see the Solaris Smartcard Administration Guide.
The following section describes behavior changes in certain commands and standards in Solaris 10 OS.
Sometimes the cfgadm -c unconfigure command fails because of pending I/Os. With the changed kernel, the command is retried offline. The cfgadm's unconfigure command might, however, succeed later without any notice to the user.
Workaround: Run the cfgadm -al command.
Solaris 10 OS includes Bash 2.0.5b. This shell no longer automatically exports the following variables to the environment:
HOSTNAME
HOSTTYPE
MACHTYPE
OSTYPE
This new behavior applies even if the shell assigns default values to these variables.
Workaround: Export these variables manually.
The behavior of /usr/bin/ln has changed to adhere to all of the standards from SVID3 through XCU6. If you use the ln command without the -f option to link to an existing target file, the link is not established. Instead, a diagnostic message is written to standard error, and the command proceeds to link any remaining source files. Finally, the ln command exits with an error value.
For example, if file b exists, the syntax ln a b generates the following message:
ln: b: File exists |
This behavior change affects existing shell scripts or programs that include the ln command without the -f option. Scripts that used to work might now fail in Solaris 10 OS.
Workaround: Use the -f option with the ln command. If you have existing scripts that execute the link utility, make sure to modify these scripts to comply with the command's new behavior.
In Solaris 10 OS, tcsh has been upgraded to version 6.12. This version no longer accepts environment variables whose names use a dash or an equals sign. Scripts that contain setenv lines and that work in earlier Solaris versions might generate errors in the current Solaris 10 release. The following error message is displayed:
setenv: Syntax error |
For more information, refer to the tcsh man page for the Solaris 10 OS.
Workaround: Do not use the dash or equals sign in names for environment variables.
Applications that were built in strict standard C conformance mode are affected by the behavior changes of certain library functions. An example is applications that were compiled by using the cc -Xc or c89 compilation mode. The behavior has changed for the following library functions:
fgetc()
fgets()
fgetwc()
fgetws()
getc()
getchar()
gets()
getwc()
getwchar()
getws()
A formal interpretation of the 1990 C Standard requires that after an end-of-file condition is set, no more data is returned from the file on subsequent input operations. The exception is if the file pointer is repositioned or the error and end-of-file flags are explicitly cleared by the application.
The behavior for all other compilation modes remains unchanged. Specifically, the interfaces can read additional newly written data from the stream after the end-of-file indicator has been set.
Workaround: Call fseek() or clearerr() on the stream to read additional data after the EOF condition has been reported on the stream.
Due to larger UIDs, processor ids, and cumulative execution time, the columns of the ps command output have been widened. Customer scripts should not assume fixed output columns.
Workaround: Scripts should use the -o option of the ps command.
For more information, see the ps(1) man page.
The command ping -v fails when the command is applied to addresses that use Internet Protocol version 6 (IPv6). The following error message is displayed:
ping: setsockopt IPV6_RECVRTHDRDSTOPTS Invalid argument |
Workaround: None. To obtain the same ICMP packet information that ping -v provides, use the snoop command.
The following Solaris Volume Manager bugs apply to the Solaris 10 release.
If you have a Solaris Volume Manager mirrored root (/) file system in which the file system does not start on cylinder 0, all submirrors you attach must also not start on cylinder 0.
If you attempt to attach a submirror starting on cylinder 0 to a mirror in which the original submirror does not start on cylinder 0, the following error message is displayed:
can't attach labeled submirror to an unlabeled mirror |
Workaround: Choose one of the following workarounds:
Ensure that both the root file system and the volume for the other submirror start on cylinder 0.
Ensure that both the root file system and the volume for the other submirror do not start on cylinder 0.
By default, the JumpStart installation process starts swap at cylinder 0 and the root (/) file system somewhere else on the disk. Common system administration practice is to start slice 0 at cylinder 0. Mirroring a default JumpStart installation with root on slice 0, but not cylinder 0, to a typical secondary disk with slice 0 that starts at cylinder 0, can cause problems. This mirroring results in an error message when you attempt to attach the second submirror. For more information about the default behavior of Solaris installation programs, see the Solaris 10 Installation Guides.
In non-English locales, the Solaris Volume Manager metassist command might fail to create volumes. For example, if LANG is set to ja (Japanese), the following error message is displayed:
xmlEncodeEntitiesReentrant : input not UTF-8 Syntax of value for attribute read on mirror is not valid Value "XXXXXX"(unknown word) for attribute read on mirror is not among the enumerated set Syntax of value for attribute write on mirror is not valid Value "XXXXXX"(Parallel in Japanse) for attribute write on mirror is not among the enumerated set metassist: XXXXXX(invalid in Japanese) volume-config |
Workaround: As superuser, set the LANG variable to LANG=C.
For the Bourne, Korn, and Bash shells, use the following command:
# LANG=C; export LANG |
For the C shell, use the following command:
# setenv LANG C |
Creating Solaris Volume Manager volume configurations with the metassist command might fail if an unformatted disk is in the system. The following error message is displayed:
metassist: failed to repartition disk |
Workaround: Manually format any unformatted disks before you issue the metassist command.
If you create a Solaris Volume Manager RAID-1 (mirror) or RAID-5 volume in a disk set that is built on top of a soft partition, hot spare devices do not work correctly.
Problems that you might encounter include, but are not limited to, the following:
A hot spare device might not activate.
A hot spare device status might change, indicating the device is broken.
A hot spare device is used, but resynced from the wrong drive.
A hot spare device in use encounters a failure, but the broken status is not reported.
Workaround: Do not use this configuration to create a Solaris Volume Manager RAID-1 or RAID-5 volume in disk sets.
You cannot replace a failed drive with a drive that has been configured with the Solaris Volume Manager software. The replacement drive must be new to Solaris Volume Manager software. If you physically move a disk from one slot to another slot on a Sun StorEdge A5x00, the metadevadm command fails. This failure occurs when the logical device name for the slice no longer exists. However, the device ID for the disk remains present in the metadevice replica. The following message is displayed:
Unnamed device detected. Please run 'devfsadm && metadevadm -r to resolve. |
You can access the disk at the new location during this time. However, you might need to use the old logical device name to access the slice.
Workaround: Physically move the drive back to its original slot.
If you remove and replace a physical disk from the system, and then use the metarecover -p -d command to write the appropriate soft partition specific information to the disk, an open failure results. The command does not update the metadevice database namespace to reflect the change in disk device identification. The condition causes an open failure for each such soft partition that is built on top of the disk. The following message is displayed:
Open Error |
Workaround: Create a soft partition on the new disk instead of using the metarecover command to recover the soft partition.
If the soft partition is part of a mirror or RAID 5, use the metareplace command without the -e option to replace the old soft partition with the new soft partition.
# metareplace dx mirror or RAID 5 old_soft_partition new_soft_partition |
This section describes issues that apply to the Sun Java Desktop System (Java DS) in the Solaris 10 OS.
This section describes issues related to Email and Calendars.
If you drag and drop email messages to a new email message body, the content of the new email message is corrupted.
Workaround: To send multiple attachments, perform the following steps:
Select the messages you want to attach.
On the Menu bar, choose Action => Forward => Attached.
Alternatively, you can press Ctrl-J to send the messages.
After you change the authentication type for the incoming mail server, Email and Calendar might not work correctly.
Workaround: Restart Email and Calendar.
After you import an LDAP Data Interchange Format file containing several contacts, only some of the contacts are displayed in your contact folder. This is a display problem only. Email and Calendar has imported all the contacts.
Workaround: Restart Email and Calendar.
This section describes login issue.
You might encounter the following error message when you log in to a Java Desktop System session:
Could not look up internet address for hostname. This will prevent GNOME from operating correctly. It may be possible to correct the problem by adding hostname to the file /etc/hosts |
Workaround: Ensure that your hostname is set up correctly in the /etc/hosts file. Perform the following steps:
Set the hostname in the /etc/hosts file as follows:
127.0.0.1 localhost loghost hostname localhost.localdomain |
hostname is the name of your system.
Ensure that your hostname is listed in the /etc/nodename file. This file must also contain the following line:
127.0.0.1 localhost loghost hostname localhost.localdomain |
When you log into Java Desktop System Release 3, your $PATH is set incorrectly to the following:
/usr/bin::/usr/dt/bin:/usr/openwin/bin:/bin: /usr/ucb:/usr/openwin/bin:/usr/dt/bin |
Workaround: Remove the following from your $PATH:
/usr/openwin/bin:
/bin:
::
The resulting path should be similar to the following example:
/usr/bin:/usr/dt/bin:/usr/ucb:/usr/openwin/bin:/usr/dt/bin |
If you use dtlogin remote connection, you cannot connect to the GNOME Display Manager from certain systems.
Workaround: When you are prompted to select the remote login, specify the IP address instead of the hostname.
If you use the Yelp browser to open the online help for Volume Control, the help file for the Keyboard Accessibility panel application is opened instead.
Workaround: None.
If you open an application's online help and no help files exist for that application, an error dialog box is displayed. Unless you click OK, the online Help system freezes and you cannot open the online help of other applications that you start subsequently.
Workaround: You must click the OK button in the error dialog box.
You cannot print documents from the Mozilla browser if the documents contain Unicode characters that are not in the Basic Multilingual Plane (BMP).
Workaround: None.
In the Mozilla browser, you can specify that User Preferences should be transferred to and from the Roaming Access server. You specify your Roaming Access option by following these steps:
On the browser, click Edit and select Preferences.
Select Roaming User, then select Item Selection.
On the right panel, select User Preferences.
However, the selection of User Preferences does not take effect.
Workaround: None.
In the Mozilla browser, you enable caret browsing by pressing F7. When caret browsing is enabled, the keyboard shortcut Ctrl-Home brings you to the beginning of the web page that you are browsing. However, this keyboard shortcut does not work when you browse certain sites such as www.yahoo.com and www.mozilla.org.
Workaround: Disable caret browsing by pressing F7.
User preferences in your home account for an earlier version of the GNOME Desktop might be partly incompatible with the version on the Java DS Release 3.
Workaround: Reset your preferences. Perform the following steps:
Log out of the Java Desktop System.
Click Session and choose Failsafe terminal.
Log in.
In the failsafe terminal window, enter the following commands:
% gnome-cleanup exit |
Log in again.
Your GNOME preferences are now reset.
The GNU Image Manipulation Program (GIMP) is not available in the Graphics menu.
Workaround: Perform the following steps.
Open a terminal window.
Edit the /usr/share/applications/gimp-2.0.desktop file.
Change the Exec and TryExec lines to add the full path to the GIMP binary:
TryExec=/usr/sfw/bin/gimp2.0 Exec=/usr/sfw/bin/gimp-remote-2.0 %u |
You might be unable to complete the online registration of the StarOffice 7 software if the software cannot find Mozilla on the system. The software must be able to locate the Email and Calendar application to successfully send documents.
Workaround: Add /usr/sfw/bin to your PATH. Perform the following steps.
Open a terminal window.
Issue the following command:
% export PATH=/usr/sfw/bin:$PATH |
To start the StarOffice software, issue the following command:
% soffice |
Complete the StarOffice registration procedure.
The slide bar and the side counter do not work when the Sound Recorder is recording a new.wav file.
Workaround: None.
The option in the Volume Control panel application that enables you to start the Volume Control desktop applications does not work.
Workaround: None.
In the Solaris software, you restrict application launching by setting to true the /desktop/gnome/lockdown/restrict_application_launching gonf key. This setting allows only certain applications to appear on the Launch menu where you can start these applications. The allowed applications are listed in the /desktop/gnome/lockdown/allowed_applications gonf key.
Currently, the list includes applications that are outdated and are no longer included in the Java Desktop System software. Moreover, the list also contains references to certain applications with incorrect directory locations. Consequently, if you restrict application launching, certain key applications such as Mozilla or StarOffice do not appear on the Launch menu.
Workaround: Perform the following steps.
Become superuser.
Remove the ~/.gconf/desktop/gnome/lockdown directory if the directory exists.
# rm -rf ~/.gconf/desktop/gnome/lockdown |
Log out of the system and then log in again.
Using the keyboard indicator might make the keyboard unusable when you switch between X servers.
Workaround: None. Do not use the Keyboard Indicator.
The File Manager might fail if you use the following View options:
View as Catalog
View as Image Collection
Depending on the View options that you use, the following error messages might be displayed:
Error:
The application nautilus has quit unexpectedly |
Error:
The Catalog view encountered an error while starting up |
Error:
The Image Collection view encountered an error while starting up |
Workaround: None. Every time these problems occur, restart File Manager or click the Restart Application button on the crash dialog box.
If you use the Sound Recorder multimedia application in CD Quality, Lossless mode, the application fails when recording starts. The following error message is displayed:
The Application "gnome-sound-recorder" has quit unexpectedly. |
Workaround: Perform the following steps.
Become superuser.
Issue the following command:
# GCONF_CONFIG_SOURCE=xml::/etc/gconf/gconf.xml.defaults /usr/bin/gconftool-2 --makefile-install-rule /etc/gconf/schemas/gnome-audio-profiles.schemas |
In addition, existing users must perform the following steps.
If the gnome-audio-profiles-properties application is running, stop the application by closing the application window.
If the profile cdlossless exists in ~/.gconf/system/gstreamer/audio/profiles, remove the profile.
% rm ~/.gconf/system/gstreamer/audio/profiles/cdlossless |
Log out of the system and then log in again.
You can only delete files from your own home directory file system.
Workaround: To delete files outside your home directory file system, open a terminal window and use the command line.
You cannot use Archive Manager to create the following types of archives:
.arj
.lha
.bzip
.lzop
.zoo
Workaround: None.
This section describes system administration bugs in Solaris 10 OS.
When running the JIST read/write/compare load test with 10 threads as part of the entrance test for Amber Road, the iscsi target coredumps. This might cause the JIST test to fail with data compare errors. Sometimes the JIST might run successfully, but a new core file is generated.
Workaround: None.
Type the URL https://localhost/:6789.2 in a Firefox browser and log in as the root user. When you click the ZFS Administration link, the ZFS Administration window does not start. The following error message is displayed:
setSelectionComponentState is not defined https://localhost:6789/zfs/zfsmodules/Header openOrClose: TreeFrame is not defined https://localhost:6789/zfs/zfsmodules/CloseFrame.jsp |
Workaround: None.
The smosservice command fails after displaying that the file /usr/snadm/lib/libspmizones.so does not exist. The following error message is displayed:
Failed to load library "libspmizones.so". ld.so.1: java: fatal: libspmizones.so: open failed: No such file or directory. |
Workaround: Create a soft link to libspmizones.so and then execute the smosservice command. Use the following command to create the link:
ln -s /usr/snadm/lib/libspmizones.so.1 /usr/snadm/lib/libspmizones.so |
The lucreate :zone feature does not work on whole root zones when a whole root non-global zone in the parent boot environment has a dedicated filesystem. Bits of the dedicated filesystem in the whole root zone will not be copied to the target zone in the alternate boot environment. The following error message is displayed:
Creating shared file system mount points. Copying root of zone havana-z1>. Copying /tests> in zone havana-z1>. egrep: syntax error |
This message essentially means that you have a partially created whole root zone in the newly created boot environment.
Workaround: Copy the bits of the whole root zone's dedicated filesystem manually to the target zone in the alternate boot environment.
In systems which have an AHCI compliant SATA controller, the BIOS setup typically enables the controller to be set in either AHCI, legacy, or RAID modes. Solaris supports AHCI and legacy modes.
The SATA mode setting in BIOS must not be changed after an initial Solaris installation. The SATA mode setting must also not be changed before or after a Solaris upgrade. If the SATA mode BIOS setting is modified after installing Solaris, the system will reset and fail to boot without indicating what led to the failure.
Workaround: If boot failure is encountered as a result of changing the BIOS setting, revert back to the original setting in order to boot Solaris.
When run on large file systems, for example ZFS, applications using statvfs(2) or statfs(2) to get information about the state of the file system exhibit an error. The following error message is displayed:
Value too large for defined data type |
Workaround: Applications should use statvfs64() instead.
Solaris Trusted Extensions administration tools such as the Solaris Management Console (SMC) and tninfo might not display the ADMIN_LOW or ADMIN_HIGH labels. Instead the administration tools might incorrectly display labels like PUBLIC and CNF : RESTRICTED.
This incorrect display of labels can result in misconfigured systems. For example, the SMC might incorrectly display PUBLIC for a zone when the actual default label is ADMIN_LOW. Because of incorrect label display the zone fails to boot.
The error is because the default label view is EXTERNAL when it should be INTERNAL. This causes ADMIN_LOW to be promoted to the minimum user label and ADMIN_HIGH to be demoted. As a result, the administration tools incorrectly display the lowest and highest labels defined instead of correctly displaying ADMIN_LOW and ADMIN_HIGH.
Workaround: Perform the following steps:
Install Solaris Trusted Extensions but do not reboot the system.
Edit your label encodings file. The default label_encodings file is /etc/security/tsol/label_encodings. Add the following line in the LOCAL DEFINITIONS section:
Default Label View is Internal; |
On systems running a Solaris release that is not zones aware, using patchadd -R, or any command that accepts the -R option to specify an alternate root path for a global zone that has non-global zones installed, will not work.
In contrast with the error message that is displayed by using the luupgrade [-t, -T, -p, -P] command, no error message regarding the use of appropriate command-level restrictions is displayed in this instance.
There is no indication that the -R option did not work. As a result of the failure of the command, Solaris 10 packages or patches are not installed on any of the installed non-global zones.
This problem occurs while installing and uninstalling packages or patches.
The -R option works if the alternate boot environment has configured non-global zones, but no installed non-global zones. However, to avoid a potential problem, or if you are not sure whether there are any installed non-global zones used as the alternate root path, restrict the use of the -R option in all instances.
For more information, see the following man pages :
Workaround 1: Upgrade the OS to at least the Solaris 10 1/06 release.
If you are running the Solaris 10 3/05 release, install the following patches to enable the use of commands that accept the -R option to create an alternate root path:
Patch ID 119254-19 for SPARC based systems
Patch ID 119255-19 for x86 based systems
Workaround 2: Restrict the use of the patchadd -R command or any command that accepts the -R option to create an alternate root path.
Instead, boot the alternate root, for example, the Solaris 10 release, as the active OS. Then install and uninstall the Solaris 10 packages and patches without using the -R option.
The cfgadm command displays ApIds that might be incorrect or inconsistent with the format that is specified in the cfgadm_pci(1M) man page. This inconsistency occurs under the following circumstances:
Upgrading to the Solaris 10 7/07 HW release
Swapping hardware of PCI or PCI Express (PCIe) attachment points at the same physical location. For example, replacing an expansion chassis at the same location.
No specific error message is displayed. However, the cfgadm command might display one of the following:
An incorrectly formatted ApId which might work
A correctly formatted ApId which might not work
If the ApId does not work, then the cfgadm command will display a corresponding error message.
Workaround: Remove all PCI and PCIe links under the /dev/cfg directory and then run the command, devfsadm -C. The PCI and PCIe links are displayed as ApIds in:
cfgadm -s "select=class(pci)" |
The smosservice or smdiskless command might not work because of a dependency on JDKTM 1.5 release.
The following error message is displayed:
/usr/sadm/bin/smosservice list -u <user> -p <password> Exception in thread "main" java.lang.UnsupportedClassVersionError: com/sun/management/viperimpl/console/BaseConsoleOptionsManager (Unsupported major.minor version 49.0) at java.lang.ClassLoader.defineClass0(Native Method) at java.lang.ClassLoader.defineClass(ClassLoader.java:539) at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:123) at java.net.URLClassLoader.defineClass(URLClassLoader.java:251) at java.net.URLClassLoader.access$100(URLClassLoader.java:55) at java.net.URLClassLoader$1.run(URLClassLoader.java:194) at java.security.AccessController.doPrivileged(Native Method) at java.net.URLClassLoader.findClass(URLClassLoader.java:187) at java.lang.ClassLoader.loadClass(ClassLoader.java:289) at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:274) at java.lang.ClassLoader.loadClass(ClassLoader.java:235) at java.lang.ClassLoader.loadClassInternal(ClassLoader.java:302) |
Workaround:
Set the JAVA_HOME variable to point to a JDK 1.5 installation.
# JAVA_HOME=/usr/java |
A system that runs the Sun Patch Manager Tool 2.0 can manage remote systems that run Patch Manager Tool, including Sun Patch Manager Tool 1.0.
However, a system with an earlier version of Patch Manager Tool cannot manage remote systems that run Patch Manager Tool 2.0. Earlier versions include the following:
Sun Patch Manager Base Software 1.x
Sun Patch Manager Tool 1.0
Common Information Model/Web Based Enterprise Management (CIM/WBEM) support for Patch Manager Tool does not exist in the Solaris 8 OS. Consequently, remote management with Patch Manager does not apply to Solaris 8 systems.
Sun Remote Services (SRS) Net Connect is supported only in the global zone. Error messages are displayed if you perform one of the following actions:
You install SRS Net Connect in a local zone.
SRS Net Connect is installed in the global zone at the time a local zone is created.
The error messages are as follows:
*** package SUNWcstu failed to install - interactive administration required: Interactive request script supplied by package pkgadd: ERROR: request script did not complete successfully Installation of SUNWcstu was suspended (interaction required). No changes were made to the system. *** package SUNWfrunc failed to install - interactive administration required: Interactive request script supplied by package pkgadd: ERROR: request script did not complete successfully Installation of SUNWfrunc was suspended (interaction required). No changes were made to the system. |
Workaround: Ignore the error messages.
While installing a non-global zone by using the zoneadm command, error or warning messages might be displayed during package installation. The messages are similar to the following example:
Preparing to install zone zone1. Creating list of files to copy from the global zone. Copying 2348 files to the zone. Initializing zone product registry. Determining zone package initialization order. Preparing to initialize 790 packages on the zone. Initialized 790 packages on zone. Zone zone1 is initialized. Installation of the following packages generated errors: SUNWjhrt SUNWmcc SUNWjhdev SUNWnsb SUNWmcon SUNWmpatchmgr Installation of the following packages generated warnings: SUNWj3rt SUNWmc SUNWwbmc SUNWmga SUNWdclnt SUNWlvma SUNWlvmg SUNWrmui SUNWdoc SUNWpl5m SUNWpmgr |
Problems about package installation are also recorded in /export/zone1/root/var/sadm/system/logs/install_log which contains a log of the zone installation.
Workaround: None.
The non-global zone can still be used even though these messages have been reported. Issues with package installation existed in earlier Solaris Express and Solaris 10 Beta releases. However, no notification about these problems was being generated. Beginning with this Solaris release, these errors are now properly reported and logged.
During dynamic reconfiguration (DR), error messages might be displayed. The messages are displayed if you perform DR while input and output operations are active on devices that are in the DR path. After the messages are displayed, the input and output operations are retried and eventually succeed. The following is a sample that is displayed:
Jul 28 12:23:19 qame10-a scsi: [ID 107833 kern.warning] WARNING: /ssm@0,0/pci@19,700000/SUNW,qlc@2,1/fp@0,0/ssd@w2100000c5056fa13,0 (ssd6): Jul 28 12:23:19 qame10-a transport rejected fatal error Jul 28 12:22:08 qame10-a scsi: [ID 107833 kern.warning] WARNING: /ssm@0,0/pci@19,700000/SUNW,qlc@2,1/fp@0,0/ssd@w2100000c5056f9a7,0 (ssd36): Jul 28 12:22:08 qame10-a SCSI transport failed: reason 'timeout': retrying command |
Workaround: None. Ignore the error messages.
The patchadd and patchrm commands work improperly in non-global zones with inherited file systems. Consequently, in those zones, the pkgchk command might generate error messages about packages under the following circumstances:
In the global zone, you apply patches for the Solaris 10 zone system by using the patchadd command.
You use the patchrm command to remove patches that you just recently applied.
In a non-global zone with inherited file systems, you check with the pkgchk command for information about a package in any of the removed patches.
The following sample message is displayed when the pkgchk command is used on SUNWcsu under the circumstances previously listed.
# pkgchk SUNWcsu ERROR: /usr/lib/inet/certdb modtime <04/26/05 10:55:26 PM> expected <01/23/05 01:48:24 AM> actual file size <36012> expected <42152> actual file cksum <37098> expected <19747> actual ERROR: /usr/lib/inet/certlocal modtime <04/26/05 10:55:26 PM> expected <01/23/05 01:48:24 AM> actual file size <44348> expected <84636> actual |
Workaround: None. The errors are harmless. Ignore the error messages.
Systems with the Solaris 10 3/05 HW1 release might cause problems with IPsec. This problem might occur on a freshly installed system or a system that imports a large number of new Service Management Facility (SMF) manifests during the boot. After these booting conditions, IPsec, which is part of svc:/network/initial:default, might be initialized prior to the encryption framework, which is part of svc:/system/cryptosvc:default. Because authentication or encryption algorithms are not available, creation of IPsec security associations might fail with an error message such as the following:
PF_KEY error: type=ADD, errno=22: Invalid argument, diagnostic code=40: Unsupported authentication algorithm |
For example, this error might occur when using DR on a Sun Fire E25K system, which involves IPsec services.
Workaround: Before performing operations that use IPsec services, perform the following steps after a boot that imports a large number of new SMF manifests:
Issue this command after booting:
ipsecalgs -s |
If /etc/inet/secret/ipseckeys exists on the system, also issue this command:
ipseckey -f /etc/inet/secret/ipseckeys |
Now you can perform actions that create IPsec security associations, such as using DR on a Sun Fire E25K system.
This procedure needs to be repeated only when a large number of new SMF manifests are imported during the boot.
If you attempt to launch the Solaris Product Registry administration utility in a zone, the attempt fails. During the zone installation, productregistry, the Solaris Product Registry database, is not duplicated in the zone. Consequently, the utility cannot run in a zone.
Workaround: As superuser, copy the productregistry database to the zone.
# cp /var/sadm/install/productregistry zone_path/var/sadm/install/ |
In the previous command, zone_path is the path to the root directory of the zone that you created.
If you use the smdiskless command to delete a diskless client, the command fails. The diskless client is not removed from the system databases. The following error message is displayed:
Failing with error EXM_BMS. |
Workaround: Unshare the /export partition before adding the client.
Installation of Net Connect 3.1.1 fails if you select the product at the beginning of a full Solaris 10 installation. This failure occurs when you are installing by using the Solaris 10 Operating System DVD. At the completion of the OS installation, the following error message is recorded in the Net Connect install log in /var/sadm/install/logs/:
Installation of SUNWSRSPX failed. Error: pkgadd failed for SUNWsrspx Install complete. Package: SUNWsrspx |
Workaround: After the OS installation is completed, follow these steps:
Insert the Solaris 10 Operating System DVD or the Solaris 10 Software - CD 4.
Change to the directory of the Net Connect product.
Run the Net Connect installer.
To download the latest version of the Sun Net Connect software and release notes, go to the Sun Net Connect portal at https://srsnetconnect.sun.com.
If you use the smosservice delete command to remove a diskless client service, the command does not successfully remove all the service directories.
Workaround: Follow these steps.
Make sure that no clients exist that use the service.
# unshare /export/exec/Solaris_10_sparc.all # rm -rf /export/exec/Solaris_10_sparc.all # rm -rf /export/exec/.copyofSolaris_10_sparc.all # rm -rf /export/.copyofSolaris_10 # rm -rf /export/Solaris_10 # rm -rf /export/share # rm -rf /export/root/templates/Solaris_10 # rm -rf /export/root/clone/Solaris_10 # rm -rf /tftpboot/inetboot.sun4u.Solaris_10 |
Remove the following entry from the /etc/bootparams file.
fs1-24 boottype=:os |
Remove this entry only if this file server does not provide functions or resources for any other services.
Remove the following entry from the /etc/dfs/dfstab file.
share -F nfs -o ro /export/exec/Solaris_8_sparc.all/usr |
Modify the /var/sadm/system/admin/services/Solaris_10 file.
If the file server is not Solaris_10, delete the file.
If the file server is Solaris_10, remove all entries after the first three lines. The deleted lines indicate the service USR_PATH and SPOOLED ROOT packages in /export/root/templates/Solaris_10 and the supported platforms.
If you use the patchadd command to install patches across the NFS from another system, the command fails. The following example shows a patchadd operation that failed and the error message that is displayed:
Validating patches... Loading patches installed on the system... [...] Loading patches requested to install. [...] Checking patches that you specified for installation. [...] Approved patches will be installed in this order: [...] Checking local zones... [...] Summary for zones: [...] Patches that passed the dependency check: [...] Patching global zone Adding patches... Checking installed patches... Verifying sufficient filesystem capacity (dry run method)... Installing patch packages... Patch Patch_ID has been successfully installed. See /var/sadm/patch/Patch_ID/log for details Patch packages installed: SUNWroute [...] Adding patches... The patch directory /dev/.SUNW_patches_0111105334-1230284-00004de14dcb29c7 cannot be found on this system. [...] Patchadd is terminating. |
Workaround: Manually copy all of the patches to be installed from the NFS server to the local system first. Then use the patchadd command to install the patches from the directory on the local system where the patches were copied.
If you use the lucreate command to create RAID-1 volumes (mirrors) that do not have device entries in the /dev/md directory, the command fails. You cannot mirror file systems with the lucreate command unless you first create the mirrors with Solaris Volume Manager software.
Workaround: Create the mirrored file systems with Solaris Volume Manager software, then create the new boot environment with the lucreate command.
For more information about the lucreate command, see the lucreate(1M) or Solaris 10 11/06 Installation Guide: Solaris Live Upgrade and Upgrade Planning.
For more information about how to create mirrored file systems with Solaris Volume Manager software, see Solaris Volume Manager Administration Guide.
If you attempt to stop the system by pressing keyboard sequences such as Stop-A or L1-A, the system might panic. An error message similar to the following example is displayed:
panic[cpu2]/thread=2a100337d40: pcisch2 (pci@9,700000): consistent dma sync timeout |
Workaround: Do not use keyboard sequences to force the system to enter OpenBoot PROM.
The ipfs command saves and restores information about the state of the Network Address Translation (NAT) and packet-filtering state tables. This utility prevents network connections from being disrupted if the system reboots. If you issue the command with the -W option, ipfs fails to save the kernel state tables. The following error message is displayed:
state:SIOCSTGET: Bad address |
Workaround: None.
After modifying the contents of snmpd.conf, you can issue the command kill -HUP snmp Process ID. This command stops the snmp process. The command then sends a signal to the System Management Agent's master agent (snmpd) to reread snmpd.conf and implement the modifications that you introduced. The command might not always cause the master agent to reread the configuration file. Consequently, using the command might not always activate modifications in the configuration file.
Instead of using kill -HUP, restart the System Management Agent after adding modifications to snmpd.conf. Perform the following steps:
Become superuser.
Type the following command:
# /etc/init.d/init.sma restart
The Solaris WBEM Services 2.5 daemon cannot locate providers that are written to the com.sun.wbem.provider interface or to the com.sun.wbem.provider20 interface. Even if you create a Solaris_ProviderPath instance for a provider that is written to these interfaces, the Solaris WBEM Services 2.5 daemon does not locate the provider.
Workaround: To enable the daemon to locate such a provider, stop and restart the Solaris WBEM Services 2.5 daemon.
# /etc/init.d/init.wbem stop # /etc/init.d/init.wbem start |
If you use the javax
API to develop
your provider, you do not need to stop and restart the Solaris WBEM Services
2.5 daemon. The Solaris WBEM Services 2.5 daemon dynamically recognizes javax
providers.
If you choose to use the com.sun application programming
interface rather than the javax
application
programming interface to develop your WBEM software, only Common Information
Model (CIM) remote method invocation (RMI) is fully supported. Other protocols,
such as XML/HTTP, are not guaranteed to work completely with the com.sun application programming interface.
The following table lists examples of invocations that execute successfully under RMI but fail under XML/HTTP:
Method Invocation |
Error Message |
---|---|
CIMClient.close() |
NullPointerException |
CIMClient.execQuery() |
CIM_ERR_QUERY_LANGUAGE_NOT_SUPPORTED |
CIMClient.getInstance() |
CIM_ERR_FAILED |
CIMClient.invokeMethod() |
XMLERROR: ClassCastException |
The Solaris Management Console Mounts and Shares tool cannot modify mount options on system-critical file systems such as root (/), /usr, and /var.
Workaround: Choose one of the following workarounds:
Use the remount option with the mount command.
# mount -F file-system-type -o remount, additional-mount-options \ device-to-mount mount-point |
Mount property modifications that are made by using the -remount option with the mount command are not persistent. In addition, all mount options that are not specified in the additional-mount-options portion of the previous command inherit the default values that are specified by the system. See the man page mount_ufs(1M) for more information.
Edit the appropriate entry in the /etc/vfstab file to modify the file-system mount properties, then reboot the system.