Skip to content

Commit a37b42c

Browse files
committed
feat(admin_manual): add serverid config parameter
Signed-off-by: Benjamin Gaussorgues <[email protected]>
1 parent c07d53b commit a37b42c

File tree

3 files changed

+50
-0
lines changed

3 files changed

+50
-0
lines changed

admin_manual/configuration_database/db_conversion.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,3 +108,19 @@ Here is a list of known old tables:
108108
* oc_privatedata - this table was later added again by the app `privatedata` (https://apps.nextcloud.com/apps/privatedata) and is safe to be removed if that app is not enabled
109109
* oc_queuedtasks
110110
* oc_sharing
111+
112+
113+
Change MySQL row type
114+
---------------------
115+
116+
If you encounter the error `Incorrect row format found in your database`, you may fix it with the following command:
117+
118+
::
119+
120+
DB_USER=nextcloud
121+
DB_PASS=<YourPassword>
122+
DB_NAME=nextcloud
123+
mysql -NB -u"${DB_USER}" -p"${DB_PASS}" "${DB_NAME}" -e 'SHOW TABLES LIKE "oc_%";' | \
124+
grep accounts | \
125+
xargs -t -I {} -- mysql -NB -u"${DB_USER}" -p"${DB_PASS}" "${DB_NAME}" -e 'ALTER TABLE '
126+

admin_manual/configuration_server/config_sample_php_parameters.rst

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2213,7 +2213,35 @@ to that folder, starting from the Nextcloud webroot. The key ``writable``
22132213
indicates if a Web server can write files to that folder.
22142214

22152215

2216+
Server identifier
2217+
-----------------
22162218

2219+
When your Nextcloud instance is using several PHP servers, each one must have an unique identifier.
2220+
2221+
serverid
2222+
^^^^^^^^
2223+
2224+
This identifier must be an integer between 0 and 1023.
2225+
For a single server of if each server have it's own ``config.php``, server ID can be configured in the usual way in ``config.php``
2226+
2227+
::
2228+
2229+
'serverid' => 123,
2230+
2231+
2232+
Otherwise, you can use a environment variable ``NC_serverid`` to configure it. It must be configured for your webserver and for CLI.
2233+
2234+
In Apache server, you can use the following directive to add it:
2235+
2236+
::
2237+
2238+
SetEnv NC_serverid 123
2239+
2240+
For CLI, we recommend to use an alias. Example for Bash:
2241+
2242+
::
2243+
2244+
alias nocc="sudo -u www-data NC_serverid=123 /path/to/nextcloud/occ"
22172245

22182246

22192247
Previews

admin_manual/release_notes/upgrade_to_33.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,3 +15,9 @@ Previews
1515

1616
The preview provider for MP3 files, which reads cover images embedded in the files, is disabled by default for performance and stability reasons.
1717
See :doc:`../configuration_files/previews_configuration` for details on how to enable or disable the preview provider.
18+
19+
Snowflake IDs
20+
-------------
21+
22+
This version of Nextcloud ships with `Snowflake IDs <https://en.wikipedia.org/wiki/Snowflake_ID>`_. Those IDs include the creation time of object, a sequence ID and a server ID.
23+
The server ID should now be configured in your config.php file or using environment variables. See :doc:`../configuration_server/config_sample_php_parameters` for more information.

0 commit comments

Comments
 (0)