upgrade.1 revision 54c356b692bd520cec70e821a41c97c39b76aac0
t
Title: upgrade
Author:
Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
Date: November 21, 2011
Manual: Tools Reference
Source: OpenDJ 2.5.0
Language: English

"UPGRADE" "1" "November 21, 2011" "OpenDJ 2.5.0" "Tools Reference"
-----------------------------------------------------------------
* Define some portability stuff
-----------------------------------------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
http://bugs.debian.org/507673
http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-----------------------------------------------------------------
* set default formatting
-----------------------------------------------------------------
disable hyphenation
disable justification (adjust text to left margin only)
-----------------------------------------------------------------
* MAIN CONTENT STARTS HERE *
-----------------------------------------------------------------
"NAME"
upgrade - upgrade OpenDJ directory server
"SYNOPSIS"

\w'upgrade 'u upgrade {options}

"DESCRIPTION"

This utility can be used to upgrade the directory server to a newer version or revert to a previous version.

When using this tool to upgrade the server you should first downloaded an OpenDJ install package (.zip) file and specify its location using the -f/--file option. You can also upgrade your server using the Java Web Start version of this tool by visiting the OpenDJ web site at www.forgerock.org/opendj.html.

When using the tool to revert to a previous version you must either indicate that you want to revert to the version before the most recent upgrade using the -r/--revertMostRecent option or specify the location of a reversion archive using the -a/--reversionArchive option.

"OPTIONS"

The following options are supported.

-a, --reversionArchive {directory}

Directory where reversion files are stored. This should be one of the child directories of the \*(Aqhistory\*(Aq directory that is created when the upgrade tool is run.

-f, --file {file}

Specifies an existing server package (.zip) file to which the current build will be upgraded using the command line version of this tool

-r, --revertMostRecent

The installation will be reverted to the state before the most recent upgrade

"Utility Input/Output Options"

-n, --no-prompt

Use non-interactive mode. If data in the command is missing, the user is not prompted and the tool will fail

-Q, --quiet

Run setup in quiet mode. Quiet mode will not output progress information to standard output

-v, --verbose

Use verbose mode

"General Options"

-V, --version

Display version information

-?, -H, --help

Display usage information

"EXIT CODES"

0

The command completed successfully.

> 0

An error occurred.

"EXAMPLES"

The following example demonstrates upgrade without interaction.

.\}

$ ./OpenDJ/upgrade -f ~/Downloads/OpenDJ-2.5.0.zip -n
See
/var/.../opends-upgrade-5650414945123366149.log
 for a detailed log of this operation.

Initializing Upgrade ..... Done.
Calculating Schema Customizations ..... Done.
Calculating Configuration Customizations ..... Done.
Backing Up Files ..... Done.
Upgrading Components ..... Done.
Preparing Customizations ..... Done.
Applying Configuration Customizations ..... Done.
Verifying Upgrade ..... Done.
Cleaning Up ..... Done.
Recording Upgrade History ..... Done.
See /path/to/OpenDJ/history/log for a detailed installation history.
QuickUpgrade Completed Successfully. The OpenDJ installation at
/path/to/OpenDJ has now been upgraded to version OpenDJ 2.5.0 (Build ID:
YYYYMMDDhhmmssZ).

See /var/.../opends-upgrade-5650414945123366149.log
 for a detailed log of this operation.
.\}
"COPYRIGHT"

Copyright \(co 2011 ForgeRock AS