openstack-ansible/doc/source/developer-docs/ops-tips.rst
daz bdb856c8fe [docs] Migrate ops and appendix content
1. Migrate Ops chapter and tips and tricks appendix to developer docs
2. Migrate Appendix G to a chapter in the developer docs
3. Minor edits

Change-Id: I4070f02b75a8f9614545be0744e63ba76a3b49e2
Implements: blueprint osa-install-guide-overhaul
2016-06-17 10:13:27 +10:00

1.6 KiB

Tips and tricks

Ansible forks

The default MaxSessions setting for the OpenSSH Daemon is 10. Each Ansible fork makes use of a Session. By default, Ansible sets the number of forks to 5. However, you can increase the number of forks used in order to improve deployment performance in large environments.

Note that more than 10 forks will cause issues for any playbooks which use delegate_to or local_action in the tasks. It is recommended that the number of forks are not raised when executing against the Control Plane, as this is where delegation is most often used.

The number of forks used may be changed on a permanent basis by including the appropriate change to the ANSIBLE_FORKS in your .bashrc file. Alternatively it can be changed for a particular playbook execution by using the --forks CLI parameter. For example, the following executes the nova playbook against the control plane with 10 forks, then against the compute nodes with 50 forks.

# openstack-ansible --forks 10 os-nova-install.yml --limit compute_containers
# openstack-ansible --forks 50 os-nova-install.yml --limit compute_hosts

For more information about forks, please see the following references: