Skip to content

Ver 0.5.1

Latest
Latest

Choose a tag to compare

View all tags
@yuhsukeogawa yuhsukeogawa released this 09 Jul 07:32
v0.5.1
7d2a8c3
image

What's new in Ver 0.5.1

This release adds config_converter — a new standalone CLI that reconstructs an L1/L2/L3 Network Sketcher topology from Cisco show running-config text files, with no live device connection required at conversion time.

config_converter highlights

  • Input: A directory of running-config text files (one device per file, multiple devices in one file, or a mix; optional per-site subdirectories).
  • Output: A ready-to-run Network Sketcher command script (<stem>_config.txt, Phase 1–6) plus audit artefacts (inventory CSV, excluded-links report, design model JSON).
  • Supported platforms: IOS / IOS-XE, NX-OS, IOS-XR, and ASA (FTD/FDM) running-config exports.
  • Topology inference: Links are inferred from IPv4 subnet matching (with degree-similarity / Blossom matching for ambiguous shared subnets). Missing peer devices are represented as gray Dummy_<TYPE>_<n> placeholders.
  • Pipeline status: Phases 1a–5 complete — config parsing, subnet-based topology inference, layout/tiering, inferred-device synthesis, WAN/closed-environment classification, and Network Sketcher command generation.
  • Configuration schema: config_converter_to_ns_config.json schema version 0.5.1.
  • Dependencies: Python 3.10+, networkx (required); ciscoconfparse2 (optional, improves parsing).

Quick Start

pip install -r config_converter/requirements.txt

python -m config_converter.src.convert \
  -i config_converter/Input_data/sample1/ \
  -o config_converter/Output_data/ns_commands_config.txt

A bundled synthetic sample is included under config_converter/Input_data/sample1/.

Important notes

  • Running-config bundles contain no explicit cabling — treat the generated diagram as a starting reference / first draft and validate against LLDP/CDP, DCIM, or physical inspection.
  • CDP/LLDP neighbour data, live API access, full routing topology modelling, and IPv6-only configs are out of scope in this release (see config_converter/README.md and DESIGN.md).

Documentation

Also in this release

  • Root README.md and AGENTS.md updated to document the new tool
  • .gitignore hardened to exclude generated Output_data/ artefacts and temp directories

For all other converters (aci_converter, catc_converter, cml_converter, cv_converter, meraki_converter, nd_converter, sna_converter, and 3rd_party/netbox_converter), see the Ver 0.5 release notes and the repository README.

Assets 2
Loading