[IMP] db_management: add doc for unlink db

db_management/db_premise.rst

@@ -6,10 +6,172 @@
 On-premise Database management
 ==============================
 
+Register a database
+===================
+
+To register your database, you just need to enter your Subscription Code in the
+banner in the App Switcher. Make sure you do not add extra spaces before or after
+your subscription code. If the registration is successful, it will turn green and
+will provide you with the Expiration Date of your freshly-registered database. You
+can check this Epiration Date in the About menu (Odoo 9) or in the Settings Dashboard
+(Odoo 10).
+
+Registration Error Message
+--------------------------
+
+If you are unable to register your database, you will likely encounter this
+message:
+
+.. image:: media/error_message_sub_code.png
+    :align: center
+    :alt: Something went wrong while registering your database,
+          you can try again or contact Odoo Help
+
+Solutions
+'''''''''
+
+* Do you have a valid Enterprise subscription?
+
+  * Check if your subscription details get the tag "In Progress" on
+    your `Odoo Account
+    <https://accounts.odoo.com/my/contract>`__ or with your Account Manager
+
+* Have you already linked a database with your subscription reference?
+
+  * You can link only one database per subscription.
+    (Need a test or a development database? `Find a partner
+    <https://www.odoo.com/partners>`__)
+
+  * You can unlink the old database yourself on your `Odoo Contract
+    <https://accounts.odoo.com/my/contract>`__ with the button "Unlink database"
+
+    .. image:: media/unlink_single_db.png
+        :align: center
+
+
+    A confirmation message will appear; make sure this is the correct database as
+    it will be deactivated shortly:
+
+    .. image:: media/unlink_confirm_enterprise_edition.png
+        :align: center
+
+
+* Do you have the updated version of Odoo 9?
+
+  * From July 2016 onward, Odoo 9 now automatically change the uuid of a
+    duplicated database; a manual operation is no longer required.
+
+  * If it's not the case, you may have multiple databases sharing the same
+    UUID. Please check on your `Odoo Contract
+    <https://accounts.odoo.com/my/contract>`__, a short message will appear
+    specifying which database is problematic:
+
+    .. image:: media/unlink_db_name_collision.png
+        :align: center
+
+
+    In this case, you need to change the UUID on your test databases to solve this
+    issue. You will find more information about this in :ref:`this section <duplicate_premise>`.
+
+    For your information, we identify database with UUID. Therefore, each database
+    should have a distinct UUID to ensure that registration and invoicing proceed
+    effortlessly for your and for us.
+
+
+Too much users error message
+----------------------------
+
+If you have more users in your local database than provisionned in your
+Odoo Enterprise subscription, you may encounter this message:
+
+.. image:: media/add_more_users.png
+    :align: center
+    :alt: This database will expire in X days, you
+          have more users than your subscription allows
+
+
+When the message appears you have 30 days before the expiration.
+The countdown is updated everyday.
+
+Solutions
+'''''''''
+
+* **Add more users** on your subscription: follow the link and Validate
+  the upsell quotation and pay for the extra users.
+
+or
+
+* **Deactivate users** as explained in this `Documentation 
+  <https://www.odoo.com
+  /documentation/user/10.0/db_management/documentation.html#deactivating-users>`__
+  and **Reject** the upsell quotation.
+
+Once your database has the correct number of users, the expiration message
+will disappear automatically after a few days, when the next verification occurs.
+We understand that it can be a bit frightening to see the countdown,
+so you can :ref:`force an Update Notification <force_ping>`  to make the message disappear
+right away.
+
+Database expired error message
+------------------------------
+
+If your database reaches its expiration date before your renew your subscription,
+you will encounter this message:
+
+.. image:: media/database_expired.png
+    :align: center
+    :alt: This database has expired.
+
+
+This **blocking** message appears after a non-blocking message that lasts 30 days.
+If you fail to take action before the end of the countdown, the database is expired.
+
+Solutions
+'''''''''
+
+* Renew your subscription: follow the link and renew your subscription - note that
+    if you wish to pay by Wire Transfer, your subscription will effectively be renewed
+    only when the payment arrives, which can take a few days. Credit card payments are
+    processed immediately.
+* Contact our `Support <https://www.odoo.com/help>`__
+
+None of those solutions worked for you? Please contact our
+`Support <https://www.odoo.com/help>`__
+
+
+.. _force_ping:
+
+Force an Update Notification
+============================
+
+Update Notifications happen once every 7 days and keep your database up-to-date with
+your Odoo Enterprise subscription. If you modify your subscription (i.e. add more users,
+renew it for a year, etc.), your local database will only be made aware of the change
+once every 7 days - this can cause discrepancies between the state of your subscription
+and some notifications in your App Switcher. When doing such an operation on your
+subscription, you can force an Update using the following procedure:
+
+1. Connect to the database with the **Administrator** account
+2. Switch to the Developer mode by using the **About** option in the
+   top-right menu (in V9) /  in **Settings**  (in V10): click on
+   **Activate the developer mode**
+3. Navigate to the "Settings" menu, then "Technical" > "Automation" >
+   "Scheduled Actions"
+4. Find "Update Notification" in the list, click on it, and finally click on the
+   button "**RUN MANUALLY**"
+5. Refresh the page, the "Expiration" notification should be gone
+
+
+.. warning:: You may have kept the same UUID on different databases and we receive
+    information from those databases too. So please read :ref:`this documentation
+    <duplicate_premise>` to know how to change the UUID.
+    After the change you can force a ping to speed up the verification,
+    your production database will then be correctly identified.
+
 .. _duplicate_premise:
 
-Duplicating a database
-======================
+Duplicate a database
+====================
 
 You can duplicate your database by accessing the database manager on your
 server (<odoo-server>/web/database/manager). In this page, you can easily
@@ -29,10 +191,10 @@ problems down the line.
     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 
+> System Parameters**, we advise you to use a
 `uuid generator <https://www.uuidgenerator.net>`__ 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
+    :align: center