test

Sun Directory Server Enterprise Edition 7.0 Upgrade and Migration Guide

Upgrading Directory Server Enterprise Edition 6 on Unsupported Platforms

In Directory Server Enterprise Edition 7.0, there are platforms that are no more supported. You must perform the specific operations to use your existing data and instances.

For more information about supported platforms, refer to Operating System Requirements in Sun Directory Server Enterprise Edition 7.0 Release Notes.

Refer to the following procedure based on your requirements:

ProcedureTo Upgrade Directory Server Enterprise Edition From Legacy Operating System

For more information on supported operating systems, refer to Operating System Requirements in Sun Directory Server Enterprise Edition 7.0 Release Notes.

  1. Stop the Directory Server and Directory Proxy Server instances.

  2. Take a backup of the whole filesystem.

    For more information, refer to Backing Up a File System in Binary Backup in Sun Directory Server Enterprise Edition 7.0 Administration Guide.

    If you need to upgrade only the Directory Proxy Server instances, use only the dpadm backup command.

  3. Upgrade your operating system version or choose a different machine with the supported operating system version installed.

    Note –

    If you are upgrading your operating system on the same machine, do not forget to copy your back up data to other machine.

  4. Install Directory Server Enterprise Edition 7.0.

    Based on your previous installation and platform combination, refer to Operating System Requirements in Sun Directory Server Enterprise Edition 7.0 Release Notes to find out what type of distribution you can install.

    Based on the solution, refer to any of the following procedures:

  5. Restore the filesystem that you backed up in Step 2.

    In case of only Directory Proxy Server instances, you can restore them using dpadm restore.

  6. Upgrade your legacy server instances.

    • For Directory Server instances:


      INSTALL_PATH/bin/dsadm upgrade INSTANCE_PATH

    • For Directory Proxy Server instances:


      INSTALL_PATH/bin/dpadm upgrade INSTANCE_PATH

ProcedureTo Upgrade 32–bit Server Instances

There is no direct way to upgrade Directory Server Enterprise Edition 6 32–bit server instances that are running on 64–bit Red Hat Enterprise Linux or SUSE Linux Enterprise Edition operating system. Even though the server instances cannot be upgraded fully automatically, the dsadm upgrade and dpadm upgrade commands upgrade the server configuration successfully.

Refer to the following procedure to upgrade such instances:

  1. If your Directory Server instance is configured to use non-default directories for databases, note the following paths:

    • For databases:


      DSEE_6_INSTALL_PATH/ds6/bin/dsconf get-server-prop -p port-number db-env-path db-log-path

    • For each suffix:


      DSEE_6_INSTALL_PATH/ds6/bin/dsconf get-suffix-prop -p port-number SUFFIX_DN db-path

  2. Export your data using version 6 installation.


    DSEE_6_INSTALL_PATH/ds6/bin/dsadm export INSTANCE_PATH SUFFIX_DN LDIF_FILE

  3. Take a backup of all the instances.


    $ tar cf BACKUP_INSTANCE INSTANCE_DIRECTORY

  4. Upgrade your legacy server instances.

    Note –

    If you have a customized schema, that needs to be manually upgraded as well. See the respective product documentation to know how to upgrade customized schema.

    • For Directory Server instances:


      DSEE_7_INSTALL_PATH/bin/dsadm upgrade INSTANCE_PATH

    • For Directory Proxy Server instances:


      DSEE_7_INSTALL_PATH/bin/dpadm upgrade INSTANCE_PATH

  5. If your Directory Server instance was configured to use non-default directories for databases, the configuration has been reset but files have not been deleted. Before reconfiguring your instance to use non-default directories, you must delete all old databases, caches, and transaction logs.

  6. Import your data in version 7 server instance.

    For each suffix:


    INSTALL_PATH/bin/dsadm import INSTANCE_PATH LDIF_FILE SUFFIX_DN
See Also

Migrating User Data Manually