Upgrading Directory Server Enterprise Edition 6

To upgrade to version 11g Release 1 (11.1.1.5.0), you must upgrade Directory Service Control Center, and Directory Server and Directory Proxy Server instances.

Note - You must upgrade the Directory Service Control Center before upgrading any Directory Server or Directory Proxy Server instances.

Refer to the following sections to upgrade:

To Upgrade Directory Service Control Center 6
Upgrading Directory Server and Directory Proxy Server Instances

To Upgrade Directory Service Control Center 6

To access the Directory Server Enterprise Edition 11g Release 1 (11.1.1.5.0) instances using DSCC, you must upgrade DSCC 6 to version 11g Release 1 (11.1.1.5.0).

Using DSCC 11g Release 1 (11.1.1.5.0), you can access version 6, 7.0, and 11g Release 1 (11.1.1.5.0) instances.

If you are upgrading DSCC that was installed using native packages, you must perform the following steps as root.

Install Directory Server Enterprise Edition 11g Release 1 (11.1.1.5.0).
For more information, see Chapter 2, Installing Directory Server Enterprise Edition, in Oracle Directory Server Enterprise Edition Installation Guide.
Stop the DSCC 6 registry and export its content.
The dsee6-install-path specifies the path where Directory Server Enterprise Edition 6 is installed.
1. Stop the DSCC 6 registry.
```
# dsee6-install-path/ds6/bin/dsadm stop /var/opt/SUNWdsee/dscc6/dcc/ads
```
2. Record the DSCC 6 registry port numbers.
```
# dsee6-install-path/ds6/bin/dsadm info /var/opt/SUNWdsee/dscc6/dcc/ads
```
3. Export the DSCC 6 registry content.
```
# dsee6-install-path/ds6/bin/dsadm export /var/opt/SUNWdsee/dscc6/dcc/ads \
cn=dscc /tmp/dscc.ldif
```
  The /tmp/dscc.ldif file contains the server configuration.
Create and populate the DSCC 11g Release 1 (11.1.1.5.0) registry with the version 6 registry content.
1. Create the DSCC 11g Release 1 (11.1.1.5.0) registry by using the same ports that DSCC 6 registry has used.
```
# install-path/bin/dsccsetup ads-create -p port -P secure-port
```
  The port and secure-port values are the values that are recorded in Step 2b.
2. Stop the registry.
```
# install-path/bin/dsadm stop /var/opt/SUNWdsee7/dcc/ads
```
3. Import the /tmp/dscc.ldif file.
```
# install-path/bin/dsadm import /var/opt/SUNWdsee7/dcc/ads /tmp/dscc.ldif cn=dscc
```
4. Start the registry.
```
# install-path/bin/dsadm start /var/opt/SUNWdsee7/dcc/ads
```
5. Verify all the registrations of the server.
```
# install-path/bin/dsccreg list-servers -p port-number
```
  All the existing servers are displayed. All the registrations are version 6 registrations.
6. (Optional) You can see all the Directory Server instances.
```
# install-path/bin/dsccmon view-servers -p port-number
```
  The server instances are shown as version 6 instances.
Deploy the DSCC 11g Release 1 (11.1.1.5.0) WAR file.
Refer to Appendix A, Deploying the DSCC WAR File, in Oracle Directory Server Enterprise Edition Installation Guide.
If you have upgraded DSCC that was installed by using native packages, you must access DSCC as root.
(Optional) Uninstall Directory Server Enterprise Edition 6.
For more information, refer to the Directory Server Enterprise Edition 6 Installation Guide.

Upgrading Directory Server and Directory Proxy Server Instances

To use the existing Directory Server and Directory Proxy Server instances with the Directory Server Enterprise Edition 11g Release 1 (11.1.1.5.0) installation, you must upgrade all the legacy instances.

The upgrade process modifies the current configuration and instance data without allowing to revert back the changes.

Before upgrading legacy Directory Server and Directory Proxy Server instances, take a backup of all the instances so that they can be restored in case of any problem. Take a backup of the instance files with a filesystem utility such as tar or cpio. For example:

