The upgrade command upgrades a directory server instance to a newer version or reverts an instance to a previous version.
The upgrade command is used to upgrade a directory server instance to a new version or revert an instance to a previous version. It can be run in one of three modes:
Graphical user interface (GUI) mode. GUI mode provides a simple way to upgrade your directory server instance using Java Web Start.
Interactive command-line mode. By default, interactive command-line mode runs the application when it is called without any options, and prompts for the required information before the upgrade begins.
Quiet upgrade mode. Quiet upgrade mode runs the application when it is called with the -Q or --quiet option and is useful for upgrade scripts. No progress information is written to the standard output with the --quiet option.
Revert the instance by using a specific reversion archive. Reversion archives are stored as subdirectories of the history directory in the server root.
Specify the upgrade package (.zip) file. This option is required unless you are running the command in interactive mode.
Revert the instance to the version prior to the most recent upgrade. This option is useful for undoing a previous upgrade.
Run in non-interactive mode. Prompt for any required information.
Run in quiet mode. No output is generated unless a significant error occurs during the process.
Use verbose mode
Display command-line usage information for the utility and exit without making any attempt to stop or restart the directory server.
Display the version information for the directory server and exit rather than attempting to run this command.
The following examples show how to use the directory server commands. You can use the commands on any UNIX, Linux, or Windows system that has at least the Java SE 5.0 (at least Sun version 1.5.0_08 or non-Sun version 1.5) runtime environment installed on its target system.
The following command walks you through the upgrade process and prompts for the .zip file that will be used to upgrade.
The following command upgrades the current files from the version contained in the specified .zip file.
$ upgrade -f OpenDS-1.1.0.zip
An exit code of 0 indicates that the operation completed successfully. A non-zero exit code indicates that an error occurred during processing.
The upgrade utility writes two log files named opends-upgrade-IDnumber.log and opends-upgrade-ext-IDnumber.log. The file is written by the upgrade process itself and the latter file is written by the zip file extraction process that takes place prior to the upgrade.
The log files are located at these paths:
UNIX (Solaris): /var/tmp/
Windows: The %TEMP% folder. By default, this folder is C:\Documents and Settings\User\Local Settings\Temp
The upgrade command is located at these paths:
UNIX and Linux: install-dir/upgrade