diff --git a/docs/docsite/rst/installation_guide/intro_installation.rst b/docs/docsite/rst/installation_guide/intro_installation.rst index ca685ab4da..8f59238d63 100644 --- a/docs/docsite/rst/installation_guide/intro_installation.rst +++ b/docs/docsite/rst/installation_guide/intro_installation.rst @@ -159,7 +159,7 @@ Debian/Ubuntu packages can also be built from the source checkout, run: $ make deb -You may also wish to run from source to get the latest, which is covered above. +You may also wish to run from source to get the latest, which is covered below. Latest Releases Via Apt (Debian) ++++++++++++++++++++++++++++++++ @@ -395,6 +395,8 @@ bugs and feature ideas. Examples of basic commands :ref:`working_with_playbooks` Learning ansible's configuration management language + :ref:`installation_faqs` + Ansible Installation related to FAQs `Mailing List `_ Questions? Help? Ideas? Stop by the list on Google Groups `irc.freenode.net `_ diff --git a/docs/docsite/rst/reference_appendices/faq.rst b/docs/docsite/rst/reference_appendices/faq.rst index 6e5bb1b817..a7a674b4c1 100644 --- a/docs/docsite/rst/reference_appendices/faq.rst +++ b/docs/docsite/rst/reference_appendices/faq.rst @@ -131,6 +131,19 @@ requires Python 2, you can also report a bug on our `bug tracker Do not replace the shebang lines of your python modules. Ansible will do this for you automatically at deploy time. +.. _installation_faqs: + +How do I handle the package dependencies required by Ansible package dependencies during Ansible installation ? ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +While installing Ansible, sometimes you may encounter errors such as `No package 'libffi' found` or `fatal error: Python.h: No such file or directory` +These errors are generally caused by the missing packages which are dependencies of the packages required by Ansible. +For example, `libffi` package is dependency of `pynacl` and `paramiko` (Ansible -> paramiko -> pynacl -> libffi). + +In order to solve these kinds of dependency issue, you may need to install required packages using the OS native package managers (e.g., `yum`, `dnf` or `apt`) or as mentioned in the package installation guide. + +Please refer the documentation of the respective package for such dependencies and their installation methods. + Common Platform Issues ++++++++++++++++++++++