Sun Java(TM) System Administration Server 5.2 2005Q4 Release Notes

Sun Java™ System Administration Server Release Notes

Version 5.2 2005Q4

Part Number 819-2407-10

These Release Notes contain important information available at the time of release of Sun Java System Administration Server 5.2 2005Q4. New features and enhancements, known issues and limitations, and other information are addressed here. Read this document before you begin using Administration Server 5.2.

The most up-to-date version of these release notes can be found at the Sun Java System documentation web site: http://docs.sun.com/app/docs/prod/entsys.05q4. Check the web site prior to installing and setting up your software. Then check the web site periodically thereafter to view the most up-to-date release notes and product documentation.

These release notes contain the following sections:

Third-party URLs are referenced in this document and provide additional, related information.


Note

Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.



Release Notes Revision History

Table 1 Revision History 

Date

Description of Changes

June 24, 2005

Beta release

September 2005

Revenue release


About Administration Server 5.2 2005Q4

In some parts of the Administration Server documentation and console, the version number of the product is referred to as 5.2. Administration Server 5.2 2005Q4 is a maintenance release of Administration Server 5.2.

Administration Server and Server Console are provided by the Java Enterprise System installer as a single installable component for managing your Sun Java System server software. Server Console is a stand-alone Java application that works in conjunction with an instance of Directory Server and an instance of Administration Server. It acts as the front-end management application for Sun Java System software, finding all servers and applications registered in your configuration directory, displaying them in a graphical interface, and allowing you to manage and configure them, as well as add or edit user information.

This section includes:

What's New in This Release

Administration Server 5.2 2005Q4 is a maintenance release of Administration Server 5.2 2004Q2. No new features have been introduced in this release of the product.

For information about the bugs fixed in Administration Server 5.2 2005Q4, see "Bugs Fixed in This Release" on page 4.

The Administration Server commands are now documented as man pages. For more information, see "Documentation Notes" on page 9.

Hardware and Software Requirements

The following software is required for Administration Server 5.2 2005Q4.


Caution

Before installing Administration Server on Solaris 8 Ultra SPARC® Platform Edition, Solaris 9 Ultra SPARC® Platform Edition, and Solaris 9 x86 Platform Edition you must ensure that the required OS patches have been installed. These patches can be obtained in the form or a patch cluster or as individual patches from http://sunsolve.sun.com. The required OS patch cluster include an installation script that installs the patches in the correct order. The clusters are updated periodically as new patch revisions are released. Select the "Patches" link on the SunSolve site and follow the links to obtain the available required OS patch clusters.

As Administration Server is installed to manage other servers, the RAM and disk space provisions for those other servers need to be added to the following provision to obtain realistic, overall requirements.


Table 2 Solaris SPARC® Hardware and Software Requirements 

Component

Platform Requirement

Operating System

Solaris 8 Ultra SPARC Platform Edition with patches required for Java Enterprise System (Sun Cluster 3.1 Release 04/04 has been qualified to run on Solaris 8 02/02 (with the recommended patches installed) and Solaris 8 HW 05/03 (PSR 2))

Solaris 9 Ultra SPARC Platform Edition with patches required for Java Enterprise System (Sun Cluster 3.1 Release 04/04 has been qualified to run on Solaris 9 04/04)

Solaris 10 Ultra SPARC Platform Edition with patches required for Java Enterprise System

RAM

64 Mbytes

Disk space

50 Mbytes

Note that:

- Administration Server requires no disk space provision for data

- Administration Server requires limited disk space provision for logs

Java

Java Runtime Environment 1.4.

Table 3 Solaris x86 Hardware and Software Requirements 

Component

Platform Requirement

Operating System

Solaris 9 x86 Platform Edition (Sun Cluster 3.1 Release 04/04 has been qualified to run on Solaris 9 04/04 x86 Platform Edition)

Solaris 10 x86 Platform Edition

RAM

64 Mbytes

Disk space

50 Mbytes

Note that:

- Administration Server requires no disk space provision for data

- Administration Server requires limited disk space provision for logs

Java

Java Runtime Environment 1.4.

Table 4 Linux Hardware and Software Requirements 

