1. Prepare controller host

When deploying MiaRec in "all-in-one" configuration on a single server, you can use the same host for both Controller and Target roles. In this case, the Ansible playbook will deploy MiaRec locally.

When deploying MiaRec on multiple servers, it is necessary to use a dedicated host for the Controller role.

Supported operating systems for the Controller host

MiaRec team officially supports the following operating system for the controller host:

  • Centos 7 64-bit
  • Centos 6 64-bit
  • Ubuntu Server 14.04 (Xenial Xerus) LTS 64-bit
  • Ubuntu Server 16.04 (Trusty Tahr) LTS 64-bit
  • Windows 10 with Bash on Ubuntu *

(*) - The Windows 10 machine could be used solely for the Controller role. If you need to install MiaRec software on Windows operating system, then check the guide Installation on Windows.

It is possible to run Ansible playbook from Mac OSX and other operating systems. The complete list of the supported OSs is available in the official Ansible documentation. The MiaRec team provides technical support for the above mentioned OSs only.

Install Ansible on Ubuntu

Install additional software packages and configure Network Time Protocol (NTP). Before you begin, we recommend upgrading your system packages and kernel.

Update package source lists:

sudo apt-get update

Upgrade the system packages and kernel:

sudo apt-get dist-upgrade

Reboot the host.

Install additional software packages if they were not installed during the operating system installation:

sudo apt-get install aptitude build-essential git ntp ntpdate openssh-server libssl-dev 

Install PIP (a tool for installing Python packages. Ansible is written in Python):

sudo apt-get install python-dev python-pip

Install Ansible using PIP:

sudo pip install ansible

Verify Ansible version:

ansible --version

The output should be something like:

$ ansible --version
ansible 2.3.1.0
  config file = 
  configured module search path = Default w/o overrides
  python version = 2.7.12 (default, Nov 19 2016, 06:48:10) [GCC 5.4.0 20160609]

Verify that ansible version is 2.2+ or higher and python version is either 2.7 or 2.6. If the python version shows 3.x then the installation of Ansible is not correct. Contact the MiaRec representative for support.

Install Ansible on Centos 7

Install additional software packages and configure Network Time Protocol (NTP). Before you begin, we recommend upgrading your system packages and kernel.

Upgrade the system packages and kernel

sudo yum upgrade

Reboot the host.

Install the Software Collections (SCL) repository. It is required for the latest version of Postgresql (11/12).

On Centos 7:

sudo yum install centos-release-scl

On RedHat Enterprise:

sudo yum-config-manager --enable rhel-server-rhscl-7-rpms

Install additional software packages if they were not installed during the operating system installation:

sudo yum install git ntp ntpdate openssh-server openssl-devel python-devel libffi-devel

Download PIP installer script and run it (PIP is a tool for installing Python packages. Ansible is written in Python):

curl "https://bootstrap.pypa.io/get-pip.py" -o "get-pip.py"
sudo python get-pip.py

Install Ansible using PIP:

sudo pip install ansible

Verify Ansible version:

ansible --version

The output should be something like:

$ ansible --version
ansible 2.3.1.0
  config file = 
  configured module search path = Default w/o overrides
  python version = 2.7.12 (default, Nov 19 2016, 06:48:10) [GCC 5.4.0 20160609]

Verify that ansible version is 2.2+ or higher and python version is either 2.7 or 2.6. If the python version shows 3.x then the installation of Ansible is not correct. Contact the MiaRec representative for support.

Install the MiaRec ansible scripts

Clone the latest stable release of the MiaRec-Ansible Git repository in the /opt/ansible-miarec directory:

git clone --recursive https://github.com/miarec/ansible-miarec /opt/ansible-miarec