Oracle Fusion Middleware Upgrade and Migration Guide for Oracle Directory Server Enterprise Edition

Part I Patching Directory Server Enterprise Edition 7 to 11g Release 1 (11.1.1)

The patching procedure converts exiting version 7 instances to 11g Release 1 (11.1.1)

This part includes the following chapter:

Chapter 2, Patching Directory Server Enterprise Edition 7 to Version 11g Release 1 (11.1.1).

Chapter 2 Patching Directory Server Enterprise Edition 7 to Version 11g Release 1 (11.1.1)

This chapter describes how to upgrade your previously deployed installation of Directory Server Enterprise Edition version 7 to version 11g Release 1 (11.1.1).

Patching Directory Server Enterprise Edition 7

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

ProcedureTo Patch a ZIP Installation of Directory Server Enterprise Edition 7

Perform this migration procedure on each Directory Server Enterprise Edition installation. However, identify the server that hosts Directory Service Control Center, and upgrade it first, before upgrading any other servers.


Note –

This procedure must be performed by the user account that owns the Directory Server Enterprise Edition installation.


  1. Run the following command.


    # INSTALL_PATH/bin/dsccsetup prepare-patch
    

    The dsccsetup prepare-patch command attempts to stop all running instances of Directory Server and Directory Proxy Server. If the dsccsetup prepare-patch command does not have permission to stop a server instance, it displays a message that describes its failure, and you must stop the server before continuing.

  2. Run one of the following commands to make sure that the server is stopped.

    To stop a directory server, run this command:


    # dsadm stop INSTANCE_DIRECTORY
    

    To stop a proxy server, run this command:


    # dpadm stop INSTANCE_DIRECTORY
    
  3. Create a temporary directory TEMP_DIRECTORY, and store a copy of the installation file in it.

    The installation file is one of the following, depending on the platform on which the server is installed:

    • ODSEE11_1_1_3_0_HP-UX.zip

    • ODSEE11_1_1_3_0_Linux-X86.zip

    • ODSEE11_1_1_3_0_Linux-X64.zip

    • ODSEE11_1_1_3_0_Solaris-Sparc.zip

    • ODSEE11_1_1_3_0_Solaris-X86.zip

    • ODSEE11_1_1_3_0_Solaris-X64.zip

    • ODSEE11_1_1_3_0_Windows-X86.zip

  4. Type the following commands to install the Directory Server Enterprise Edition software.


    # cd TEMP_DIRECTORY
    # unzip -qq ODSEE11_1_1_3_0_xxx.zip
    # cd ODSEE_ZIP_Distribution
    # unzip -qq sun-dsee7.zip -d INSTALL_PATH
    # cd INSTALL_PATH/dsee7

    This step effectively overwrites the existing installation, so the INSTALL_PATH refers to the installation path used in Step 1. All existing files should be overwritten.

  5. Run the following command.


    # bin/dsccsetup complete-patch
    
  6. Restart all server instances that were stopped in Step 1 .

  7. If you are patching the server that hosts Directory Service Control Center only, redeploy the Directory Service Control Center (DSCC) WAR file, INSTALL_PATH/dsee7/var/dscc7.war, as described in Pre-Configuring the Directory Server Enterprise Edition Installation in Oracle Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition and Appendix A, Deploying the DSCC WAR File, in Oracle Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition.


    Note –

    You must patch the Directory Service Control Center before patching any Directory Server or Directory Proxy Server server instances.


ProcedureTo Patch a Native Installation of Directory Server Enterprise Edition 7

  1. Run the following command.


    # unzip -qq -d INSTALL_PATH TEMP_DIRECTORY/ODSEE11_1_1_3_0_Solaris-xxx-pkg.zip
    

    where xxx specifies the installation file for the server.

  2. Run the following command.


    # INSTALL_PATH/bin/dsccsetup prepare-patch
    

    The dsccsetup prepare-patch command attempts to stop all running instances of Directory Server and Directory Proxy Server. If the dsccsetup prepare-patch command does not have permission to stop a server instance, it displays a message that describes its failure, and you must stop the server before continuing.

  3. Create a temporary directory TEMP_DIRECTORY, and store a copy of the installation file in it.

    The installation file is one of the following, depending on the platform on which the server is installed:

    • ODSEE11_1_1_3_0_Solaris-Sparc-pkg.zip

    • ODSEE11_1_1_3_0_Solaris-X86-pkg.zip

    • ODSEE11_1_1_3_0_Solaris-X64-pkg.zip

  4. If the server is installed on Solaris 9, run the following command to begin removing the current installation.


    # pkgrm SUNWdsee7-config
    
  5. Run the following command to remove the current installation.


    # pkgrm SUNWdsee7 SUNWdsee7-var SUNWdsee7-man
    
  6. Type the following commands to install the Directory Server Enterprise Edition software.


    cd /var/tmp/dsee/ODSEE_PKG_Distribution
    # pkgadd -d . SUNWdsee7
    # pkgadd -d . SUNWdsee7-var
    # pkgadd -d . SUNWdsee7-man
  7. If you are running the Solaris 9 operating system, you must install the SUNWdsee7-config package.

    • On a Solaris SPARC system, type:


      # pkgadd -d SunOS5.9 SUNWdsee7-config
    • On a Solaris x86 system, type:


      # pkgadd -d . SUNWdsee7-config
  8. Run the following command to apply current patches to the new installation.


    # patchadd PATCH_NUMBERS
    

    For the complete list of patches required for your platform, see List of Packages Required Before Installing Directory Server Enterprise Edition in Oracle Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition.

  9. Run the following command.


    # INSTALL_PATH/bin/dsccsetup complete-patch
    
  10. Manually restart all server instances that were stopped in Step 2.

  11. If you are patching the server that hosts Directory Service Control Center only, redeploy the DSCC WAR file, INSTALL_PATH/dsee7/var/dscc7.war, as described in Pre-Configuring the Directory Server Enterprise Edition Installation in Oracle Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition and Appendix A, Deploying the DSCC WAR File, in Oracle Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition.


    Note –

    You must patch the Directory Service Control Center before patching any Directory Server or Directory Proxy Server instances.


  12. For each Directory Proxy Server instance that has been registered as an SMF service, disable and reenable the service as follows:


    # dpadm disable-service instance-path
    # dpadm enable-service instance-path