diff --git a/_static/banners/db_management.jpg b/_static/banners/db_management.jpg deleted file mode 100644 index b6b1aac46..000000000 Binary files a/_static/banners/db_management.jpg and /dev/null differ diff --git a/_static/banners/db_online.jpg b/_static/banners/db_online.jpg new file mode 100644 index 000000000..1140ae637 Binary files /dev/null and b/_static/banners/db_online.jpg differ diff --git a/_static/banners/db_premise.jpg b/_static/banners/db_premise.jpg new file mode 100644 index 000000000..42a7bf0b1 Binary files /dev/null and b/_static/banners/db_premise.jpg differ diff --git a/_static/banners/users.jpg b/_static/banners/users.jpg new file mode 100644 index 000000000..6d6edf2d0 Binary files /dev/null and b/_static/banners/users.jpg differ diff --git a/applications.rst b/applications.rst index 86e61f9a7..44e4a04e0 100644 --- a/applications.rst +++ b/applications.rst @@ -18,8 +18,6 @@ Applications project expense/expense general - getting_started/documentation - db_management/documentation legal .. expenses .. recruitment diff --git a/db_management/db_online.rst b/db_management/db_online.rst new file mode 100644 index 000000000..1bf7df2c6 --- /dev/null +++ b/db_management/db_online.rst @@ -0,0 +1,57 @@ +:banner: banners/db_online.jpg + + +.. _db_online: + +========================== +Online Database management +========================== + +.. _duplicate_online: + +Duplicating a database +====================== + +.. note:: Database duplication, renaming, custom DNS, etc. is not available + to free customers of our Online platform. + +Access the `database management page `__ +(you will have to sign in). Next, make sure you are connected as the +administrator of the database you want to duplicate. After that, click +on the **Manage Your Databases** button. + +.. image:: media/databases.png + :align: center + +In the line of the database you want to duplicate, you will have a few +buttons. To duplicate your database, just click **Duplicate**. You will +have to give a name to your duplicate, then click **Duplicate Database**. + +.. image:: media/db_buttons.png + :align: center + +.. image:: media/db_duplicate.png + :align: center + +.. danger:: A duplicated database has the same behaviour as a real one: + + * Emails are sent + + * Payments are processed (in the e-commerce, for example) + + * Delivery orders (shipping providers) are sent + + * Etc. + + It is **strongly** advised to test behaviour using sample + customers/products (with a `disposable e-mail `__ + address, for example) + +After a few seconds, you will be logged in your duplicated database. +Notice that the url uses the name you chose for your duplicated +database. + +.. note :: Duplicate databases expire automatically after 15 days. + + .. image:: media/dup_expires.png + :align: center diff --git a/db_management/db_premise.rst b/db_management/db_premise.rst new file mode 100644 index 000000000..03e267327 --- /dev/null +++ b/db_management/db_premise.rst @@ -0,0 +1,38 @@ +:banner: banners/db_premise.jpg + +.. _db_premise: + +============================== +On-premise Database management +============================== + +.. _duplicate_premise: + +Duplicating a database +====================== + +You can duplicate your database by accessing the database manager on your +server (/web/database/manager). In this page, you can easily +duplicate your database (among other things). + +.. image:: media/db_manager.gif + :align: center + + +When you duplicate a local database, it is **strongly** advised to change +the duplicated database's uuid (Unniversally Unique Identifier), since this +uuid is how your database identifies itself with our servers. Having two +databases with the same uuid could result in invoicing problems or registration +problems down the line. + +.. note:: From July 2016 onward, Odoo 9 now automatically change the uuid of a + duplicated database; a manual operation is no longer required. + +The database uuid is currently accessible from the menu **Settings > Technical +> System Parameters**, we advise you to use a +`uuid generator `__ or to use the unix command +``uuidgen`` to generate a new uuid. You can then simply replace it like any +other record by clicking on it and using the edit button. + +.. image:: media/db_uuid.png + :align: center \ No newline at end of file diff --git a/db_management/documentation.rst b/db_management/documentation.rst index 2a29fbd6e..4ada742f7 100644 --- a/db_management/documentation.rst +++ b/db_management/documentation.rst @@ -1,10 +1,10 @@ -:banner: banners/db_management.jpg +:banner: banners/users.jpg .. _db_management/documentation: -============================ -How to manage your databases -============================ +================== +Users and Features +================== As the administrator of your database, you are responsible for its usage. This includes the Apps you install as well as the number of users currently @@ -17,94 +17,18 @@ subscription amount significantly (or switch you from a free account to a paying one on our online platform). This page contains some information as to how you can manage your Odoo -instances. The most important section concern the -:ref:`duplication ` of your database: whenever you wish to -install or remove an App, you should **always** test it first on a duplicate -of your production database. That way, if something goes wrong, your -day-to-day business is not impacted. +instances. Before carrying any of these procedures, we **strongly** advise +to test them on a duplicate of your database first. That way, if something goes +wrong, your day-to-day business is not impacted. + +.. note:: You can find guides on how to duplicate your databases both for + :ref:`online ` and :ref:`on premise ` + installations. .. note:: If you have questions about the content of this page or if you encounter an issue while carrying out these procedures, please contact us through our `support form `__. -.. note:: Database duplication, renaming, custom DNS, etc. is not available - to free customers of our Online platform. - - -.. _duplicate: - -Duplicating a database (online) -=============================== - -Access the `database management page `__ -(you will have to sign in). Next, make sure you are connected as the -administrator of the database you want to duplicate. After that, click -on the **Manage Your Databases** button. - -.. image:: media/databases.png - :align: center - -In the line of the database you want to duplicate, you will have a few -buttons. To duplicate your database, just click **Duplicate**. You will -have to give a name to your duplicate, then click **Duplicate Database**. - -.. image:: media/db_buttons.png - :align: center - -.. image:: media/db_duplicate.png - :align: center - -.. danger:: A duplicated database has the same behaviour as a real one: - - * Emails are sent - - * Payments are processed (in the e-commerce, for example) - - * Delivery orders (shipping providers) are sent - - * Etc. - - It is **strongly** advised to test behaviour using sample - customers/products (with a `disposable e-mail `__ - address, for example) - -After a few seconds, you will be logged in your duplicated database. -Notice that the url uses the name you chose for your duplicated -database. - -.. note :: Duplicate databases expire automatically after 15 days. - - .. image:: media/dup_expires.png - :align: center - -Duplicating a database (on-premise) -=================================== - -You can duplicate your database by accessing the database manager on your -server (/web/database/manager). In this page, you can easily -duplicate your database (among other things). - -.. image:: media/db_manager.gif - :align: center - - -When you duplicate a local database, it is **strongly** advised to change -the duplicated database's uuid (Unniversally Unique Identifier), since this -uuid is how your database identifies itself with our servers. Having two -databases with the same uuid could result in invoicing problems or registration -problems down the line. - -.. note:: From July 2016 onward, Odoo 9 now automatically change the uuid of a - duplicated database; a manual operation is no longer required. - -The database uuid is currently accessible from the menu **Settings > Technical -> System Parameters**, we advise you to use a -`uuid generator `__ or to use the unix command -``uuidgen`` to generate a new uuid. You can then simply replace it like any -other record by clicking on it and using the edit button. - -.. image:: media/db_uuid.png - :align: center Deactivating Users ================== diff --git a/getting_started.rst b/getting_started.rst deleted file mode 100644 index 2292179c6..000000000 --- a/getting_started.rst +++ /dev/null @@ -1,10 +0,0 @@ -:banner: banners/getting_started.jpg - -=============== -Getting Started -=============== - -.. toctree:: - :titlesonly: - - getting_started/documentation diff --git a/index.rst b/index.rst index 3bc0e8ea5..7edc0c482 100644 --- a/index.rst +++ b/index.rst @@ -9,3 +9,4 @@ Odoo User Documentation Index applications + practical \ No newline at end of file diff --git a/practical.rst b/practical.rst new file mode 100644 index 000000000..31790adbd --- /dev/null +++ b/practical.rst @@ -0,0 +1,11 @@ +===================== +Practical Information +===================== + +.. toctree:: + :titlesonly: + + getting_started/documentation + db_management/documentation + db_management/db_online + db_management/db_premise \ No newline at end of file