$ tar cf BACKUP_INSTANCE INSTANCE_DIRECTORY

Note - Upgrading version 6 instances on a platform that is still supported in version 11g Release 1 (11.1.1.5.0), requires no data migration.

But in some cases, directly upgrading the server instances is not possible. For example, upgrading a version 6 32–bit instance that was running on Red Hat Enterprise Linux or SUSE Linux Enterprise Edition 64–bit platform is no longer possible. The instance has to be 64–bit to run on 64–bit platform. Follow the procedure specified at Upgrading Directory Server Enterprise Edition 6 on Unsupported Platforms to upgrade such instances.

Note - If you are upgrading from version 6.2 to 11g Release 1 (11.1.1.5.0), refer to the following steps and then proceed to upgrade to 11g Release 1 (11.1.1.5.0):

Export database to an LDIF file.

For more information see the dsadm export command in dsadm(1M).
Upgrade Directory Server Enterprise Edition 6.2 installation to version 6.3.

For detailed information, see Sun Directory Server Enterprise Edition 6.3 Installation Guide.
Import data from the LDIF file that was created in Step 1.

For more information, see Importing Data From an LDIF File in Oracle Directory Server Enterprise Edition Administration Guide

To Upgrade Directory Server Instances

The following procedure is also valid for the following:

Upgrading the native packages based instances on Solaris operating system to zip distribution based instances on Solaris operating system.
Upgrading the zip distribution based instances on Solaris operating system to native packages based instances on Solaris operating system. In this case, step 2 is not applicable.
Upgrading native packages based instances on the platforms that are no more supported for native packages based distribution in this version. On such platforms, the instances must be upgraded to zip distribution instances.

Install Directory Server Enterprise Edition 11g Release 1 (11.1.1.5.0).
Before upgrading the version 6 instances created by using native packages, to the 11g Release 1 (11.1.1.5.0) zip distribution instances, disable all the features specific to native packages by using the version 6 native packages installation.
- If your instance is registered to start at boot, type the following command:
```
$ ./dsadm autostart --off INSTANCE_PATH
```
- If your instance is registered as a Windows service, type the following command:
```
$ ./dsadm disable-service --type WIN_SERVICE INSTANCE_PATH
```
- If your instance is registered as an SMF service, type the following command:
```
$ ./dsadm disable-service --type SMF INSTANCE_PATH
```
- If your instance is registered in a cluster, type the following command:
```
$ ./dsadm disable-service --type CLUSTER INSTANCE_PATH
```

Type the following command from the version 11g Release 1 (11.1.1.5.0) installation to upgrade the Directory Server instances.

$ ./dsadm upgrade [-i] INSTANCE_PATH

For example, to upgrade the /local/example instance, type the following command:

# ./dsadm upgrade /local/example

Directory Server instance '/local/example' will be upgraded to version 11.1.1.5.0.
It will no longer be usable with DSEE 6 commands.
Moving legacy scripts into '/local/example/bak/2011-03-28-01-45-18' ...
Adding new files to instance ...
Upgrading dse.ldif ...
Old version of dse.ldif has been moved into '/local/example/bak/2011-03-28-01-45-18'.
Upgrading dse.ldif ...
Old version of dse.ldif has been moved into '/local/example/bak/2011-03-28-01-45-18'.
Old version of 00core.ldif has been moved into '/local/example/bak/2011-03-28-01-45-18'.
Directory Server instance '/local/example' is now ready to be used with ODSEE 11.1.1.5.0 commands.

Use —i with the dsadm upgrade command to suppress the warning message.

Note - After upgrading to version 11g Release 1 (11.1.1.5.0), the following version 6 behavior is preserved.

Directory Server 6 is noncompliant with RFC 4522 when returning binary attributes in search results. To preserve this behavior, by default, the compat-flag Directory Server configuration property is set to no-rfc4522. To check the value of compat-flag, refer to the following command:

$ dsconf get-server-prop -p port compat-flag

For more information about the compat-flag property, see server(5dsconf).

