7321N/A<?
xml version="1.0" encoding="UTF-8"?>
7321N/A ! This work is licensed under the Creative Commons 7321N/A ! Attribution-NonCommercial-NoDerivs 3.0 Unported License. 7321N/A ! To view a copy of this license, visit 7321N/A ! or send a letter to Creative Commons, 444 Castro Street, 7321N/A ! Suite 900, Mountain View, California, 94041, USA. 7321N/A ! You can also obtain a copy of the license at 7321N/A ! See the License for the specific language governing permissions 7321N/A ! and limitations under the License. 7321N/A ! If applicable, add the following below this CCPL HEADER, with the fields 7321N/A ! enclosed by brackets "[]" replaced with your own identifying information: 7321N/A ! Portions Copyright [yyyy] [name of copyright owner] 7321N/A ! Copyright 2011-2014 ForgeRock AS 7321N/A<
refentry xml:
id='rebuild-index-1' 7321N/A version='5.0' xml:
lang='en' 7321N/A <
info><
copyright><
year>2011-2014</
year><
holder>ForgeRock AS</
holder></
copyright></
info>
7321N/A <
refentrytitle>rebuild-index</
refentrytitle><
manvolnum>1</
manvolnum>
7321N/A <
refmiscinfo class="software">OpenDJ</
refmiscinfo>
7321N/A <
refmiscinfo class="version"><?
eval ${
docTargetVersion}?></
refmiscinfo>
7321N/A <
refname>rebuild-index</
refname>
7321N/A <
refpurpose>rebuild index after configuration change</
refpurpose>
7321N/A <
command>rebuild-index</
command>
7321N/A <
arg choice="req">options</
arg>
7321N/A <
para>This utility can be used to rebuild index data within a backend based
7321N/A on the Berkeley DB Java Edition.</
para>
7321N/A <
para>The following options are supported.</
para>
7321N/A <
term><
option>-b, --baseDN {baseDN}</
option></
term>
7321N/A <
para>Base DN of a backend supporting indexing. Rebuild is performed on
7321N/A indexes within the scope of the given base DN.</
para>
7321N/A <
term><
option>--clearDegradedState</
option></
term>
7321N/A <
para>Indicates that indexes do not need rebuilding because they are known
7321N/A to be empty and forcefully marks them as valid. <
emphasis>This is an
7321N/A advanced option which must only be used in cases where a degraded index is
7321N/A known to be empty and does not therefore need rebuilding.</
emphasis> This
7321N/A situation typically arises when an index is created for an attribute which
7321N/A has just been added to the schema.</
para>
7321N/A <
term><
option>-i, --index {index}</
option></
term>
7321N/A <
para>Names of index(es) to rebuild. For an attribute index this is
7321N/A simply an attribute name. At least one index must be specified for
7321N/A rebuild. Cannot be used with the <
option>--rebuildAll</
option>
7321N/A or <
option>--rebuildDegraded</
option> options.</
para>
7321N/A <
term><
option>--rebuildAll</
option></
term>
7321N/A <
para>Rebuild all indexes, including any DN2ID, DN2URI, VLV and
7321N/A extensible indexes. Cannot be used with the <
option>--index</
option>
7321N/A or <
option>--rebuildDegraded</
option> options.</
para>
7321N/A <
term><
option>--rebuildDegraded</
option></
term>
7321N/A <
para>Rebuild all degraded indexes, including any DN2ID, DN2URI, VLV and
7321N/A extensible indexes. Cannot be used with the <
option>--index</
option>
7321N/A or <
option>--rebuildAll</
option> options.</
para>
7321N/A <
term><
option>--tmpdirectory {directory}</
option></
term>
7321N/A <
para>Path to temporary directory for index scratch files during index
7321N/A <
para>Default value: import-tmp</
para>
7321N/A <
title>Task Backend Connection Options</
title>
7321N/A <
term><
option>--connectTimeout {timeout}</
option></
term>
7321N/A <
para>Maximum length of time (in milliseconds) that can be taken to
7321N/A establish a connection. Use '0' to specify no time out.</
para>
7321N/A <
para>Default value: 30000</
para>
7321N/A <
term><
option>-D, --bindDN {bindDN}</
option></
term>
7321N/A <
para>DN to use to bind to the server</
para>
7321N/A <
para>Default value: cn=Directory Manager</
para>
7321N/A <
term><
option>-h, --hostname {host}</
option></
term>
7321N/A <
para>Directory server hostname or IP address</
para>
7321N/A <
term><
option>-j, --bindPasswordFile {bindPasswordFile}</
option></
term>
7321N/A <
para>Bind password file</
para>
7321N/A <
term><
option>-K, --keyStorePath {keyStorePath}</
option></
term>
7321N/A <
para> Certificate key store path</
para>
7321N/A <
term><
option>-N, --certNickname {nickname}</
option></
term>
7321N/A <
para>Nickname of certificate for SSL client authentication</
para>
7321N/A <
term><
option>-o, --saslOption {name=value}</
option></
term>
7321N/A <
para>SASL bind options</
para>
7321N/A <
term><
option>-p, --port {port}</
option></
term>
7321N/A <
para>Directory server administration port number</
para>
7321N/A <
para>Default value: 4444</
para>
7321N/A <
term><
option>-P, --trustStorePath {trustStorePath}</
option></
term>
7321N/A <
para>Certificate trust store path</
para>
7321N/A <
term><
option>-T, --trustStorePassword {trustStorePassword}</
option></
term>
7321N/A <
para>Certificate trust store PIN</
para>
7321N/A <
term><
option>-u, --keyStorePasswordFile {keyStorePasswordFile}</
option></
term>
7321N/A <
para>Certificate key store PIN file</
para>
7321N/A <
term><
option>-U, --trustStorePasswordFile {path}</
option></
term>
7321N/A <
para>Certificate trust store PIN file</
para>
7321N/A <
term><
option>-w, --bindPassword {bindPassword}</
option></
term>
7321N/A <
para>Password to use to bind to the server</
para>
7321N/A <
para>Use <
option>-w -</
option> to have the command prompt for the
7321N/A password, rather than enter the password on the command line.</
para>
7321N/A <
term><
option>-W, --keyStorePassword {keyStorePassword}</
option></
term>
7321N/A <
para>Certificate key store PIN</
para>
7321N/A <
term><
option>-X, --trustAll</
option></
term>
7321N/A <
para>Trust all server SSL certificates</
para>
7321N/A <
title>Task Scheduling Options</
title>
7321N/A <
term><
option>--completionNotify {emailAddress}</
option></
term>
7321N/A <
para>Email address of a recipient to be notified when the task
7321N/A completes. This option may be specified more than once.</
para>
7321N/A <
term><
option>--dependency {taskID}</
option></
term>
7321N/A <
para>ID of a task upon which this task depends. A task will not start
7321N/A execution until all its dependencies have completed execution.</
para>
7321N/A <
term><
option>--errorNotify {emailAddress}</
option></
term>
7321N/A <
para>Email address of a recipient to be notified if an error occurs
7321N/A when this task executes. This option may be specified more than
7321N/A <
term><
option>--failedDependencyAction {action}</
option></
term>
7321N/A <
para>Action this task will take should one if its dependent tasks fail.
7321N/A The value must be one of PROCESS, CANCEL, DISABLE. If not specified
7321N/A <
term><
option>--recurringTask {schedulePattern}</
option></
term>
7321N/A <
para>Indicates the task is recurring and will be scheduled according
7321N/A <
term><
option>-t, --start {startTime}</
option></
term>
7321N/A <
para>Indicates the
date/
time at which this operation will start when
7321N/A scheduled as a server task expressed in YYYYMMDDhhmmssZ format for UTC
7321N/A time or YYYYMMDDhhmmss for local time. A value of '0' will cause the
7321N/A task to be scheduled for immediate execution. When this option is
7321N/A specified the operation will be scheduled to start at the specified
7321N/A time after which this utility will exit immediately.</
para>
7321N/A <
term><
option>--noPropertiesFile</
option></
term>
7321N/A <
para>No properties file will be used to get default command line
7321N/A <
term><
option>--propertiesFilePath {propertiesFilePath}</
option></
term>
7321N/A <
para>Path to the file containing default property values used for
7321N/A command line arguments</
para>
7321N/A <
title>General Options</
title>
7321N/A <
term><
option>-V, --version</
option></
term>
7321N/A <
para>Display version information</
para>
7321N/A <
term><
option>-?, -H, --help</
option></
term>
7321N/A <
para>Display usage information</
para>
7321N/A <
para>The command completed successfully.</
para>
7321N/A <
para>An error occurred while parsing the command-line arguments.</
para>
7321N/A <
para>The following example schedules a task to start immediately that
7321N/A rebuilds the <
literal>cn</
literal> (common name) index.</
para>
7321N/A -w password -b dc=example,dc=com -i cn -t 0</
userinput>
7321N/A<
computeroutput>Rebuild Index task 20110607160349596 scheduled to start Jun 7, 2011 4:03:49 PM</
computeroutput>