diff --git a/README.md b/README.md
index 9baee07..77a4424 100644
--- a/README.md
+++ b/README.md
@@ -1,43 +1,66 @@
 # openstack-ansible-os_monasca-agent
 
-steps for install
+# Install
 
-add python-monascaclient to 'utility_pip_packages' in  /opt/openstack-ansible/playbooks/utility-install.yml
+### Client installation
+
+For Mitaka and below, add ```python-monascaclient``` to the ```utility_pip_packages``` variable in  ```/opt/openstack-ansible/playbooks/utility-install.yml``` to install the monasca client in the utility hosts, and re-run the playbook.
+
+### Add packages to repo container
+
+Make a file ```/etc/openstack_deploy/user_variables_monasca.yml``` with the following:
+```
+monasca_requires_pip_packages:
+  - monasca-agent
+  - gevent==1.1.1
+  - msgpack-python
+  - netaddr
+  - psutil==3.0.1
+```
+
+Then re-run the ```repo-build.yml``` playbook in the ```/opt/openstack-ansible/playbook```:
+
+```
+openstack-ansible repo-build.yml
+```
+
+### Run playbook
 
 
 
-add packages for repo-build
 
-make file called user_variables_monasca.yml with the following:
+# Notes
 
-  monasca_requires_pip_packages:
-    - monasca-agent
-    - gevent==1.1.1
-    - msgpack-python
-    - netaddr
-    - psutil==3.0.1
+### Skips repo & utility containers
 
+By default, this skips the repo and utility containers as they do not host openstack services. Set ```skip_repo_utility_hosts``` to ```false``` to install the agent on those hosts as well.
 
-By default, this skips the repo and utility containers as they do not host openstack services. Set skip_repo_utility_hosts to false to install on those hosts as well.
+### Generate host_alive checks
 
 To create host_alive checks for all hosts in the Openstack-Ansible inventory,
 populate host_alive_check_hosts with a list of hosts that should do the checking, ideally the monasca hosts.
-
-  host_alive_check_hosts:
-    - monasca-1
-    - monasca-2
-    - monasca-3
+```
+host_alive_check_hosts:
+  - monasca-1
+  - monasca-2
+  - monasca-3
+```
 
 To add extra hosts to the ssh host checks,
-cd
+```
+extra_host_alive_checks:
+  - { hostname: 'test1',ip:'1.1.1.1' }
+  - { hostname: 'test2',ip:'2.2.2.2' }
+```
 
-To regen the list of hosts after inventory changes, re-run the playbook with the tag regen_host_alive_checks:
-
-  openstack-ansible os-monasca-agent.yml -t regen_host_alive_checks
-
-
-TODO
+To regen the host_alive configuration after inventory changes, re-run the playbook with the tag ```regen_host_alive_checks```:
+```
+openstack-ansible os-monasca-agent.yml -t regen_host_alive_checks
+```
+# TODO
 
 Fix process I/O access issue.
 
+```
 2016-11-14 07:16:07 UTC | DEBUG | collector | monasca_agent.collector.checks.check.process(process.py:123) | monasca-agent user does not have access to I/O counters for process 4699: <bound method Process.name of <psutil.Process(pid=4699, name='supervisord') at 140220130336016>>
+```
diff --git a/defaults/main.yml b/defaults/main.yml
index 875b166..3db4d15 100644
--- a/defaults/main.yml
+++ b/defaults/main.yml
@@ -12,6 +12,7 @@ monasca_agent_project_name: monasca-agent
 monasca_agent_role_name: monasca-agent
 host_alive_check_hosts:
 extra_host_alive_checks:
-
+  - { hostname: 'test1',ip:'1.1.1.1' }
+  - { hostname: 'test2',ip:'2.2.2.2' }
 # implement
 skip_repo_utility_hosts: true