Component

Platform Requirement

Operating System

RedHat Advanced Server 2.1 Update 6 or RedHat Advanced Server 3.0 Update 4

Patches or service packs

None

Additional software

None

Compatibility libraries

The following compatibility libraries:

  • compat-gcc-7.3-2.96.128.i386.rpm
  • compat-gcc-c++-7.3-2.96.128.i386.rpm
  • compat-libstdc++-7.3-2.96.128.i386.rpm

If you running 64-bit Linux, you must install the system libraries for 32-bit Linux.

Java

Java Runtime Environment 1.4.


Note

Administration Server 5.2 has been validated with Sun Cluster 3.1.



Bugs Fixed in This Release

The following table describes bugs fixed in Administration Server 5.2.

Table 5 Bugs Fixed in Administration Server 5.2 2005Q4 

Bug Number

Bug Synopsis

6210901

Directory Server Console: Deleting group member does not work due to case sensitivity

6252097

Possible security exposure via HTTP admin interface

6269410

Bad version displayed when upgrading Admin Server

6196837

Advanced Search for Administrators Fails When the Console Is Not Running in English


Important Information

For information that is not contained in the core product documentation, see the following sections:

Accessibility Features for People With Disabilities

To obtain accessibility features that have been released since the publishing of this media, consult Section 508 product assessments available from Sun upon request to determine which versions are best suited for deploying accessible solutions. Updated versions of applications can be found at: http://sun.com/software/javaenterprisesystem/get.html.

For information on Sun's commitment to accessibility, visit http://sun.com/access.

Installation Notes

Note that upgrade is not supported for the beta release of this product. Patch versions will be provided with the revenue release of the product.

For information about patch requirements and installation, see the following sections:

Patch Requirement Information

The following tables give the numbers and minimum versions for the alignment patches.

All patches referred to in this section are the minimum version number required for upgrade. It is possible that a new version of the patch has been issued since this document was published. A newer version is indicated by a different version number at the end of the patch. For example: 123456-04 is a newer version of 123456-02 but they are the same patch ID. Refer to the README file for each patch listed for special instructions.

To access the patches, go to http://sunsolve.sun.com.


Caution

To avoid breaking product dependencies, it is mandatory to install the patches in the order provided in the following tables.


Table 6 Administration Server 5.2 2005Q4 Alignment Patches Required For Solaris 8 (SPARC)

Patch Number

Patch Description

116103-06

International Components for Unicode Patch

119209-04

NSPR 4.5.2 / NSS 3.10 / JSS 4.1

115328-02

Simple Authentication and Security Layer (2.01)

115610-23

Administration Server 5.2 patch

117047-17

Patch for localized Solaris packages

119725-02

LDAP JDK Patch

Table 7 Administration Server 5.2 2005Q4 Alignment Patches Required For Solaris 9 (SPARC)

Patch Number

Patch Description

114677-08

International Components for Unicode Patch

119211-04

NSPR 4.5.2 / NSS 3.10 / JSS 4.1

115342-02

Simple Authentication and Security Layer (2.01)

115610-23

Administration Server 5.2 patch

117047-17

Patch for localized Solaris packages

119725-02

LDAP JDK Patch

Table 8 Administration Server 5.2 2005Q4 Alignment Patches Required for Solaris 9 (x86)

Patch Number

Patch Description

114678-08

International Components for Unicode Patch

119212-04

NSPR 4.5.2 / NSS 3.10 / JSS 4.1

115611-23

Administration Server 5.2 patch

117047-17

Patch for localized Solaris packages

119725-02

LDAP JDK Patch

Table 9 Administration Server 5.2 2005Q4 Alignment Patches Required For Solaris 10 (SPARC)

Patch Number

Patch Description

114677-08

International Components for Unicode Patch

119213-04

NSPR 4.5.2 / NSS 3.10 / JSS 4.1

115342-01

Simple Authentication and Security Layer (2.01)

115610-23

Administration Server 5.2 patch

117047-17

Patch for localized Solaris packages

119725-02

LDAP JDK Patch

