- Shell 93.2%
- Jinja 6.8%
Add firmware upgrade documentation and helper script for upgrading Cisco Catalyst 2960G from LANBASE 12.2(35)SE5 (no SSH) to LANBASE-K9 12.2(50)SE5 or 12.2(55)SE12 (SSH-enabled). Found working K9 images on archive.org: - c2960-lanbasek9-mz.122-50.SE5 (~11.8 MB tar) - c2960-lanbasek9-tar.122-55.SE12 (~13.8 MB tar) Add: - docs/FIRMWARE-UPGRADE.md: upgrade guide with direct download URLs, checksums, XMODEM/TFTP procedures, rollback plan - docs/FIRMWARE-UPGRADE-CHECKLIST.md: step-by-step checklist - scripts/cisco-firmware-upgrade: download, verify checksums, extract .bin from tar, print next steps WARNING: Cisco IOS is copyrighted software. archive.org items are user-uploaded mirrors, not official Cisco distribution. |
||
|---|---|---|
| .opencode/skills/cisco-console-relay | ||
| configs | ||
| docs | ||
| iac | ||
| scripts | ||
| .gitignore | ||
| AGENTS.md | ||
| DEVELOPER.md | ||
| GUIDELINES.md | ||
| README.md | ||
Cisco Catalyst 2960G — Recovery & Provisioning
Recovery and homelab provisioning of a Cisco Catalyst WS-C2960G-24TC-L switch for small-business production use.
Quick Links
- AGENTS.md — Agent instruction file (concise, tool-centric — read this first)
- GUIDELINES.md — Tool mandates, workflow, safety rules
- DEVELOPER.md — Developer setup, architecture, troubleshooting
- docs/cisco_homelab_setup_guide.tex — Canonical setup and recovery procedure (LaTeX)
- docs/console-troubleshooting.md — Bring-up state, tests performed, next steps
- docs/recovery-plan.md — Current recovery plan with remote-relay architecture
- docs/wiring-rj45-db9-x86.md — Detailed RJ45-to-DB9 wiring for Debian x86 console server
- docs/BUYING-GUIDE.md — Console hardware buying guide (options, prices, wiring)
- docs/ARCHITECTURE.md — All possible console connection architectures
- docs/RECOVERY-STATE.md — Current state of the switch recovery
Architecture
The agent runs in an LXC container on a server. The serial console cable is physically connected to the user's laptop (ssh root@10.8.0.11). All console access goes through SSH — the tmux+picocom session lives on the laptop.
LXC (agent) --ssh--> laptop (10.8.0.11) --tmux+picocom--> /dev/ttyUSB1 --cable--> switch CONSOLE port
Console Relay
Use scripts/cisco-console from the repository root. All commands are executed on the laptop via SSH from the LXC:
ssh root@10.8.0.11 "cd /root/cisco-2960g && ./scripts/cisco-console start /dev/ttyUSB1 9600"
ssh root@10.8.0.11 "cd /root/cisco-2960g && ./scripts/cisco-console send 'show version'"
ssh root@10.8.0.11 "cd /root/cisco-2960g && ./scripts/cisco-console capture 200"
ssh root@10.8.0.11 "cd /root/cisco-2960g && ./scripts/cisco-console stop"
RS-232 Level Warning
The Cisco 2960G console port is RS-232 (±12V). Direct 5V TTL from the FTDI adapter does not work and risks damaging the FTDI. Use a MAX3232 RS-232↔TTL transceiver or a USB-to-RS232 adapter in-line before connecting to the switch console.
Safety
Ask for confirmation before destructive or state-changing switch commands. Never commit credentials, serial numbers, or console logs.