fix Failover→Fallback naming and missing/stale script references

Failover/ was renamed to Fallback/ — all script paths and README links
updated across README.md, Orchestrators README, and User Script Plug-in README.

array_start.sh → array_started.sh in Orchestrators scripts table (wrong name).

fallback_state_reset.sh: script is referenced in User Script Plug-in README
but does not exist in Fallback/. Entry updated to document it as not yet built
and provides the manual workaround (direct state file write).

Note: /mnt/user/appdata-Failover/ share path references left unchanged —
that is the actual unRAID share name on the server, not the script folder.
This commit is contained in:
Gmer4Lfe
2026-05-22 21:47:03 -04:00
parent 8b0ee44b65
commit 8d72fbf0e2
3 changed files with 20 additions and 25 deletions
+2 -2
View File
@@ -166,7 +166,7 @@ without `--log`.
| Script | What It Orchestrates | Schedule | | Script | What It Orchestrates | Schedule |
|--------|---------------------|----------| |--------|---------------------|----------|
| `array_start.sh` | All array startup scripts in order | At Startup of Array | | `array_started.sh` | All array startup scripts in order | At Startup of Array |
| `watchdog_orchestrator.sh` | resource → docker → system → stability watchdogs | Every minute | | `watchdog_orchestrator.sh` | resource → docker → system → stability watchdogs | Every minute |
| `transcode_management.sh` | Cleanup then manager — order critical | Every 3 minutes | | `transcode_management.sh` | Cleanup then manager — order critical | Every 3 minutes |
| `arrs_failed_stalled_recovery.sh` | Failed import + stalled download recovery | Every 6 hours | | `arrs_failed_stalled_recovery.sh` | Failed import + stalled download recovery | Every 6 hours |
@@ -222,7 +222,7 @@ ARRAY_START_SCRIPTS=(
"Watchdogs/docker_watchdog.sh" # container health BEFORE failover — "Watchdogs/docker_watchdog.sh" # container health BEFORE failover —
# containers must be healthy for failover # containers must be healthy for failover
# to make reliable decisions # to make reliable decisions
"Failover/failover.sh" # failover LAST — needs everything else stable "Fallback/fallback.sh" # fallback LAST — needs everything else stable
) )
``` ```
+16 -21
View File
@@ -675,7 +675,7 @@ Background: NO (runs and exits — status check)
```bash ```bash
#!/bin/bash #!/bin/bash
/mnt/user/appdata/unraid_scripts/Failover/failover.sh --status /mnt/user/appdata/unraid_scripts/Fallback/fallback.sh --status
``` ```
**What it does:** **What it does:**
@@ -700,7 +700,7 @@ Background: YES — test takes several minutes
```bash ```bash
#!/bin/bash #!/bin/bash
/mnt/user/appdata/unraid_scripts/Failover/failover_test.sh --dry-run /mnt/user/appdata/unraid_scripts/Fallback/fallback_test.sh --dry-run
``` ```
**What it does:** **What it does:**
@@ -721,31 +721,26 @@ Change `--dry-run` to nothing and run during a maintenance window.
--- ---
### ── failover_state_reset ──────────────────────────────────────────────────── ### ── fallback_state_reset ────────────────────────────────────────────────────
``` > **Not yet built.** `fallback_state_reset.sh` is a planned utility — not in `Fallback/` yet.
Category: Failover >
Name: failover_state_reset > **Manual workaround** when state file is stuck in FAILOVER after a failed test or
Schedule: None — run manually (after testing or failed handback) > forced kill of fallback.sh:
Background: NO > ```bash
``` > # Verify first — right containers on right server, DDNS correct, fallback.sh not running
> cat /boot/config/fallback_state.db
> echo "state=NORMAL" > /boot/config/fallback_state.db
> ```
> Resets state only — does NOT start or stop any containers.
```bash **When you need this:**
#!/bin/bash
/mnt/user/appdata/unraid_scripts/Failover/failover_state_reset.sh --status
```
**What it does:**
Shows current state file then prompts for confirmation before resetting to NORMAL.
Resets state file only — does NOT start or stop any containers.
**When to use:**
State file stuck in FAILOVER after a test that didn't complete cleanly. After killing State file stuck in FAILOVER after a test that didn't complete cleanly. After killing
failover.sh directly (not via plugin Abort button). After a failed handback. fallback.sh directly (not via plugin Abort button). After a failed handback.
**Verify before resetting:** **Verify before resetting:**
Right containers on right server. DDNS correct (`nslookup Gmer4Lfe.com`). Right containers on right server. DDNS correct (`nslookup Gmer4Lfe.com`).
Both servers Tailscale connected. failover.sh not currently running. Both servers Tailscale connected. fallback.sh not currently running.
--- ---
+2 -2
View File
@@ -403,7 +403,7 @@ The DDNS sequencing is critical — one domain, one DDNS container, at all times
handback sequence stops remote DDNS first, rsyncs, starts containers, starts local handback sequence stops remote DDNS first, rsyncs, starts containers, starts local
DDNS last. Split-brain DNS is prevented by design. DDNS last. Split-brain DNS is prevented by design.
**→ Full detail: [README-Failover.md](Failover/README-Failover.md)** **→ Full detail: [README-Fallback.md](Fallback/README-Fallback.md)**
--- ---
@@ -710,7 +710,7 @@ If you're setting this up from scratch on two servers:
| README | What It Covers | | README | What It Covers |
|--------|---------------| |--------|---------------|
| [README-Failover.md](Failover/README-Failover.md) | DDNS sequencing, tiered failover, handback, split brain prevention, failover_test.sh | | [README-Fallback.md](Fallback/README-Fallback.md) | DDNS sequencing, tiered fallback, handback, split brain prevention, fallback_test.sh |
| [README-Docker_Essentials.md](Docker_Essentials/README-Docker_Essentials.md) | Two-tier container watchdog, memory limits, dependency ordering, skip list, daily/weekly restarts | | [README-Docker_Essentials.md](Docker_Essentials/README-Docker_Essentials.md) | Two-tier container watchdog, memory limits, dependency ordering, skip list, daily/weekly restarts |
| [README-Unraid_Essentials.md](unRAID_Essentials/README-Unraid_Essentials.md) | Three-tier system watchdog, WebGUI recovery, inotify tuning, PHP-FPM, log hygiene | | [README-Unraid_Essentials.md](unRAID_Essentials/README-Unraid_Essentials.md) | Three-tier system watchdog, WebGUI recovery, inotify tuning, PHP-FPM, log hygiene |
| [README-Orchestrators.md](Orchestrators/README-Orchestrators.md) | What runs when, execution order, daily/weekly windows, adding jobs | | [README-Orchestrators.md](Orchestrators/README-Orchestrators.md) | What runs when, execution order, daily/weekly windows, adding jobs |