Introduction
The cisco.ios collection provides the resource modules and network modules used to manage Cisco IOS and IOS-XE devices through Ansible, covering areas such as BGP, VRF, interfaces, VLANs, flow monitors, and SPAN/ERSPAN sessions. Version 11.7.1 has just been published on Ansible Galaxy, superseding 11.7.0.
Whats New
This Is a Bugfix Re-release, Not a Feature Release
11.7.1 is functionally identical to 11.7.0 except for a single fix: the monitor_sessions module's module_utils package shipped with empty __init__.py files in 11.7.0, which caused failures described as "empty-init" errors when the module was loaded. 11.7.1 cleans up those init.py files so the module loads correctly. No other code, module, or plugin was changed between 11.7.0 and 11.7.1.
Bugfixes in 11.7.1
- Clean the
init.pyfiles within themonitor_sessionsmodule_utils. This removes the failures seen with empty-init.
What Was Already in 11.7.0 (for context)
Since 11.7.1 carries forward everything from 11.7.0 unchanged, it's worth summarizing what that previous release already contained:
BGP fixes across ios_bgp_global and ios_bgp_address_family:
- Fixed BMP server fact parsing
- Fixed activation ordering
- Fixed peer-group declaration parsing
- Fixed input validation issues
VRF fixes across ios_vrf_global and ios_vrf_address_family:
- Fixed route distinguisher updates and absent VRF deletion in overridden state (
ios_vrf_global) - Fixed unicast SAFI defaults, route-target idempotency, and deleted state scoping (
ios_vrf_address_family)
Interface and VLAN fixes across ios_vlans, ios_interfaces, and ios_l3_interfaces:
- Excluded reserved VLANs in overridden state (
ios_vlans) - Removed absent logical interfaces and redundant shutdowns (
ios_interfaces) - Fixed IP replacement ordering (
ios_l3_interfaces)
New modules added in 11.7.0:
ios_flow_monitor_globalandios_flow_monitor_interfacesfor Flexible NetFlow managementios_monitor_sessionsfor local SPAN and ERSPAN source sessions
New features added in 11.7.0:
- Multi-server BMP support (
bmp.serversandneighbors.bmp_activate.servers) inios_bgp_globalandios_bgp_address_family peer_group_declarationsupport inios_bgp_global- TCP MSS adjustment parameters (
tcp_adjust_mssandipv6_tcp_adjust_mss) inios_l3_interfaces - Large-community support in
ios_route_maps
Collections Involved
| Component | Version | Change in 11.7.1 |
|---|---|---|
| cisco.ios | 11.7.0 → 11.7.1 | Fixed empty __init__.py files in monitor_sessions module_utils |
How to Install and Test
Upgrade the collection to 11.7.1 and confirm the monitor_sessions module loads without the empty-init error.
# Install or upgrade cisco.ios to the latest version
ansible-galaxy collection install cisco.ios --upgrade
# Install the exact version explicitly
ansible-galaxy collection install cisco.ios:==11.7.1
# Verify the installed version
ansible-galaxy collection list cisco.ios
# Check that monitor_sessions module_utils loads correctly
ansible-doc cisco.ios.ios_monitor_sessions
# Dry-run a basic fact gathering task against a lab IOS device to confirm the collection works end to end
ansible -m cisco.ios.ios_facts -a 'gather_subset=all' lab_ios_host
If the collection was pinned in a requirements.yml, bump the version there as well:
cat <<'EOF' > requirements.yml
collections:
- name: cisco.ios
version: 11.7.1
EOF
ansible-galaxy collection install -r requirements.yml
Conclusion
Anyone running 11.7.0 and hitting monitor_sessions module load failures with empty-init errors should upgrade to 11.7.1 directly; there is no other behavioral change to account for. Anyone not using ios_monitor_sessions can upgrade at their own convenience since the rest of the collection is unchanged from 11.7.0.