To use the existing Directory Server and Directory Proxy Server instances with the Directory Server Enterprise Edition 7.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 |
Upgrading version 6 instances on a platform that is still supported in version 7.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.
If you are upgrading from version 6.2 to 7.0, refer to the following steps and then proceed to upgrade to 7.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 Sun Directory Server Enterprise Edition 7.0 Administration Guide
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 7.0.
Before upgrading the version 6 instances created by using native packages, to the 7.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 7.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 7. It will no longer be usable with DSEE 6 commands. Do you want to continue [y/n]? y Moving legacy scripts into '/local/example/bak/2009-08-25-11-23-16' ... Adding new files to instance ... Upgrading dse.ldif ... Old version of dse.ldif has been moved into '/local/example/bak/2009-08-25-11-23-16'. Directory Server instance '/local/example' is now ready to be used with DSEE 7 commands. |
Use —i with the dsadm upgrade command to suppress the warning message.
After upgrading to version 7.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).
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 Server instances that you want to use with the version 7.0, by using the dsadm upgrade command.
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 7.0, you must unregister the Directory Server instances from DSCC 6 and register them with DSCC 7.0. For more information about registration and unregistration, refer dsccreg(1M).
(Optional) Remove Directory Server Enterprise Edition 6.
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 7.0.
Before upgrading the version 6 instances created by using native packages, to the 7.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 7.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 version 7. 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/2009-08-25-11-09-06'. Directory Proxy Server instance '/local/example' is now ready to be used with DSEE 7 commands. |
Upgrade all the Directory Proxy Server instances that you want to use with the version 7.0, by using the dpadm upgrade command.
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.