Release Notes
Release 1.9.2-post1 (2024-12-10)
This release fixes an annoying bug affecting users of Ansible 11.x.
Release 1.9.2 (2024-11-03)
The netlab exec command can execute the same command on a set of network devices
netlab supports Cisco IOS on Linux (IOL), IOL layer-2 image, and IOSv/IOSvL2 in vrnetlab containers
Edgeshark can be used as an external tool to provide GUI-based access to lab packet capture
Release 1.9.1 (2024-10-05)
netlab capture command implements packet capture on VM- or container interfaces
IS-IS route import (redistribution) and IS-IS VRF instances
RIPv2/Ripng route import and VRF instances
Support for Cisco IOSv layer-2 image
Release 1.9.0-post1 (2024-08-26)
This release contains minor improvements, numerous SR Linux configuration fixes, a few other bug fixes, and documentation fixes.
Release 1.9.0 (2024-08-19)
Generic Routing Configuration Module supporting routing policies, prefix filters, AS-path filters, and BGP community filters
Default route origination in OSPFv2 and OSPFv3
Route import (redistribution) into OSPFv2, OSPFv3, and BGP.
Change device configuration or use SuzieQ in validation tests
Release 1.8.4-post2 (2024-07-13)
This release contains only bug fixes and documentation fixes.
Release 1.8.4-post1 (2024-07-01)
This release contains only bug fixes and documentation fixes.
Release 1.8.4 (2024-06-22)
Support for Cisco Catalyst 8000v
Unified support of vrnetlab containers (including ArubaCX, Cisco Catalyst 8000v, Cisco CSR 1000v, Dell OS10, Cisco Nexus 9000v, Mikrotik RouterOS, Juniper vMX, vPTX and vSRX)
Automated build of GitHub Codespaces devcontainer
Handle keyboard interrupts in long-running netlab commands, including netlab up, netlab initial and netlab validate.
Add
--readyaction to netlab initial command to wait for lab devices to become ready without configuring them.
Release 1.8.3 (2024-06-16)
BGP Link Bandwidth community in bgp.policy plugin
BGP route server/client in bgp.session plugin.
Installation scripts work with Ubuntu 24.04. They were also tested on Ubuntu 22.04, Ubuntu 20.04, and Debian Bookworm.
Release 1.8.2 (2024-05-13)
Create reports from a subset of nodes
Inspect the same variable(s) across multiple nodes
Check for the presence of Vagrant boxes or Docker containers before starting the lab and display pointers to build recipes.
Check installed Ansible collections before starting netlab up or netlab initial
Support for Sonic VM based on Azure sonic-vs images.
Numerous improvements in the Vagrant box-building process
Release 1.8.1-post1 (2024-04-24)
This release contains only bug fixes and documentation fixes.
Release 1.8.1 (2024-04-08)
Refactor the netlab status printout
Add ‘retry tests until the timeout’ functionality to netlab validate (including the actual time it took to get the expected results).
OSPFv3 in VRFs, implemented on Arista EOS, Cisco IOS, Cisco IOS-XE, FRR, and Junos (vMX, vPTX, vSRX).
EBGP sessions over IPv4 unnumbered and IPv6 LLA interfaces on Arista EOS
Cisco IOS XRd container support
Numerous configuration template fixes, including reduced OSPF SPF/LSA and IPv6 ND RA timers.
Release 1.8.0 (2024-03-01)
netlab up command can reload saved device configurations instead of starting the initial device configuration process.
DHCP configuration module implements DHCP clients, DHCP servers, and DHCP relays for IPv4 and IPv6.
Lab topology can include control plane- and network services daemons running in Linux containers. This release includes BIRD and dnsmasq daemons.
BGP configuration module supports 4-octet BGP AS numbers and large BGP communities.
Validation plugins allow you to write more powerful netlab validate validation tests without creating complex Jinja2 templates
You can build Docker containers for the supported daemons with the netlab clab build command
Release 1.7.2 (2024-01-26)
This release contains only bug fixes and documentation fixes.
Release 1.7.1 (2024-01-08)
Add ‘wait’ parameter to validation tests
Use colors in netlab up/down/test/validate printouts
Use color-coded error messages
Use the rich Python library to pretty-print tables, JSON, and YAML
Release 1.7.0 (2023-12-03)
netlab validate command can be used to execute lab validation tests.
The fabric plugin generates a whole leaf-and-spine fabric topology from a few parameters.
The bgp.domain plugin allows you to create topologies with multiple independent devices or sites using the same BGP AS number.
The bgp.policy plugin supports AS-path prepending on Arista EOS, Aruba AOS-CX, Cisco CSR 1000v, Cisco IOSv, Cumulus Linux, FRR
bgp.originate plugin uses loopbacks (instead of static routes to Null device) to originate BGP IPv4 and IPv6 prefixes
The
--showoption of the netlab connect command implements a consistent cross-device way of executing show commands.
Release 1.6.4 (2023-10-23)
Implement simple BGP routing policies in bgp.policy plugin
Implement remove_private_as, passive BGP peers and BFD for BGP neighbors in bgp.session plugin
Selectively apply BGP session attributes to IBGP and EBGP sessions
Enable external tools in user defaults
Default groups allow you to specify user- or project-wide groups in the defaults files.
Release 1.6.3 (2023-10-06)
ebgp.utils plugin supports TCP-AO, configurable BGP timers, and Generic TTL Security Mechanism (TTL session protection)
Shorter version of BGP neighbor report
Release 1.6.2 (2023-08-26)
Display a subset of available reports in netlab show reports command
Display warnings in reports relying on ipaddr Ansible filter
Add IPv6 prefixes and neighbors to BGP reports
Add IPv6 column to text addressing report
Make some report columns optional to reduce the report width
Implement inter-VRF route leaking for Cumulus/FRR
Release 1.6.1 (2023-08-18)
netlab report can generate Markdown markup (ideal for augmenting documentation written in Markdown)
BGP AS number and BGP neighbor reports (text, Markdown, HTML)
Release 1.6.0 (2023-08-01)
New commands: netlab report, netlab graph and netlab inspect
New reports: node and link addressing, lab wiring, management IP addresses and credentials
Improved netlab show command can display configuration modules, output modules, virtualization providers and reports
Connect containers to outside world through macvlan interfaces
Host-to-lab-device port forwarding with libvirt and containerlab
Nokia SR OS OSPF P2MP support
Release 1.5.4 (2023-06-10)
Juniper vPTX/vEVO support by Stefano Sasso (initial configuration, IPv4+IPv6, OSPFv2/v3, IS-IS, BGP, BFD, VLANs, VRFs, MPLS, SR-MPLS)
Juniper vSRX can be run as a vrnetlab-packaged container (by Stefano Sasso)
Documentation migrated to netlab.tools
Release 1.5.3 (2023-05-15)
‘unknown’ device type can be used to deploy devices not yet supported by netlab
Public libvirt networks can be used to connect labs to outside world
MPLS VPN support for SR OS
Improved virtualization provider installation testing with (hopefully) useful error messages
Release 1.5.2 (2023-04-27)
Add `–force flag to ‘netlab down’ command
Release 1.5.1 (2023-04-02)
Stricter type checks for node names, group names, VLAN names, VRF names, link roles, address pools, device names, and Linux bridges. Names must be identifiers: alphanumeric strings up to 16 characters long.
netlab status file tracks active lab instances – used by netlab create, netlab up and netlab down commands to check for duplicate lab instances.
Release 1.5.0 (2023-01-28)
Split large libvirt topology into smaller vagrant up batches
Use custom network/bridge name and IP subnet for
vagrant-libvirtmanagement network‘loopback’ link type can be used to create additional loopback interfaces
Release 1.4.3 (2023-01-12)
IOS XRv support (initial configuration, IPv4+IPv6, OSPFv2/v3, IS-IS, BGP)
MPLS, LDP and L3VPN support on FRR
Rewrite Linux container deployment to remove Python and
ipdependencies
Release 1.4.2 (2022-12-18)
Juniper vMX support
Junos BFD, VRF, MPLS, SR-MPLS, and MPLS/VPN support
Full VLAN support on vMX and routed VLAN interfaces on vSRX
CSR 1000v VLAN and VXLAN support
VyOS containerlab support
Release 1.4.1 (2022-11-25)
Cisco ASAv support
VRRP and anycast gateway on Dell OS10
VRRP on VyOS
Unnumbered OSPF interfaces on VyOS
Add support for all EVPN bundle services
Release 1.4.0 (2022-11-04)
EVPN asymmetric IRB
Anycast gateway and VRRP
EVPN MPLS transport
New address allocation algorithm for links with small IPv4 prefixes
Tighter control of VXLAN-enabled and EVPN-controlled VLANs and VRFs
Unmanaged and unprovisioned devices
For older releases, check the release notes archive.