| The @PLUGIN@ plugin allows to synchronize eviction of caches, secondary indexes, |
| stream events and websessions between two Gerrit instances sharing the same git |
| repositories and database. The plugin needs to be installed in both instances. |
| |
| Every time a cache eviction occurs in one of the instances, the other instance's |
| cache is updated. This way, both caches are kept synchronized. |
| |
| Every time the secondary index is modified in one of the instances, i.e., a |
| change is added, updated or removed from the index, the other instance index is |
| updated accordingly. This way, both indexes are kept synchronized. |
| |
| Every time a stream event occurs in one of the instances (see [more events info] |
| (https://gerrit-review.googlesource.com/Documentation/cmd-stream-events.html#events)), |
| the event is forwarded to the other instance which re-plays it. This way, the |
| output of the stream-events command is the same, no matter what instance a |
| client is connected to. |
| |
| The built-in Gerrit H2 based websession cache is replaced with a file based |
| implementation that is shared amongst both instance. |
| |
| For this to work, http must be enabled in both instances, the plugin must be |
| configured with valid credentials and a shared directory must be accesssible |
| from both instances. For further information, refer to [config](config.md) |
| documentation. |
