The Banner Management artifact demonstrates the ability to agnostically manage different types of banners across multiple device types via Itential Automation Platform (IAP).
This artifact allows users to execute the automation against their network devices that are managed by Ansible. Currently, the supported device OS types are Cisco-IOS, Cisco-IOSXR & Cisco-NX.
This artifact utilizes an Itential provided Ansible Role "itential_set_banner" which allows device level abstraction when configuring banners on selected device types.
In order to take full advantage of the Banner Management pre-built automation, users will need to satisfy the following requirements:
- Verify Itential Ansible Manager is successfully installed and functional.
- Connectivity has been established between Itential Automation Platform and Ansible Manager Instance
- Devices are onboarded within Ansible Manager and device connectivity has been established.
- Itential provided Ansible Role: itential_get_facts + itential_set_banner has been onboarded into Ansible Manager and decorated with appropriate metadata. (How to onboard ansible roles & decorate them)
How to Onboard & Decorate an Ansible Role within Itential Ansible Manager
**Perform the procedure below for both "itential_get_facts" & "itential_set_banner" roles.
- Download and transfer the Itential provided Ansible Role: itential_set_banner to the VM where Itential Ansible Manager is installed.
- Un-tar or Unzip the itential_set_banner tar file and move it to /usr/share/ansible/roles
- Log into the Ansible Manager GUI and browse to the API Documentation Page and execute the /roles/refresh API located under the Roles section (As shown in the figure below)
- Browse to the Roles section on the left side panel and verify the newly onboarded role can be seen.
- Click on the itential_set_banner role and click the Edit button on the window in order to decorate the role with the appropriate metadata.
- Copy the content available within the following file: /usr/share/ansible/roles/itential_set_banner/metadata/decoration.json and paste it in the text section (As shown in the figure below) and click the SAVE button.
- At this point, you have successfully onboarded and decorated the itential_set_banner role.
- Log into the Itential Automation Platform and browse Adapter status page: Settings ---> Systems ---> Adapters (Tab) and restart the ansible manager adapter (As shown in the figure below)
- Once the Ansible Manager adapter restarts successfully, the system would have auto-generated a network intelligent task that represents the newly onboarded Ansible role.
How to install
In order to onboard the Banner Management automation, please use the latest version of Itential application: app-prebuilt_automations available within Itential's Software Repository. Please click -> Download App-prebuilt_automations and use your Nexus credentials in order to view the file for download.
How to run
- Browse to the Automation Catalog application and create a new Automation Catalog item called Banner Management (As shown in the figure below).
- Choose the "EDIT" option on the newly create Banner Management entry and set the following options (As shown in the image below):
i. Group(s): Itential Artifact ii. Workflow: IAP_Set-Banner-v1
- Click the "Run Manually" button in order to kick off the Banner Management automation (As shown in the figure above)
- Once the automation has been successfully kicked off, browse to the Active Jobs application and review the kicked off automation job.
- After the system finishes execution of the automated tasks, it will stop on the 1st manual task in order to obtain under input from the end-user. Please fill out the banner details as requested in the form (As shown in the figure below)
- Once all the information has been submitted via the form, the system will continue executing the rest of the automated tasks and present a manual task in order to provide a Pre-Check/Post-Check Diff of the configuration change on the network device. Please review the configuration diff by executing the manual task (As shown in the figure below) and click the "Proceed" button to end the automation.
Please use your Itential Customer Success account if you need support when using this artifact.