From e1f81d7f315c68171d34b397ba1c71c78a420050 Mon Sep 17 00:00:00 2001 From: Kambiz Aghaiepour Date: Wed, 15 Jun 2016 18:23:28 -0400 Subject: [PATCH] update README for docker svc installs Specifically when the graphite, carbon-cache and grafana services are installed on undercloud host, the user should know to use the docker playbooks. This is to avoid package version requirement issues. This is a change to the README.rst to make it more clear to the end user when to use which playbook. README can be viewed here: http://rst.ninjs.org/?n=56d6bb46eadab514752335f7e11e3881&theme=basic Change-Id: I929dd840b22a0342a5044aadb4e5141af936d1fa --- ansible/README.rst | 56 ++++++++++++++++++++++++++++++++-------------- 1 file changed, 39 insertions(+), 17 deletions(-) diff --git a/ansible/README.rst b/ansible/README.rst index d451074ed..77833eb82 100644 --- a/ansible/README.rst +++ b/ansible/README.rst @@ -40,7 +40,7 @@ hosts file for ansible and generate a "jumpbox" ssh config: # ./generate_tripleo_hostfile.sh ~/.ssh/config -\*Review the hosts file the script generates. +Review the hosts file the script generates. Ansible Installers ------------------ @@ -104,36 +104,57 @@ Install Generic ELK Clients ansible-playbook -i hosts install/elk-client.yml --extra-vars 'elk_server=X.X.X.X' - elk\_server variable will be generated after the ELK stack playbook - runs #### Install ELK Clients for OpenStack nodes + runs - :: +Install ELK Clients for OpenStack nodes +''''''''''''''''''''''''''''''''''''''' - ansible-playbook -i hosts install/elk-openstack-client.yml --extra-vars 'elk_server=X.X.X.X' +:: + + ansible-playbook -i hosts install/elk-openstack-client.yml --extra-vars 'elk_server=X.X.X.X' - elk\_server variable will be generated after the ELK stack playbook - runs ##### Install graphite service + runs - :: +Install graphite service +'''''''''''''''''''''''' - # ansible-playbook -i hosts install/graphite.yml +When installing graphite, carbon-cache and grafana on a +director/rdo-manager undecloud host, Use the docker playbook instead of +this one. This playbook is intended for use when you have enough +resources to allocate dedicated systems for the graphing/stats related +services. Prior to installing grafana, please review +install/group\_vars/all.yml file and your ansible inventory file You +will need to define values for the grafana\_host and graphite\_host IP +addresses here. + +:: + + # ansible-playbook -i hosts install/graphite.yml Install graphite service as a docker container '''''''''''''''''''''''''''''''''''''''''''''' - Prior to installing graphite as a docker container, please review - install/group\_vars/all.yml file and ensure the docker related - settings will work with your target host. +Prior to installing graphite as a docker container, please review +install/group\_vars/all.yml file and ensure the docker related settings +will work with your target host. This playbook is ideal when installing +services on director/rdo-manager undercloud host(s). + +:: - :: - - # ansible-playbook -i hosts install/graphite-docker.yml + # ansible-playbook -i hosts install/graphite-docker.yml Install grafana service ''''''''''''''''''''''' -Prior to installing grafana, please review install/group\_vars/all.yml -file and your ansible inventory file You will need to define values for -the grafana\_host and graphite\_host IP addresses here. +When installing graphite, carbon-cache and grafana on a +director/rdo-manager undecloud host, Use the docker playbook instead of +this one. This playbook is intended for use when you have enough +resources to allocate dedicated systems for the graphing/stats related +services. Prior to installing grafana, please review +install/group\_vars/all.yml file and your ansible inventory file You +will need to define values for the grafana\_host and graphite\_host IP +addresses here. :: @@ -144,7 +165,8 @@ Install grafana service as a docker container Prior to installing graphite as a docker container, please review install/group\_vars/all.yml file and ensure the docker related settings -will work with your target host. +will work with your target host. This playbook is ideal when installing +services on director/rdo-manager undercloud host(s). ::