From 34dca8541756313d9859f98694d61b6c813e2a29 Mon Sep 17 00:00:00 2001 From: Sam Doran Date: Thu, 5 Apr 2018 13:46:46 -0400 Subject: [PATCH] Update installation docs for RHEL based distributions. (#38056) Upstream rpms are no longer in Extras but EPEL as well as releases.ansible.com. Add instructions for adding Ansible Engine repo to RHEL. --- docs/docsite/Makefile | 2 +- docs/docsite/rst/conf.py | 2 +- .../installation_guide/intro_installation.rst | 22 ++++++++----------- 3 files changed, 11 insertions(+), 15 deletions(-) diff --git a/docs/docsite/Makefile b/docs/docsite/Makefile index 897c48dfdf..1e6495c424 100644 --- a/docs/docsite/Makefile +++ b/docs/docsite/Makefile @@ -112,4 +112,4 @@ epub: htmlsingle: assertrst sphinx-build -j $(CPUS) -b html -d $(BUILDDIR)/doctrees ./rst $(BUILDDIR)/html rst/$(rst) - @echo "Output is in $(BUILDDIR)/$(rst:.rst=.html)" + @echo "Output is in $(BUILDDIR)/html/$(rst:.rst=.html)" diff --git a/docs/docsite/rst/conf.py b/docs/docsite/rst/conf.py index 7cc6d4dd06..2e93e7d7bc 100644 --- a/docs/docsite/rst/conf.py +++ b/docs/docsite/rst/conf.py @@ -28,7 +28,7 @@ import os sys.path.insert(0, os.path.join('ansible', 'lib')) sys.path.append(os.path.abspath('_themes')) -VERSION = '2.4' +VERSION = '2.6' AUTHOR = 'Ansible, Inc' diff --git a/docs/docsite/rst/installation_guide/intro_installation.rst b/docs/docsite/rst/installation_guide/intro_installation.rst index 0c6959db68..3bbb93f98a 100644 --- a/docs/docsite/rst/installation_guide/intro_installation.rst +++ b/docs/docsite/rst/installation_guide/intro_installation.rst @@ -88,7 +88,7 @@ default this uses sftp. If that's not available, you can switch to scp in By default, Ansible uses Python 2 in order to maintain compatibility with older distributions such as 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 :ref:`inventory`) to point at your 2.X Python. Distributions + the ``ansible_python_interpreter`` variable in inventory (see :ref:`inventory`) to point at your 2.X Python. Distributions like Red Hat Enterprise Linux, CentOS, Fedora, and Ubuntu all have a 2.X interpreter installed by default and this does not apply to those distributions. This is also true of nearly all Unix systems. @@ -120,23 +120,19 @@ On RHEL and CentOS: $ sudo yum install ansible -.. note:: We've changed how the Ansible community packages are distributed. - For users of RHEL/CentOS/Scientific Linux version 7, the Ansible community RPM - package will transition from the EPEL repository to the Extras channel. There will be no - change for version 6 of RHEL/CentOS/Scientific Linux since Extras is not a part of version 6. +RPMs for RHEL 7 are available from the `Ansible Engine repository `_. -RPMs for RHEL7 are available from `the Extras channel `_. +To enable the Ansible Engine repository, run the following command: -RPMs for RHEL6 are available from yum for `EPEL -`_ 6 and currently supported -Fedora distributions. +.. code-block:: bash -Ansible will also have RPMs/YUM-repo available `here `_. + $ sudo subsription-manager repos --enable rhel-7-server-ansible-2.6-rpms -Ansible version 2.4 can manage earlier operating -systems that contain Python 2.6 or higher. +RPMs for currently supported versions of RHEL, CentOS, and Fedora are available from `EPEL `_ as well as `releases.ansible.com `_. -You can also build an RPM yourself. From the root of a checkout or tarball, use the ``make rpm`` command to build an RPM you can distribute and install. +Ansible version 2.4 and later can manage earlier operating systems that contain Python 2.6 or higher. + +You can also build an RPM yourself. From the root of a checkout or tarball, use the ``make rpm`` command to build an RPM you can distribute and install. .. code-block:: bash