Solaris 9 (SPARC Platform Edition) 9/02 Release Notes

Chapter 2 Solaris Runtime Issues

This chapter describes runtime issues that are known to be problems.

The following runtime bug descriptions have been added to this chapter since this document was published on the Solaris 9 9/02 Documentation CD and in the Installation Kiosk on the Solaris 9 9/02 Installation CD.

Smart Card Bugs

System Does Not Respond to Smart Card (4415094)

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.

  1. Perform a remote login to the machine on which the ocfserv process terminated.

  2. Become superuser.

  3. Kill the dtsession process by typing the following in a terminal window.


    # pkill dtsession
    
ocfserv restarts and smart card login and capability are restored.

Edit Config File Menu Item in Smartcards Management Console Does Not Work (4447632)

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.

Common Desktop Environment (CDE) Bugs

dtmail Crashes When Launched From the Command Line if FontList Option Is Specified (4677329)

dtmail crashes after connecting with the IMAP server if the FontList option is specified when dtmail is launched from the command line. See the following example.


/usr/dt/bin/dtmail -xrm "Dtmail*FontList: -*-r-normal-*:"

The following error message is displayed.


Segmentation Fault

This problem occurs in both the C and ja locales.

Workaround: Do not specify the FontList option when you launch dtmail from the command line.

CDE Mailer Appears to Hang While Displaying Email With Long Lines (4418793)

If you try to read an email message with many long lines in any of the Solaris 9 9/02 Unicode or UTF-8 locales, CDE Mailer (dtmail) appears to hang. The message does not display immediately.

Workaround: Choose one of the following workarounds.

PDASync Cannot Delete Last Entry From the Desktop (4260435)

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.

PDASync Does Not Support Data Exchange With the Multibyte Internationalized PDA Device (4263814)

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 PDASync application. If you accidentally exchange multibyte data and corrupt that data, restore your data from the backup.

System Administration Bugs

UltraSPARC II CP Event Message in Solaris 9 9/02 Operating Environment Not Always Produced (4732403)

In the Solaris 9 9/02 operating environment, on UltraSPARC II-based systems, the CP Event message that accompanies some Uncorrectable Memory Error messages is not always produced. These systems include the Sun EnterpriseTM 10000 and Sun EnterpriseTM 6500/6000/5500/5000/ 4500/4000/3500/3000 systems. The result is that some information needed to identify a failing CPU might not always be present.

Workaround: For the latest information regarding this issue, check the SunSolve web site at http://sunsolve.sun.com.

Solaris WBEM Services 2.5 Daemon Cannot Locate com.sun Application Programming Interface Providers (4619576)

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

Note -

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.


Some com.sun Application Programming Interface Method Invocations Fail Under XML/HTTP Transport Protocol (4497393, 4497399, 4497406, 4497411)

If you choose to use the com.sun application programming interface rather than the javax application programming interface to develop your WBEM software, only 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

Cannot Modify File System Mount Properties With Solaris Management Console Mounts and Shares Tool (4466829)

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.

CIM_ERR_LOW_ON_MEMORY Error Occurs When Trying to Add Data With WBEM (4312409)

The following error message is displayed when memory is low:


CIM_ERR_LOW_ON_MEMORY

You cannot add more entries when the Common Information Model (CIM) Object Manager has run low on memory. You must reset the CIM Object Manager Repository.

Workaround: To reset the CIM Object Manager Repository, follow these steps.

  1. Become superuser.

  2. Stop the CIM Object Manager.


    # /etc/init.d/init.wbem stop
    
  3. Remove the JavaSpacesTM log directory.


    # /bin/rm -rf /var/sadm/wbem/log
    
  4. Restart the CIM Object Manager.


    # /etc/init.d/init.wbem start
    

    Note -

    When you reset the CIM Object Manager Repository, you lose any proprietary definitions in your data store. You must recompile the MOF files that contain those definitions by using the mofcomp command. See the following example.


    # /usr/sadm/bin/mofcomp -u root -p root-password your-mof-file
    

Solaris Volume Manager Issue

Solaris Volume Manager metattach Command Might Fail

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.


Note -

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, displays an error message when you attempt to attach the second submirror. For more information about the default behavior of Solaris installation programs, see "Swap Installation Issue".


Solaris Volume Manager Bugs

Detaching Submirror With metadetach Command Automatically Resizes Mirror (4678627)

