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