Skip to main content


Installing Unravel on multi-cluster deployment using Ansible

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

    cp vars_template.yml vars.yml
  2. 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 multi-cluster.

  3. 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 group, and installing specific libraries. Use the pre-reqs.yml playbook command to fulfill these preconditions.

  4. Add the edge nodes in inventories.

    vi inventories/edge_nodes/hosts
  5. Navigate to ansible-installation/inventories/<node> directory and open the hosts file.

  6. Append the edge node hostname and ssh information as a new line.

    Example hosts file:

    [edge_nodes] ansible_user=root ansible_ssh_private_key_file=/root/.ssh/id_rsa
  7. For each edge node, specify the Cloudera Manager server TLS certificate:

    tls_certificate: "/opt/certs/unravel_wildcard.pem"
  8. 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 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