| Dariusz Luksza | ebab92a | 2014-09-10 11:14:19 +0200 | [diff] [blame] | 1 | = SwitchSecureStore |
| 2 | |
| 3 | == NAME |
| 4 | SwitchSecureStore - Changes the currently used SecureStore implementation |
| 5 | |
| 6 | == SYNOPSIS |
| Michael Ochmann | a843461 | 2016-07-08 10:58:27 +0200 | [diff] [blame] | 7 | [verse] |
| Dariusz Luksza | ebab92a | 2014-09-10 11:14:19 +0200 | [diff] [blame] | 8 | -- |
| Michael Ochmann | a843461 | 2016-07-08 10:58:27 +0200 | [diff] [blame] | 9 | _java_ -jar gerrit.war _SwitchSecureStore_ |
| Kaushik Lingarkar | e46048c | 2023-01-13 08:55:12 -0800 | [diff] [blame] | 10 | [--new-secure-store-lib=<PATH_TO_JAR>] |
| Dariusz Luksza | ebab92a | 2014-09-10 11:14:19 +0200 | [diff] [blame] | 11 | -- |
| 12 | |
| 13 | == DESCRIPTION |
| 14 | Changes the SecureStore implementation used by Gerrit. It migrates all data |
| 15 | stored in the old implementation, removes the old implementation jar file |
| 16 | from `$site_path/lib` and puts the new one there. As a final step |
| 17 | the link:config-gerrit.html#gerrit.secureStoreClass[gerrit.secureStoreClass] |
| 18 | property of `gerrit.config` will be updated. |
| 19 | |
| 20 | All dependencies not provided by Gerrit should be put the in `$site_path/lib` |
| 21 | directory manually, before running the `SwitchSecureStore` program. |
| 22 | |
| 23 | After this operation there is no automatic way back the to standard Gerrit no-op |
| 24 | secure store implementation, however there is a manual procedure: |
| 25 | * stop Gerrit, |
| 26 | * remove SecureStore jar file from `$site_path/lib`, |
| 27 | * put plain text passwords into `$site_path/etc/secure.conf` file, |
| 28 | * start Gerrit. |
| 29 | |
| 30 | == OPTIONS |
| 31 | |
| 32 | --new-secure-store-lib:: |
| 33 | Path to jar file with new SecureStore implementation. Jar dependencies must be |
| 34 | put in `$site_path/lib` directory. |
| 35 | |
| 36 | GERRIT |
| 37 | ------ |
| 38 | Part of link:index.html[Gerrit Code Review] |
| 39 | |
| 40 | SEARCHBOX |
| 41 | --------- |
