Skip to main content


Installing Unravel on a single cluster deployment using Ansible

  1. Ensure that Ansible is not running on the Unravel node, and then set hosts in the inventories directory.


    cd inventories
    ls -alR


    total 16
    drwxr-xr-x 4 user1 domain users 4096 Apr 23 10:31 .
    drwxr-xr-x 5 user1 domain users 4096 Jun 15 19:33 ..
    drwxr-xr-x 2 user1 domain users 4096 Apr 23 10:32 core_node
    drwxr-xr-x 2 user1 domain users 4096 Jun 15 19:33 edge_nodes
    total 12
    drwxr-xr-x 2 user1 domain users 4096 Apr 23 10:32 .
    drwxr-xr-x 4 user1 domain users 4096 Apr 23 10:31 ..
    -rw-r--r-- 1 user1 domain users   46 Apr 13 18:39 hosts
  2. Navigate to ansible-installation/inventories/<node> directory and open the hosts file.

  3. Append the hostname and ssh information as a new line.

    Example hosts file:

    [core_node] ansible_user=root ansible_ssh_private_key_file=/home/root/.ssh/id_rsa


    • hosts in edge_nodes must remain empty.

    • hosts in core_nodes must have become_user undefined.

    For additional parameters, see Ansible documentation.

  4. Navigate to the ansible-installation directory and create a copy of the vars_template.yml file.

    cp vars_template.yml vars.yml
  5. Edit vars.yml by using any editor. For example, the vi editor.

    vi vars.yml

    The vars.yml file contains deployment parameters. You can customize these parameters for installing and deploying Unravel on a single cluster.

  6. For the root user, set the prerequisites using the pre-reqs.yml file.

    ansible-playbook -i inventories/ pre-reqs.yml -e @vars.yml -vvv

    Before Unravel is installed by the Ansible playbook, you must ensure that certain preconditions are met. For example, creating a Unravel directory, user, and a group and installing specific libraries. Use the pre-reqs.yml playbook command to fulfill these preconditions.

  7. From the Unravel server, run the Ansible playbook.

    ansible-playbook -i inventories/ install_unravel.yml -e @vars.yml -vvv

    Applies all values specified in the vars.yml to the Ansible playbook. See Verify Unravel installation using Ansible.


    If an error occurs, modify the vars.yml file depending on the error, and rerun the Ansible playbook with the specific tag for which an error has occurred. To see the list of available tags, run the following command:

    ansible-playbook -i inventories/ install_unravel.yml -vvv -e @vars.yml --list-tags