:show-content: ========== On-premise ========== Register a database =================== To register your database, enter your subscription code in the banner in the app dashboard. If the registration is successful, the banner will turn green and display the database expiration date. .. tip:: The expiration date is also displayed at the bottom of the Settings page. .. _on-premise/duplicate: Duplicate a database ==================== Duplicate a database by accessing the database manager on your server (`/web/database/manager`). Typically, you want to duplicate your production database into a neutralized testing database. It can be done by checking the neutralize box when prompted, which executes all :file:`neutralize.sql` scripts for every installed module. Common error messages and solutions =================================== Registration error ------------------ In case of a registration error, the following message should be displayed. .. image:: on_premise/error-message-sub-code.png :alt: Database registration error message To resolve the issue: - Check the **validity of your Odoo Enterprise subscription** by verifying if your subscription details have the tag :guilabel:`In Progress` on your `Odoo Account `_ or contact your Account Manager. - Ensure that **no other database is linked** to the subscription code, as only one database can be linked per subscription. .. tip:: If a test or a development database is needed, you can :ref:`duplicate a database `. - Verify that **no databases share the same UUID** (Universally Unique Identifier) by opening your `Odoo Contract `_. If two or more databases share the same UUID, their name will be displayed. .. image:: on_premise/unlink-db-name-collision.png :alt: Database UUID error message If that is the case, manually change the database(s) UUID or `send a support ticket `_. - As the update notification must be able to reach Odoo's subscription validation servers, ensure your **network and firewall settings** allow the Odoo server to open outgoing connections towards: - Odoo 18.0 and above: `services.odoo.com` on port `80` - Odoo 17.0 and below: `services.openerp.com` on port `80` These ports must be kept open even after registering a database, as the update notification runs once a week. Too many users error -------------------- If you have more users in a local database than provisioned in your Odoo Enterprise subscription, the following message should be displayed. .. image:: on_premise/add-more-users.png :alt: Too many users on a database error message When the message appears, you have 30 days to act before the database expires. The countdown is updated every day. To resolve the issue, either: - **Add more users** to your subscription by clicking the :guilabel:`Upgrade your subscription` link displayed in the message to validate the upsell quotation and pay for the extra users. - :ref:`Deactivate users ` and **reject** the upsell quotation. Once your database has the correct number of users, the expiration message disappears automatically after a few days, when the next verification occurs. Database expired error ---------------------- If your database expires before you renew your subscription, the following message should be displayed. .. image:: on_premise/database-expired.png :alt: Database expired error message This message appears if you fail to act before the end of the 30-day countdown. To resolve the issue, either: - Click the :guilabel:`Renew your subscription` link displayed in the message and complete the process. If you pay by wire transfer, your subscription will be renewed when the payment arrives which can take a few days. Credit card payments are processed immediately. - `Send a support ticket `_. .. toctree:: on_premise/packages on_premise/source on_premise/update on_premise/deploy on_premise/email_gateway on_premise/geo_ip on_premise/community_to_enterprise