Users Guide

Table Of Contents
dellos10_facts: Retrieves the running conguration from an OS10 switch.
Dell EMC Networking Ansible roles
Ansible roles allow you to automatically load variable les (vars_files) and tasks based on a known le structure. Grouping content by
roles allows the roles to be easily shared with other users. These roles are abstracted for OS6, OS9 and OS10. Download Dell EMC Ansible
Networking roles from
https://galaxy.ansible.com/.
For information and examples about how to use the Ansible roles, see Dell EMC Networking Repositories.
Ansible inventory le
The inventory le contains the list of hosts on which you want to run commands. Ansible can run tasks on multiple hosts at the same time.
Ansible playbooks use /etc/ansible/hosts as the default inventory le. To specify a dierent inventory le, use the -i filepath
command as an option when you run an Ansible playbook.
Ansible playbook le
Using playbooks, Ansible can congure multiple devices. Playbooks are human-readable scripts that are expressed in YAML format. An
Ansible playbook takes inventory and playbook les as arguments and maps the group of hosts in the inventory les to the tasks listed in
the playbook le.
Ansible variables
In Ansible, variables dene switch congurations. Many Dell EMC switches have common congurations. Common conguration variables
are stored in the vars/main.yaml le; for example, dns_server and ntp_server. All host-specic congurations are stored in the
host_vars/host_name.yaml conguration le; for example, the hostname of a switch. Variables are also used as part of playbook
denitions, command-line arguments, and inventory denitions.
Example: Congure an OS10 switch using Ansible
OS10 supports Ansible integration to automate switch conguration. For detailed information about how to use Ansible scripts and create
Ansible playbooks, go to:
Dell EMC Ansible Documentation
Dell EMC Networking Guides and search for Ansible
You can download auto-generated Ansible conguration les for the network design you provide from the Dell EMC Fabric Design Center.
Before you start
Before you congure an OS10 switch using Ansible, congure basic network settings on your switch, such as assigning an IP address and
default gateway to the management interface:
1 Connect a terminal emulator to the console serial port on the switch using a serial cable. The serial port settings are 115200, 8 data
bits, and no parity.
2 Congure the management interface; for example:
OS10(config)# interface mgmt 1/1/1
OS10(conf-if-ma-1/1/1)# no ip address dhcp
OS10(conf-if-ma-1/1/1)# ip address 10.1.1.10/24
OS10(conf-if-ma-1/1/1)# no shutdown
OS10(conf-if-ma-1/1/1)# exit
OS10(config)# management route 10.10.20.0/24 10.1.1.1
OS10(config)# end
Ansible conguration example
In this example, the conguration uses Ansible roles to congure an OS10 switch from an Ansible controller node with:
OS10 provisioning
107