![]() * lib/ansible/modules/cloud/digital_ocean/digital_ocean_snapshot_info.py: fix typos * lib/ansible/modules/cloud/ovirt/ovirt_host_network.py: fix typos * test/integration/targets/cnos_backup/README.md: fix typos * test/integration/targets/cnos_bgp/README.md: fix typos * test/integration/targets/cnos_command/README.md: fix typos * test/integration/targets/cnos_conditional_command/README.md: fix typos * test/integration/targets/cnos_conditional_template/README.md: fix typos * test/integration/targets/cnos_config/README.md: fix typos * test/integration/targets/cnos_facts/README.md: fix typos * test/integration/targets/cnos_image/README.md: fix typos * test/integration/targets/cnos_rollback/README.md: fix typos * test/integration/targets/cnos_save/README.md: fix typos * test/integration/targets/cnos_showrun/README.md: fix typos * test/integration/targets/cnos_template/README.md: fix typos * test/integration/targets/cnos_vlag/README.md: fix typos * test/integration/targets/enos_command/README.md: fix typos * test/integration/targets/enos_config/README.md: fix typos * test/integration/targets/enos_facts/README.md: fix typos * test/legacy/roles/cnos_backup/README.md: fix typos * test/legacy/roles/cnos_bgp/README.md: fix typos * test/legacy/roles/cnos_command/README.md: fix typos * test/legacy/roles/cnos_conditional_command/README.md: fix typos * test/legacy/roles/cnos_conditional_template/README.md: fix typos * test/legacy/roles/cnos_ethernet/README.md: fix typos * test/legacy/roles/cnos_facts/README.md: fix typos * test/legacy/roles/cnos_image/README.md: fix typos * test/legacy/roles/cnos_portchannel/README.md: fix typos * test/legacy/roles/cnos_rollback/README.md: fix typos * test/legacy/roles/cnos_save/README.md: fix typos * test/legacy/roles/cnos_showrun/README.md: fix typos * test/legacy/roles/cnos_template/README.md: fix typos * test/legacy/roles/cnos_vlag/README.md: fix typos * test/legacy/roles/cnos_vlan/README.md: fix typos |
5 years ago | |
---|---|---|
.. | ||
defaults | ||
tasks | ||
tests/cli | ||
vars | ||
README.md | ||
aliases |
README.md
Ansible Role: enos_facts - Displays switch information
Collects a base set of device facts from a remote Lenovo device running on ENOS. This module prepends all of the base network fact keys with C(ansible_net_). The facts module will always collect a base set of facts from the device and can enable or disable collection of additional facts.
Requirements
- Ansible version 2.4 or later (Ansible installation documentation)
- Lenovo switches running ENOS version 8.4.1.0 or later
- an SSH connection to the Lenovo switch (SSH must be enabled on the network device)
Role Variables
Available variables are listed below, along with description.
The following are mandatory inventory variables:
Variable | Description |
---|---|
ansible_connection |
Has to be network_cli |
ansible_network_os |
Has to be enos |
ansible_ssh_user |
Specifies the username used to log into the switch |
ansible_ssh_pass |
Specifies the password used to log into the switch |
To gather subsets you will specify the following variables to get appropriate data retrieved from the devices
Variable | Description |
---|---|
gather_subset |
When supplied, this argument will restrict the facts collected to a given subset. Possible values for this argument include all, hardware, config, and interfaces. Can specify a list of values to include a larger subset. Values can also be used with an initial C(M(!)) to specify that a specific subset should not be collected. |
Need to specify these variables in vars/main.yml under variable cli
Variable | Description |
---|---|
host |
Has to be "{{ inventory_hostname }}" |
port |
Has to be22 |
username |
User Name of switch |
password |
Password of switch |
timeout |
time out value for CLI |
authorize |
Whether u have to enter enable mode for data collection. |
auth_pass |
Enable Password if required |
Dependencies
- username.iptables - Configures the firewall and blocks all ports except those needed for web server and SSH access.
- username.common - Performs common server configuration.
- enos_facts.py - This module file will be located at lib/ansible/modules/network/enos/ of Ansible installation.
- enos.py - This module util file will be located at lib/ansible/module_utils/network/enos of Ansible installation.
- enos.py - This module plugin file will be located at lib/ansible/plugins/action of Ansible installation.
- enos.py - This module plugin file will be located at lib/ansible/plugins/cliconf of Ansible installation.
- enos.py - This module plugin file will be located at lib/ansible/plugins/cliconf of Ansible installation.
- /etc/ansible/hosts - You must edit the /etc/ansible/hosts file with the device information of the switches designated as leaf switches. You may refer to enos_command_sample_hosts for a sample configuration.
Ansible keeps track of all network elements that it manages through a hosts file. Before the execution of a playbook, the hosts file must be set up.
Open the /etc/ansible/hosts file with root privileges. Most of the file is commented out by using #. You can also comment out the entries you will be adding by using #. You need to copy the content of the hosts file for the role into the /etc/ansible/hosts file. The sample hosts file for the role is located in the main directory.
[enos_facts]
10.241.105.24 ansible_connection=network_cli ansible_network_os=enos ansible_ssh_user=<username> ansible_ssh_pass=<password>
Note: You need to change the IP addresses to fit your specific topology. You also need to change the <username>
and <password>
to the appropriate values used to log into the specific Lenovo network devices.
Example Playbook
To execute an Ansible playbook, use the following command:
ansible-playbook enos_facts_sample.yml -vvv
-vvv
is an optional verbose command that helps identify what is happening during playbook execution. The playbook for each role is located in the main directory of the solution.
- name: Module to do some CLI Command configurations
hosts: enos_facts
gather_facts: no
connection: network_cli
roles:
- enos_facts
License
Copyright (C) 2017 Lenovo, Inc.
This file is part of Ansible
Ansible is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Ansible is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Ansible. If not, see http://www.gnu.org/licenses/.