Differences

This shows you the differences between two versions of the page.

--- servers:ubuntu24:dokuwiki [2026/02/19 16:16] – freedomotter
+++ servers:ubuntu24:dokuwiki [2026/02/19 16:18] (current) – freedomotter
@@ Line 83: / Line 83: @@
 lib/plugins/
 </code>
+If plugin errors occur:
+<code bash>
+sudo chown -R www-data:www-data data conf lib/plugins
+</code>
+----
+===== nginx Notes =====
+Typical PHP handler block:
+<code nginx>
+location ~ \.php$ {
+    include snippets/fastcgi-php.conf;
+    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
+}
+</code>
+After changes:
+<code bash>
+sudo nginx -t
+sudo systemctl reload nginx
+</code>
+----
+===== Common Problems =====
+==== SQLite PDO driver not available ====
+Error:
+<code>
+Exception: SQLite PDO driver not available
+</code>
+Fix:
+<code bash>
+sudo apt install php8.3-sqlite3
+sudo systemctl restart php8.3-fpm
+</code>
+Verify:
+<code bash>
+php -m | grep sqlite
+</code>
+----
+==== Blank page or plugin crashes ====
+Check logs:
+<code bash>
+tail -f /var/log/nginx/error.log
+tail -f /var/www/html/amigaz/wiki/data/log/error.log
+</code>
+Restart PHP:
+<code bash>
+sudo systemctl restart php8.3-fpm
+</code>
+----
+==== After PHP upgrade, wiki breaks ====
+Symptoms:
+  * Tag search stops working
+  * Plugins fail
+  * White pages
+Cause:
+PHP modules for the new version are missing.
+Fix example (after upgrade to 8.4):
+<code bash>
+sudo apt install php8.4-fpm php8.4-sqlite3 php8.4-xml php8.4-mbstring php8.4-gd php8.4-curl php8.4-intl php8.4-zip
+sudo systemctl restart php8.4-fpm
+</code>
+----
+===== Upgrade Checklist =====
+Before upgrade:
+<code bash>
+cd /var/www/html/amigaz
+tar -czf wiki-backup.tar.gz wiki
+</code>
+After PHP or system upgrade:
+. Verify PHP version
+<code bash>
+php -v
+</code>
+. Reinstall modules for that version
+<code bash>
+sudo apt install phpX.Y-sqlite3 phpX.Y-xml phpX.Y-mbstring phpX.Y-gd phpX.Y-curl phpX.Y-intl phpX.Y-zip
+</code>
+. Restart PHP
+<code bash>
+sudo systemctl restart phpX.Y-fpm
+</code>
+. Test wiki search and plugins
+----
+===== Quick Recovery Steps =====
+If the wiki is broken:
+. Check PHP-FPM status
+<code bash>
+systemctl status php8.3-fpm
+</code>
+. Restart services
+<code bash>
+systemctl restart php8.3-fpm
+systemctl reload nginx
+</code>
+. Check error logs
+<code bash>
+tail -n 50 /var/log/nginx/error.log
+tail -n 50 /var/www/html/amigaz/wiki/data/log/error.log
+</code>
+. Verify SQLite module
+<code bash>
+php -m | grep sqlite
+</code>
+----
+===== Useful Commands =====
+<code bash>
+nginx -T
+systemctl restart php8.3-fpm
+systemctl reload nginx
+php -v
+php -m
+df -h
+</code>