Title: upgrade
Author:
Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
Date: 05/17/2013
Manual: Tools Reference
Source: OpenDJ 2.6.0
Language: English
* 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 *
-----------------------------------------------------------------
\w'upgrade 'u upgrade {options}
This utility upgrades OpenDJ configuration (schema, directory server configuration, and other configuration files) and application data (primarily directory data) so that it is compatible with the binary files and scripts that are installed.
The upgrade command thus performs only part of the upgrade process, which includes the following phases for a single server.
\h'-04' 1.\h'+01'\c .\}
\h'-04' 2.\h'+01'\c .\}
\h'-04' 3.\h'+01'\c .\}
\h'-04' 4.\h'+01'\c .\}
.it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1
Important
The upgrade command does not back up OpenDJ before you upgrade, nor does it restore OpenDJ if the upgrade command fails. In order to revert a failed upgrade, make sure you back up OpenDJ directory server before you overwrite existing binary and script files.
By default, the upgrade command requests confirmation before making important configuration changes. You can use the --no-prompt option to run the command non-interactively.
When using the --no-prompt option, if the upgrade command cannot complete because it requires confirmation for a potentially very long or critical task, then it exits with an error and a message about how to finish making the changes. You can add the --force option to force a non-interactive upgrade to continue in this case, also performing long running and critical tasks.
After upgrading, see the resulting upgrade.log file for a full list of operations performed.
The following options are supported.
--force
Forces a non-interactive upgrade to continue even if it requires user interaction. In particular, long running or critical upgrade tasks, such as re-indexing, which require user confirmation will be skipped. This option may only be used with the --no-prompt option.
--ignoreErrors
Ignores any errors which occur during the upgrade. This option should be used with caution and may be useful in automated deployments where potential errors are known in advance and resolved after the upgrade has completed.
-n, --no-prompt
Use non-interactive mode. Prompt for any required information rather than fail.
-Q, --quiet
Use quiet mode.
-v, --verbose
Use verbose mode.
-V, --version
Display version information.
-?, -H, --help
Display usage information.
0
The command completed successfully.
2
The command was run in non-interactive mode, but could not complete because confirmation was required to run a long or critical task. See the error message or the log for details.
Other
An error occurred.
The following example shows the upgrade process for OpenDJ directory server installed from the cross-platform (.zip) delivery.
.\}
$ cd /path/to $ ls OpenDJ-2.4.6 $ ./OpenDJ-2.4.6/bin/stop-ds --quiet ... msg=The backend userRoot is now taken offline ... msg=The Directory Server is now stopped $ zip -rq OpenDJ-backup.zip OpenDJ-2.4.6 $ unzip -q ~/Downloads/OpenDJ-2.6.0.zip $ cp -r opendj/* OpenDJ-2.4.6/ $ rm -rf opendj $ mv OpenDJ-2.4.6 opendj $ ./opendj/upgrade --no-prompt >>>> OpenDJ Upgrade Utility * OpenDJ will be upgraded from version 2.4.6.8102 to 2.6.0.revision * See \*(Aq/path/to/opendj/upgrade.log\*(Aq for a detailed log of this operation >>>> Preparing to upgrade OpenDJ 2.6.0 modified the default configuration of the \*(AqisMemberOf\*(Aq virtual attribute so that it is included with group entries. This was done in order to make it easier for users to determine which groups a \*(Aqnested\*(Aq group belongs to. Do you want to make this configuration change? (yes/no) yes The upgrade is ready to proceed. Do you wish to continue? (yes/no) yes >>>> Performing upgrade Fixing de-DE collation matching rule OID............................ 100% Updating password policy configurations............................. 100% Updating audit log publisher configuration.......................... 100% Adding \*(Aqetag\*(Aq virtual attribute schema.............................. 100% Configuring \*(Aqetag\*(Aq virtual attribute................................ 100% Configuring \*(Aqds-pwp-password-expiration-time\*(Aq virtual attribute..... 100% Updating certificate syntax configuration........................... 100% Updating JPEG syntax configuration.................................. 100% Updating country string syntax configuration........................ 100% Modifying filter in \*(AqisMemberOf\*(Aq virtual attribute configuration.... 100% Updating dictionary password validator configuration................ 100% Updating attribute value password validator configuration........... 100% Adding PBKDF2 password storage scheme configuration................. 100% Replacing schema file \*(Aq02-config.ldif\*(Aq.............................. 100% Archiving concatenated schema....................................... 100% >>>> OpenDJ was successfully upgraded from version 2.4.6.8102 to 2.6.0.revision * See \*(Aq/path/to/opendj/upgrade.log\*(Aq for a detailed log of this operation $ ./opendj/bin/start-ds --quiet $
Native packages (.deb, .rpm) perform more of the upgrade process, stopping OpenDJ if it is running, overwriting older files with newer files, running this utility, and starting OpenDJ if it was running when you upgraded the package(s).
Copyright \(co 2011-2013 ForgeRock AS