Upgrade all the Directory Server instances that you want to use with the version 11g Release 1 (11.1.1.5.0), by using the dsadm upgrade command.
Note - The legacy instances once upgraded cannot be restored to its previous installation.
The following dsadm commands do not require legacy instances to be upgraded before using them.
```
     - info
     - stop
     - disable-service
     - autostart --off
     - get-flags
     - set-flags
     - add-cert
     - add-selfsign-cert
     - export-cert
     - import-cert
     - import-selfsign-cert
     - list-certs
     - remove-cert
     - renew-cert
     - renew-selfsign-cert
     - request-cert/show-cert
     - show-access-log
     - show-error-log
     - delete
```
To use the upgraded instances with DSCC 11g Release 1 (11.1.1.5.0), you must unregister the Directory Server instances from DSCC 6 and register them with DSCC 11g Release 1 (11.1.1.5.0). For more information about registration and unregistration, refer dsccreg(1M).
(Optional) Remove Directory Server Enterprise Edition 6.

To Upgrade Directory Proxy Server Instances

The following procedure is also valid for the following:

Upgrading native packages based instances on Solaris operating system to the zip distribution based instances on Solaris operating system.
Upgrading zip distribution based instances on Solaris operating system to the native packages based instances on Solaris operating system. In this case, step 2 is not applicable.
Upgrading native packages based instances on the platforms that are no more supported for native packages based distribution in this version. On such platforms, the instances must be upgraded to zip distribution based instances.

Install Directory Server Enterprise Edition 11g Release 1 (11.1.1.5.0).
Before upgrading the version 6 instances created by using native packages, to the 11g Release 1 (11.1.1.5.0) zip distribution instances, disable features specific to the native packages by using the version 6 native packages installation.
- If your instance is registered to start at boot, type the following command:
```
$ ./dpadm autostart --off INSTANCE_PATH
```
- If your instance is registered as a Windows service, type the following command:
```
$ ./dpadm disable-service --type WIN_SERVICE INSTANCE_PATH
```
- If your instance is registered as an SMF service, type the following command:
```
$ ./dpadm disable-service --type SMF INSTANCE_PATH
```
Type the following command from the version 11g Release 1 (11.1.1.5.0) installation to upgrade the Directory Proxy Server instances.
```
$ ./dpadm upgrade -i INSTANCE_PATH
```
For example, to upgrade the /local/example instance, type the following command:
```
# ./dpadm upgrade -i /local/example

Directory Proxy Server instance '/local/example' will be upgraded to ODSEE 11.1.1.5.0.
It will no longer be usable with DSEE 6 commands.
Do you want to continue [y/n]? y
Upgrading conf.ldif ...
Old version of conf.ldif has been moved into '/local/example/bak/2011-03-28-01-47-19'.
Upgrading conf.ldif ...
Old version of conf.ldif has been moved into '/local/example/bak/2011-03-28-01-47-19'.
Directory Proxy Server instance '/local/example' is now ready to be used with ODSEE 11.1.1.5.0 commands.
```
Note - After upgrading to version 11g Release 1 (11.1.1.5.0), the following version 6 behavior is preserved.
To retain the pattern matching distribution algorithm version 6 behavior, the compat-flag Directory Proxy Server configuration property is set to pattern-matching-also-6. To check the value of compat-flag, refer to the following command:
```
$ dpconf get-server-prop -p port compat-flag
```
For more information about the compat-flag property, see compat-flag(5dpconf).
Upgrade all the Directory Proxy Server instances that you want to use with the version 11g Release 1 (11.1.1.5.0), by using the dpadm upgrade command.
Note - The legacy instances once upgraded cannot be restored to its previous installation.
The following dpadm commands do not require legacy instances to be upgraded before using them.
```
     - info
     - stop
     - disable-service
     - autostart --off
     - get-flags / set-flags
     - add-cert
     - add-selfsign-cert
     - import-cert
     - list-certs
     - remove-cert
     - renew-cert
     - request-cert
     - show-cert
     - delete
```
(Optional) Remove Directory Server Enterprise Edition 6.

Skip Navigation Links
Exit Print View
	Oracle Directory Server Enterprise Edition Upgrade and Migration Guide 11 g Release 1 (11.1.1.5.0)