docs: INSTALL.md - erster Sprung auf 4.5.0 nutzt das Werkzeug aus dem neuen Tarball (#7)

Files changed: - INSTALL.md
2026-09-04 12:52:43 +02:00
parent 0ba94c63d1
commit d4cbeca5a8
1 changed files with 14 additions and 0 deletions
@@ -195,6 +195,20 @@ dem sich jede Instanz mitten im Upgrade befindet.
   tools/wikitool dist upgrade <tarball-oder-verzeichnis> --dry-run
   ```

+   **Beim ersten Sprung auf `4.5.0` oder höher gibt es dieses Kommando in der Instanz noch
+   nicht** - es kam erst mit `4.5.0`. Dann das Werkzeug aus dem entpackten *neuen* Tarball
+   verwenden, gegen die alte Instanz gerichtet:
+
+   ```bash
+   tar -xzf chemenu-stack-<version>.tar.gz
+   CHEMENU_ROOT="$PWD" chemenu-stack-<version>/tools/wikitool \
+     dist upgrade chemenu-stack-<version>.tar.gz --dry-run
+   ```
+
+   `CHEMENU_ROOT` sagt dem Paket, auf welchen Korpus es zeigen soll (siehe § Konfiguration);
+   ohne die Variable würde es den entpackten Tarball selbst für die Instanz halten. Ab dem
+   zweiten Upgrade trägt die Instanz das Kommando selbst und die kurze Form oben genügt.
+
   Klassifiziert jede Datei aus dem `files`-Block der neuen `.wikitool-release.json`:
   unverändert seit der Installation, lokal verändert oder gelöscht, neu im Release, oder aus dem
   Release entfallen - und druckt die Migrationskette, die nach dem Tausch aussteht, ohne sie