Table 10 Administration Server 5.2 2005Q4 Alignment Patches Required for Solaris 10 (x86)

Patch Number

Patch Description

114678-08

International Components for Unicode Patch

119214-04

NSPR 4.5.2 / NSS 3.10 / JSS 4.1

115611-23

Administration Server 5.2 patch

117047-17

Patch for localized Solaris packages

119725-02

LDAP JDK Patch

On Linux systems, the alignment patches include the Administration Server patch available on http://sunsolve.sun.com and shared component patches, which are provided on the distribution CD. See "Applying Linux Shared Component RPMs" in the Sun Java Enterprise System 2005Q4 Upgrade and Migration Guide for information on locating and installing the RPMs.

Table 11 Administration Server 5.2 2005Q4 Alignment Patches Required for Linux

Patch Number

Patch Description

118079-10

sun-admin-server-5.2-18.i386.rpm
sun-server-console-5.2-18.i386.rpm
sun-admin-server-man-5.2-8.i386.rpm

 

sun-nspr-4.5.2-4.i386.rpm
sun-nss-3.10-4.i386.rpm
sun-jss-4.1-4.i386.rpm
sun-sasl-2..18-1.i386.rpm
sun-icu-2.1-6.i386.rpm
sun-ljdk-4.18-4.i386.rpm
sun-ldapcsdk-5.12-3.i386.rpm

For more information about the Sun Java Enterprise System, see http://www.sun.com/service/sunjavasystem/javaenterprisesystem.

General Installation Information

Compatibility Issues

Sun Java System Administration Server and the Java Swing-based Console used today for remote graphical administration of Directory Server and other software may be replaced. A new implementation might be implemented to allow full browser-based service management, with easier configuration for access through firewalls.

As a result, the following commands might not be included in a future release:

In addition, everything in o=NetscapeRoot, might change. In particular, o=NetscapeRoot might no longer be present and the serverroot architecture might be replaced by a different one.

Documentation Notes

Man Pages

Administration Server commands and Administration Server commands are documented as man pages and delivered in the following formats:

For information about how to access the man pages, see the Java Enterprise System Installation Guide.

Product Version Number

In some parts of the Administration Server documentation and console, the version number of the product is referred to as 5.2. Administration Server 5 2005Q4 is a maintenance release of Administration Server 5.2.

Localized Documentation

Localized documentation is posted to http://docs.sun.com/ as it becomes available.


Known Issues and Limitations

This section contains a list of the known issues and limitations with Administration Server 5.2 2005Q4. The issues are grouped into the following categories:

Installation, Uninstallation and Migration

Administration Server Cannot Start if Installation Path Is Too Long (4788213)

If the installation path is more than 54 characters long the Administration Server cannot start correctly.

Workaround
Ensure that your full installation path does not contain more than 54 characters.

Console Does Not Support the Management of External Security Devices (4795512)

The console does not support the management of external security devices, such as Sun Crypto Accelerator 1000 Board.

Workaround
Manage external security devices by using the command line.

Duplicate Value Error Logged in the Configuration Directory Server During Installation (4841576)

During configuration of Directory Server, an ACI on the server group entry for each new server installation is added. If the entry already exists and the ACI value already exists on the entry (which is the case when Administration Server is installed after Directory Server), then a message similar to the following massage is logged in the Configuration Directory Server:

Workaround
Ignore the error message.

Cannot Use Multibyte Characters at Installation of AS and DS (4882927)

At installation, using multibyte characters for anything other than the suffix name causes Directory Server and Administration Server configuration to fail.

Workaround
Use monobyte characters for all fields other than the suffix name.

Administration Server Installation Date Is Incorrect (4908818)

The installation date for Administration Server is incorrect.

Workaround
Ignore the installation date for Administration Server.

Cannot Import a Chain of CA Certificates by Using Server Console or certutil Tool (4913224)

You cannot import a chain of CA certificates by using the Server Console or the certutil tool.

Workaround
Import one CA certificate at a time by using either the Server Console or the certutil tool.

. suitespot File Is Not Removed When Administration Server Is Uninstalled (4968548)

When Administration Server is uninstalled, the .suitespot file is not removed from the ServerRoot directory.

