| Global-refdb utility | |
| ============================== | |
| COMMANDS | |
| ---- | |
| `globalrefdb check` utility compare the repository refs status against | |
| the global-refdb. | |
| `globalrefdb update-ref` utility to manually update global-refdb entry | |
| in the eventuality that global-refdb is out of sync with all other nodes. | |
| SYNOPSIS | |
| -------- | |
| > ssh -p <port> <host> globalrefdb check PROJECT [--ref <ref name>] [--verbose] | |
| > ssh -p <port> <host> globalrefdb update-ref PROJECT REF-NAME NEW-VALUE | |
| > ssh -p <port> <host> globalrefdb show-ref PROJECT [--ref <ref name>]* | |
| DESCRIPTION | |
| ----------- | |
| ## Check | |
| Verify if the local with the global refs for a project, reporting all differences | |
| between the two SHA1s. The operation can operate on the individual ref passed as | |
| a parameter. | |
| ## Update-ref | |
| Update global-refdb in case we cannot automatically deduce which ref is | |
| the latest. | |
| This can happen if the global-refdb finds itself behind other nodes. | |
| ## Show-ref | |
| Shows the global-refdb ref value, when present. | |
| ACCESS | |
| ------ | |
| Any user who has been granted the 'Administrate Server' capability. | |
| SCRIPTING | |
| --------- | |
| This command is intended to be used in scripts. | |
| EXAMPLES | |
| -------- | |
| Check if all refs of the All-Users project are up-to-date with the global-refdb: | |
| > $ ssh -p 29418 review.example.com globalrefdb check All-Users | |
| Update global-refdb's sha1 | |
| > $ ssh -p 29418 review.example.com globalrefdb update-ref All-Users refs/draft-comments/nn/nnnn/nn <sha1> |