|
| |
| Sun Java Enterprise System Upgrade Guide for HP-UX | |
Chapter 3
Directory Server and Administration ServerThis chapter describes how to upgrade Directory Server and Administration Server components to Java ES Release 4 (2005Q4). These upgrades are documented together because the two components work closely together.
The chapter provides a general overview of upgrade issues and procedures for the different upgrade paths supported by Java ES Release 4.
Overview of Directory Server and Administration Server UpgradesThis section describes the following general aspects of Directory Server and its associated Administration Server components that impact upgrading to Java ES Release 4:
About Java ES Release 4
Java ES Release 4 versions of Directory Server and Administration Server represent only minor bug fixes and improvements. There are no new functional capabilities.
Java ES Release 4 Upgrade Roadmap
Table 3-1 shows the supported Directory Server and Administration Server, upgrade paths to Java ES Release 4.
Directory Server and Administration Server Data
Directory Server and Administration Server make use of Directory Server itself for storing configuration data. The data is stored in a specific tree structure within the directory. The Directory Server instance hosting the configuration is referred to as the configuration directory.
The configuration directory can be a dedicated Directory Server instance, which is a recommended security practice, or it can also host user identity data or service configuration data. The configuration directory can reside on the same computer as other Directory Server instances and the Administration Server; however in most deployment architectures, the configuration directory is remote from the other components that use it to store configuration information.
The following table shows the type of data that could be impacted by an upgrade of Directory Server and Administration Server software.
Compatibility Issues
Release 4 Directory Server and Administration Server do not introduce any interface changes. These components are, as a group, backwardly compatible with earlier versions. However, any one of these components is not backwardly compatible with earlier versions of the others; all need to be upgraded as a unit.
Dependencies
Dependencies on other Java ES components can impact the procedure for upgrading and re-configuring Directory Server and Administration Server software. Each of these components has dependencies on Java ES components as follows:
- Directory Server. Directory Server has dependencies on specific Java ES shared components (see Table 1-6). Directory Server has a dependency on Administration Server, which is used to configure Directory Server replication and other aspects of Directory Server functions.
- Administration Server. Administration Server (and the Administration Console user interface) has dependencies on specific Java ES shared components (see Table 1-6). Administration Server has a dependency on Directory Server (specifically a configuration directory) where it stores configuration data.
Upgrading Directory Server and Administration Server from Java ES Release 3This section includes information about upgrading Directory Server and Administration Server from Java ES Release 3 to Java ES Release 4. The section covers the following topics:
Introduction
When upgrading Java ES Release 3 Directory Server and Administration Server, to Release 4, consider the following aspects of the upgrade process:
- General Upgrade Approach. The upgrade is performed by applying patches to the Release 3 version. Re-configuration of Directory Server and Administration Server are achieved by synchronizing the configuration directory with the upgraded software.
- Upgrade Dependencies. While Directory Server and Administration Server have dependencies on a number of Java ES shared components (see Table 1-6), Release 4 Directory Server and Administration Server are compatible with the Release 3 versions of these shared components. Upgrade of these shared components is therefore optional with respect to upgrade of Directory Server and Administration Server to Release 4.
- Backward Compatibility. Release 4 Directory Server and Administration Server, backwardly compatible with their Release 3 versions.
- Upgrade Rollback. A rollback of the Release 4 upgrade is achieved on HP-UX by removing the Release 4 upgrade patches and re-synchronizing the configuration directory with the previous software state.
Directory and Administration Server Upgrade
This section describes how to perform an upgrade of Directory Server and Administration Server from Java ES Release 3 to Java ES Release 4 on the HP-UX. The section covers the following topics:
Pre-Upgrade Tasks
Before you upgrade Directory Server and Administration Server, you should perform the tasks described below.
Verify Current Version Information
You can verify the current version of Directory Server and associated components by restarting the Directory Server daemon using the -v option:
# cd serverroot/bin/slapd/server
# ./ns-slapd -v
You can see the result of the command as mentioned below:
Sun Java(TM) System Directory Server/5.2_Patch_3
and checking the startup messages in the Directory Server error log:
/opt/sun/mps/serverroot/slapd- <server-instance>/logs/errors
Upgrade Directory Server and Administration Server Dependencies
It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Java ES Release 4. However, because Directory Server and Administration Server do not require upgrading Release 3 shared components, this task is optional.
Back Up Directory Server Data
The Directory Server and Administration Server upgrade process modifies configuration directory data. Therefore, before you upgrade, it is recommended that you back up your configuration directory data using the Directory Server Console or a command-line utility such as db2bak.
Obtain Required Configuration Information and Passwords
You should know the Directory Server administrator user ID and password for your currently installed version.
In addition, Directory Server, and its associated Administration Server must run as the same user and group. That is, they must run with the same UID and GID.
Upgrading Directory Server and Administration Server
This section discusses considerations that impact the upgrade procedure for Directory Server and Administration Server followed by a description of the procedure itself.
Upgrade Considerations
The upgrade of Directory Server and Administration Server software to Java ES Release 4 takes into account the following considerations:
- Any Java ES components using a Directory Server instance (such as Messaging Server) should be shut down before you upgrade that instance. However, most deployment architectures use multiple instances of Directory Server to provide high availability or scalability. In such cases, you can perform a rolling upgrade of Directory Server and the Directory Server clients need not be shut down.
- The upgrade of the two components must be done in the following sequence: Administration Server and Directory Server. This sequence is because the re-configuration data must take place in a particular order.
- The component being upgraded must be shut down when patches are being applied, however the associated configuration directory must subsequently be running to re-configure the component being upgraded.
- In a deployment architecture in which there are multiple instances of Directory Server running on a single computer (all corresponding to the same installed Directory Server image), upgrading the Directory Server image will upgrade all the instances. In such architectures, there is only one Administration Server instance per installed Directory Server image.
- In many deployment architectures the configuration directory is a separate Directory Server instance. It might be local or on a different computer system from where the upgrade is being performed. Similarly, the Administration Server might be local or on a different computer system from where the upgrade of Directory Server is being performed.
- In some deployment architectures Directory Server has been installed standalone by deselecting Administration Server at installation time. In that case, however, the Administration Server upgrade procedure must still be performed, in addition to the Directory Server upgrade procedure, as described in the instructions that follow.
Table 3-4 Patches1 to Upgrade Directory Server and Administration Server
Component
Patch ID
Directory Server
121393-01
Directory Server locale
121931-01
Administration Server
121515-01
Administration Server locale
121933-01
1Patch revision numbers are the minimum required for upgrade to Java ES Release 4. If newer revisions become available, use the newer ones instead of those shown in the table.
Upgrade ProcedureThe procedure documented below applies to Directory Server and Administration Server instances residing locally on the computer where the upgrade is taking place.
- Obtain the required patches, based on Table 2-1 for the shared components.
- Obtain the required patches, based on Table 3-4 for the Directory and Administration Server.
Patches can be downloaded from:
- Login as super user.
- Upgrade the Shared Components.
- Upgrade the Administration Server.
swinstall -s <absolute-location>/<patch_ID > <patch_ID>
- Upgrade the Directory Server.
- swinstall -s <absolute-location>/<patch_ID> <patch_ID>
- cd /opt/sun/mps/serverroot/shared/bin; ./sync-product-cds -r /opt/sun/mps/serverroot -v 5.2_Patch_4 -j ds524.jar -g ds524.jar -n "Sun Java(TM) System Directory Server" -b "2005.286.1827" -i "cn=Sun ONE Directory Server, cn=Server Group, cn=< server-instance>.red.iplanet.com, ou=red.iplanet.com, o=NetscapeRoot"
You will be prompted for the admin username and password
Verifying the Upgrade
- You can verify successful upgrade of Directory Server and associated components by restarting the Directory Server daemon using the -v option:
# cd <server_root>/bin/slapd/server
# ./ns-slapd -v
You can verify the result as mentioned below:
Sun Java(TM) System Directory Server/5.2_Patch_4
and then checking the startup messages in the Directory Server error log:
/opt/sun/mps/serverroot/slapd-< server-instance>/logs/errors
- You can verify successful upgrade of Administration Server using the command as mentioned below:
# cd <server_root>/
# ./startconsole
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrade Procedure.
Rolling Back the Upgrade
Rollback Considerations
Rollback Procedure
- Login as super user.
- Rollback the Directory Server using the following commands:
- swremove <patch_ID>
- cd /opt/sun/mps/serverroot/shared/bin; ./sync-product-cds -r /opt/sun/mps/serverroot -v 5.2_Patch_3 -j ds523.jar -g ds523.jar -n "Sun Java(TM) System Directory Server" -b "2005.179.2117" -i "cn=Sun ONE Directory Server, cn=Server Group, cn=< server-instance>.red.iplanet.com, ou=red.iplanet.com, o=NetscapeRoot"
You will be prompted for the admin username and password.
- Verify the rollback of Directory Server:
# cd <server_root>/bin/slapd/server
# ./ns-slapd -v
You can verify the result as mentioned below:
Sun Java(TM) System Directory Server/5.2_Patch_3
- Roll back the Shared Components.
- Roll back the Administration Server by using the following commands:
- Verify the rollback of Administration Server.
/opt/sun/mps/serverroot/startconsole