Workaround
After uninstallation of Administration Server manually remove the .suitespot file from the ServerRoot directory.

Cannot install Administration Server patch 115611-18 on Solaris 9 for x86 (4970985)

The pkginfo files delivered with Directory Server 5.2 for Solaris 9 for x86 contained an erroneous ARCH type (ARCH=sparc instead of ARCH=i386). This inconsistency with the Sun Java Enterprise System renders it impossible to apply patches.

Workaround
Before applying the patch, edit the following pkginfo files manually with the correct ARCH=i386 ARCH type:

Administration Server Configuration Accepts Unsupported Versions of Java Development Kit (JDK) (4990183)

Administration Server requires JDK version 1.4.1 or later.If JDK versions 1.3.x. is used during the configuration of Administration Server the Administration Server will not start. A warning is given but the configuration is not stopped.

Workaround
Use JDK version 1.4.1 or later during the configuration of Administration Server.

Backout Fails if Administration Server Is Backed Out Before Directory Proxy Server (5015762)

Backout fails if Administration Server is backed out before Directory Proxy Server.

Workaround
Back out of Directory Proxy Server before backing out of Administration Server. For more information about updating and backing out of Directory Proxy Server, see the Java Enterprise System Upgrade and Migration Guide.

SUNW.mps Pointer in Incorrect Location After Relocation of Packages (5035882)

If the SUNWas* packages are relocated to a directory other than the default installation directory, the SUNW.mps pointer is also relocated. Consequently, the SUNW.mps pointer will not be in the correct directory. To find the directory that contains the SUNW.mps pointer, run this command:

Workaround
Do not relocate SUNWas* packages.

If you have relocated the SUNWas* packages, correct the location of the SUNW.mps pointer as follows:

  1. Move the SUNW.mps pointer to this directory:
  2. /usr/cluster/lib/rgm/rtreg

  3. Set the destination of the SUNW.mps pointer to the location returned by this command:
    • For Administration Server 5.2 2005Q1 and Administration Server 5.2 2005Q4:

Cannot start Directory Proxy Server Console (5041840)

If the Administration Server is started before the Configuration Directory Server after installation, the Directory Proxy Server cannot access the Administration Server. In this scenario, it is impossible to start Directory Proxy Server.

Workaround
Start the Configuration Directory Server before starting the Administration Server.

RPM Upgrade Fails From Administration Server 5.2 2004Q2 to Administration Server 5.2 2005Q1 (5074779)

The following error is produced on Linux platforms during upgrade from Administration Server 5.2 2004Q2 to Administration Server 5.2 2005Q1:

error: execution of %preun scriptlet from sun-admin-server-5.2-3 failed, exit status 1

This error occurs because the RPM manager installs the RPM for Administration Server 5.2 2005Q1 but cannot remove the RPM for Administration Server 5.2 2004Q2. The RPM for Administration Server 5.2 2004Q2 is still configured and the pre-uninstall script (%preun) prevents it from being removed

Workaround
Manually remove the RPM for Administration Server 5.2 2004Q2 by using the --noscripts option to prevent the %preun script from being executed. For example:

Run the following command to verify that Administration Server 5.2 2004Q2 has been removed. Only one RPM release should be returned:

Cannot Install Patch 117047 on Administration Server 5.2 RTM (6200639)

If you migrate from Administration Server 5.2 RTM to a later version of Administration Server, the localization patch 117047 cannot be installed. The pkginfo files in patch 117047 are inconsistent with those in Administration Server 5.2 RTM for the values ARCH and VERSION.

Workaround
Before apply the localization patch, perform the following steps:

  1. On the server running Administration Server 5.2 RTM, locate the pkginfo files for each installed localization package. For example, the Japanese localization package files could be here:
  2. /var/sadm/pkg/SUNWjdsvcp/pkginfo

    /var/sadm/pkg/SUNWjdsvu/pkginfo

  3. In the pkginfo file for each installed localization package, change the values of ARCH and VERSION to the following values:
  4. ARCH=all

    VERSION=5.2,REV=2003.05.23

