Add install section.

1 files changed, 36 insertions, 9 deletions

diff --git a/README b/README
index 3d2e535..958c1f5 100644
--- a/README
+++ b/README
@@ -32,16 +32,43 @@ also intended to be installed in the cloud. It may be possible to install
 it on a standlone host, but set up scripts described below assume full control
 of the host, and may alter configuration of other software and services.
 
+Please make sure that you have working (command-line) EC2 environment and can
+run ec2-* commands (for example, ec2-describe-instances). See
+https://help.ubuntu.com/community/EC2StartersGuide for this initial setup.
+
+Quick install:
+
+bzr clone lp:linaro-android-build-tools
+cd linaro-android-build-tools/control
+./sandbox-create <name of your existing EC2 keypair>
+
+This will create complete Cloud Buildd setup, you just need to fill in EC2
+credentials which will be used to create build slave instances.
+
+Open URL as output when 'sandbox-create' script finished in the browser,
+append "/jenkins". Login as username: admin, password: admin. Go to
+"Manage Jenkins" -> "Configure System". Search for "Access Key ID",
+"Secret Access Key" and fill in EC2 credentials. Now you need to create
+keypair which Jenkins will use to create slave instances, this supposed to
+be automated by clicking on "Generate Key", but does not work in latest
+Jenkins versions, so instead run:
+
+ec2-add-keypair jenkins@cloud-buildd >jenkins@cloud-buildd.rsa
+
+Paste contents of jenkins@cloud-buildd.rsa into "EC2 RSA Private Key". Click
+"Test Connection" and ensure you get "SUCCESS".
+
+In addittion to fully automated sandbox-create script which takes care of
+instance creation for master node, there're following scripts with narrower
+scope:
+
+    control/setup-control-node-via-ssh <hostname>
+      * This will set up existing instance/physical host as Cloud Buildd master
+      node
     control/setup-control-node
-      * Sets up Cloud Buildd control node on a blank, freshly installed
-      host/instance. The host must run Ubuntu Server 10.10 and 11.04. Set up
-      procedure includes install and configuring Jenkins, Apache, and other
-      components and services used by Cloud Buildd.
-    control/setup-control-node-via-ssh
-      * Runs setup-control-node script above over SSH.
-    control/sandbox-create
-      * Creates EC2 instance and installs control node on it, all in one
-      step.
+      * This will set up Cloud Buildd control node on the current host, which
+      should be a blank, freshly installed host/instance running Ubuntu Server
+      10.10 or 11.04.
 
 Documentation
 -------------