diff --git a/content/administration/upgrade/odoo_online.rst b/content/administration/upgrade/odoo_online.rst index 0576eb214..b30c2b74b 100644 --- a/content/administration/upgrade/odoo_online.rst +++ b/content/administration/upgrade/odoo_online.rst @@ -2,29 +2,68 @@ Odoo Online =========== -Requesting a test upgrade -========================= +Odoo databases can be manually upgraded directly from the main Odoo website. To upgrade an Odoo +database, navigate to the `database manager `_ page and sign in. -#. Go to your `database manager `_ -#. Click on your profile icon and select *My Databases*. +The database manager page displays all of the Odoo databases associated with the user's account. Any +databases that are not already on the most recent version of Odoo display an **arrow in a circle** +icon next to the database name, indicating that the database can be upgraded. - .. image:: odoo_online/accessing-my-databases.png - :alt: Selecting My Databases under my profile +.. image:: odoo_online/databases-page.png + :align: center + :alt: The database manager page with an upgrade button next to the name of a database. -#. Click on the up arrow button next to your main database name to proceed to the test upgrade. +Test database +============= - .. image:: odoo_online/upgrade-option.png - :alt: Selecting the action settings icon +Click on the **arrow in a circle** icon to start the upgrade process. On the :guilabel:`Upgrade your +database` pop-up, select the version of Odoo that the platform will be upgraded to. In the +:guilabel:`Email to notify` field, enter an email address that will receive email notifications +about the database upgrade. -#. In the pop-up message that appears, select the target version and then :guilabel:`Test` as - purpose. +There is also a :guilabel:`Purpose` section on the pop-up that is used to specify the reason for the +upgrade. However, at this stage of the process, the only selectable option is :guilabel:`Test`, as +Odoo requires users to create a test copy of the upgraded database before converting the actual +database. - .. note:: - The :guilabel:`Production` purpose doesn't appear if you didn't test your upgraded database at - least once. +.. image:: odoo_online/upgrade-pop-up.png + :align: center + :alt: The "Upgrade your database" pop-up. -#. This triggers the automated upgrade process. A confirmation email is then sent to you with the - the link to the upgraded database or to provide information if the upgrade failed. +After filling out the form, click the :guilabel:`Upgrade` button. The pop-up disappears and the +database being upgraded shows a red :guilabel:`Upgrade in progress` tag next to its name. An email +confirming that the upgrade is in progress is also sent to the email address specified on the +pop-up. - .. note:: - You can also see and access your test database from your *My Databases* page. +.. image:: odoo_online/upgrade-in-progress.png + :align: center + :alt: The "Upgrade in progress" tag next to the database name. + +Once the upgrade is complete, a new test database appears on the `database manager +`_ page. To access the test database, click the drop-down arrow +(:guilabel:`⯆`) to the left of the main database's name. Doing so makes the test version appear +below it. Finally, click the green :guilabel:`Connect` button on the right side of the test +version's row to go to the database. + +.. image:: odoo_online/test-database.png + :align: center + :alt: A test database on the database manager page. + +Except for being on the newer version of Odoo, the test database is an exact copy of the one being +upgraded. It is important to do extensive testing in this database to ensure that the upgrade has +not altered or corrupted any data, and that all workflows still proceed as expected. + +Production database +=================== + +After confirming the integrity of the new version, return to the `database manager +`_ page. Once again, click on the **arrow in a circle** icon next +to the database being upgraded. The :guilabel:`Upgrade your database` pop-up appears as before, +except that there is now a :guilabel:`Production` option under the :guilabel:`Purpose` section. + +Select the :guilabel:`Production` option and then click :guilabel:`Upgrade` to begin the upgrade +process. As before, a notification email is sent to the email address provided and a red +:guilabel:`Upgrade in progress` tag appears next to the name of the database. + +After the upgrade is finished, the :guilabel:`Upgrade in progress` tag disappears and the database +is upgraded to the version specified. diff --git a/content/administration/upgrade/odoo_online/accessing-my-databases.png b/content/administration/upgrade/odoo_online/accessing-my-databases.png deleted file mode 100644 index 5d2a7e4be..000000000 Binary files a/content/administration/upgrade/odoo_online/accessing-my-databases.png and /dev/null differ diff --git a/content/administration/upgrade/odoo_online/databases-page.png b/content/administration/upgrade/odoo_online/databases-page.png new file mode 100644 index 000000000..03333a726 Binary files /dev/null and b/content/administration/upgrade/odoo_online/databases-page.png differ diff --git a/content/administration/upgrade/odoo_online/test-database.png b/content/administration/upgrade/odoo_online/test-database.png new file mode 100644 index 000000000..32d46a016 Binary files /dev/null and b/content/administration/upgrade/odoo_online/test-database.png differ diff --git a/content/administration/upgrade/odoo_online/upgrade-in-progress.png b/content/administration/upgrade/odoo_online/upgrade-in-progress.png new file mode 100644 index 000000000..b15fbfcab Binary files /dev/null and b/content/administration/upgrade/odoo_online/upgrade-in-progress.png differ diff --git a/content/administration/upgrade/odoo_online/upgrade-option.png b/content/administration/upgrade/odoo_online/upgrade-option.png deleted file mode 100644 index 88e50d754..000000000 Binary files a/content/administration/upgrade/odoo_online/upgrade-option.png and /dev/null differ diff --git a/content/administration/upgrade/odoo_online/upgrade-pop-up.png b/content/administration/upgrade/odoo_online/upgrade-pop-up.png new file mode 100644 index 000000000..5ce654422 Binary files /dev/null and b/content/administration/upgrade/odoo_online/upgrade-pop-up.png differ