Nota: Lo que sigue es solo una guía. Cada cliente es diferente.

A través de nuestra experiencia en soporte ayudando a clientes, hemos visto muchos casos en los que no tener un plan de actualización adecuado (y documentado) conduce a problemas  inesperados con prioridad de Crisis. En algunos casos, podemos solucionar el problema durante el periodo de actualización, pero no siempre, ya que algunas situaciones pueden requerir una investigación más exhaustiva que puede llevar días o incluso meses.

Es esencial documentar el proceso de actualización, incluyendo los pasos que se deben efectuar antes, durante y después de la actualización, ¡incluso en servidores y aplicaciones pequeñas! Además, un plan de actualización documentado es muy útil cuando involucra a terceros, como proveedores de software o hardware. Al entregar este documento a un proveedor externo (como InterSystems) se acelerará la comprensión de todo el contexto.

Después de trabajar con diferentes documentos, me gustaría compartir unas instrucciones generales para ayudaros a crear un plan de actualización o para ponerlo al día. Por supuesto, se me escaparán algunas cosas. Estoy seguro de que algunos de vosotros tenéis mucha experiencia y podréis añadir ideas y sugerencias, ¡así que no dudéis en comentar este artículo!

Nota: Lo que sigue es solo una guía. Cada cliente es diferente.

---

Manual para realizar actualizaciones con éxito

Cada actualización a una versión principal (major) debería tener unos pasos y estrategias imprescindibles, similares a las que se describen aquí. Nuestra experiencia con clientes demuestra que un plan detallado es clave para una actualización con éxito, con pruebas y acciones documentadas.
 

Introducción

Incluye una breve descripción de la actualización, sin detalles. Incluye el objetivo y la situación actual.
 

1. Infraestructura

Incluye una tabla con los datos esenciales y documentos detallados (listos para ser enviados). Debe incluir la arquitectura actual y la futura (si corresponde).

Arquitectura ACTUAL (ejemplo general)

Servidor	IP	FUNCIÓN	HW	Producto	Sistema Operativo
PROD1	192.178.1.10	REPLICAR	10 cores 20 RAM	Caché 2017.2	Windows 2012
PROD2	192.178.1.11	REPLICAR	10 cores 20 RAM	Caché 2017.2	Windows 2012
	192.178.1.30	VIP
ARB	192.178.1.12	Árbitro	2 cores 4 RAM	Caché 2017.2	Windows 2012
BCK	192.178.1.13	Recuperación en caso de desastre (DR)	24cores 10 RAM	Caché 2017.2	Windows 2012

Detalles
Extrae los siguientes datos y guárdalos en un sitio compartido, listos para ser enviados si alguien los requiere:

• Informe de ^Buttons o ^SystemCheck para cada servidor
• Informe de ^Buttons o ^SystemPerformance para cada servidor. Los datos deben abarcar unos cuantos días, incluyendo el día de mayor actividad
• Detalles del hardware (proveedor, especificaciones, etc.)

Arquitectura FUTURA (si está prevista su actualización)

Obtener datos similares a los de la arquitectura actual.
 

2. Contactos

Puede parecer de sentido común, pero es esencial saber quién tiene autoridad para tomar decisiones relacionadas con las actualizaciones, quién está a cargo de qué y a quién hay que contactar en caso de emergencia. Es imprescindible disponer de una tabla sencilla adjunta al documento de actualización.

Nombre	Función	Empresa	Teléfono	Correo electrónico
John	Administrador	ACME	+34222222	John@acme.com
Gary	Desarrollador	ACME	+34222222	Gary@acme.com
Susan	Gestor	ACME	+34222222	susana@acme.com
Centro de Soporte Internacional (WRC)	Soporte de InterSystems (ISC)	InterSystems	+112321321	support@intersytems.com
Dell	Soporte de Dell	Dell	+1xxx	support@delll.com

3. Plan de prueba y detalles

