Actualizar¶
An upgrade involves moving a database from an older version to a newer supported version (e.g., from Odoo 15.0 to Odoo 17.0). Regular upgrades are crucial as each version offers new features, bug fixes, and security patches. Using a supported version is strongly recommended. Each major version is supported for three years.
Depending on the hosting type and Odoo version used, a database upgrade can be mandatory.
Es obligatorio que actualice su base de datos cada dos años si usa una versión principal (por ejemplo, 15.0, 16.0 o 17.0).
If a database is on a minor version (e.g., 17.1, 17.2, 17.4), an upgrade is mandatory a few weeks after the next version is released. Minor versions are usually released every three months.
After the initial three years of support, you will have another two years to complete the upgrade. You will be notified when an upgrade is required.
You can stay on the same version indefinitely, even if it is not recommended. Note that the smaller the version gap, the easier the upgrade should be.
You will receive a notification in your database a few weeks before a mandatory upgrade will be automatically carried out. You are in control of the process as long as the deadline is not reached.
Concretely, Odoo’s Upgrade Team performs a silent test upgrade of every database that should be upgraded. If the test is successful and lasts less than 20 minutes, you can directly trigger the upgrade from the database. If the test fails, you can test an upgrade using the database manager.
When you are invited to upgrade, it is strongly recommended to request an upgraded test database first and spend time testing it.
An automatic upgrade to the next version will be triggered if no action is taken before the specified due date.
Una actualización no cubre:
Cambiar a una versión anterior de Odoo
Cambiar de edición (por ejemplo, de Community a Enterprise)
Cambiar el tipo de alojamiento (por ejemplo, de local a Odoo en línea)
Migración de otro ERP a Odoo
Advertencia
If your database contains custom modules, it cannot be upgraded until a version of your custom modules is available for the target version of Odoo. For customers maintaining their own custom modules, we recommend to parallelize the process by requesting an upgraded database while also upgrading the source code of your custom modules.
Resumen del proceso de actualización¶
Request an upgraded test database (see obtaining an upgraded test database).
Si aplica, actualice el código fuente de su módulo personalizado para que sea compatible con la nueva versión de Odoo (consulte Upgrade a customized database).
Thoroughly test the upgraded database (see testing the new version of the database).
Report any issue encountered during the testing to Odoo by going to the Support page and selecting «An issue related to my future upgrade (I am testing an upgrade)».
Una vez que se resuelvan todos los problemas y esté seguro de que la base de datos actualizada se puede utilizar como su base de datos principal, planifique la actualización de su base de datos de producción.
Request the upgrade for the production database, rendering it unavailable for the time it takes to complete the process (see upgrading the production database).
Report any issue encountered during the upgrade to Odoo by going to the Support page and selecting «An issue related to my upgrade (production)».
Obtener una base de datos de prueba actualizada¶
The Upgrade page is the main platform for requesting an upgraded database. However, depending on the hosting type, you can upgrade from the command line (on-premise), the Odoo Online database manager, or your Odoo.sh project.
Nota
La plataforma de actualización sigue la misma política de privacidad que los demás servicios de Odoo.com. Visite el reglamento general de protección de datos para obtener más información sobre cómo Odoo maneja sus datos y privacidad.
Odoo Online databases can be manually upgraded via the database manager.
El administrador de la base de datos muestra todas las bases de datos vinculadas a la cuenta del usuario. Las bases de datos que no están en la versión más reciente de Odoo muestran un ícono de una flecha en un círculo junto a su nombre, indicando que se pueden actualizar.
Haga clic en el icono de la flecha en un círculo para iniciar el proceso de actualización. En la ventana emergente, complete la siguiente información:
La versión de Odoo a la que desea actualizar, generalmente es la última versión.
El correo electrónico que debe recibir el enlace a la base de datos actualizada
El propósito de la actualización, se establece como prueba de forma automática en su primera solicitud de actualización.
La etiqueta actualización en progreso se muestra junto al nombre de la base de datos hasta que se complete. Una vez que se termine el proceso, se enviará un correo electrónico con un enlace a la base de datos de prueba actualizada a la dirección proporcionada. También podrá acceder a la base de datos desde el administrador de la base de datos, solo debe hacer clic en la flecha desplegable antes del nombre de la base de datos.
Odoo.sh está integrado con la plataforma de actualización para hacer el proceso de actualización más sencillo.
The latest production daily automatic backup is then sent to the Upgrade platform.
Una vez que la plataforma de actualización haya terminado de actualizar la copia de seguridad y la haya cargado en la rama, se colocará en un modo especial: cada vez que envíe una confirmación a su rama, se realizará una operación de restauración de la copia de seguridad actualizada y una actualización de todos los módulos personalizados. Esto le permite probar sus módulos personalizados en una copia exacta de la base de datos actualizada. Puede encontrar el archivo de registro del proceso de actualización en su nueva compilación de preparación actualizada en: file:~/logs/upgrade.log
.
Importante
Si se trata de bases de datos con módulos personalizados es necesario actualizar el código fuente con la versión objetivo de Odoo antes de que se pueda realizar la actualización. Si no hay ninguno, se omitirá el modo «actualizar al confirmar», se construirá la base de datos actualizada tan pronto como se transfiera desde la plataforma de actualización y se saldrá del modo de actualización.
Consulte la página Upgrade a customized database para obtener más información.
Puede iniciar el proceso de actualización estándar al escribir el siguiente comando en la línea de comandos de la máquina donde se encuentra alojada la base de datos.
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
Nota
This command has some requirements on the environment it runs in:
Some external commands that must be provided by the operating system, normally found in any Linux distribution (including WSL). An error will be displayed if one or several of them are missing.
The system user that executes the command needs to be configured with access to the database. Please refer to the PostgreSQL documentation of the client environment or the client password file for this requirement.
The script needs to be able to reach one or multiple servers of the upgrade platform both on TCP port 443 and to any random TCP port in the range between 32768 and 60999. This can be in conflict with your restrictive firewall and may need an exception added to the firewall configuration.
Puede utilizar el siguiente comando para mostrar la ayuda general y los comandos principales.
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
Importante
En las bases de datos que tienen módulos personalizados instalados, el código fuente de estos módulos debe estar actualizado para la nueva versión de Odoo antes de que se realice la actualización. Consulte Upgrade a customized database para obtener más dtalles.
Nota
Por razones de seguridad, solo la persona que envío la solicitud de actualización puede descargarla.
Por motivos de almacenaje, debe subir la copia de su base de datos sin un repositorio de archivos al servidor de actualización. Por lo tanto, la base de datos actualizada no contiene el repositorio de archivos de producción.
Antes de restaurar la base de datos actualizada, su repositorio de archivos debe estar unido a al repositorio de archivos de producción para que pueda realizar las pruebas bajo las mismas condiciones que la nueva versión.
La base de datos actualizada contiene:
Un archivo
dump.sql
que contiene la base de datos actualizada.Una carpeta de
repositorio de archivos
que contiene los archivos que se extrajeron de los registros internos de la base de datos en archivos adjuntos (si es que hay) y nuevos archivos estándar de Odoo de la versión objetivo de Odoo (imágenes nuevas, iconos, logos de los proveedores de pago, etc.). Esta es la carpeta que debe fusionarse con el repositorio de archivos de producción para obtener el repositorio completo.
Nota
Puede solicitar múltiples bases de datos de prueba si desea probar una actualización más de una vez.
Nota
Al completar una solicitud de actualización, el reporte de actualización se adjunta al correo electrónico de actualización exitosa y además también está disponible en la aplicación Conversaciones para los usuarios que forman parte del grupo «Administración / Ajustes». Este reporte proporciona información importante sobre los cambios introducidos por la nueva versión.
Probar la nueva versión de la base de datos¶
It is essential to test the upgraded test database to ensure that you are not stuck in your day-to-day activities by a change in views, behavior, or an error message once the upgrade goes live.
Nota
Las bases de datos de prueba están neutralizadas y algunas de sus funciones están deshabilitadas para evitar que afecten la base de datos de producción:
Las actividades programadas están deshabilitadas.
Los servidores de correo saliente se deshabilitan. Para esto, los que ya existen se archivan y además se agrega uno falso.
Los proveedores de pago y los transportistas se restablecen a un entorno de prueba.
La sincronización bancaria se deshabilita. En caso de que desee probarla, póngase en contacto con su proveedor de sincronización bancaria para que le proporcione las credenciales del entorno de prueba.
Le recomendamos probar tantos flujos empresariales como le sea posible para asegurarse de que funcionen de forma correcta y para que se familiarice más con la nueva versión.
Lista de verificación de prueba básica
¿Hay vistas que están desactivadas en su base de datos de prueba pero activas en su base de datos de producción?
¿Sus vistas habituales se muestran de forma correcta?
¿Sus reportes (facturas, órdenes de ventas, etcétera) se están generando de manera correcta?
¿Las páginas de su sitio web están funcionando de forma adecuada?
¿Puede crear y modificar registros? (como órdenes de ventas, facturas, compras, usuarios, contactos, empresas, etcétera).
¿Las plantillas de correo electrónico presentan errores?
¿Las traducciones almacenadas tienen errores?
¿Sus filtros de búsqueda están disponibles?
¿Puede exportar sus datos?
Verificar un producto aleatorio de su catálogo de productos y comparar sus datos de prueba y producción para comprobar que todo es igual (categoría del producto, precio de venta, precio de costo, proveedor, cuentas, rutas, etcétera).
Comprar el producto (aplicación Compra).
Confirmar su recepción (aplicación Inventario).
Verificar si la ruta para recibir el producto es la misma que estableció en la base de datos de producción (aplicación Inventario).
Vender el producto (aplicación Ventas) a un cliente aleatorio.
Abrir la base de datos con sus clientes (aplicación Contactos), seleccionar un cliente (o empresa) y verificar su información.
Enviar el producto (aplicación Compra).
Verificar si la ruta para enviar el producto es la misma que estableció en la base de datos de producción (aplicación Inventario).
Validar la factura del cliente (aplicación Facturación o Contabilidad).
Acreditar una factura (emitir una nota de crédito) y verificar si se comporta de la misma manera que en la base de datos de producción.
Verificar el reporte de resultados (aplicación Contabilidad).
Revisar de forma aleatoria sus impuestos, divisas, cuentas bancarias y año fiscal (aplicación Contabilidad).
Realizar todas las etapas de una orden en línea (aplicación Sitio web), desde la selección de productos en su tienda hasta el proceso de pago. Verificar si todo se comporta de la misma manera que en la base de datos de producción.
Esta lista no está completa. El ejemplo puede extenderse a otras de sus aplicaciones según el uso que le da a Odoo.
If you face an issue while testing your upgraded test database, you can request the assistance of Odoo by going to the Support page and selecting «An issue related to my future upgrade (I am testing an upgrade)». In any case, it is essential to report any problem encountered during the testing to fix it before upgrading your production database.
Es posible que haya algunas diferencias significativas en las vistas estándar, funciones, campos y modelos al momento de realizar las pruebas. No es posible revertir cada cambio de forma individual, sin embargo, si uno de los cambios introducido por una nueva versión hace que una personalización tenga errores, es responsabilidad de la persona que le da mantenimiento a su módulo personalizado que sea compatible con la nueva versión de Odoo.
Truco
No olvide probar lo siguiente:
Integraciones con software externo (EDI, API, etcétera).
Flujos de trabajo compartidos entre varias aplicaciones (vender en línea con Comercio electrónico, convertir un lead en una orden de venta, entregar productos, etcétera).
Exportación de datos.
Acciones automatizadas.
Acciones del servidor en el menú de acción desde las vistas de formulario, así como al seleccionar varios registros en las vistas de lista.
Actualizar la base de datos de producción¶
Once the tests are completed and you are confident that the upgraded database can be used as your main database without any issues, it is time to plan the go-live day.
Su base de datos de producción no estará disponible mientras se actualiza. Le recomendamos que realice la actualización en un momento en que el uso de la base de datos es mínimo.
Como los scripts de actualización estándar y su base de datos evolucionan de forma constante, también le recomendamos que con frecuencia solicite otra base de datos de prueba actualizada, con la finalidad de asegurarse de que el proceso de actualización se realiza con éxito, sobre todo si su finalización toma mucho tiempo. Además, le recomendamos ensayar todo el proceso de actualización un día antes de actualizar la base de datos de producción.
Importante
Empezar a usar la producción sin hacer pruebas primero puede ocasionar:
Que los usuarios no se ajusten a los cambios y nuevas funciones.
Que haya interrupciones en las actividades empresariales (por ejemplo, ya no contar con la posibilidad de validar una acción).
Que los clientes tengan una mala experiencia de usuario (por ejemplo, si un sitio web de comercio electrónico deja de funcionar de manera adecuada).
The process of upgrading a production database is similar to upgrading a test database, but with a few exceptions.
The process is similar to obtaining an upgraded test database, except for the purpose option, which must be set to Production instead of Test.
Advertencia
Después de solicitar la actualización, la base de datos no estará disponible hasta que termine la actualización. Una vez que el proceso haya finalizado, es imposible volver a la versión anterior.
The process is similar to obtaining an upgraded test database on the Production branch.
El proceso se activa al momento en que hace un nuevo commit en la rama. Esto permite que el proceso de actualización se sincronice con la implementación del código fuente actualizado de los módulos personalizados. Si no hay módulos personalizados, el proceso de actualización se activa de inmediato.
Importante
La base de datos no está disponible durante todo el proceso. Si ocurre algún error, la plataforma revierte la actualización de forma automática, como si se tratara de una actualización regular. En caso de que el proceso sea exitoso, se crea una copia de seguridad de la base de datos antes de la actualización.
La actualización de sus módulos personalizados debe ser exitosa antes de completar todo el proceso de actualización. Asegúrese de que su actualización de prueba sea éxitosa antes de intentarlo en producción. Para obtener más información sobre cómo actualizar sus módulos personalizados consulte Upgrade a customized database.
El comando para actualizar una base de datos a producción es parecido al comando para actualizar una base de prueba, solo debe reemplazar el argumento test
por production
:
$ python <(curl -s https://upgrade.odoo.com/upgrade) production -d <your db name> -t <target version>
An upgraded production database can also be requested via the Upgrade page.
Once the database is uploaded, any modification to your production database will not be present on your upgraded database. This is why we recommend not using it during the upgrade process.
Importante
Al solicitar una base de datos actualizada para fines de producción, la copia se envía sin los archivos almacenados. Por lo tanto, los archivos almacenados de la base de datos actualizada deben fusionarse con los que corresponden a producción antes de implementar la nueva versión.
In case of an issue with your production database, you can request the assistance of Odoo by going to the Support page and selecting «An issue related to my future upgrade (I am testing an upgrade)».
Acuerdo de nivel de servicio (SLA, por sus siglas en inglés)¶
Con Odoo Enterprise, actualizar la base de datos a la versión más reciente es gratis e incluye cualquier tipo de soporte requerido para rectificar posibles discrepancias en la base de datos actualizada.
Tiene disponible información acerca de los servicios de actualización que incluye la Licencia Enterprise en el Acuerdo de Suscripción de Odoo Enterprise. Sin embargo, esta sección aclara qué servicios de actualización puede esperar.
Servicios de actualización que cubre el SLA¶
Las bases de datos alojadas en las plataformas en la nube de Odoo (Odoo en línea y Odoo.sh) o que se alojan a si mismas (Local) se pueden beneficiar de los servicios de actualización en todo momento para:
actualizar todas las aplicaciones estándar;
actualizar todas las personalizaciones creadas con la aplicación Studio, siempre y cuando Studio siga instalado y la suscripción correspondiente siga activa; y
actualizar todos los desarrollos y personalizaciones que cubre una suscripción de mantenimiento para las personalizaciones.
Los servicios de actualización se limitan a una conversión técnica y la adaptación de una base de datos (módulos estándar y datos) para hacerlos compatibles con la versión objetivo de la actualización.
Servicios de actualización que no cubre el SLA¶
Los siguientes servicios relacionados con la actualización no incluyen:
la limpieza de datos y configuraciones pre-existentes al momento de actualizar;
the upgrade of additional modules not covered by a maintenance contract that are created in-house or by third parties, including Odoo partners; and
capacitación para usar las funciones de la versión actualizada y flujos de trabajo.