Document need for Access Database capability
In order for pull-replication to replicate `All-Users` refs, the `Access
Database` capability needs to be enabled for the user performing
replication.
The lack of such capability would prevent All-Users' meta refs from
being replicated.
Document this requirement to make Gerrit admins able to configure
pull-replication correctly.
Bug: Issue 16594
Change-Id: Id5c8ed4cf35b21e725c52d8dee397f12ab3afad1
diff --git a/src/main/resources/Documentation/config.md b/src/main/resources/Documentation/config.md
index 51b10d8..eb15c02 100644
--- a/src/main/resources/Documentation/config.md
+++ b/src/main/resources/Documentation/config.md
@@ -558,6 +558,14 @@
remote.NAME.password
: Password to use for HTTP authentication on this remote.
+In both cases, the Global Capability `Access Database` [1] needs to be allowed
+in order to permit all `All-Users`' refs to be replicated. When _basic auth_ is
+used, the capability must be assigned to the `remote.NAME.username` used in
+configuration, whilst for _bearer token_, it needs to be assigned to
+the `Pull-replication Internal User` user.
+
+[1] https://gerrit-review.googlesource.com/Documentation/access-control.html#capability_accessDatabase
+
File `~/.ssh/config`
--------------------
