Skip to content

Commit 90d2637

Browse files
Update oxidized version to 0.35.0 and improve model documentation
- Update all version references from 0.30.1 to 0.35.0 across documentation - Add tplink model example to router.db.template with warning about hyphen - Add troubleshooting section for model naming errors (tp-link vs tplink) - Update version history in UPGRADE.md to reflect current version - Update DECISIONS.md to reflect version pinning decision for 0.35.0 - Add CUSTOM-MODELS.md documentation for custom model installation - Fix model name examples to prevent common mistakes
1 parent 2d8a170 commit 90d2637

14 files changed

Lines changed: 423 additions & 42 deletions

DEVICE-MANAGEMENT.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1150,6 +1150,34 @@ tail -f /var/lib/oxidized/data/oxidized.log | grep -i "cipher\|algorithm\|ssh"
11501150
2. Try similar model (e.g., `ios` for many Cisco devices)
11511151
3. Check Oxidized documentation for custom models
11521152

1153+
**Model Name Errors (Device Not Showing in Web UI):**
1154+
1155+
If a device is in `router.db` but not appearing in the web UI, check for model name errors:
1156+
1157+
1. **Check logs for ModelNotFound errors:**
1158+
```bash
1159+
sudo tail -50 /var/lib/oxidized/data/oxidized.log | grep -i "modelnotfound\|unknown model"
1160+
```
1161+
1162+
2. **Common mistakes:**
1163+
-`tp-link` (with hyphen) → ✅ `tplink` (no hyphen)
1164+
-`Cisco-IOS` → ✅ `ios` (lowercase, no hyphen)
1165+
-`Juniper` → ✅ `junos` (specific model name)
1166+
1167+
3. **Verify model name:**
1168+
- Model names are case-sensitive and must match exactly
1169+
- Check official model list: https://github.com/ytti/oxidized/tree/master/lib/oxidized/model
1170+
- Model file name = model name (e.g., `tplink.rb` → use `tplink`)
1171+
1172+
4. **Fix:**
1173+
```bash
1174+
# Edit router.db
1175+
sudo vim /var/lib/oxidized/config/router.db
1176+
# Correct the model name (e.g., change tp-link to tplink)
1177+
# Restart service
1178+
sudo systemctl restart oxidized.service
1179+
```
1180+
11531181
---
11541182

11551183
## Validation Tools
@@ -1463,4 +1491,4 @@ sudo rm /var/lib/oxidized/config/router.db.backup.*
14631491
---
14641492

14651493
**Last Updated:** 2026-01-18
1466-
**Oxidized Version:** 0.30.1
1494+
**Oxidized Version:** 0.35.0

DIRECTORY-STRUCTURE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -520,4 +520,4 @@ ls -la /var/lib/oxidized/config/output/
520520
---
521521

522522
**Last Updated:** 2026-01-18
523-
**Oxidized Version:** 0.30.1
523+
**Oxidized Version:** 0.35.0

README-OXIDIZED.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1071,7 +1071,7 @@ If an upgrade causes issues:
10711071

10721072
2. **Update `.env` to previous version**:
10731073
```bash
1074-
OXIDIZED_IMAGE="docker.io/oxidized/oxidized:0.30.1" # Previous version
1074+
OXIDIZED_IMAGE="docker.io/oxidized/oxidized:0.35.0" # Previous version
10751075
```
10761076

10771077
3. **Re-deploy**:
@@ -1133,7 +1133,7 @@ sudo cat /var/lib/oxidized/config/config
11331133
ls -la /var/lib/oxidized/
11341134

11351135
# Pull image manually
1136-
sudo podman pull docker.io/oxidized/oxidized:0.30.1
1136+
sudo podman pull docker.io/oxidized/oxidized:0.35.0
11371137
```
11381138

11391139
#### Devices Not Backing Up

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ configurations, tracks changes using Git, and supports 130+ device models.
104104
│ │ systemd (Quadlets) │ │
105105
│ │ │ │
106106
│ │ ┌──────────────────────────────────────────────┐ │ │
107-
│ │ │ Podman Container (oxidized:0.30.1) │ │ │
107+
│ │ │ Podman Container (oxidized:0.35.0) │ │ │
108108
│ │ │ │ │ │
109109
│ │ │ 🤖 Oxidized Service │ │ │
110110
│ │ │ ├─ REST API (port 8888) │ │ │
@@ -425,7 +425,7 @@ OXIDIZED_ROOT="/var/lib/oxidized"
425425

426426
# Container image (pinned version)
427427

428-
OXIDIZED_IMAGE="docker.io/oxidized/oxidized:0.30.1"
428+
OXIDIZED_IMAGE="docker.io/oxidized/oxidized:0.35.0"
429429

430430
# Device credentials (global defaults)
431431

0 commit comments

Comments
 (0)