Updated ansible README.

Change-Id: I3a80d9e7ab297fb90de8e3d15ea741c8e56e0617

1 files changed, 28 insertions, 5 deletions

diff --git a/ansible/README b/ansible/README
index ccb0130..5583b4c 100644
--- a/ansible/README
+++ b/ansible/README
@@ -1,10 +1,33 @@
-To run the configuration, it is necessary to fill in the secrets.yml file
-with the correct user names and passwords for the service used.
+Important Notice
+----------------
+
+To run the configuration, it is necessary to:
+ - Rename the file secrets.yml.local in secrets.yml
+ - Update it with with the correct credentials
 
 The secrets.yml file contains variables for:
  - Crowd user name and password
  - Jira user name and password
+ - A list of paths to local files necessary for Apache SSL configuration
+
+ Not providing those values will result in the playbook not being applied or
+ in the application not being installed correctly.
+
+ Note: if the playbook is executed without those variables, the values on the
+ server will be lost!! Do not run the playbook if you do not have those values.
+
+ Executing the Ansible Playbook
+ ------------------------------
+ 
+ This is a "special" setup: we have two domains, hosted on the same machine.
+ Since the ansible steps are executed for each domain, we cannot execute them
+ all at the same time.
+
+ It is necessary to first run it for one domain, and then for the other. There
+ can be errors on the package installation, since it needs exclusive lock.
+
+ To execute the playbook, from the ansible folder:
+
+ ansible-playbook -i hosts site.yml -l status.linaro.org
 
- Those values are necessary for the local_settings.py file to run the
- application.
- 
\ No newline at end of file
+ and then for the other domain, roadmap.linaro.org.