saschabach
/
gplx
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

style: Improve formatting in IONOS VPS deployment runbook for better readability

This commit is contained in:
Sascha 2026-06-05 17:13:15 +02:00
parent 4923c0771a
commit 9ca73776bb
1 changed files with 21 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/DEPLOYMENT_IONOS_VPS_RUNBOOK.md
View File

@ -8,16 +8,16 @@ Use it verbatim for a repeat deployment or hand it to another AI assistant.
## Environment ## Environment
| Item | Value | | Item | Value |
|-----------------|-------------------------------| | -------------------- | -------------------------------- |
| Server IP | `31.70.94.35` | | Server IP | `31.70.94.35` |
| OS | Ubuntu 24.04 LTS | | OS | Ubuntu 24.04 LTS |
| Web root | `/var/www/gplx/mediawiki` | | Web root | `/var/www/gplx/mediawiki` |
| Git bare repo | `/var/repo/gplx.git` | | Git bare repo | `/var/repo/gplx.git` |
| DB name/user | `gplx` / `gplx` | | DB name/user | `gplx` / `gplx` |
| MW admin user | `Gxplex_admin` | | MW admin user | `Gxplex_admin` |
| MW admin pass | `TempAdmin123` ← **change this** | | MW admin pass | `TempAdmin123` ← **change this** |
| HTTP Basic Auth user | `testUser` | | HTTP Basic Auth user | `testUser` |
--- ---
@ -338,14 +338,14 @@ php maintenance/run.php changePassword --user="Benutzername" --password="NeuesPa
## Gotchas encountered ## Gotchas encountered
| Problem | Cause | Fix | | 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 | | `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 | | `/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` | | 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 | | `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 | | `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` | | 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` | | 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 | | 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 | | `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 |