8000 [IMP] db_management: rework section for future content · getodoochina/documentation-user@60ab9a5 · GitHub
[go: up one dir, main page]
Skip to content

Commit 60ab9a5

Browse files
bouvydtivisse
bouvyd
authored and
tivisse
committed
[IMP] db_management: rework section for future content
The "database management" section was just a big fourre-tout. This commit splits a new "Practical Info" section from the "Applications" section and split the db management page in 3 sub-pages that will be soon extended.
1 parent 3cfcd41 commit 60ab9a5

11 files changed

+118
-99
lines changed

‎_static/banners/db_management.jpg

-58.6 KB
Binary file not shown.

‎_static/banners/db_online.jpg

78.5 KB
Loading

‎_static/banners/db_premise.jpg

230 KB
Loading

‎_static/banners/users.jpg

429 KB
Loading

‎applications.rst

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,6 @@ Applications
1818
project
1919
expense/expense
2020
general
21-
getting_started/documentation
22-
db_management/documentation
2321
legal
2422
.. expenses
2523
.. recruitment

‎db_management/db_online.rst

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
:banner: banners/db_online.jpg
2+
3+
4+
.. _db_online:
5+
6+
==========================
7+
Online Database management
8+
==========================
9+
10+
.. _duplicate_online:
11+
12+
Duplicating a database
13+
======================
14+
15+
.. note:: Database duplication, renaming, custom DNS, etc. is not available
16+
to free customers of our Online platform.
17+
18+
Access the `database management page <https://www.odoo.com/my/databases>`__
19+
(you will have to sign in). Next, make sure you are connected as the
20+
administrator of the database you want to duplicate. After that, click
21+
on the **Manage Your Databases** button.
22+
23+
.. image:: media/databases.png
24+
:align: center
25+
26+
In the line of the database you want to duplicate, you will have a few
27+
buttons. To duplicate your database, just click **Duplicate**. You will
28+
have to give a name to your duplicate, then click **Duplicate Database**.
29+
30+
.. image:: media/db_buttons.png
31+
:align: center
32+
33+
.. image:: media/db_duplicate.png
34+
:align: center
35+
36+
.. danger:: A duplicated database has the same behaviour as a real one:
37+
38+
* Emails are sent
39+
40+
* Payments are processed (in the e-commerce, for example)
41+
42+
* Delivery orders (shipping providers) are sent
43+
44+
* Etc.
45+
46+
It is **strongly** advised to test behaviour using sample
47+
customers/products (with a `disposable e-mail <http://www.mailinator.com>`__
48+
address, for example)
49+
50+
After a few seconds, you will be logged in your duplicated database.
51+
Notice that the url uses the name you chose for your duplicated
52+
database.
53+
54+
.. note :: Duplicate databases expire automatically after 15 days.
55+
56+
.. image:: media/dup_expires.png
57+
:align: center

‎db_management/db_premise.rst

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
:banner: banners/db_premise.jpg
2+
3+
.. _db_premise:
4+
5+
==============================
6+
On-premise Database management
7+
==============================
8+
9+
.. _duplicate_premise:
10+
11+
Duplicating a database
12+
======================
13+
14+
You can duplicate your database by accessing the database manager on your
15+
server (<odoo-server>/web/database/manager). In this page, you can easily
16+
duplicate your database (among other things).
17+
18+
.. image:: media/db_manager.gif
19+
:align: center
20+
21+
22+
When you duplicate a local database, it is **strongly** advised to change
23+
the duplicated database's uuid (Unniversally Unique Identifier), since this
24+
uuid is how your database identifies itself with our servers. Having two
25+
databases with the same uuid could result in invoicing problems or registration
26+
problems down the line.
27+
28+
.. note:: From July 2016 onward, Odoo 9 now automatically change the uuid of a
29+
duplicated database; a manual operation is no longer required.
30+
31+
The database uuid is currently accessible from the menu **Settings > Technical
32+
> System Parameters**, we advise you to use a
33+
`uuid generator <https://www.uuidgenerator.net>`__ or to use the unix command
34+
``uuidgen`` to generate a new uuid. You can then simply replace it like any
35+
other record by clicking on it and using the edit button.
36+
37+
.. image:: media/db_uuid.png
38+
:align: center

‎db_management/documentation.rst

Lines changed: 11 additions & 87 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
:banner: banners/db_management.jpg
1+
:banner: banners/users.jpg
22

33
.. _db_management/documentation:
44

