Agent-Jones is a web-service used to configure and retrieve info from Cisco devices. Mostly switches, but it could as well be used for routers. Its goal is to serve as a back-end for nice GUIs and collectors applications. As such, it doesn't have any GUI.
The whole stuff is written in Python, using the Flask micro-framework, and a very nice SNMP lib for Python called snimpy 1, 2.
- Version
11.3.2020with Python 3.x should be considered as beta, because I could not try every case. Especially the "write-functions" haven't been tested. Get in touch if you see an issue. This version is not deployed anywhere, because the intended use (cbQoS polling on Cisco 3850) is not working (a Cisco limitation). - Version
22.5.2017with Python 2.x is considered stable, and deployed on at least 3 major networks with 1'000+ devices, WAN and LAN, routers and switches, all Cisco.
- Get info from a single device.
- Save the running-config to startup-config.
- Assign an interface to a VLAN.
- Get the vlan list from a device (currently only native vlans).
- Get the voice-vlan for an interface.
- GET interfaces from a device. Option to list the MAC addresses of devices connected to each port.
- Configure an interface : adminStatus and ifAlias (called description in Cisco language).
- List the connected MAC addresses : MAC (ethernet) to interface mappings from a device.
- CDP information for each interface.
- DHCP snooping information for each interface.
- Trunk status for each interface.
- Get the interface counters of one interface.
- Get the ARP table (MAC to IP).
- SNMP get or walk on a OID
- CBQoS (Class-Based Quality of Service) information for each interface.
- command-line CBQoS parser script.
- Run commands over SSH
Everyone wants screenshots. Here are some for "device info" and "interface list", when tested from Postman.
.
.
- not tested on non-Cisco devices. It could work because I used mostly "standard" MIBs (whatever "standard" means in this context).
The following IOS commands might be present on modeled devices to allow for long-term indices persistence, but their presence is not mandatory. They are anyway a good starting point for your Cisco configuration templates.
snmp-server ifindex persist
snmp mib persist cbqos
See the release notes.
Read the installation guide.
Using the web-service is as easy as any such web-service. This is an example with curl, adapt to your own language.
curl -u user:password http://0.0.0.0:5000/aj/api/v1/device/switch1.domain.com
Using ssh commands is a bit more complicated. You have to provide 3 parameters to a PUT request:
- CmdList : ["terminal length 0", "show users", "show version”]
- uuid as usual
- driver : ios
A corresponding curl command would be something like:
curl -X PUT -H Authorization:Basic FIXME -H Content-Type:multipart/form-data; -F CmdList={["terminal length 0", "show users", "show version"]} -F uuid=345abc -F driver=ios http://0.0.0.0:5000/aj/api/v1/device/ssh/switch1.domain.com
If you expect any long output, you need to pass “terminal length 0” as first command. In fact, I would recommend to always pass it.
This script is a utility tool, not directly used within Agent-Jones. It is here to debug / visualize Cisco CBQoS configuration (if you have looked at the CISCO-CLASS-BASED-QOS-MIB, you know what I mean). See util/qos_parser.py. You need a virtualenv with pysnmp installed to run it, tested with Python 3.7 and 3.8.
Cookbook:
python3 -m venv utilvenv
source utilvenv/bin/activate
pip install pysnmp
python3 ./qos_parser.py -c community -d device -p 161 -j /tmp/output.json [-D]
The JSON output file is similar to what Agent-Jones provides with the /qos/ API endpoint.
http://0.0.0.0:5000/xdoc/
There is a log file defined in config.py. Tail it. Same way, check the Apache log files if you implemented it as a WSGI application.
- works as a virtualenv to protect your instance from courageaous system-admins using OS-upgrade without too much knowledge.
- python 3.7 or 3.8 (might work for older 3.x versions if you get the dependencies installed)
- See ToDO
be sure to understand Flask-restful and snimpy, then the code should be easy to extend.
GPL V2.
- Charles Bueche wrote the initial version.
Start by reading the FAQ.
For easy questions, feel free to email me. For more, I will be very happy to provide commercial support.