aos-wlan-ansible-role

=====================

This Ansible Network role provides tools for managing configurations specifically for ArubaOS (AOS) Mobility Master and Standalone Controllers.

Requirements

---

• Python version 2.7 or 3.5+
• Ansible version 2.8.1 or later
• AOS firmware version 8.0 or higher

Installation

---

To install via GitHub, use this command. Add -f to overwrite the current version:

ansible-galaxy install git+https://github.com/aruba/aos-wlan-ansible-role.git

To install via Galaxy:

ansible-galaxy install arubanetworks.aos_wlan_role

Inventory Variables

---

You need to define these variables in your inventory for your AOS host:

• ansible_host: IP address of the controller in A.B.C.D format
• ansible_user: Controller username in plain text
• ansible_password: Controller password in plain text
• ansible_connection: Always set to httpapi
• ansible_network_os: Always set to aos
• ansible_httpapi_port: Always set to 4343
• ansible_httpapi_use_ssl: Set to True since AOS uses port 4343 for REST
• ansible_httpapi_validate_certs: Set to True or False based on whether you want Ansible to validate certificates

Sample Inventories:

Sample inventory.yml:

all:
  hosts:
    controller:
      ansible_host: 10.1.1.1
      ansible_user: admin
      ansible_password: password
      ansible_connection: httpapi
      ansible_network_os: aos
      ansible_httpapi_port: 4343
      ansible_httpapi_validate_certs: True
      ansible_httpapi_use_ssl: True

Sample inventory.ini:

aos_1 ansible_host=10.1.1.1 ansible_user=admin ansible_password=password ansible_connection=httpapi ansible_network_os=aos ansible_httpapi_port=4343 ansible_httpapi_validate_certs=True ansible_httpapi_use_ssl=True

Example Playbook

---

If installed from GitHub, use the role name aos-wlan-ansible-role:

---
- hosts: all
  roles:
    - role: aos-wlan-ansible-role
  tasks:
    - name: Create a radius server
      aos_api_config:
        method: POST
        config_path: /md/SLR
        data:
          - rad_server:
              - rad_server_name: test-dot1x
                rad_host:
                  host: 1.1.1.1

If installed from Galaxy, use the role name arubanetworks.aos_wlan_role:

---
- hosts: all
  roles:
    - role: arubanetworks.aos_wlan_role
  tasks:
    - name: Create a radius server
      aos_api_config:
        method: POST
        config_path: /md/SLR
        data:
          - rad_server:
              - rad_server_name: test-dot1x
                rad_host:
                  host: 1.1.1.1

You can also find example playbooks in the sample_playbooks directory on the GitHub repository. These are designed for various typical tasks performed on the Mobility Master, utilizing different modules available in this role. You can select a playbook that suits your needs and adapt it for your own use.

Contribution

---

At Aruba Networks, we are committed to maintaining high-quality products. If you encounter any issues, please report them on our GitHub, and we will respond quickly!

License

---

Apache 2.0

Author Information

---

Jay Pathak (jayp193)
Karthikeyan Dhandapani (kdhandapani)