diff --git a/admin_manual/configuration_database/bigint_identifiers.rst b/admin_manual/configuration_database/bigint_identifiers.rst new file mode 100644 index 000000000..ee6faf639 --- /dev/null +++ b/admin_manual/configuration_database/bigint_identifiers.rst @@ -0,0 +1,24 @@ +========================== +BigInt (64bit) identifiers +========================== + +Since Nextcloud 13 big integers are used to store identifiers and auto-increment keys in the database. +Because changing columns on huge tables can take quite a while (up to hours or days), the update from +Nextcloud 12 or earlier did not perform this migration on the filecache and activity table. + +To make it easy to force the update on that tables too, we added a console command, which can be used +to migrate the remaining columns to bigints. + +The command can safely be executed. It will show a success message when there is nothing to do:: + + sudo -u www-data ./occ db:convert-filecache-bigint + All tables already up to date! + +or otherwise ask for confirmation, before performing the heavy actions:: + + sudo -u www-data ./occ db:convert-filecache-bigint + This can take up to hours, depending on the number of files in your instance! + Continue with the conversion (y/n)? [n] + +.. note:: Similar to a normal update, you should shutdown your apache or nginx server or enable maintenance + mode before running the command to avoid issues with your sync clients. diff --git a/admin_manual/configuration_database/index.rst b/admin_manual/configuration_database/index.rst index 202ee1ae4..f2a697aa4 100644 --- a/admin_manual/configuration_database/index.rst +++ b/admin_manual/configuration_database/index.rst @@ -5,6 +5,7 @@ Database Configuration .. toctree:: :maxdepth: 2 - db_conversion.rst - linux_database_configuration.rst + db_conversion + linux_database_configuration mysql_4byte_support + bigint_identifiers