Fix the missing DB entry in Gerrit DB

Due to an unknown reason (still under investigation), a few of the new
LDAP users were not able to login after first time because the Gerrit DB
was missing one of the two entries needed to authenticate the user (the
second entry is only needed for the users with non-null usernames).
The entry with external Id - "gerrit:abc" was never inserted to DB
in such cases whereas the entry with external id - "username:abc" was
created resulting in an account creation for the user.

This causes inconsistency in the DB. An account gets created in first login
attempt and second attempt fails to create missing external id because the
"username:abc" entry already exists causing the DB action to rollback.

As this bug is very infrequent and hard to replicate, this change
provides an after-fix for the issue i.e. fixes the problem when an entry
is missing in Gerrit DB. It checks if there exists an account already
for the given username and links the newly created external ID to that
account. It prevents the need to manually enter the missing entries in
DB to solve the issue.

Bug: Issue 7652
Change-Id: Icd2fbf77971f00783277f88fa085ea1bc761878f
1 file changed
tree: a63fe1b0ce749ab763bb0b6229328cf92e9bf742
  1. .bazelproject
  2. .editorconfig
  3. .git-blame-ignore-revs
  4. .gitignore
  5. .gitmodules
  6. .mailmap
  7. .pydevproject
  8. .settings/
  9. BUILD
  11. Documentation/
  13. README.md
  14. ReleaseNotes/
  17. contrib/
  18. gerrit-acceptance-framework/
  19. gerrit-acceptance-tests/
  20. gerrit-antlr/
  21. gerrit-cache-h2/
  22. gerrit-common/
  23. gerrit-elasticsearch/
  24. gerrit-extension-api/
  25. gerrit-gpg/
  26. gerrit-gwtdebug/
  27. gerrit-gwtexpui/
  28. gerrit-gwtui-common/
  29. gerrit-gwtui/
  30. gerrit-httpd/
  31. gerrit-launcher/
  32. gerrit-lucene/
  33. gerrit-main/
  34. gerrit-oauth/
  35. gerrit-openid/
  36. gerrit-patch-commonsnet/
  37. gerrit-patch-jgit/
  38. gerrit-pgm/
  39. gerrit-plugin-api/
  40. gerrit-plugin-gwtui/
  41. gerrit-prettify/
  42. gerrit-reviewdb/
  43. gerrit-server/
  44. gerrit-sshd/
  45. gerrit-test-util/
  46. gerrit-util-cli/
  47. gerrit-util-http/
  48. gerrit-util-ssl/
  49. gerrit-war/
  50. lib/
  51. plugins/
  52. polygerrit-ui/
  53. tools/
  54. version.bzl
  55. website/

Gerrit Code Review

Gerrit is a code review and project management tool for Git based projects.

Build Status


Gerrit makes reviews easier by showing changes in a side-by-side display, and allowing inline comments to be added by any reviewer.

Gerrit simplifies Git based project maintainership by permitting any authorized user to submit changes to the master Git repository, rather than requiring all approved changes to be merged in by hand by the project maintainer.


For information about how to install and use Gerrit, refer to the documentation.


Our canonical Git repository is located on googlesource.com. There is a mirror of the repository on Github.

Reporting bugs

Please report bugs on the issue tracker.


Gerrit is the work of hundreds of contributors. We appreciate your help!

Please read the contribution guidelines.

Note that we do not accept Pull Requests via the Github mirror.

Getting in contact

The IRC channel on freenode is #gerrit. An archive is available at: echelog.com.

The Developer Mailing list is repo-discuss on Google Groups.


Gerrit is provided under the Apache License 2.0.


Install Bazel and run the following:

    git clone --recursive https://gerrit.googlesource.com/gerrit
    cd gerrit && bazel build release

Install binary packages (Deb/Rpm)

The instruction how to configure GerritForge/BinTray repositories is here

On Debian/Ubuntu run:

    apt-get update & apt-get install gerrit=<version>-<release>

NOTE: release is a counter that starts with 1 and indicates the number of packages that have been released with the same version of the software.

On CentOS/RedHat run:

    yum clean all && yum install gerrit-<version>[-<release>]

On Fedora run:

    dnf clean all && dnf install gerrit-<version>[-<release>]

Use pre-built Gerrit images on Docker

Docker images of Gerrit are available on DockerHub

To run a CentOS 7 based Gerrit image:

    docker run -p 8080:8080 gerritforge/gerrit-centos7[:version]

To run a Ubuntu 15.04 based Gerrit image:

    docker run -p 8080:8080 gerritforge/gerrit-ubuntu15.04[:version]

NOTE: release is optional. Last released package of the version is installed if the release number is omitted.