derekwangHPEAruba / aruba-ansible-modules

Aruba Ansible Modules

aruba-ansible-modules

All Ansible modules, module installer, and example playbooks for Aruba Switching and WLAN products.

Structure

• Aruba Switching and WLAN Ansible modules and files are stored in aruba_module_installer/library.
• Documentation of Switching and WLAN Ansible modules are located in module_documentation/
• Frequently Asked Questions are located in FAQ.md
• Aruba Switching and WLAN Ansible playbook examples are stored in example_playbooks/

How to Install Modules

The aruba_module_installer.py tool installs all files/directories required by Ansible for Aruba Switching and WLAN integration.

Requirements

• Linux operating system
• Python 2.7 or 3.5+
• Ansible version 2.5 or later

How to run this code

From command line:

$ python aruba_module_installer.py

If you receive a permission error, use 'sudo':

$ sudo python aruba_module_installer.py

In order to run these scripts, please complete the steps below:

1. Install Python version 2.7 or 3.5+ on the system.

2. Install Ansible 2.5 or later (refer https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html).

Optional Arguments

optional arguments:
  -h, --help    show this help message and exit
  -r, --remove  remove all files & directories installed by this script.
  --reinstall   remove all files & directories installed by this script. Then
                re-install.
  --cx          only install files/directories required for ArubaOS-CX.
  --switch      only install files/directories required for ArubaOS-Switch.

How to Run a Playbook on ArubaOS-Switch or ArubaOS-CX Device

Below you'll find step by step instructions on how to run an example playbook on your ArubaOS-Switch or CX device.

Prerequisites

Follow the above steps to install the ArubaOS-CX and ArubaOS-Switch Ansible modules.

ArubaOS-CX

1. Assign an IP address to the management interface of your CX device. Ensure that the IP address is reachable from your Ansible control machine.
2. Enable REST on your CX device with the following commands:

   switch(config)# https-server rest access-mode read-write
   switch(config)# https-server vrf mgmt
   

3. Modify the IP address in the hosts file example_playbooks/arubaoscx/cx_hosts.yml to match the IP of your CX device.
4. Modify the ansible_user and ansible_password in the hosts file example_playbooks/arubaoscx/cx_hosts.yml to match the login information of your CX device.

ArubaOS-Switch

1. Assign an IP address to the management interface of your Switch device. Ensure that the IP address is reachable from your Ansible control machine.
2. Enable REST on your Switch device with the following commands:

   switch(config)# web-management ssl
   switch(config)# rest-interface
   

3. Modify the IP address in the hosts file example_playbooks/arubaoss/switch_hosts.yml to match the IP of your Switch device.
4. Modify the ansible_user and ansible_password in the hosts file example_playbooks/arubaoss/switch_hosts.yml to match the login information of your Switch device.

Executing a Playbook

To execute a playbook run the following command from the Linux machine, replace playbook_file with the desired playbook and either cx_hosts.yml or switch_hosts.yml:

$ ansible-playbook [playbook_file] -i [cx_hosts.yml|switch_hosts.yml]