Skip to content

Commit

Permalink
Release 1.7.1
Browse files Browse the repository at this point in the history
  • Loading branch information
ipspace committed Jan 8, 2024
1 parent 6d09af2 commit ab2440b
Show file tree
Hide file tree
Showing 6 changed files with 80 additions and 7 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,9 @@ Interested? [Read the documentation](https://netlab.tools) and [installation gui

## Releases

The latest release is [release 1.7.0](https://github.com/ipspace/netlab/releases/tag/release_1.7.0), which includes a significant overhaul of lab topology data validation (more details in the [release notes](https://netlab.tools/release/))
The latest release is [release 1.7.1](https://github.com/ipspace/netlab/releases/tag/release_1.7.1). It's mostly a maintenance release with UI improvements (more details in the [release notes](https://netlab.tools/release/))

If you encounter bugs using release 1.7.0, please downgrade to [1.6.4](https://github.com/ipspace/netlab/releases/tag/release_1.6.4) and [open a GitHub issue](https://github.com/ipspace/netlab/issues).
If you encounter bugs using release 1.7.x, please downgrade to [1.6.4](https://github.com/ipspace/netlab/releases/tag/release_1.6.4) and [open a GitHub issue](https://github.com/ipspace/netlab/issues).
<!--
It contains [numerous new features](https://netlab.tools/release/1.6/) that might have a few bugs. Should you encounter one of those creatures, please open a GitHub issue and use release 1.5.4.
-->
Expand Down
10 changes: 10 additions & 0 deletions docs/release.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,16 @@
Release notes
=============

**[Release 1.7.1](release-1.7.1) (2024-01-08)**

* [Automatically create nodes from group members](groups-auto-create)
* [Add 'wait' parameter](validate-wait) 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

[More features...](release-1.7.1)

**[Release 1.7.0](release-1.7.0) (2023-12-03)**

* **[netlab validate](netlab/validate.md)** command can be used to execute [lab validation tests](topology/validate.md).
Expand Down
48 changes: 47 additions & 1 deletion docs/release/1.7.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,33 @@

## New Functionality

(Release-1.7.0)=
(release-1.7.1)=
### Release 1.7.1

* [Automatically create nodes from group members](groups-auto-create)
* [Add 'wait' parameter](validate-wait) 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
* Display object descriptions in the 'netlab show attributes' printout
* Use any loopback interface for VXLAN VTEP (not just the *Loopback0*)

**Platform enhancements:**

* Juniper vPTX can run as a container with *containerlab*
* Implement unnumbered EBGP on FRR VRFs

**Minor improvements:**

* Add parent interface data to unnumbered interfaces
* Make loopback more like a regular interface
* Print an error message when the validation test is interrupted

**Integration tests:**

Release 1.7.1 includes improved initial configuration, VLAN, VXLAN, and VRF integration tests with automated validation.

(release-1.7.0)=
### Release 1.7.0

* [Lab validation tests](../topology/validate.md) executed with the **[netlab validate](../netlab/validate.md)** command.
Expand Down Expand Up @@ -61,6 +87,22 @@ For more details, read the [](../dev/validation.md)

## Bug Fixes

### Bug Fixes in Release 1.7.1

* Hosts need at least one adjacent router with a real IPv4 address
* Cumulus Linux 4.x using VLAN-aware bridge does no support routed native VLANs or routed subinterfaces
* Pad NX-OS hostname if it's too short
* Make 'hostvars' available when evaluating validation templates
* Use yet another path to Ansible filters to cope with Ansible release 4.10.0
* Accept empty tools definitions could be empty (NoneType) when validating lab topology
* Propagate module attribute types (global -> node, link -> intf)
* Redistributing leaked VRF routes into OSPF on Arista EOS requires an additional configuration option
* STP has to be disabled on VLAN-aware Linux bridges using VXLAN
* Failure to execute command is a validation failure
* Replace 'termcolor' with 'rich' markup
* Fix DHCP race condition with 'interfaces' file mounted into Cumulus containers
* loopback0 on Cumulus Linux is named 'lo' not 'lo0'

### Bug Fixes in Release 1.7.0-post1

* ArubaCX: fix MTU plus minor stuff (#979)
Expand All @@ -80,6 +122,10 @@ For more details, read the [](../dev/validation.md)

## Documentation Fixes

### Documentation Fixes in Release 1.7.1

* Polish 'topology defaults' documentation, add [troubleshooting hints](defaults-debug)

### Documentation Fixes in Release 1.7.0-post1

* Remove the FRR version from the platform support tables (fixes #973)
Expand Down
21 changes: 19 additions & 2 deletions docs/topology/validate.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,16 +68,33 @@ validate:
"64 bytes" in stdout
```

Alternatively, you could add a dummy test that does nothing more than wait for the control-plane protocols to stabilize:

```
validate:
wait:
description: Waiting for STP and OSPF to stabilize
wait: 45
ping:
description: Ping-based reachability test
nodes: [ h1,h2 ]
devices: [ linux ]
exec: ping -c 5 -W 1 -A h3
valid: |
"64 bytes" in stdout
```

(validate-multi-platform)=
## Complex Multi-Platform Example

The following validation test is used on the ISP router in the [Configure a Single EBGP Session](https://bgplabs.net/basic/1-session/) lab to check whether the user configured an EBGP session with the ISP router:

```
session:
description: Check EBGP session on ISP router
description: Check the EBGP session on the ISP router
fail: The EBGP session with your router is not established
pass: The EBGP session is in Established state
pass: The EBGP session is in the Established state
nodes: [ x1 ]
show:
cumulus: bgp summary json
Expand Down
2 changes: 1 addition & 1 deletion legacy/setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

sys.path.append('..')

version="1.7.0-post1"
version="1.7.1"

long_description = (Path(__file__).parent / "README.md").read_text()

Expand Down
2 changes: 1 addition & 1 deletion netsim/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

import sys

__version__ = "1.7.0-post1"
__version__ = "1.7.1"

try:
import box
Expand Down

0 comments on commit ab2440b

Please sign in to comment.