Modified: for 9.2.2

Enable Ansible Playbook

The SBC registration with the EMS for ISO-based Installation is automated through the Ansible playbook. Ansible playbooks are frameworks that automate tasks with limited or no human involvement. One or more Ansible tasks are combined to make a play. Two or more plays are combined to create an Ansible playbook.

The Ansible playbook feature automates the following processes:

  • User-provided input parameters are saved on the SBC. This enables the reuse of input parameters.
  • Once the hook is inserted into the SBC, the EMS registration/instance-up notification occurs automatically on every boot-up.

This feature enables the Ansible playbook triggers from outside (centos/ubuntu/RHEL) where the Ansible is installed and auto-register the SBC to the EMS. This is for the special case where the EMS info injection through the configuration drive is not possible. For example, the ISO case.

Note

The Ansible playbook to automate the SBC Registration with the EMS is supported only on the SWe platforms such as KVM/VMware.

Prerequisites

  1. A Linux server with Ansible 2.8.7 installed.
  2. SSH access for 'linuxadmin' user to management IP of each SBC node.
  3. The EMS Registration Interface MOP tarball.

Procedure

Perform the following procedures to ensure the SBC auto-registers to the EMS after every reboot during an ISO-based installation:

  1. Log on to the EMS.
  2. Navigate to Network → Cluster Management → Manage VNFs.
  3. Create a cluster for each set of the SBC nodes.

  4. Ensure every cluster contains a unique cluster-ID. 

    Note

    Use Generate ID option or use the cluster name to generate the cluster-ID.

    Cluster creation

  5. Log on to the Linux server where Ansible is installed.

  6. Download the EMS registration interface MOP package and extract it. 

    ems-registration-interface

  7. Change the directory to 'ems-registration-interface' directory: 

    cd ems-registration-interface

  8. Configure the ansible connection to the SBC in ansible.cfg.

  9. Enter the cluster-ID and the access details to the EMS in inventory.

  10. Run the playbook:

    ansible-playbook registerToEMS.yml

  11. Check the status on the EMS Console to make sure the SBC is registered and online.

    Node information in the EMS portal after the SBC registration.