If you use the metadetach command to remove a submirror from a mirror, you might not be able to reattach the submirror. This problem occurs because the mirror is automatically resized after you detach the submirror.

Workaround: Before you use the metadetach command to detach a submirror, attach a submirror of equal size to the submirror you want to detach.

Solaris Volume Manager metareplace -e Command Fails to Enable Soft Partitions When Disks Are Removed and Then Replaced (4645781)

If you physically remove a soft partitioned disk from a system and then replace it with a new disk, the metareplace -e command fails to enable the soft partitions. This failure might occur whether or not you used the metarecover command prior to issuing the metareplace -e command to enable the soft partitions.

Workaround: Re-create the soft partitions on the new disk.


Note -

If the soft partitions are a 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

Solaris Volume Manager metahs -e Command Fails On Copper Cable Storage Boxes When Failed Hot Spare Disk Has Been Swapped Out (4644106)

The metahs -e command might fail if you encounter the following circumstances.

  1. A hot spare device encounters a problem, such as an induced error, when using the metaverify test utility.

  2. Solaris Volume Manager software attempts to activate the hot spare when an error occurs on a metadevice. The hot spare is marked broken.

  3. The system is brought down. The failed disk that contains the hot spare is replaced with a new disk at the same location.

  4. When the system is booted, Solaris Volume Manager software does not recognize the new hot spare.

  5. The metahs -e command is used to enable the hot spare on the new disk.

The following message is displayed.


WARNING: md: d0: open error of hotspare (Unavailable)

The failure occurs because the Solaris Volume Manager software does not internally recognize the new hot spare disk that was swapped into the same physical location. The Solaris Volume Manager software continues to display the device ID of the disk that is no longer in the system.


Note -

This failure is not known to occur on a Photon or storage enclosures where the device number changes when a disk is replaced.


Workaround: Choose one of the following workarounds.

Solaris Volume Manager metadevadm Command Fails If Logical Device Name No Longer Exists (4645721)

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 Photon, 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.

Note -

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.

Solaris Volume Manager metarecover Command Fails to Update metadb Namespace (4645776)

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


Note -

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

Networking Bugs

Idle Solaris PPP 4.0 Daemon Might Exit During Holdoff Period (4647938)

The Solaris Point-to-Point Protocol (PPP) 4.0 daemon (pppd) might unexpectedly exit under the following conditions.

If the pppd daemon exits unexpectedly, a message that is similar to the following message is logged in the appropriate system log file.


current date hostname pppd[PID]: [ID 702911 daemon.error] unable
to set IP to pass: Invalid argument
current date hostname pppd[PID]: [ID 702911 daemon.error] unable to
enable IPCP

See the man page pppd(1M) for more information on the demand and holdoff options to the pppd daemon.

Workaround: Choose one of the following workarounds.

Configuring Multiple Tunnels Between Two IP Nodes With Filtering Enabled Might Result in Packet Loss (4152864)

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

Security Bugs

Unlocking CDE Screenlock Removes Kerberos Version 5 Credentials (4674474)

If you unlock a locked CDE session, all your cached Kerberos version 5 (krb5) credentials might be removed. The result is you might not be able to access various system utilities. This problem occurs under the following conditions.

If this problem occurs, the following error message is displayed.


lock screen: PAM-KRB5 (auth): Error verifying TGT with host/host-name:
Permission denied in replay cache code

Workaround: Add the following non-pam_krb5 dtsession entries to the /etc/pam.conf file.


dtsession auth requisite pam_authtok_get.so.1
dtsession auth required  pam_unix_auth.so.1

With these entries in the /etc/pam.conf file, the pam_krb5 module does not run by default.

CDE Removable Media Auto Run Capability Removed From the Solaris 9 9/02 Operating Environment (4483353)

The Removable Media auto run capability in the CDE desktop environment has been temporarily removed from the Solaris 9 9/02 operating environment. This capability has been removed to mitigate potential security issues.

To use the auto run function for a CD-ROM or another removable media volume, you must do one of the following:


Note -

For the latest information on security issues and patches, check the SunSolve web site at http://sunsolve.sun.com. All security patches are available from the SunSolve site without a support contract.


cron, at, and batch Cannot Schedule Jobs for Locked Accounts (4622431)

In the Solaris 9 9/02 operating environment, locked accounts are treated in the same way as expired or nonexistent accounts. As a result, the cron, at, and batch utilities cannot schedule jobs on locked accounts.

Workaround: To enable locked accounts to accept cron, at, or batch jobs, replace the password field of a locked account (*LK*) with the string NP, for no password.

