Files

T

dohertj2 5a4da57457 Decommission the old Plex VM

Plex has run as a container on the Docker host since the 2026-09-16
migration. The old Debian 11 VM (10.100.0.24) is now retired per
plex-docker-migration.md section 9, steps 1, 2 and 4-7:

- removed from the Veeam "Backup VMs" job
- guest shut down gracefully, pre-migration snapshot removed and
  consolidated back to Plex.vmdk
- Guacamole "Plex SSH" connection deleted
- .24 / 10.50.0.31 DHCP leases released on the UDM

The VMDKs are deliberately kept until ~2026-10-15 so the VM remains a
one-command rollback; step 3 stays open until then.

Before powering the VM off, every integration was re-verified as
pointing at 10.100.0.35: Sonarr, Radarr, Tautulli, seerr, Uptime Kuma,
Homepage, Traefik and the UDM PLEX port-forward.

Section 9 gains a decommission log recording two behaviours that cost
time to work out: Veeam turns a removed job include into an explicit
Exclude tombstone rather than deleting it, and a plain sqlite3
integrity_check on a Plex library DB fails with "unknown tokenizer:
collating" because the stock binary lacks Plex's FTS collation - that
is not corruption.

ESXi port-group counts corrected (LAN_100 7->6, DATA_50 4->3), verified
by counting NICs on powered-on VMs.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-17 12:04:45 -04:00

2.1 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Purpose

netfix is a diagnostic/debugging toolkit for troubleshooting network connectivity between VMs running on an ESXi hypervisor host and an external client, connected through Unifi network switches.

Environment Context

Hypervisor: VMware ESXi
Network infrastructure: Ubiquiti Unifi switches
Debugging scope: VM-to-external-client connectivity issues across the ESXi virtual switch and physical Unifi switch layers

Credentials

Credentials live inline in each component's .md file under its Access section. Read the relevant doc to find them.

Components

TrueNAS Server — NAS at 10.100.0.25 (management) / 10.50.0.x (storage), serves SMB and NFS
ESXi Host — HP server at 10.2.0.12, ESXi 8.0.3, 8 VMs (6 powered on), access via govc only (not SSH). Read esxi.md for credentials and connection details.
Docker Server — Debian 13 at 10.100.0.35, Docker host for 21 containers (arr stack, Traefik, Semaphore/Ansible). This is the local machine.
Plex Server — container on the Docker host (10.100.0.35) since 2026-09-16, Plex Media Server 1.43, NFS media from TrueNAS. Old Debian 11 VM decommissioned 2026-09-17 (powered off, disks retained until ~2026-10-15).
Home Assistant — HAOS at 10.100.0.40, HA 2026.2.2, 2,411 entities, smart home automation. API access only (no SSH).
Ignition Gateway — Debian 11 at 10.100.0.90, Ignition 8.3.3 (Maker), SCADA/IIoT platform with PostgreSQL 13
Veeam Server — Windows Server 2025 at 10.100.0.30, Veeam B&R 12.3, backup server. Read veeam.md for credentials and connection details.
Desktop — Windows PC, dual-homed on LAN_100 (10.100.0.49) and DATA_50 (10.50.0.49)
Wonderware Dev VM — Windows 10 ESXi VM at 10.100.0.48, OpenSSH (passwordless)
Unifi Network — UDM Pro gateway + USW Pro Aggregation central switch, API access via key