From 954ed2468b126d8201f0d976e9bbf82395787360 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Wed, 25 Oct 2017 10:14:18 +0200 Subject: [PATCH 1/2] Add doc about bigints Signed-off-by: Joas Schilling --- .../bigint_identifiers.rst | 21 +++++++++++++++++++ admin_manual/configuration_database/index.rst | 5 +++-- 2 files changed, 24 insertions(+), 2 deletions(-) create mode 100644 admin_manual/configuration_database/bigint_identifiers.rst diff --git a/admin_manual/configuration_database/bigint_identifiers.rst b/admin_manual/configuration_database/bigint_identifiers.rst new file mode 100644 index 000000000..5fba8d2ab --- /dev/null +++ b/admin_manual/configuration_database/bigint_identifiers.rst @@ -0,0 +1,21 @@ +========================== +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] 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 From fa222396dffc045af71ab2fd5da341ddc94114a3 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Thu, 26 Oct 2017 10:33:32 +0200 Subject: [PATCH 2/2] Suggest to shutdown or maintenance mode Signed-off-by: Joas Schilling --- admin_manual/configuration_database/bigint_identifiers.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/admin_manual/configuration_database/bigint_identifiers.rst b/admin_manual/configuration_database/bigint_identifiers.rst index 5fba8d2ab..ee6faf639 100644 --- a/admin_manual/configuration_database/bigint_identifiers.rst +++ b/admin_manual/configuration_database/bigint_identifiers.rst @@ -19,3 +19,6 @@ 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.