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.py files within the monitor_sessions module_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_global and ios_flow_monitor_interfaces for Flexible NetFlow management
  • ios_monitor_sessions for local SPAN and ERSPAN source sessions

New features added in 11.7.0:

  • Multi-server BMP support (bmp.servers and neighbors.bmp_activate.servers) in ios_bgp_global and ios_bgp_address_family
  • peer_group_declaration support in ios_bgp_global
  • TCP MSS adjustment parameters (tcp_adjust_mss and ipv6_tcp_adjust_mss) in ios_l3_interfaces
  • Large-community support in ios_route_maps

Collections Involved

ComponentVersionChange in 11.7.1
cisco.ios11.7.0 → 11.7.1Fixed 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.