8000 [IMP] db_management: add doc for unlink db · kattekrab/documentation-user@c6b62de · GitHub
[go: up one dir, main page]
Skip to content

Commit c6b62de

Browse files
TheEvilQueen-IDEtivisse
TheEvilQueen-IDE
authored and
tivisse
committed
[IMP] db_management: add doc for unlink db
1 parent da89e98 commit c6b62de

File tree

7 files changed

+166
-4
lines changed

7 files changed

+166
-4
lines changed

‎db_management/db_premise.rst

Lines changed: 166 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,172 @@
66
On-premise Database management
77
==============================
88

9+
Register a database
10+
===================
11+
12+
To register your database, you just need to enter your Subscription Code in the
13+
banner in the App Switcher. Make sure you do not add extra spaces before or after
14+
your subscription code. If the registration is successful, it will turn green and
15+
will provide you with the Expiration Date of your freshly-registered database. You
16+
can check this Epiration Date in the About menu (Odoo 9) or in the Settings Dashboard
17+
(Odoo 10).
18+
19+
Registration Error Message
20+
--------------------------
21+
22+
If you are unable to register your database, you will likely encounter this
23+
message:
24+
25+
.. image:: media/error_message_sub_code.png
26+
:align: center
27+
:alt: Something went wrong while registering your database,
28+
you can try again or contact Odoo Help
29+
30+
Solutions
31+
'''''''''
32+
33+
* Do you have a valid Enterprise subscription?
34+
35+
* Check if your subscription details get the tag "In Progress" on
36+
your `Odoo Account
37+
<https://accounts.odoo.com/my/contract>`__ or with your Account Manager
38+
39+
* Have you already linked a database with your subscription reference?
40+
41+
* You can link only one database per subscription.
42+
(Need a test or a development database? `Find a partner
43+
<https://www.odoo.com/partners>`__)
44+
45+
* You can unlink the old database yourself on your `Odoo Contract
46+
<https://accounts.odoo.com/my/contract>`__ with the button "Unlink database"
47+
48+
.. image:: media/unlink_single_db.png
49+
:align: center
50+
51+
52+
A confirmation message will appear; make sure this is the correct database as
53+
it will be deactivated shortly:
54+
55+
.. image:: media/unlink_confirm_enterprise_edition.png
56+
:align: center
57+
58+
59+
* Do you have the updated version of Odoo 9?
60+
61+
* From July 2016 onward, Odoo 9 now automatically change the uuid of a
62+
duplicated database; a manual operation is no longer required.
63+
64+
* If it's not the case, you may have multiple databases sharing the same
65+
UUID. Please check on your `Odoo Contract
66+
<https://accounts.odoo.com/my/contract>`__, a short message will appear
67+
specifying which database is problematic:
68+
69+
.. image:: media/unlink_db_name_collision.png
70+
:align: center
71+
72+
73+
In this case, you need to change the UUID on your test databases to solve this
74+
issue. You will find more information about this in :ref:`this section <duplicate_premise>`.
75+
76+
For your information, we identify database with UUID. Therefore, each database
77+
should have a distinct UUID to ensure that registration and invoicing proceed
78+
effortlessly for your and for us.
79+
80+
81+
Too much users error message
82+
----------------------------
83+
84+
If you have more users in your local database than provisionned in your
85+
Odoo Enterprise subscription, you may encounter this message:
86+
87+
.. image:: media/add_more_users.png
88+
:align: center
89+
:alt: This database will expire in X days, you
90+
have more users than your subscription allows
91+
92+
93+
When the message appears you have 30 days before the expiration.
94+
The countdown is updated everyday.
95+
96+
Solutions
97+
'''''''''
98+
99+
* **Add more users** on your subscription: follow the link and Validate
100+
the upsell quotation and pay for the extra users.
101+
102+
or
103+
104+
* **Deactivate users** as explained in this `Documentation
105+
<https://www.odoo.com
106+
/documentation/user/10.0/db_management/documentation.html#deactivating-users>`__
107+
and **Reject** the upsell quotation.
108+
109+
Once your database has the correct number of users, the expiration message
110+
will disappear automatically after a few days, when the next verification occurs.
111+
We understand that it can be a bit frightening to see the countdown,
112+
so you can :ref:`force an Update Notification <force_ping>` to make the message disappear
113+
right away.
114+
115+
Database expired error message
116+
------------------------------
117+
118+
If your database reaches its expiration date before your renew your subscription,
119+
you will encounter this message:
120+
121+
.. image:: media/database_expired.png
122+
:align: center
123+
:alt: This database has expired.
124+
125+
126+
This **blocking** message appears after a non-blocking message that lasts 30 days.
127+
If you fail to take action before the end of the countdown, the database is expired.
128+
129+
Solutions
130+
'''''''''
131+
132+
* Renew your subscription: follow the link and renew your subscription - note that
133+
if you wish to pay by Wire Transfer, your subscription will effectively be renewed
134+
only when the payment arrives, which can take a few days. Credit card payments are
135+
processed immediately.
136+
* Contact our `Support <https://www.odoo.com/help>`__
137+
138+
None of those solutions worked for you? Please contact our
139+
`Support <https://www.odoo.com/help>`__
140+
141+
142+
.. _force_ping:
143+
144+
Force an Update Notification
145+
============================
146+
147+
Update Notifications happen once every 7 days and keep your database up-to-date with
148+
your Odoo Enterprise subscription. If you modify your subscription (i.e. add more users,
149+
renew it for a year, etc.), your local database will only be made aware of the change
150+
once every 7 days - this can cause discrepancies between the state of your subscription
151+
and some notifications in your App Switcher. When doing such an operation on your
152+
subscription, you can force an Update using the following procedure:
153+
154+
1. Connect to the database with the **Administrator** account
155+
2. Switch to the Developer mode by using the **About** option in the
156+
top-right menu (in V9) / in **Settings** (in V10): click on
157+
**Activate the developer mode**
158+
3. Navigate to the "Settings" menu, then "Technical" > "Automation" >
159+
"Scheduled Actions"
160+
4. Find "Update Notification" in the list, click on it, and finally click on the
161+
button "**RUN MANUALLY**"
162+
5. Refresh the page, the "Expiration" notification should be gone
163+
164+
165+
.. warning:: You may have kept the same UUID on different databases and we receive
166+
information from those databases too. So please read :ref:`this documentation
167+
<duplicate_premise>` to know how to change the UUID.
168+
After the change you can force a ping to speed up the verification,
169+
your production database will then be correctly identified.
170+
9171
.. _duplicate_premise:
10172

11-
Duplicating a database
12-
======================
173+
Duplicate a database
174+
====================
13175

14176
You can duplicate your database by accessing the database manager on your
15177
server (<odoo-server>/web/database/manager). In this page, you can easily
@@ -29,10 +191,10 @@ problems down the line.
29191
duplicated database; a manual operation is no longer required.
30192

31193
The database uuid is currently accessible from the menu **Settings > Technical
32-
> System Parameters**, we advise you to use a
194+
> System Parameters**, we advise you to use a
33195
`uuid generator <https://www.uuidgenerator.net>`__ or to use the unix command
34196
``uuidgen`` to generate a new uuid. You can then simply replace it like any
35197
other record by clicking on it and using the edit button.
36198

37199
.. image:: media/db_uuid.png
38-
:align: center
200+
:align: center

‎db_management/media/add_more_users.png

29.7 KB
Loading

‎db_management/media/database_expired.png

11.1 KB
Loading

‎db_management/media/error_message_sub_code.png

17.4 KB
Loading

‎db_management/media/unlink_confirm_enterprise_edition.png

33 KB
Loading

‎db_management/media/unlink_db_name_collision.png

44.9 KB
Loading

‎db_management/media/unlink_single_db.png

31.9 KB
Loading

0 commit comments

Comments
 (0)
0