From 9ca73776bb50397c10771139dabac73a13afcae4 Mon Sep 17 00:00:00 2001 From: Sascha Date: Fri, 5 Jun 2026 17:13:15 +0200 Subject: [PATCH] style: Improve formatting in IONOS VPS deployment runbook for better readability --- docs/DEPLOYMENT_IONOS_VPS_RUNBOOK.md | 42 ++++++++++++++-------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/DEPLOYMENT_IONOS_VPS_RUNBOOK.md b/docs/DEPLOYMENT_IONOS_VPS_RUNBOOK.md index 6d57157..0956ed8 100644 --- a/docs/DEPLOYMENT_IONOS_VPS_RUNBOOK.md +++ b/docs/DEPLOYMENT_IONOS_VPS_RUNBOOK.md @@ -8,16 +8,16 @@ Use it verbatim for a repeat deployment or hand it to another AI assistant. ## Environment -| Item | Value | -|-----------------|-------------------------------| -| Server IP | `31.70.94.35` | -| OS | Ubuntu 24.04 LTS | -| Web root | `/var/www/gplx/mediawiki` | -| Git bare repo | `/var/repo/gplx.git` | -| DB name/user | `gplx` / `gplx` | -| MW admin user | `Gxplex_admin` | -| MW admin pass | `TempAdmin123` ← **change this** | -| HTTP Basic Auth user | `testUser` | +| Item | Value | +| -------------------- | -------------------------------- | +| Server IP | `31.70.94.35` | +| OS | Ubuntu 24.04 LTS | +| Web root | `/var/www/gplx/mediawiki` | +| Git bare repo | `/var/repo/gplx.git` | +| DB name/user | `gplx` / `gplx` | +| MW admin user | `Gxplex_admin` | +| MW admin pass | `TempAdmin123` ← **change this** | +| HTTP Basic Auth user | `testUser` | --- @@ -338,14 +338,14 @@ php maintenance/run.php changePassword --user="Benutzername" --password="NeuesPa ## Gotchas encountered -| Problem | Cause | Fix | -|---------|-------|-----| -| `git push ionos main` failed (exit 1) | Remote pointed at non-bare working dir | Created bare repo at `/var/repo/gplx.git` with post-receive hook | -| `/var/www/gplx/mediawiki` not found after push | Directory was checked out by hook — actually worked, just needed to look again | `ls /var/www/gplx/mediawiki` confirmed it was there | -| SMW fatal: `Class "Onoi\Cache\NullCache" not found` | SMW vendor deps not installed | `composer install --no-dev -d extensions/SemanticMediaWiki` | -| `update.php`: "Can not upgrade from versions older than 1.35" | Completely empty DB — MW misreads it | Use `install.php` with `LocalSettings.php` temporarily moved away | -| `install.php`: "A LocalSettings.php file has been detected" | Installer refuses when file exists | `mv LocalSettings.php LocalSettings.php.bak` before install, restore after | -| Apache won't start | nginx was holding port 80 | `systemctl stop nginx && systemctl disable nginx` | -| Basic Auth not blocking (returns 200 for anonymous) | `Require all granted` + `Require valid-user` = OR logic | Remove `Require all granted`; only keep `Require valid-user` | -| DB "Access denied for user gplx" | Password in LocalSettings.php didn't match DB | `ALTER USER 'gplx'@'localhost' IDENTIFIED BY '...'` to sync them | -| `ERROR 1050: Table 'actor' already exists` on SQL import | Fresh MW install already created tables; importing on top fails | `DROP DATABASE gplx` + recreate, then import | +| Problem | Cause | Fix | +| ------------------------------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | +| `git push ionos main` failed (exit 1) | Remote pointed at non-bare working dir | Created bare repo at `/var/repo/gplx.git` with post-receive hook | +| `/var/www/gplx/mediawiki` not found after push | Directory was checked out by hook — actually worked, just needed to look again | `ls /var/www/gplx/mediawiki` confirmed it was there | +| SMW fatal: `Class "Onoi\Cache\NullCache" not found` | SMW vendor deps not installed | `composer install --no-dev -d extensions/SemanticMediaWiki` | +| `update.php`: "Can not upgrade from versions older than 1.35" | Completely empty DB — MW misreads it | Use `install.php` with `LocalSettings.php` temporarily moved away | +| `install.php`: "A LocalSettings.php file has been detected" | Installer refuses when file exists | `mv LocalSettings.php LocalSettings.php.bak` before install, restore after | +| Apache won't start | nginx was holding port 80 | `systemctl stop nginx && systemctl disable nginx` | +| Basic Auth not blocking (returns 200 for anonymous) | `Require all granted` + `Require valid-user` = OR logic | Remove `Require all granted`; only keep `Require valid-user` | +| DB "Access denied for user gplx" | Password in LocalSettings.php didn't match DB | `ALTER USER 'gplx'@'localhost' IDENTIFIED BY '...'` to sync them | +| `ERROR 1050: Table 'actor' already exists` on SQL import | Fresh MW install already created tables; importing on top fails | `DROP DATABASE gplx` + recreate, then import |