diff --git a/docsite/rst/intro_installation.rst b/docsite/rst/intro_installation.rst index c6666392ab..61b2b8f357 100644 --- a/docsite/rst/intro_installation.rst +++ b/docsite/rst/intro_installation.rst @@ -47,12 +47,14 @@ Control Machine Requirements Currently Ansible can be run from any machine with Python 2.6 or 2.7 installed (Windows isn't supported for the control machine). +.. note:: + Ansible 2.2 introduces a tech preview of support for Python 3. For more information, see `Python 3 Support `_. + This includes Red Hat, Debian, CentOS, OS X, any of the BSDs, and so on. .. note:: - As of 2.0 ansible uses a few more file handles to manage its forks. OS X has a very low setting so if you want to use 15 or more forks - you'll need to raise the ulimit with ``sudo launchctl limit maxfiles unlimited``. This command can also fix any "Too many open files" error. + As of version 2.0, Ansible uses a few more file handles to manage its forks. Mac OS X by default is configured for a small amound of file handles, so if you want to use 15 or more forks you'll need to raise the ulimit with ``sudo launchctl limit maxfiles unlimited``. This command can also fix any "Too many open files" error. .. warning:: @@ -86,8 +88,9 @@ You also need Python 2.4 or later. If you are running less than Python 2.5 on th .. note:: - Python 3 is a slightly different language than Python 2 and some Python programs (including - Ansible) are not switching over yet. Ansible uses Python 2 in order to maintain compability with older distributions + Ansible 2.2 introduces a tech preview of support for Python 3. For more information, see `Python 3 Support `_. + + By default, Ansible uses Python 2 in order to maintain compability with older distributions such as RHEL 5 and RHEL 6. However, some Linux distributions (Gentoo, Arch) may not have a Python 2.X interpreter installed by default. On those systems, you should install one, and set the 'ansible_python_interpreter' variable in inventory (see :doc:`intro_inventory`) to point at your 2.X Python. Distributions @@ -95,6 +98,7 @@ You also need Python 2.4 or later. If you are running less than Python 2.5 on th by default and this does not apply to those distributions. This is also true of nearly all Unix systems. + If you need to bootstrap these remote systems by installing Python 2.X, using the 'raw' module will be able to do it remotely. For example, ``ansible myhost --sudo -m raw -a "yum install -y python2 python-simplejson"``