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:
@@ -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
|
||||||
)
|
)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -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 |
|
||||||
|
|||||||
Reference in New Issue
Block a user