This post shows an example of the basic upgrade procedure of Oracle Directory Server Enterprise Edition from 11g Release 1 (  to ODSEE was initially installed using a zip distribution in a linux x86-64 environment in this example. We referred to this documentation on Oracle’s website here. 

First step is to check whether the installed version of ODSEE requires migration or upgrade. Directory Server 5.x supports migration only and all the other 11g Release 1, 7.x, 6.x ODSEE instances support upgrade.

ODSEE 11g Release 1 upgrade overwrites all the binaries. All the old files related to previous installation will be replaced by the new files because co-existense with the older version is not possible.

Upgrade Steps:

(i) Make a backup of all the instances so that they can be restored if any problem during upgrade. Be Ready with the download of ODSEE 11g Release 1 ( installation file.

(ii) Stop the Cacao module.

# INSTALL-PATH/dsee7/bin/cacaoadm stop

(iii) Run ‘prepare-patch’ command as shown in the example


This command stops all the Directory Server instances and servers. If any of the servers are not stopped due to some permission issue, then we have to manually stop them

#INSTALL-PATH/bin/dsadm stop instance-path  — to stop a directory server

#INSTALL-PATH/bin/dpadm stop instance-path — to stop a proxy server

(iv) Unzip the downloaded installation file ( to the same ‘INSTALL-PATH’ where we have the older version ( This step will make sure all the old files are overwritten as shown in the example –


(v) After the files are replaced successfully, we have to run the ‘complete-patch’ command which will create the DSCC war file as shown in the example. Redeploy this war file into the necessary applications.


(vi) If there was any manual stopping of servers after the ‘prepare-patch’ step because of any problems, then such Directory Server instances should be manually upgraded

#INSTALL-PATH/bin/dsadm upgrade [-i] instance-path

The upgrade is complete and all the servers could be started now.