Administration Server 2004Q2 Fails to Start With Java Development Kit 1.5 (6265989)

Java Development Kit 1.5 requires Administration Server 2005Q1 or later.

RPM Dependencies Are Not Satisfied During Upgrade on Linux (6309661)

The Java ES installer ignores RPM dependencies during upgrade of Administration Server on Linux.

Workaround
Perform the upgrade with the --nodeps option.

General Issues

admin_ip.pl Script Does Not Work Correctly (4892243)

The admin_ip.pl script does not work correctly.

Workaround
Use the console instead of the admin_ip.pl script.

Security Restrictions for IP addresses and Hostnames Do Not Conform to Documentation (4948897)

For certain IP addresses and hostname formats, security restrictions for connecting to the Administration Server do not conform to the documentation.

Help Page Does Not Exist for the Accounts Tab When Messaging Server Is Running (4952871)

When Messaging Server is running, the help page does not exist for the following location on the server console:

  1. In the Console main window, click the Users and Groups tab
  2. In the Users and Groups main window, double-click on any user
  3. In the left-hand frame, select Accounts
  4. Click on the Help button

Workaround
Do not manage users and mailing lists by using the console. Instead, use the User Management Utility as described in the Messaging Server Administration Guide, on http://docs.sun.com/source/819-0105/users.html.

Cannot Restart Administration Server From the Console on an x86 Cluster (4974780)

The Administration Server cannot be restarted from the console when using Solaris 9 on an x86 cluster.

Workaround
On the Administration Server console select Stop Server and then Restart Server.

slapd Daemon Takes the Administration Server Port When Restarted From the Console (5002054)

When the slapd daemon is restarted from the console, it can take the Administration Server port and prevent Administration Server from being restarted by the console.

Workaround
Restart the slapd daemon from the command line.

"not start admin server" Alert on mpconsole is Not Visible (6277022)

If the mpsconsole is started before the Administration Server, the following alert is produced: "not start admin server". You cannot read the alert because it is masked by the mpsconsole logo.

Administration Guide Gives Incorrect Default location of mpsadmserver (6299574)

For Linux installation, the default location of the mpsadmserver is not located in/usr/sbin/mpsadmserver as stated in the manual, it is in this directory: /opt/sun/admin-server/5.2/sbin/mpsadmserver.

No titles for all windows for Administration Server framework (6306305)

No window titles for all products of Administration Server framework on French, German and Spanish locales on Linux.

Garbled titles of OLH windows and Admin Server (6310211)

Garbled titles for all OLH windows and for some windows of Admin Server on zh_TW.UTF-8 and zh_TW.big5 locales on Linux.


Redistributable Files

Sun Java System Administration Server 5.2 2005Q4 does not contain any files which you can redistribute.


How to Report Problems and Provide Feedback

If you have problems with Sun Java System Administration Server, contact Sun customer support using one of the following mechanisms:

So that we can best assist you in resolving problems, please have the following information available when you contact support:

You might also find it useful to subscribe to the following interest groups, where Sun Java System Administration Server topics are discussed:

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:

Please provide the full document title and part number in the appropriate fields. The part number can be found on the title page of the book or at the top of the document, and is usually a seven or nine digit number. For example, the part number of these Administration Server 5.2 Release Notes is 819-2407-10.


Additional Sun Resources

Useful Sun Java System information can be found at the following Internet locations:


Copyright © 2005 Sun Microsystems, Inc. All rights reserved.

Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

SUN PROPRIETARY/CONFIDENTIAL.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.

Use is subject to license terms.

This distribution may include materials developed by third parties.

Portions may be derived from Berkeley BSD systems, licensed from U. of CA.

Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries.


Copyright © 2005 Sun Microsystems, Inc. Tous droits réservés.

Sun Microsystems, Inc. détient les droits de propriété intellectuels relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plus des brevets américains listés à l'adresse http://www.sun.com/patents et un ou les brevets supplémentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays.

Propriété de SUN/CONFIDENTIEL.

L'utilisation est soumise aux termes du contrat de licence.

Cette distribution peut comprendre des composants développés par des tierces parties.

Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l'Université de Californie.

Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d'autres pays.