gerrit/Documentation/cmd-index-start.txt
Khai Do b9a5d00e15 Add an optional flag to force an online reindex
As discussed on Gerrit ML[1] and in referenced issue, there are
situations where you may want to run an online reindex besides
the upgrade gerrit use case.  This change allows users to force an
online reindex.

[1] https://groups.google.com/d/msg/repo-discuss/pUn8fHVh58w/icsSFef2CAAJ

feature: issue 3987
Change-Id: Ie88b7effda08996f7c0f325543be703bcf09c794
2016-08-02 14:09:12 -07:00

52 lines
1.2 KiB
Plaintext

= gerrit index start
== NAME
gerrit index start - Start the online indexer
== SYNOPSIS
[verse]
--
_ssh_ -p <port> <host> _gerrit index start_ <INDEX> [--force]
--
== DESCRIPTION
Gerrit supports online index schema upgrades. When starting Gerrit for the first
time after an upgrade that requires an index schema upgrade, the online indexer
will be started. If the schema upgrade is a success, the new index will be
activated and if it fails, a statement in the logs will be printed with the
number of successfully/failed indexed changes.
This command allows restarting the online indexer without having to restart
Gerrit. This command will not start the indexer if it is already running or if
the active index is the latest.
== ACCESS
Caller must be a member of the privileged 'Administrators' group.
== SCRIPTING
This command is intended to be used in scripts.
== OPTIONS
<INDEX>::
Restart the online indexer on this secondary index.
Currently supported values:
* changes
* accounts
--force::
Force an online re-index.
== EXAMPLES
Start the online indexer for the 'changes' index:
----
$ ssh -p 29418 review.example.com gerrit index start changes
----
GERRIT
------
Part of link:index.html[Gerrit Code Review]
SEARCHBOX
---------