Incluye una descripción de las pruebas realizadas actualmente y las previstas. Las pruebas deben abarcar una actualización completa con un entorno similar. Las pruebas de actualización deberían permitir completar las siguientes secciones sobre la actualización. Si no hay pruebas o no se han completado, deberá anotarse y prepararse para cruzar los dedos. ;-)
 

4. Principales pasos de la actualización

Debería incluir un resumen sencillo de los diferentes pasos. Por ejemplo:

1. Stop instances (Prod1 and Prod2)
2. Copy database folders to new systems (NewProd1 and NewProd2)
3. Start NewProd1
4. Compile classes on new Prod1, run update data scripts
5. Start NewProd2
6. Check Mirror synch
7. Assign old IPs
8. Allow users to connect

 

5. Detalles del plan

Detalla los pasos anteriores y cómo realizarlos, incluyendo los comandos que se deben ejecutar, los archivos para importar, etc. La mayoría de los pasos no son útiles para empresas externas que no conocen las aplicaciones, y puede que no sea necesario incluirlas cuando se envíe el plan a terceros.
 

6. Tareas relacionadas

Las actualizaciones, incluyendo los cambios en las aplicaciones, normalmente requieren tareas que hay que realizar antes, durante y después. Se puede crear una sencilla tabla de tareas para controlar todos los pasos, los tiempos, etc.

Un plan detallado pueden incluir cosas como:

Tareas previas a la actualización (ejemplo)

(Detallar todas las tareas necesarias antes de la actualización)

Tarea	Fecha	Estado	Responsable	Notas
Actualizar índices	09/07/22	Hecho	Integración	Actualizar los índices en X para soportar XY
Actualizar el IIS	09/08/22	Pendiente	Administración Web	Actualizar los servidores web antes de realizar la actualización final
Obtener el informe de integridad	09/07/22	Hecho	Administración de Iris	Obtener un informe de integridad de todas las bases de datos

Tareas durante la actualización (ejemplo)

(Detallar las tareas y el plan de actualización paso a paso)

Tarea	Hora (planificada)	Hora (real)	Estado	Responsable	Notas
Parar a los usuarios	06:00	06:10	Pendiente	Integración	Llamar a X para detener las conexiones
Obtener ^SystemCheck	06:10		Pendiente	Administración de Iris
...	..		...	...
Permitir conexiones	09:10		Pendiente	Administración de Iris

 

Tareas después de la actualización

(Detallar todas las tareas necesarias después de la actualización)

Tarea	Fecha	Estado	Responsable	Notas
Activar ^SystemPerformance	01/01/22	Pendiente	Administración de Iris	Ejecutar el funcionamiento durante unos días

5. Incidencias/Problemas durante la actualización

Escribe los problemas encontrados durante la actualización. Especialmente los problemas que no impidan la actualización. Esta lista puede incluir una falta de comandos necesarios, mensajes de error nuevos, etc. Esta lista te ayudará a mejorar los documentos de actualización futuros y a que no te olvides de arreglar los problemas actuales.

6. Plan de recuperación en caso de desastres / Regresar

Describe el plan en caso de que la actualización falle. Esto debería implicar volver a los antiguos servidores, detener los nuevos, iniciar X, Z, etc. Es útil tener escritos todos los pasos para volver a un escenario de seguridad. Recuerda que el plan de recuperación en caso de desastres normalmente se realiza bajo estrés, y es fácil omitir pasos y olvidar cómo hacerlo o dónde están los archivos, las configuraciones, etc.

Este plan de recuperación debería ser un enlace o ampliación al documento de recuperación existente. Y sino hubiese ninguno, sería un buen momento de crearlo, ya sabéis, la ley de Murphy...

 

* * *

El objetivo principal de esta guía es que conozcas las dificultades del proceso de actualización y que pienses por adelantado.

Probar, documentar y volver a probar es la garantía de actualizaciones con éxito.