Files
Christian Manivong 4c4805bae3 docs: add LCOS SX 4 (GS-3152X) as first-target candidate
The GS-3152X runs LCOS SX 4.30 (end of life 2028-08). netmiko already has
a transport for it, show running-config exists (SX 3 can only export its
config to TFTP), and its Cisco-like CLI is closer to the current SX 5
switches. docs/lcos-sx4.md maps the getters to commands from the SX 4.30
CLI reference; fixtures.md gets the matching capture list.

Refs NetOrk/netork#1094
2026-10-13 00:35:11 +02:00

95 lines
3.1 KiB
Markdown

# Fixtures to capture
Record raw output from a real device the first time one is connected. Store it under
`tests/fixtures/<model>-<firmware>/` (e.g. `gs-2310p-plus-3.34/`), one file per command,
plus a `COMMANDS.txt` that lists the command, the section it ran in, and the device state
that matters (links up/down, PoE consumers, LLDP neighbours present or not).
Scrub before committing: serial numbers, public IPs, SNMP communities, hostnames that
identify a site.
## LCOS SX 3 (GS-23xx)
Session basics:
- [ ] login banner and the first prompt after SSH login
- [ ] `?` at the top level (list of sections)
- [ ] `?` inside each section listed below
- [ ] the error text of an invalid command and of an invalid parameter
Per section:
- [ ] `system` → `show`
- [ ] `firmware` → `show`
- [ ] `port` → `show configuration`
- [ ] `port` → `show status` (with at least one link up and one down)
- [ ] `port` → `show simple-counter`
- [ ] `port` → `show detail-counter 1`
- [ ] `port` → `show sfp <sfp-port>` (with and without a module)
- [ ] `ip` → `show`
- [ ] `ipv6` → `show current`
- [ ] `fdb` → `show mac-table`
- [ ] `fdb` → `show static-mac`
- [ ] `lldp` → `show config`
- [ ] `lldp` → `show info <port-list>` (with a neighbour, e.g. another switch or a router)
- [ ] `vlan` → `show vlan`
- [ ] `vlan` → `show port-config`
- [ ] `vlan` → `show port-status static`
- [ ] `thermal` → `show`
- [ ] `snmp` → `show snmp`
- [ ] `snmp` → `show community`
- [ ] `time` → `show ntp`
- [ ] `poe` → `show config` (PoE models only)
- [ ] `poe` → `show status` (with a powered device attached)
- [ ] `aggregation` → `show`
- [ ] `lacp` → `show status`
- [ ] `stp` → `show status`
- [ ] `syslog` → `show log`
Configuration:
- [ ] `config-file` → `export` to a TFTP server once (the XML file itself)
- [ ] whether the web UI offers a configuration download, and how (URL, auth)
## LCOS SX 4 (GS-3xxx)
Session basics:
- [ ] login banner and the first prompt after SSH login
- [ ] `show ?` (list of show commands on this firmware)
- [ ] the error text of an invalid command
Commands:
- [ ] `show version`
- [ ] `show system cpu status`
- [ ] `show interface * status`
- [ ] `show interface * description`
- [ ] `show interface * capabilities`
- [ ] `show interface * statistics`
- [ ] `show interface * switchport`
- [ ] `show interface * transceiver` (with and without an SFP+ module)
- [ ] `show interface vlan`
- [ ] `show ip interface brief`
- [ ] `show ipv6 interface brief`
- [ ] `show ip arp`
- [ ] `show ip route`
- [ ] `show mac address-table`
- [ ] `show lldp neighbors` (with a neighbour)
- [ ] `show vlan`
- [ ] `show process load`
- [ ] `show thermal-protect`
- [ ] `show green-ethernet fan`
- [ ] `show snmp`
- [ ] `show snmp community`
- [ ] `show ntp status`
- [ ] `show users`
- [ ] `show ip dhcp server binding`, `show ip dhcp pool` (if the DHCP server is used)
- [ ] `show poe`, `show poe interface` (PoE models only)
- [ ] `show aggregation`, `show lacp`
- [ ] `show spanning-tree`
- [ ] `show logging`
- [ ] `show licenses`
- [ ] `show running-config`
- [ ] `show running-config all-defaults`