From 3dbcb15c6f6b25d7bfbcdd4ae2074c23ca9c7204 Mon Sep 17 00:00:00 2001
From: Monty Taylor <mordred@inaugust.com>
Date: Fri, 22 Jul 2011 12:17:55 -0400
Subject: [PATCH] Added launchpad sync docs, and linked in tarmac.

Change-Id: Ib1af24af2b347babe4a5555008c9b5a192763d85
---
 doc/gerrit.rst | 36 ++++++++++++++++++++++++++++++++++++
 doc/index.rst  |  1 +
 2 files changed, 37 insertions(+)

diff --git a/doc/gerrit.rst b/doc/gerrit.rst
index 66a70b51..431ffa13 100644
--- a/doc/gerrit.rst
+++ b/doc/gerrit.rst
@@ -364,3 +364,39 @@ Set permissions as follows::
     label code review -2/+2: foo-core
     submit: foo-core
 
+Launchpad Sync
+**************
+
+The launchpad user sync process consists of two scripts which are in
+openstack/openstack-ci on github: sync_launchpad_users.py and
+insert_gerrit.py.
+
+Both scripts should be run as gerrit2 on review.openstack.org
+
+sync_launchpad_users.py runs and creates a python pickle file, users.pickle,
+with all of the user and group information. This is a long process. (12
+minutes)
+
+insert_gerrit.py reads the pickle file and applies it to the MySQL database.
+The gerrit caches must then be flushed.
+
+Depends
+-------
+::
+
+  apt-get install python-mysqldb python-openid python-launchpadlib
+
+Keys
+----
+
+The key for the launchpad sync user is in ~/.ssh/launchpad_rsa.
+
+Running
+-------
+::
+
+  cd openstack-ci
+  git pull
+  python sync_launchpad_users.py
+  python insert_gerrit.py
+  ssh -i /home/gerrit2/.ssh/launchpadsync_rsa -p29418 review.openstack.org gerrit flush-caches
diff --git a/doc/index.rst b/doc/index.rst
index b22a0240..dd4191ea 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -24,6 +24,7 @@ Contents:
 
    jenkins
    gerrit
+   tarmac
 
 Indices and tables
 ==================