Additional Software Bug

Veritas Volume Manager Might Fail on Systems Running Solaris 9 9/02 Operating Environment (4642114)

If you try to perform various tasks with Veritas Volume Manager on a system that is running the Solaris 9 9/02 operating environment, the vxddladm addjob or vxddladm addsupport utilities might core dump.

Workaround: Follow these steps.

  1. Become superuser.

  2. Verify that the /var/ld/ld.config file and /usr/bin/crle utility exist on the system.

  3. Type the following commands in a terminal window.


     # /usr/bin/cp /var/ld/ld.config /var/ld/ld.config.save
     # /usr/bin/crle -E LD_LIBRARY_PATH=/usr/lib
     # appropriate-vxddladm-command
     # /usr/bin/mv /var/ld/ld.config.save /var/ld/ld.config
    

Documentation CD Issues

iPlanet Directory Server 5.1 Documentation Links Do Not Work Properly

In the iPlanetTM Directory Server 5.1 Collection (Solaris Edition), links titled DocHome and links between separate books do not work. If you select these links, your browser displays a Not Found error.

Workaround: To navigate between iPlanet Directory Server 5.1 documents on your system, go to the iPlanet Directory Server 5.1 Collection (Solaris Edition) page at http://docs.sun.com. Click the link to the document you want to view.

SUNWsdocs Package Necessary to Remove Other Documentation Packages

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.

Documentation CD Bugs

European Locale PDF Documents Available Only Through C Locale (4674475)

In the Solaris 9 9/02 operating environment, and other UNIX based systems, PDF documents on the Solaris 9 9/02 Documentation 1 of 2 CD are not accessible in the following European locales.

This problem occurs because of a limitation with Adobe Acrobat Reader. For more information on this problem, see the Adobe Technote site at http://www.adobe.com:80/support/techdocs/294de.htm.

Workaround: Choose one of the following workarounds.

Removing Solaris 9 9/02 Documentation Packages Might Unexpectedly Uninstall Some Solaris 9 9/02 Documentation Collections (4641961)

Some Solaris 9 9/02 documentation collections might be unexpectedly removed from your system if the following occurs.

  1. You install both the Solaris 9 9/02 Documentation 1 of 2 and 2 of 2 CDs on your system.

  2. You then use the prodreg utility or the Solaris 9 9/02 Documentation CD installer program to remove certain documentation packages.

The Solaris 9 9/02 Documentation CD 1 of 2 and 2 of 2 have three collections in common. If you remove the packages that contain these collections from either of the Solaris 9 9/02 Documentation 1 of 2 or 2 of 2 CD installations, the package is removed for both installations.

The following table lists the packages that might be removed unexpectedly.

Table 2-1 Solaris 9 9/02 Documentation Packages Contained on Both Solaris 9 9/02 Documentation CDs

HTML Package Names 

PDF Package Names 

Collection Description 

SUNWaadm

SUNWpaadm

Solaris 9 System Administrator Collection 

SUNWdev

SUNWpdev

Solaris 9 Developer Collection 

SUNWids

SUNWpids

iPlanet Directory Server 5.1 Collection 

Workaround: Choose one of the following workarounds.

Localization Bugs

AltGraph-E Does Not Produce Euro Character in en_US.UTF-8 Locale (4633549)

In the en_US.UTF-8 locale, you cannot input the Euro character by simultaneously pressing the AltGraph and E keys.

Workaround: Choose one of the following workarounds.

Shift-U Does Not Work as Expected in Arabic Locales (4303879)

To generate the diacritic character in Arabic locales, type the Arabic character, then Shift-U.

Sorting in the European UTF-8 Locales Does Not Function Correctly (4307314)

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

Secure Shell Application Is Not Fully Localized (4680353)

The Secure Shell application is not localized and cannot be fully translated.

Sun ONE Directory Server (formerly iPlanet Directory Server) Issues

Setup Issue

When entering Distinguished Names during installation, use the UTF-8 character set encoding. Other encodings are not supported. Installation operations do not convert data from local character set encoding to UTF-8 character set encoding. LDIF files used to import data must also use UTF-8 character set encoding. Import operations do not convert data from local character set encoding to UTF-8 character set encoding.

Schema Issues

The schema provided with the SunTM Open Net Environment (Sun ONE) Directory Server (formerly iPlanet Directory Server) 5.1 differs from that specified in RFC 2256 for the groupOfNames and groupOfUniquenames object classes. In the schema provided, the member and uniquemember attribute types are optional. RFC 2256 specifies that at least one value for these types must be present in the respective object class.

