This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

Updating your OpenERP Installation

Going to a Newer Minor/Patch Release

OpenERP's release policy states that minor/patch releases of the stable versions are usually published every month. These are recommended for production deployment, as they include the latest security updates and bugfixes, and do not require any migration process.

Of course you should always test these updates on a staging environment (copy of your production environment) before actually applying them on the real production systems.

For more details regarding the release cycle, have a look at the section OpenERP Release Policy FAQ.

Minor/patch releases of OpenERP are identified by an increasing 3rd release number, for example, v6.0.15 would be the 15th patch release of OpenERP v6.0.

Note

Minor Versions

You can skip minor versions, for example, you do not need to install all the intermediary versions between 6.0.6 and 6.0.15 if you need to upgrade an outdated installation, as long as you stay in the same version line (6.0 in this example).

Updating an existing OpenERP installation to a newer patch release boils down to 2 operations:

  • Install the new code over the existing one

  • Synchronize each existing database with the new code

In order to accomplish this, the following step-by-step procedure should give you the best results:

  1. Make a fresh backup of all existing databases, as well as a backup of the files of your OpenERP installation (server, web and addons), just in case.

  2. Stop the OpenERP server and the Web Server (if present).

  3. Update the source files to the latest release, or simply install the new releases over the previous ones. If need be, you can uninstall the previous version, but be sure to avoid uninstalling PostgreSQL, as this could delete your current databases!

  4. Locate the separate server executable openerp-server.exe (this is not the executable used by the Windows Service!). It should be in the location where you installed OpenERP Server, for example in C:\Programs\OpenERP 6.0\Server.

  5. From a Command-Line Prompt, start the server executable manually (directly call the executable you located above), with the following parameters, to trigger an update of all module data and views in the database, based on the new source files (include your usual startup parameters, if any, and replace DB_NAME with the name of the OpenERP database you wish to update):

    openerp-server.exe -d DB_NAME -u all
    
  6. Let the server complete its startup (watch the log file for the final message that says OpenERP server is running, waiting for connections or wait until you can connect to that database with a GTK client), then stop the server using the Ctrl+C key combination and repeat previous step for each database on this OpenERP installation (any database not updated will use the latest business logic but might have errors or missing improvements in the views until you update it using this procedure).

  7. Stop the server again with Ctrl+C and restart it normally as a service.

  8. Start the Web Server if present.

  9. You can now proceed with the update of the GTK clients, which can be done separately by simply reinstalling the latest version over the previous one.

Note

Server

As an alternative to restarting the server in update mode for each database, as described above, you may try to start the server normally after installing the new version, and then connect to each database as the Administrator user, open the list of modules and manually trigger an update of the base module.

Because all modules depend on base they will be updated too. However this requires the Administrator password of each database and may not work for some updates, specifically when the update prevents you from logging into the system.

Tip

Developer Book

For more technical details on the actual operations accomplished by the server during such an update, you may refer to the corresponding section in the Developer Book: Upgrading Server, Modules.

Going to a Newer Major Release

OpenERP's release policy states that one or two major releases are published from the development version every year. Transitioning to the next major release implies a lot more changes than jumping to another minor release. As the underlying OpenERP data structures usually evolve quite a bit from one major release to the next, a full migration of the existing data is needed. Each major release will be published with specific recommendations and procedures for upgrading an existing OpenERP system to the next major version.

Note

Major Release

For major releases, it is usually not possible to skip one release, for example upgrading directly from OpenERP 4.2 to OpenERP 6.0. If you need to do such an upgrade, you will simply have to do each intermediary upgrade one after the other.