Sun Java(TM) System Administration Server 5 2004Q2 Release Notes

Sun Java™ System Administration Server Release Notes

Version 5.2 2004Q2

Part Number 817-5214

These Release Notes contain important information available at the time of release of Administration Server 5 2004Q2. New features and enhancements, known issues and limitations, and other information are addressed here. Read this document before you begin using Administration Server 5 2004Q2.

The most up-to-date version of these release notes can be found at: http://docs.sun.com/coll/AdmnistrationServer_04q2 Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and manuals.

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

May, 2004

Initial release of the Administration Server Release Notes


About Administration Server 5 2004Q2

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 2004Q2 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

The main new development brought by Administration Server 5 2004Q2 is the improved product reliability notably in terms of memory robustness and concurrent server access. The Administration Server documentation has been reworked so that the Administration Server now has its own separate set of release notes and what was formerly called the Server Console Management Guide is now called the Administration Server Administration Guide. For more detailed regarding the improvements made to the product see the Bugs Fixed in This Release section.

For information regarding both the standalone Administration Server 5.2 release and the 5.2 release packaged with the 2003Q4 release of Sun JavaTM Enterprise System see the Sun ONE Directory Server 5.2 Release Notes.

Software Requirements

The following software is required for this release of Administration Server.


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 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)

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

Table 3  Solaris x86 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)

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

Table 4  Linux Software Requirements 

Component

Platform Requirement

Operating System

RedHat Advanced Server 2.1 Update 2

Patches or service packs

None

Additional software

None



Note

Sun Java System Administration Server 5.2 has been validated with Sun Cluster 3.1.


Bugs Fixed in This Release

The tables below describe the bugs fixed in Administration Server 5.2 in the following areas:


Important Information

This section contains the latest information that is not contained in the core product documentation. This section covers the following topics:

Installation Notes

This topic contains important patch requirement and general installation information, and is divided into the following subsections:

Patch Requirement Information

If you have Administration Server 5.2 installed from Solaris packages and wish to bring it in line with Administration Server as delivered in Java Enterprise System 2004Q2, install the following patches with at least the given version number or more, available at 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 8  Administration Server 5.2 Java Enterprise System 2004Q2 Alignment Patches Required For Solaris 8 (SPARC)

Patch Number

Patch Description

116103-03

SunOS 5.8: International Components for Unicode Patch

114045-03

SunOS 5.8: Netscape Portable Runtime(4.1.4)/Network Security System(3.3.4)

115924-08

SunOS 5.8: NSPR4.1.6 / NSS 3.3.6 / JSS 3.1.2.5

115328-01

SunOS 5.8: Simple Authentication and Security Layer (2.01)

115610-09

SunOS 5.9_sparc: Sun ONE AdminServer 5.2 patch

Note that this patch is also valid for Solaris 8

Table 9  Administration Server 5.2 Java Enterprise System 2004Q2 Alignment Patches Required For Solaris 9 (SPARC)

Patch Number

Patch Description

114677-06

SunOS 5.9: International Components for Unicode Patch

114049-04

SunOS 5.9: Netscape Portable Runtime(4.1.4)/Network Security System(3.3.4)

115926-08

SunOS 5.9: NSPR4.1.6 / NSS 3.3.6 / JSS 3.1.2.5

115342-01

SunOS 5.9: Simple Authentication and Security Layer (2.01)

115610-09

SunOS 5.9_sparc: Sun ONE AdminServer 5.2 patch

Table 10  Administration Server 5.2 Java Enterprise System 2004Q2 Alignment Patches Required For Solaris 9 (x86)

Patch Number

Patch Description

114678-06

SunOS 5.9_x86: International Components for Unicode Patch

114050-04

SunOS 5.9_x86: Netscape Portable Runtime(4.1.4)/Network Security System(3.3.4)

115927-08

SunOS 5.9_x86: NSPR4.1.6 / NSS 3.3.6 / JSS 3.1.2.5

115611-09

SunOS 5.9_x86 : Sun ONE AdminServer 5.2 patch

For more information on the Sun Java Enterprise System, see http://wwws.sun.com/software/learnabout/enterprisesystem/index.html.

General Installation Information

Documentation Notes


Known Issues and Limitations

This section contains a list of the known problems and issues with Administration Server 5.2. The following product areas are covered:

Installation, Uninstallation and Migration Issues

Multibyte characters at installation cause configuration problems (#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.

Cannot install Administration Server patch 115611-02 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:

/var/sadm/pkg/SUNWasvc/pkginfo
/var/sadm/pkg/SUNWasvcp/pkginfo
/var/sadm/pkg/SUNWasvr/pkginfo
/var/sadm/pkg/SUNWasvu/pkginfo

Administration Server installation date is incorrect (#4908818)

Uninstalling Administration Server does not remove the .suitespot file from the ServerRoot directory (#4968548)

Administration Server configuration accepts non-supported versions of the Java Development Kit (JDK) (#4990183)

It is possible to install Administration Server using the 1.3.x version of the JDK, but Administration Server will fail to start.

Workaround
Ensure that you use at least the 1.4.1 version of the JDK.

An installation path of more than 54 characters prevents the Administration Server from starting correctly (#4788213)

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

If during backout of Directory Proxy Server, an Administration Server patch is backed out before a Directory Proxy Server patch, the backout fails (#5015762)

Workaround
During backout of Directory Proxy Server, back out Administration Server patches before backing out Directory Proxy Server patches.

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.

General Issues

The admin_ip.pl script does not work when several Administration Servers are registered with the Configuration Directory Server (CDS) (#4910472)

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

The admin_ip.pl script does not function correctly (#4892243)

Importing a chain of CA certificates using the Server Console or the certutil tool does not work (#4913224)

Workaround
Be sure to import each certificate one by one, using either the certutil tool or the Console.

The IP address and hostname restrictions for connecting to the Administration Server may, with certain address and hostname formats, not function as per the documentation details (#4948897)

The Japanese Online Help includes some content in English (5047194)


Redistributable Files

Sun Java System Administration Server 5.2 2004Q2 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:

http://swforum.sun.com

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:

http://www.sun.com/hwdocs/feedback

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 this Administration Server 5.2 Release Notes is 817-5214.


Additional Sun Resources

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


Copyright � 2004 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 � 2004 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.