OdooWiki OCA HUB

Upgrade Analysis

upgrade_analysis folder_open OCA/server-tools open_in_new
Migration License: AGPL-3

This module provides the tool to generate the database analysis files that indicate how the Odoo data model and module data have changed between two versions of Odoo. Database analysis files for the core modules are included in the OpenUpgrade distribution so as a migration script developer you will not usually need to use this tool yourself. If you do need to run your analysis of a custom set of modules, please refer to the documentation here:

This module is just a tool, a continuation of the old openupgrade_records in OpenUpgrade in previous versions. It's not recommended to have this module in a production database.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

This module compares the data model of two Odoo databases (an old and a new version) and produces analysis files that list what changed in modules, models, fields and XML records. It is a migration tool, not meant for production use.

Upgrade Analysis is a technical migration tool. It lets you register a connection to another Odoo server (server, port, database, user, password) and test that connection. From a comparison configuration you can launch a new analysis, which reads the model and data definitions of both databases and writes the differences to files.

In Odoo it appears under Administration as the "Upgrade Analysis" menu, with submenus for Upgrade Analyses, Comparison Configurations, Records, and two wizards: Generate Records Wizard and Install Modules Wizard.

  • The analysis screen has a "Perform Analysis" button; it records the analysis date, compares fields, XML records and models, and shows a log. Results can be written to module directories or kept in the log.
  • The Records screen stores the captured definitions (fields, XML IDs, models) with their attributes, and can dump field information.
  • The Generate Records Wizard rebuilds the records table by reinstalling all installed modules.
  • The Install Modules Wizard helps select and install modules, with buttons to select Odoo modules, OCA modules, other modules, all installable modules, or unselect all.
  • It also adds two computed flags on modules: whether a module is an Odoo module and whether it is an OCA module.

It touches ir.module.module, upgrade.analysis, upgrade.attribute, upgrade.comparison.config, upgrade.record and the two wizards.

Depends on

base

Menus it adds

Upgrade AnalysisUpgrade AnalysesComparison ConfigurationsRecordsGenerate Records WizardInstall Modules Wizard
Models and fields (7)
  • upgrade.record · new modelmode, name, type, field, model, domain, module, prefix, suffix, noupdate, definition, model_type, attribute_ids, model_original_module
  • ir.module.module · extends an existing modelis_oca_module, is_odoo_module
  • upgrade.analysis · new modellog, state, config_id (Comparison Config), write_files, upgrade_path, analysis_date
  • upgrade.attribute · new modelname, value, record_id
  • upgrade.install.wizard · new modelstate, module_ids (Modules), module_qty (Modules Quantity)
  • upgrade.comparison.config · new modelname, port, server, version, database, password, username, analysis_ids (Analyses), analysis_qty
  • upgrade.generate.record.wizard · new modelstate

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 6 confirmed, 3 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/server-tools.

terminal Installation and usage

OCA documentation · Odoo 19.0

Usage instructions

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.