Files
browbeat/ansible/README.md
Alex Krzos f54470ee9d Break out collectd config files.
+ Trimmed down Ceph Process list
+ Added Graphite host type, consolidated all generic host types to single playbook collectd-generic (baremetal, guest, cfme, graphite, satellite6)

Change-Id: I2af61fc8dc507407dd7983e44cd3302713fd3ddd
2016-03-10 22:01:48 -05:00

121 lines
3.3 KiB
Markdown

Table of Contents
=================
- [Ansible for Browbeat](#)
- [To use](#)
- [Ansible Installers](#)
- [Performance Check](#)
- [Performance Tune](#)
- [Adjust your overcloud](#)
# Ansible for Browbeat
Currently we support Ansible 1.9.4 within browbeat-venv and ansible 2.0 for installation.
Playbooks for:
* Installing Browbeat, collectd, connmon, graphite, grafana, and grafana dashboards
* Check overcloud for performance issues
* Tune overcloud for performance (Experimental)
* Adjust number of workers for cinder/keystone/neutron/nova
* Deploy keystone in eventlet/httpd
* Adjust keystone token type to UUID/Fernet
* Adjust neutron l3 agents
* Adjust nova greenlet_pool_size / max_overflow
## To use
Install your public key into stack's authorized_keys
```
# ssh-copy-id stack@<undercloud-ip>
```
Then run gen_hosts.sh script to generate your overcloud's hosts file for ansible and generate a "jumpbox" ssh config:
```
# ./gen_hostfile.sh <undercloud-ip> ~/.ssh/config
```
*Review the hosts file the script generates.
## Ansible Installers
##### Install Browbeat
Image upload requires Ansible 2.0
```
# vi install/group_vars/all # Edit ansible vars file (Installation parameters)
# ansible-playbook -i hosts install/browbeat.yml
```
##### Install Collectd Agent (Requires a Graphite Server)
Prior to installing the agent, please review the install/group_vars/all to ensure the
correct parameters are passed
```
# ansible-playbook -i hosts install/collectd-openstack.yml
```
To install collectd on everything other than Openstack machines, view the [README for collectd-generic](README.collectd-generic.md).
##### Install Connmon
Requires Ansible 2.0
```
# ansible-playbook -i hosts install/connmon.yml
```
##### Install graphite service
```
# ansible-playbook -i hosts install/graphite.yml
```
##### Install grafana service
Default user is admin/admin and the graphite data source will need to be defined.
```
# ansible-playbook -i hosts install/grafana.yml
```
##### Install Grafana Dashboards (Requires a Grafana Server)
Review install/group_vars/all before deploying the grafana dashboards
```
# ansible-playbook -i hosts install/dashboards.yml
```
## Performance Check
Run the check playbook to identify common performance issues:
```
# ansible-playbook -i hosts check/site.yml
```
## Performance Tune
Run the tune playbook to tune your OSPd deployed cloud for performance:
```
# ansible-playbook -i hosts tune/tune.yml
```
## Adjust your overcloud
To modify the number of workers each service is running:
```
# ansible-playbook -i hosts browbeat/adjustment-workers.yml -e "workers=8"
```
Nova and Keystone will be running 8 workers per service.
To modify number of workers each service is running and ensure Keystone is deployed in eventlet:
```
# ansible-playbook -i hosts browbeat/adjustment-workers.yml -e "workers=8 keystone_deployment=eventlet"
```
To run Keystone in httpd, change keystone_deployment to httpd:
```
# ansible-playbook -i hosts browbeat/adjustment-workers.yml -e "workers=8 keystone_deployment=httpd"
```
To switch to fernet tokens:
```
# ansible-playbook -i hosts browbeat/keystone_token_type.yml -e "token_provider=fernet"
```
To switch to UUID tokens:
```
# ansible-playbook -i hosts browbeat/keystone_token_type.yml -e "token_provider=uuid"
```