5-
============================
6-
How to manage your databases
7-
============================
5+
==================
6+
Users and Features
7+
==================
88

99
As the administrator of your database, you are responsible for its usage.
1010
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
1717
to a paying one on our online platform).
1818

1919
This page contains some information as to how you can manage your Odoo
20-
instances. The most important section concern the
21-
:ref:`duplication <duplicate>` of your database: whenever you wish to
22-
install or remove an App, you should **always** test it first on a duplicate
23-
of your production database. That way, if something goes wrong, your
24-
day-to-day business is not impacted.
20+
instances. Before carrying any of these procedures, we **strongly** advise
21+
to test them on a duplicate of your database first. That way, if something goes
22+
wrong, your day-to-day business is not impacted.
23+
24+
.. note:: You can find guides on how to duplicate your databases both for
25+
:ref:`online <duplicate_online>` and :ref:`on premise <duplicate_premise>`
26+
installations.
2527

2628
.. note:: If you have questions about the content of this page or if you
2729
encounter an issue while carrying out these procedures, please contact
2830
us through our `support form <https://www.odoo.com/help>`__.
2931

30-
.. note:: Database duplication, renaming, custom DNS, etc. is not available
31-
to free customers of our Online platform.
32-
33-
34-
.. _duplicate:
35-
36-
Duplicating a database (online)
37-
===============================
38-
39-
Access the `database management page <https://www.odoo.com/my/databases>`__
40-
(you will have to sign in). Next, make sure you are connected as the
41-
administrator of the database you want to duplicate. After that, click
42-
on the **Manage Your Databases** button.
43-
44-
.. image:: media/databases.png
45-
:align: center
46-
47-
In the line of the database you want to duplicate, you will have a few
48-
buttons. To duplicate your database, just click **Duplicate**. You will
49-
have to give a name to your duplicate, then click **Duplicate Database**.
50-
51-
.. image:: media/db_buttons.png
52-
:align: center
53-
54-
.. image:: media/db_duplicate.png
55-
:align: center
56-
57-
.. danger:: A duplicated database has the same behaviour as a real one:
58-
59-
* Emails are sent
60-
61-
* Payments are processed (in the e-commerce, for example)
62-
63-
* Delivery orders (shipping providers) are sent
64-
65-
* Etc.
66-
67-
It is **strongly** advised to test behaviour using sample
68-
customers/products (with a `disposable e-mail <http://www.mailinator.com>`__
69-
address, for example)
70-
71-
After a few seconds, you will be logged in your duplicated database.
72-
Notice that the url uses the name you chose for your duplicated
73-
database.
74-
75-
.. note :: Duplicate databases expire automatically after 15 days.
76-
77-
.. image:: media/dup_expires.png
78-
:align: center
79-
80-
Duplicating a database (on-premise)
81-
===================================
82-
83-
You can duplicate your database by accessing the database manager on your
84-
server (<odoo-server>/web/database/manager). In this page, you can easily
85-
duplicate your database (among other things).
86-
87-
.. image:: media/db_manager.gif
88-
:align: center
89-
90-
91-
When you duplicate a local database, it is **strongly** advised to change
92-
the duplicated database's uuid (Unniversally Unique Identifier), since this
93-
uuid is how your database identifies itself with our servers. Having two
94-
databases with the same uuid could result in invoicing problems or registration
95-
problems down the line.
96-
97-
.. note:: From July 2016 onward, Odoo 9 now automatically change the uuid of a
98-
duplicated database; a manual operation is no longer required.
99-
100-
The database uuid is currently accessible from the menu **Settings > Technical
101-
> System Parameters**, we advise you to use a
102-
`uuid generator <https://www.uuidgenerator.net>`__ or to use the unix command
103-
``uuidgen`` to generate a new uuid. You can then simply replace it like any
104-
other record by clicking on it and using the edit button.
105-
106-
.. image:: media/db_uuid.png
107-
:align: center
10832

10933
Deactivating Users
11034
==================

‎getting_started.rst

Lines changed: 0 additions & 10 deletions
This file was deleted.

‎index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,3 +9,4 @@ Odoo User Documentation A1F7
99

1010
Index <self>
1111
applications
12+
practical

‎practical.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
=====================
2+
Practical Information
3+
=====================
4+
5+
.. toctree::
6+
:titlesonly:
7+
8+
getting_started/documentation
9+
db_management/documentation
10+
db_management/db_online
11+
db_management/db_premise

0 commit comments

Comments
 (0)
0