Commit Graph

102 Commits

Author SHA1 Message Date
495247ae4a standardize occ command documentation
Use `sudo -E -u www-data php occ` everywhere.
Motivation: this should work on more appliances like also inside docker containers.
Signed-off-by: Simon L. <szaimen@e.mail.de>
2025-04-29 13:21:08 +02:00
2f269adec6 feat: hello codespell
Signed-off-by: Daniel Kesselberg <mail@danielkesselberg.de>
2024-07-23 13:04:10 +02:00
377125a347 Update some outdated versions and links
Signed-off-by: Joas Schilling <213943+nickvergessen@users.noreply.github.com>
2024-03-16 19:50:34 +01:00
4fe91a6ed6 docs(admin): Emphasize recommended versions in db chapter (#11588)
Signed-off-by: Josh <josh.t.richards@gmail.com>
2024-02-27 17:21:25 -05:00
508aa2f1ef docs(admin): Clarify DB conversion steps and command usage (#11584)
Signed-off-by: Josh <josh.t.richards@gmail.com>
Co-authored-by: Joas Schilling <213943+nickvergessen@users.noreply.github.com>
2024-02-26 10:21:46 -05:00
b44a8da8e1 feat(adminmanual): Add db replica docs
Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
2024-01-17 18:40:42 +01:00
d07a30fc73 Database installation - MariaDB use mariadb / no FLUSH PRIVILEGES
MariaDB is deprecating off its mysql client usage (has been a symlink for a very long time).

FLUSH PRIVILEGES aren't required after any creation of users or grants. It has only two very specific meenings that aren't the case here; when credentials are directly changes in underlying tables using DML, or the server was started with --skip-grant-tables and this is ending that lack of priv scheme.

Signed-off-by: Daniel Black <daniel@mariadb.org>
2023-11-06 08:19:49 +11:00
529193a694 Merge pull request #9510 from nextcloud/bugfix/noid/improve-utf8-manual 2023-01-02 17:25:53 +01:00
fee809cb64 Improve UTF8 manual with older DB versions
Signed-off-by: Joas Schilling <coding@schilljs.com>
2023-01-02 07:23:10 +01:00
973565115c Adjust ROW_FORMAT note to changes in Nextcloud 24
Since Nextcloud 24 (nextcloud/server#e49233a79546) ROW_FORMAT is no
longer set to "COMPRESSED" when changing the character set of tables to
"utf8mb4" in the "Repair MySQL collation" repair step. However, that
repair step still sets the ROW_FORMAT to "DYNAMIC" before changing the
collation of tables, no matter the character set.

Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>
2022-12-23 19:15:03 +01:00
aac802569f address review
Co-authored-by: Vitor Mattos <vitor@php.rio>
Signed-off-by: Simon L. <szaimen@e.mail.de>
2022-10-27 13:06:42 +02:00
4c05d88d9c rework postgresql docs
Signed-off-by: szaimen <szaimen@e.mail.de>
2022-10-18 23:22:00 +02:00
2e882a59ee Update splitting.rst
typo

Signed-off-by: Fernando Ribeiro <fribeiro@fribeiro.org>
2022-10-03 21:54:47 +01:00
6eb005f994 docs: fix duplicated DB command and add missing 2022-05-04 07:56:12 +02:00
f38448b6bf Merge pull request #8089 from nextcloud/feature/8085/splitting-databases-for-scaling
Add admin docs for splitting databases
2022-02-22 16:00:48 +01:00
f610e0e742 Require optional database steps to be performed
Signed-off-by: Joas Schilling <coding@schilljs.com>
2022-02-22 15:27:58 +01:00
dc2460aeb5 Add admin docs for splitting databases
Signed-off-by: Joas Schilling <coding@schilljs.com>
2022-02-22 15:04:40 +01:00
4f15b44aa3 Update misleading/incorrect nouns in admin manual
Signed-off-by: Carl Csaposs <carl@csaposs.com>
2022-02-10 02:06:01 +00:00
37dcac99eb Fix "An Nextcloud" typo
Signed-off-by: Jani Uusitalo <jani@mummila.net>
2021-04-09 14:41:51 +03:00
564286ecaa Add note about when to enable SSL
As the manual currently reads it sounds like you should always enable SSL for your database. Added note explaining that is is only necessary when you connect remotely.
Since the default install for MariaDB or MySQL only allows communication on localhost through a unix socket, this will not need to be configured for most installs.
2021-01-23 14:38:58 -05:00
dfe90ce2e8 Adjust the manual to MySQL 8 required
Signed-off-by: Joas Schilling <coding@schilljs.com>
2021-01-15 11:47:28 +01:00
dcec6d6582 Admin manual: Fix another typo and missing value
- "skip_server_name" with underscores.
- Add "= 1" which was missing. Assuming that the previous author meant
  to enable this, since the default is 0.

Signed-off-by: Simon Westersund <swestersund@users.noreply.github.com>
2020-10-30 15:16:21 +02:00
f08de1c7b0 Admin manual: Fix typo in MySQL/MariaDB properties
- Change dashes to underscores in the property names. Verified the names
  via the following documentation pages:
  - MySQL: https://dev.mysql.com/doc/refman/8.0/en/server-option-variable-reference.html
  - MariaDB: https://mariadb.com/kb/en/server-system-variables/

Signed-off-by: Simon Westersund <swestersund@users.noreply.github.com>
2020-10-30 15:05:19 +02:00
e90372eb4b Update admin_manual/configuration_database/linux_database_configuration.rst 2020-10-28 15:30:49 +01:00
66d13f2d44 Update admin_manual/configuration_database/linux_database_configuration.rst
Co-authored-by: Morris Jobke <hey@morrisjobke.de>
2020-10-28 14:07:15 +01:00
b071977647 add mysql ssl config
add mysql ssl config
2020-10-28 12:54:58 +01:00
db8dcedaf2 Clarify on InnoDB file format
Signed-off-by: Morris Jobke <hey@morrisjobke.de>
2020-10-20 09:40:57 +02:00
122ed88e53 Update urls to HTTPS
Signed-off-by: J0WI <J0WI@users.noreply.github.com>
2020-09-17 20:33:30 +02:00
355bad4931 Add missing space
And remove unnecessary hyphen.
2020-08-18 09:04:54 +02:00
6033245489 Continue at step 3 of MySQL
Signed-off-by: Joas Schilling <coding@schilljs.com>
2020-06-18 08:38:36 +02:00
bd9ef16c19 purge strings about explicit Nextcloud versions
Versions deprecate fast and aren't needed in upstream documentation branches.

Signed-off-by: Sascha Wiswedel <sascha.wiswedel@nextcloud.com>
2020-06-04 12:48:13 +02:00
d55351819e typo error
COMMITED in comment instead of having COMMITTED
2020-03-26 21:30:14 +01:00
d3b9d73efa Fix typo
Signed-off-by: Joas Schilling <coding@schilljs.com>
2020-01-22 10:31:47 +01:00
b1811b409d Add a comment about the changed ROW_FORMAT
Signed-off-by: Joas Schilling <coding@schilljs.com>
2020-01-20 11:45:41 +01:00
e8a7c0d2bf Merge pull request #1755 from BernieO/bernieo-convertInteractive
document option --no-interaction for occ db:convert-type
2020-01-07 15:58:18 +01:00
9890900cd5 Cleanup installation manual
Move example out of manual installation, mark snap/vm as community project

Signed-off-by: Julius Härtl <jus@bitgrid.net>
2020-01-02 15:33:45 +01:00
1ea05ad224 correction of minor typo
Signed-off-by: Bernhard Ostertag <bernieo.code@gmx.de>
2019-12-29 16:39:04 +01:00
4f604a6531 document option --no-interaction for occ db:convert-type
see: https://github.com/nextcloud/server/pull/18576

Signed-off-by: Bernhard Ostertag <bernieo.code@gmx.de>
2019-12-29 16:34:20 +01:00
96fe694b55 mysql_4byte_support.rst: adjust wording, avoid repetition
Co-Authored-By: Sascha Wiswedel <wiswedel@users.noreply.github.com>
2019-10-29 16:25:58 +01:00
2e8a5c5014 mysql_4byte_support: extra maintenance steps
Make sure we `cd` to our nextcloud location
Enable and disable maintenance mode explicitly
Fixes #1572
2019-09-12 11:27:37 +02:00
6fddb4755c Update mysql_4byte_support.rst (#1470)
Update mysql_4byte_support.rst
2019-07-02 07:39:23 +02:00
2a725a60d0 Include info about Barracuda innodb_file_format
innodb_file_format=Barracuda is required for utf8mb4, some hosts/servers might not use this file format. It is important to check before upgrading.

Signed-off-by: Patrick Robertson <robertson.patrick@gmail.com>
2019-06-27 09:23:05 +08:00
1b582ec1d3 Update mysql_4byte_support.rst
To clarify needed mysql user privileges.
I am not quite sure if this also applies to <code>ALTER DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;</code> in mysql section 3.
2019-06-01 21:42:44 +02:00
J N
b251a5f388 Update linux_database_configuration.rst
PostgreSQL instead of MySQL on how to remotley access a postgres server (previously "To access a PostgreSQL installation on a...")
2019-05-28 13:35:12 +03:00
c58f36ee46 Make people continue with MySQL instructions
Signed-off-by: Bernhard Ostertag <bernieo.github@gmx.de>

It does not seem to be obvious to continue with the MySQL steps when using MariaDB 10.2 or earlier after step 4 when no error occurred.

According forum thread: https://help.nextcloud.com/t/solved-mysql-is-used-as-database-but-does-not-support-4-byte-characters-error-message-persist-after-fix/52999/2
2019-05-12 00:53:21 +02:00
238e3f14e0 Update admin_manual/configuration_database/mysql_4byte_support.rst
ok

Co-Authored-By: rth-dev <rth@dev-used.de>
2019-05-06 13:15:49 +00:00
b165041d4d Update admin_manual/configuration_database/mysql_4byte_support.rst
thanks for the hint : )

Co-Authored-By: rth-dev <rth@dev-used.de>
2019-05-06 13:15:49 +00:00
rth
9d485395db Update mysql_4byte_support.rst 2019-05-06 13:15:48 +00:00
c7a7a424d7 Add a note about the necessary mysqldump change
Signed-off-by: Joas Schilling <coding@schilljs.com>
2019-04-29 11:49:51 +02:00
3e95ccee5f Fix double dash rendering - fixes #1344
Signed-off-by: Morris Jobke <hey@morrisjobke.de>
2019-04-02 07:15:05 +02:00