| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 1 | = LocalUsernamesToLowerCase |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 2 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 3 | == NAME |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 4 | LocalUsernamesToLowerCase - Convert the local username of every |
| 5 | account to lower case |
| 6 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 7 | == SYNOPSIS |
| Michael Ochmann | a843461 | 2016-07-08 10:58:27 +0200 | [diff] [blame] | 8 | [verse] |
| Yuxuan 'fishy' Wang | d85b687 | 2013-11-15 11:47:46 -0800 | [diff] [blame] | 9 | -- |
| Michael Ochmann | a843461 | 2016-07-08 10:58:27 +0200 | [diff] [blame] | 10 | _java_ -jar gerrit.war _LocalUsernamesToLowerCase |
| 11 | -d <SITE_PATH> |
| Yuxuan 'fishy' Wang | d85b687 | 2013-11-15 11:47:46 -0800 | [diff] [blame] | 12 | -- |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 13 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 14 | == DESCRIPTION |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 15 | Converts the local username for every account to lower case. The |
| 16 | local username is the username that is used to login into the Gerrit |
| David Pursehouse | a1d633b | 2014-05-02 17:21:02 +0900 | [diff] [blame] | 17 | Web UI. |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 18 | |
| 19 | This task is only intended to be run if the configuration parameter |
| 20 | link:config-gerrit.html#ldap.localUsernameToLowerCase[ldap.localUsernameToLowerCase] |
| 21 | was set to true to achieve case insensitive LDAP login to the Gerrit |
| David Pursehouse | a1d633b | 2014-05-02 17:21:02 +0900 | [diff] [blame] | 22 | Web UI. |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 23 | |
| 24 | Please be aware that the conversion of the local usernames to lower |
| 25 | case can't be undone. |
| 26 | |
| 27 | The program will produce errors if there are accounts that have the |
| 28 | same local username, but with different case. In this case the local |
| 29 | username for these accounts is not converted to lower case. |
| 30 | |
| 31 | This task can run in the background concurrently to the server if the |
| 32 | database is MySQL or PostgreSQL. If the database is H2, this task |
| 33 | must be run by itself. |
| 34 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 35 | == OPTIONS |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 36 | |
| 37 | -d:: |
| Yuxuan 'fishy' Wang | 77e1508 | 2013-12-09 15:43:25 -0800 | [diff] [blame] | 38 | --site-path:: |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 39 | Location of the gerrit.config file, and all other per-site |
| 40 | configuration data, supporting libraries and log files. |
| 41 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 42 | == CONTEXT |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 43 | This command can only be run on a server which has direct |
| 44 | connectivity to the metadata database. |
| 45 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 46 | == EXAMPLES |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 47 | To convert the local username of every account to lower case: |
| 48 | |
| Michael Ochmann | b99feab | 2016-07-06 14:10:22 +0200 | [diff] [blame] | 49 | ---- |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 50 | $ java -jar gerrit.war LocalUsernamesToLowerCase -d site_path |
| Michael Ochmann | b99feab | 2016-07-06 14:10:22 +0200 | [diff] [blame] | 51 | ---- |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 52 | |
| Fredrik Luthander | a6bb951 | 2014-03-24 18:59:45 -0700 | [diff] [blame] | 53 | == SEE ALSO |
| Edwin Kempin | b3b0d29 | 2011-09-14 14:17:34 +0200 | [diff] [blame] | 54 | |
| 55 | * Configuration parameter link:config-gerrit.html#ldap.localUsernameToLowerCase[ldap.localUsernameToLowerCase] |
| 56 | |
| 57 | GERRIT |
| 58 | ------ |
| 59 | Part of link:index.html[Gerrit Code Review] |
| Yuxuan 'fishy' Wang | 99cb68d | 2013-10-31 17:26:00 -0700 | [diff] [blame] | 60 | |
| 61 | SEARCHBOX |
| 62 | --------- |
