NAME

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

SYNOPSIS

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 auth.userNameCaseInsensitive and auth.userNameCaseInsensitiveMigrationMode to be set to true to perform the migration.

After the successful migration 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

Part of Gerrit Code Review