= gerrit migrate-externalids-to-insensitive

== NAME
gerrit migrate-externalids-to-insensitive - Migrate external-ids to case insensitive.

== SYNOPSIS
[verse]
--
_ssh_ -p <port> <host> _gerrit migrate-externalids-to-insensitive_
  [--preserve-migration-mode]
--

== DESCRIPTION
This command allows to trigger online conversion of `username` and
`gerrit` external IDs to be handled case insensitively. This is done by
recomputing the name of the note from the sha1 sum of the all lowercase
external ID key, instead of preserving the key capitalization.

The command requires link:#auth.userNameCaseInsensitive[auth.userNameCaseInsensitive] and
link:#auth.userNameCaseInsensitiveMigrationMode[auth.userNameCaseInsensitiveMigrationMode] to
be set to true to perform the migration.

After the successful migration
link:#auth.userNameCaseInsensitiveMigrationMode[auth.userNameCaseInsensitiveMigrationMode] is
set to false.

== ACCESS
Caller must be a member of the privileged 'Administrators' group.

== SCRIPTING
This command is intended to be used in scripts.

== OPTIONS
--preserve-migration-mode::
	Skip setting `auth.userNameCaseInsensitiveMigrationMode` to `false` after the
	migration completes successfully. This option is useful in multi-primary and
	IaC setups where admins may prefer to update the migration mode config on all
	primaries and/or using IaC tooling after the migration completes.

== EXAMPLES
Start the online external ids migration:

----
$ ssh -p 29418 review.example.com gerrit migrate-externalids-to-insensitive
----

GERRIT
------
Part of link:index.html[Gerrit Code Review]

SEARCHBOX
---------