Cisco CBS
Overview
A module to control and monitor Cisco CBS-series switches.
Interface list features:
- list of interfaces with bitrate (and recent historical stats)
- ability to enable/disable ports
- view POE status and control power
- add description to interface (click on the name to edit)
- select VLAN, including editing of trunk or access mode
- display of interface rate (1G/100M)
- ablity to ‘protect’ ports to prevent accidental changes (useful for uplinks etc) - stored locally in BUG
- display of neighbors and/or known devices (LLDP or FDB)
- configurable DHCP address source to convert discovered MAC addresses to IP
Interface page features:
- more detailed view of interface
- statistics graph for last few minutes
- neighbor details (LLDP)
- devices tab (FDB) with optional IP lookup
Also polls the switch to check if there are pending changes and prompts to save if there are.
Also checks the device to see if the password has expired - this is a common cause of problems.
Configuration
| Field | Default Value | Description |
|---|---|---|
id | "" | Unique identifier for this module instance (usually auto-generated). |
needsConfigured | true | Indicates whether the module has been configured since build. |
title | "" | Human-readable title for this module instance, shown in the UI. |
module | "cisco-c1300" | Internal name of the module. |
description | "" | Optional text describing the module instance in the UI. |
notes | "" | Free-text field for extra notes about this configuration. |
enabled | false | Whether the module instance is enabled |
address | "" | IP address or hostname of the device to connect to. |
username | "bug" | Username used to authenticate with the device |
password | "" | Password for the user |
enabled | false | Flag indicating whether this module instance is active. |
snmpCommunity | public | SNMP community with write access to the device |
protectedInterfaces | [] | An of array of interfaces which are ‘protected’ |
dhcpSources | [] | An of array panel IDs which provide the dhcp server capability |
Capabilities
This module follows BUG’s standard capabilities model. For more information, see BUG Capabilities Documentation.
| Type | List |
|---|---|
| Exposes | None |
| Consumes | dhcp-server |
Device Configuration
- Create a username/password with write access - used to ssh into the device for the pending status
- Create an SNMP community with write access - used for all other actions
Troubleshooting
Changelog
version 1.1.7
- 2026-02-09: fix status timeouts (fd554f6)
version 1.1.6
- 2026-02-09: service/util updates (73e1f9e)
version 1.1.5
- 2026-02-06: improve service logging (c70cf23)
version 1.1.4
- 2026-02-05: fix status check timeouts (63cbf43)
version 1.1.3
- 2026-02-04: set pending flag on any change to update UI (58494b4)
- 2026-02-04: improve logging in status handlers (a892bdd)
- 2026-02-04: refactor services with try/catch/throw (471d8ee)
- 2026-02-04: add default status check (67c018b)
- 2026-02-04: add README (1e9bd70)
version 1.1.2
- 2026-02-04: use mongo bulkwrite to improve performance (8e8cb29)
version 1.1.1
- 2026-02-04: improve performance of workers (9713866)
- 2026-02-04: improve api route error handling (2024cfe)
version 1.1.0
- 2025-06-28 add support for poe
version 1.0.0
- 2023-31-01: fix vlan range + remove debug