The aci attribute is an operational attribute that is not returned in a search unless you explicitly request the attribute.

Replication Issue

Multi-Master Replication over WAN is currently not supported.

Server Plug-in Issues

SunTM ONE Directory Server 5.1 provides the UID Uniqueness plug-in. By default, the plug-in is not activated. To ensure attribute uniqueness for specific attributes, create a new instance of the Attribute Uniqueness plug-in for each attribute. For more information on the Attribute Uniqueness plug-in, refer to the iPlanet Directory Server 5.1 Administrator's Guide at http://docs.sun.com.

The Referential Integrity plug-in is now off by default. To avoid conflict resolution loops, the Referential Integrity plug-in should only be enabled on one master replica in a multi-master replication environment. Before enabling the Referential Integrity plug-in on servers that issue chaining requests, analyze your performance resource, time, and integrity needs. Integrity checks can consume significant memory and CPU resources.

Roles and Class of Service Issue

The nsRoleDN attribute is used to define a role. This attribute should not be used for evaluating role membership in a user's entry. When evaluating role membership, look at the nsrole attribute.

Indexing Issue

If VLV indexes encompass more than one database, the VLV indexes do not work correctly.

Sun ONE Directory Server Bugs

Cannot Inactivate Users Through Console (4521017)

If you launch the Sun ONE Directory Server 5.1 Console and create a new user or new role as inactive, the newly created user or newly created role is not inactivated. Users and roles cannot be created through the Console as inactive.

Workaround: To create an inactive user or inactive role, follow these steps:

  1. Create the new user or new role.

  2. Double-click the newly created user or newly created role, or select the newly created user or newly created role. Click the Properties item from the Object menu.

  3. Click the Account tab.

  4. Click the Inactivate button.

  5. Click OK.

The newly created user or newly created role is inactivated.

Cannot Configure Directory With a Root Suffix That Contains Spaces (4526501)

If you specifiy a base DN that contains a space, for example, o=U.S. Government,C=US at Sun ONE Directory Server 5.1 configuration time, the resulting DN is truncated to Government,C=US. At configuration time, the DN should be entered as o=U.S.%20Government,C=US.

Workaround: To correct the base DN entry, follow these steps.

  1. Select the top directory entry in the left side of the navigation pane of the Servers and Applications tab on the Console.

  2. Edit the suffix in the User directory subtree field.

  3. Click OK.

Password Policy Information Is Not Synchronized Between Servers (4527608)

If you update a non-master directory server with password policy information, the information is not replicated to all other servers. This information includes account lockouts.

Workaround: Manage password policy information manually on each server.

Account Lockout Remains in Effect After the User Password Is Changed (4527623)

If Account Lockout is in effect and the user password is changed, Account Lockout remains in effect.

Workaround: Reset the accountUnlockTime, passwordRetryCount, and retryCountResetTime lockout attributes to unlock the account.

Console Backup Immediately After Install Fails (4531022)

If you install the Sun ONE Directory Server 5.1, start the console, initialize the directory with an LDIF file, and then backup the server, the Console reports the backup was successful. However, the backup has actually failed.

Workaround: Perform the following tasks from the Console after you initialize the database:

  1. Stop the server.

  2. Restart the server.

  3. Perform the backup.

Server Ignores Case Sensitive Syntax When Normalizing DN Attributes (4630941)

You cannot use the LDAP naming services to create automount path names that are identical, except for case results in non-unique path names. The directory server does not allow creation of entries if the naming attribute is defined with case-sensitive syntax and an entry already exists with the same name, but a different case.


Note -

/home/foo and /home/Foo paths cannot co-exist.


For example, if entry attr=foo,dc=mycompany,dc=com exists, the server does not allow the creation of attr=Foo,dc=mycompany,dc=com. A side effect of this problem is that when LDAP naming services are used, automount path names have to be unique regardless of their case.

Workaround: None.

Stopping the Server During Export, Backup, Restore, or Index Creation Crashes the Server (4678334)

If the server is stopped during export, backup, restore or index creation, the server crashes.

Workaround: Do not stop the server during these types of operations.

Replication Unable to Use Self-signed Certificate (4679442)

If you attempt to configure replication over (SSL) with certificate-based authentication, replication does not work if either of the following conditions exist.

Workaround: None.