2011-2013ForgeRock ASupgrade1OpenDJupgradeupgrade OpenDJ configuration & application dataupgradeoptionsDescriptionThis 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.Get and unpack a newer version of OpenDJ directory server
software.Stop the current OpenDJ directory server.Overwrite existing binary and script files with those of the
newer version, and then run this utility, the upgrade
command, before restarting OpenDJ.Start the upgraded OpenDJ directory server.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 option to run the command
non-interactively.When using the 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 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.OptionsThe following options are supported.Automatically accepts the product license if there is one in the
delivery.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 option.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.Utility Input/Output OptionsUse non-interactive mode. Prompt for any required information
rather than fail.Use quiet mode.Use verbose mode.General OptionsDisplay version information.Display usage information.Exit Codes0The command completed successfully.2The 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.OtherAn error occurred.See the Installation Guide for an example
upgrade process for OpenDJ directory server installed from the cross-platform
(.zip) delivery, Upgrading From
OpenDJ 2.4.5.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).