From c10c5495be191fe227e5957db97cb4a66db09fa9 Mon Sep 17 00:00:00 2001 From: bkil Date: Sat, 25 Mar 2023 14:30:29 +0100 Subject: [PATCH 1/4] doc/Improve-Performance.md: replace old links with updated GitHub ones --- doc/Improve-Performance.md | 2 +- doc/de/FAQ-admin.md | 2 +- doc/de/Improve-Performance.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/Improve-Performance.md b/doc/Improve-Performance.md index 79490c257..1d0a859f1 100644 --- a/doc/Improve-Performance.md +++ b/doc/Improve-Performance.md @@ -81,6 +81,6 @@ Please refer to external documentation for a more detailed explanation how to se ### Database -There are scripts like [tuning-primer.sh](http://www.day32.com/MySQL/) and [mysqltuner.pl](http://mysqltuner.pl) that analyze your database server and give hints on values that could be changed. +There are scripts like [tuning-primer.sh](https://github.com/BMDan/tuning-primer.sh) and [mysqltuner.pl](https://github.com/major/MySQLTuner-perl/blob/master/mysqltuner.pl) that analyze your database server and give hints on values that could be changed. Please enable the slow query log. This helps to find performance problems. diff --git a/doc/de/FAQ-admin.md b/doc/de/FAQ-admin.md index f9cd14929..5b355e142 100644 --- a/doc/de/FAQ-admin.md +++ b/doc/de/FAQ-admin.md @@ -27,7 +27,7 @@ Der Quellcode von Friendica Red ist [hier](https://github.com/friendica/red) zu Addons findest Du auf [dieser Seite](https://github.com/friendica/friendica-addons). -Wenn Du neue Themen suchst, findest Du sie auf [Friendica-Themes.com](http://friendica-themes.com/). +Wenn Du neue Themen suchst, findest Du sie auf [github.com/bkil/friendica-themes](https://github.com/bkil/friendica-themes). ### Ich habe meine E-Mail Adresse geändern und jetzt ist das Admin Panel verschwunden? diff --git a/doc/de/Improve-Performance.md b/doc/de/Improve-Performance.md index d9be4fca6..df90437e7 100644 --- a/doc/de/Improve-Performance.md +++ b/doc/de/Improve-Performance.md @@ -95,6 +95,6 @@ Nutze externe Dokumente, um eine detailiertere Erklärung für die Einrichtung e ### Database -Es gibt Skripte wie [tuning-primer.sh](http://www.day32.com/MySQL/) und [mysqltuner.pl](http://mysqltuner.pl), die den Datenbankserver analysieren und Hinweise darauf geben, welche Werte verändert werden könnten. +Es gibt Skripte wie [tuning-primer.sh](https://github.com/BMDan/tuning-primer.sh) und [mysqltuner.pl](https://github.com/major/MySQLTuner-perl/blob/master/mysqltuner.pl), die den Datenbankserver analysieren und Hinweise darauf geben, welche Werte verändert werden könnten. Aktivere hierfür die "Slow query" Log-Datei, um Performanceprobleme zu erkennen. From 10687244be96817728b968c1980c84633cdb6cbe Mon Sep 17 00:00:00 2001 From: bkil Date: Sat, 25 Mar 2023 14:31:11 +0100 Subject: [PATCH 2/4] doc/Install.md: link to guides for Ubuntu 22.04, systemd and Unraid --- doc/Install.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/doc/Install.md b/doc/Install.md index d0c3576ac..6b1fff914 100644 --- a/doc/Install.md +++ b/doc/Install.md @@ -51,10 +51,13 @@ For alternative server configurations (such as Nginx server and MariaDB database ### Alternative Installation Methods This guide will walk you through the manual installation process of Friendica. -If this is nothing for you, you might be interested in +If this is nothing for you, you might be interested in the following: -* the [Friendica Docker image](https://github.com/friendica/docker) or -* how to [install Friendica with YunoHost](https://github.com/YunoHost-Apps/friendica_ynh). +* the [Friendica Docker image](https://github.com/friendica/docker) +* how to [install Friendica with YunoHost](https://github.com/YunoHost-Apps/friendica_ynh) +* [Tutorial: Creating a Friendica Server with Ubuntu 22.04](https://nequalsonelifestyle.com/2022/07/30/creating-friendica-server-ubuntu/) + * [Setting Up Friendica Daemon as a Systemd Service Tutorial](https://nequalsonelifestyle.com/2022/08/04/setting-up-friendica-daemon-systemd-service/) +* [Setting up Friendica on Unraid](https://www.jenovarain.com/2023/03/setting-up-friendica-on-unraid/) (NAS) ### Get Friendica From 60a719cffa9a08a024d075fc4037f986130d7267 Mon Sep 17 00:00:00 2001 From: bkil Date: Sat, 25 Mar 2023 14:34:26 +0100 Subject: [PATCH 3/4] doc/Install.md: more troubleshooting config keys for previous entries --- doc/Install.md | 31 ++++++++++++++++++++++++------- 1 file changed, 24 insertions(+), 7 deletions(-) diff --git a/doc/Install.md b/doc/Install.md index 6b1fff914..de4ef1b65 100644 --- a/doc/Install.md +++ b/doc/Install.md @@ -466,9 +466,11 @@ After that, restart mysql and try again. ### Your worker never or rarely runs -Friendica is coded to always play nice. It checks whether the host machine is idle enough and if it _seems_ to be overloaded, it intermittently refuses to process the worker queue. +Friendica is coded to always play nice. +It checks whether the host machine is idle enough and if it _seems_ to be overloaded, it intermittently refuses to process the worker queue. -Such checks originate from the days of single-user single-core machines and involves thresholds that you should adjust based on the number of exclusive CPU cores you have. See this issue for more information: +Such checks originate from the days of single-user single-core machines and involves thresholds that you should adjust based on the number of exclusive CPU cores you have. +See this issue for more information: * https://github.com/friendica/friendica/issues/10131 @@ -485,28 +487,40 @@ You tried to upload an image up to 100kB and it failed. You may not have the ownership or file mode set correctly if you are using the file system storage backend. -Change the backend to database. If this solves it, that is what needs to be fixed. +Change the backend to database. +If this solves it, that is what needs to be fixed. + +Verify in your PHP ini: + +* `file_uploads`: should be `1` +* `upload_tmp_dir`: should be writable (falls back to system default temp) and not blocked by `open_basedir` ### Error uploading large files You may find `413 Request Entity Too Large` or `500 Internal Error` in the network inspector of the browser if the file is too large, for example if it is a video. -First try to upload a very small file, up to 100kB. If that succeeds, you will need to increase limits at multiple places, including on any web proxy that you are using. +First try to upload a very small file, up to 100kB. +If that succeeds, you will need to increase limits at multiple places, including on any web proxy that you are using. +Which one applies to you depends on your installation. In your PHP ini: * `upload_max_filesize`: defaults to 2MB * `post_max_size`: defaults to 8MB, must be greater than `upload_max_filesize` * `memory_limit`: defaults to 128MB, must be greater than `post_max_size` +* `max_input_time`: time limit of an upload, defaults to -1, meaning it uses `max_execution_time` instead +* `max_execution_time`: defaults to 30 seconds, should be enough if you also set `max_input_time` You should verify whether you changed them in the _right file_ by checking the web interface at the end of the overview on the `Admin` panel. -For Apache2: +In your Apache2 config: * `LimitRequestBody`: defaults to unlimited +* `FcgidMaxRequestLen`: defaults to 128kB * `SSLRenegBufferSize`: defaults to 128kB, only if your site uses TLS and perhaps only when using `SSLVerifyClient` or `SSLVerifyDepth` +* Remove `LoadModule reqtimeout_module modules / mod_reqtimeout.so` or adjust `RequestReadTimeout`: defaults to 20 seconds and >= 500 byte/second -For nginx: +In your nginx config: * `client_max_body_size`: defaults to 1MB @@ -514,7 +528,10 @@ If you are using the database backend for storage, increase this in your SQL con * `max_allowed_packet`: defaults to 32MB -If you use the ModSecurity WAF: +In your ModSecurity WAF config: * `SecRequestBodyLimit`: defaults to 12MB * `SecRequestBodyNoFilesLimit`: defaults to 128kB, should not apply to Friendica + +In the end, you will need to restart all services that you have changed configuration for. +If you don't know which ones these are, just reboot. From 0ed26d6258e1b2378e5021709b57fb0a50698d27 Mon Sep 17 00:00:00 2001 From: bkil Date: Sat, 25 Mar 2023 14:37:18 +0100 Subject: [PATCH 4/4] doc/Install.md: troubleshooting: Diaspora support, DB migration timeout --- doc/Install.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/Install.md b/doc/Install.md index de4ef1b65..51cddf453 100644 --- a/doc/Install.md +++ b/doc/Install.md @@ -535,3 +535,21 @@ In your ModSecurity WAF config: In the end, you will need to restart all services that you have changed configuration for. If you don't know which ones these are, just reboot. + +### Diaspora support is not activated + +You get this error when you try to add a Diaspora contact. + +You can enable it from the web interface in `Admin -> Site -> Policies -> Enable diaspora* support`. +You may also set it manually in the config file or in the database within the `diaspora_enabled` key of the `system` category. + +### Upgrade failed due to DB migration timeout + +Altering of a table may fail if it contains a large number of rows. +First verify the existing timeout (50s by default): + +`show global variables like "innodb_lock_wait_timeout";` + +Then increase it: + +`set global innodb_lock_wait_timeout=600;`