From ead4516ae14222ca64e41155ffa509511a5e7276 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Felix=20B=C3=B6hm?= Date: Fri, 1 Aug 2014 13:46:12 +0200 Subject: [PATCH 1/3] added docs for db:convert --- admin_manual/maintenance/convert_db.rst | 63 +++++++++++++++++++++++++ admin_manual/maintenance/index.rst | 1 + 2 files changed, 64 insertions(+) create mode 100644 admin_manual/maintenance/convert_db.rst diff --git a/admin_manual/maintenance/convert_db.rst b/admin_manual/maintenance/convert_db.rst new file mode 100644 index 000000000..355e306d4 --- /dev/null +++ b/admin_manual/maintenance/convert_db.rst @@ -0,0 +1,63 @@ +Converting Database Type +======================== + +You can convert a sqlite database to a more performant mysql or pgsql database with the ownCloud command line tool. +Available since ownCloud version 7.0.0. To convert former ownCloud installations, first update to at least version 7.0.0. + + +Run the conversion +------------------ + +First setup the new database, here called "new_db_name". +In ownCloud root folder call + +.. code-block:: bash + + php occ db:convert-type [options] type username hostname database + +The Options + +* ``--port="3306"`` the database port (optional) +* ``--password="mysql_user_password"`` password for the new database. If omitted the tool will ask you (optional) +* ``--clear-schema`` clear schema (optional) +* ``--all-apps`` by default, tables for enabled apps are converted, use to convert also tables of deactivated apps (optional) + +*Note:* The converter searches for apps in your configured app folders and uses the schema definitions in the apps to create the new table. So tables of removed apps will not be converted even with option ``--all-apps`` + +For example + +.. code-block:: bash + + php occ db:convert-type --all-apps mysql oc_mysql_user 127.0.0.1 new_db_name + + +On success the converter will automaticly configure the new database in your ownCloud config ``config.php`` + +Unconvertable Tables +-------------------- + +If you updated your ownCloud installation there might exist old tables, which are not used anymore. The converter will tell you + +.. code-block:: bash + + The following tables will not be converted: + oc_permissions + ... + +You can ignore these tables. +Here is a list of known old tables: + +* oc_calendar_calendars +* oc_calendar_objects +* oc_calendar_share_calendar +* oc_calendar_share_event +* oc_fscache +* oc_log +* oc_media_albums +* oc_media_artists +* oc_media_sessions +* oc_media_songs +* oc_media_users +* oc_permissions +* oc_queuedtasks +* oc_sharing \ No newline at end of file diff --git a/admin_manual/maintenance/index.rst b/admin_manual/maintenance/index.rst index 4dee7b5da..31be6380c 100644 --- a/admin_manual/maintenance/index.rst +++ b/admin_manual/maintenance/index.rst @@ -10,4 +10,5 @@ Maintenance update restore migrating + convert_db From cbbceacabac24586893c59394cdb13011021ca0c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20M=C3=BCller?= Date: Mon, 4 Aug 2014 10:21:47 +0200 Subject: [PATCH 2/3] fixing typos --- admin_manual/maintenance/convert_db.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/admin_manual/maintenance/convert_db.rst b/admin_manual/maintenance/convert_db.rst index 355e306d4..7077411dc 100644 --- a/admin_manual/maintenance/convert_db.rst +++ b/admin_manual/maintenance/convert_db.rst @@ -1,7 +1,7 @@ Converting Database Type ======================== -You can convert a sqlite database to a more performant mysql or pgsql database with the ownCloud command line tool. +You can convert a sqlite database to a more performing MySql, MariaDB or PostgreSQL database with the ownCloud command line tool. Available since ownCloud version 7.0.0. To convert former ownCloud installations, first update to at least version 7.0.0. @@ -31,9 +31,9 @@ For example php occ db:convert-type --all-apps mysql oc_mysql_user 127.0.0.1 new_db_name -On success the converter will automaticly configure the new database in your ownCloud config ``config.php`` +On success the converter will automatically configure the new database in your ownCloud config ``config.php`` -Unconvertable Tables +Unconvertible Tables -------------------- If you updated your ownCloud installation there might exist old tables, which are not used anymore. The converter will tell you @@ -60,4 +60,4 @@ Here is a list of known old tables: * oc_media_users * oc_permissions * oc_queuedtasks -* oc_sharing \ No newline at end of file +* oc_sharing From ce086cf3b7ab0a8313e0020a6854d2f55864ad28 Mon Sep 17 00:00:00 2001 From: Morris Jobke Date: Mon, 15 Sep 2014 15:42:20 +0200 Subject: [PATCH 3/3] fix typos --- admin_manual/maintenance/convert_db.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/admin_manual/maintenance/convert_db.rst b/admin_manual/maintenance/convert_db.rst index 7077411dc..c4bdf840c 100644 --- a/admin_manual/maintenance/convert_db.rst +++ b/admin_manual/maintenance/convert_db.rst @@ -1,7 +1,7 @@ Converting Database Type ======================== -You can convert a sqlite database to a more performing MySql, MariaDB or PostgreSQL database with the ownCloud command line tool. +You can convert a sqlite database to a more performing MySQL, MariaDB or PostgreSQL database with the ownCloud command line tool. Available since ownCloud version 7.0.0. To convert former ownCloud installations, first update to at least version 7.0.0. @@ -24,7 +24,7 @@ The Options *Note:* The converter searches for apps in your configured app folders and uses the schema definitions in the apps to create the new table. So tables of removed apps will not be converted even with option ``--all-apps`` -For example +For example .. code-block:: bash @@ -36,7 +36,7 @@ On success the converter will automatically configure the new database in your o Unconvertible Tables -------------------- -If you updated your ownCloud installation there might exist old tables, which are not used anymore. The converter will tell you +If you updated your ownCloud installation there might exist old tables, which are not used anymore. The converter will tell you .. code-block:: bash