Installing Ansible, Git and Co.

The SDM framework based on configuration management system Ansible and the version control system Git. Another dependency is the python package netaddr. This page descripes how to install these tools.

Installing Ansible

Ansible have to installed on the control node which based on an UNIX/Linux operating system. It is not possible to install Ansible on Microsoft Windows. For detailed instructions on installing Ansible on various UNIX/Linux systems, see the Ansible documentation.

Installing Git

Git is one of the most widely used version control systems and is usally shipped as a core compentent of the most UNIX/Linux distributions. This makes it possible to install Git with distribution-specific package management tools. Here are some examples:

Arch Linux

$ sudo pacman -S git

Debian / Ubuntu

$ sudo apt install git

FreeBSD

$ sudo pkg install git

RHEL / CentOS / Fedora

$ sudo dnf install git

On CentOS and RHEL (Version < 8):

$ sudo yum install git

SLES / openSUSE

$ sudo zypper install git

Installing netaddr

The Python package netaddr is needed for IP address calculations. It can be installed with the package installer of Python (pip) in this way:

$ pip install --user netaddr

But the package is also often shipped as a component of the most UNIX/Linux distributions and is installable with the distribution-specific package management tools. Here are some examples:

Arch Linux

For Python 2:

$ sudo pacman -S python2-netaddr

For Python 3:

$ sudo pacman -S python-netaddr

Debian / Ubuntu

For Python 2:

$ sudo apt install python-netaddr

For Python 3:

$ sudo apt install python3-netaddr

FreeBSD

For Python 3:

$ sudo pkg intall py37-netaddr

RHEL / CentOS / Fedora

For Python 2 (Fedora only):

$ sudo dnf install python2-netaddr

For Python 3:

$ sudo dnf install python3-netaddr

On CentOS and RHEL (Version < 8):

For Python 2:

$ sudo yum install python-netaddr

SLES / openSUSE

$ sudo zypper install python-netaddr

Hint: It is recommended to use only Python 3, because Python 2 is marked as obsolete and will no longer receive support from April 2020.

Installation of dependencies for the management of Microsoft Windows nodes

If you like to manage Microsoft Windows nodes via WinRM you also need the Python module pywinrm. It can be installed in the same way as netaddr (see above):

$ pip install --user pywinrm

Some UNIX/Linux distributions also shipped it. Here are some examples:

Arch Linux

$ sudo pacman -S python-pywinrm

Debian / Ubuntu

$ apt install python3-winrm

Hint: On Ubuntu the package is included in the universe sub-repository.

FreeBSD

$ sudo pkg intall py37-pywinrm

RHEL / CentOS / Fedora

$ sudo dnf install python3-winrm

On CentOS and RHEL (Version < 8):

$ sudo yum install python2-winrm

SLES / openSUSE

$ sudo zypper install python3-winrm

For more information about managing Microsoft Windows nodes with Ansible, see the Ansible Documentation / Windows Guide.