> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/es/operaciones/sop-update.md). # Guía de actualización de versiones de VergeOS Esta guía ofrece las mejores prácticas para actualizar de forma segura un sistema VergeOS a una nueva versión puntual. Se centra en la seguridad de los datos y la resiliencia del sistema mediante un enfoque metódico. {% hint style="info" %} **Descripción general** Actualizar su sistema VergeOS requiere una planificación y ejecución cuidadosas para garantizar una interrupción mínima de sus servicios. Esta guía desglosa el proceso en fases principales: 1. **Preparación** - Pasos a seguir antes de su ventana de mantenimiento programada 2. **Verificación previa a la actualización** - Comprobaciones finales inmediatamente antes de comenzar la actualización 3. **Ejecución de la actualización** - El proceso de instalación de la actualización 4. **Verificación posterior a la actualización** - Asegurarse de que la actualización se realizó correctamente {% endhint %} {% hint style="info" %} **Requisitos específicos del entorno** Esta guía cubre buenas prácticas generales. Es posible que deba adaptar estos pasos a su entorno y requisitos específicos. {% endhint %} ## Requisitos previos * Acceso administrativo al sistema VergeOS * Acceso IPMI a todos los nodos del clúster * Conectividad de red para las descargas de actualización * **Tiempo estimado:** 1-2 horas según el tamaño del clúster y la complejidad de la actualización ## Fase de preparación Complete estos pasos con suficiente antelación a su ventana de mantenimiento programada: ### Preparación del sistema * [ ] Asegúrese de que la retención de instantáneas del sistema sea suficiente para una posible reversión * [ ] Establezca criterios específicos de éxito y verificación para sus cargas de trabajo * [ ] Identifique cohortes de VMs, servicios, etc. necesarios para su caso de uso particular {% hint style="info" %} **Ejemplos de casos de uso** VDI puede tener varias imágenes o grupos de recursos distintos. VPS puede centrarse más en la funcionalidad y la conectividad de la red. {% endhint %} * [ ] Mapee cualquier evento del sistema y de los invitados que dependa del tiempo y que deba seguir funcionando ### Documentación y planificación * [ ] Actualice la documentación de la plataforma con la ventana de mantenimiento planificada * [ ] Revise cualquier actualización/mejora sinérgica que pueda ser necesario ejecutar * Evite combinar actualizaciones innecesarias * [ ] Revise las notas de la versión y planifique cualquier impacto específico * [ ] Documente la configuración actual del sistema como referencia para la reversión * [ ] Planifique el cronograma de comunicación para los usuarios afectados ### Verificación de recursos * [ ] Compruebe la utilización de recursos del clúster * Asegúrese de que su sistema tenga suficientes recursos de reserva para perder su nodo más grande * [ ] Confirme las rutas de red entre los hosts * Desde cada nodo: Diagnóstico de nodo -> Configuración de Fabric (todas las rutas en todos los nodos deben estar "confirmed:true") * [ ] Si la redundancia de red no se ha probado recientemente, programe una prueba antes de actualizar * [ ] Confirme el acceso IPMI a todos los hosts mediante un método que permita acceso a la consola en caso de emergencia ### Preparación de la actualización 1. En VergeOS, navegue a **Sistema > Actualizaciones** 2. Haga clic en **Buscar actualizaciones** 3. Descargue la actualización (no comenzará hasta que se haga clic en "Instalar") 4. Registre la versión actual y la versión objetivo para la documentación ## Verificación previa a la actualización Realice estas comprobaciones el día del mantenimiento programado, antes de comenzar la actualización: ### Verificación del estado actual * [ ] Confirme que la versión en ejecución es la versión esperada * [ ] Revise los registros en busca de errores recientes * Anote cualquier problema no crítico * Cancele si se encuentran errores críticos * [ ] Verifique que la disponibilidad de recursos cumpla los requisitos N+1 * Confirme que el uso de RAM permite que las cargas de trabajo se ejecuten con un nodo fuera de línea * [ ] Verifique que las instantáneas del sistema sean recientes y estén disponibles * Establezca que la instantánea más reciente expire varios días en el futuro para una retención adicional * [ ] Confirme que la sincronización multisitio funciona y está actualizada * [ ] Verifique que todos los niveles de vSAN estén en buen estado (estado verde) * [ ] Confirme que no haya nodos pendientes de reinicio * [ ] Registre la línea base del rendimiento del sistema para compararla después de la actualización ### Verificación de la actualización * [ ] Confirme su actualización preparada en **Sistema > Actualizaciones** * [ ] Vuelva a buscar actualizaciones * Si hay otra actualización, evalúela cuidadosamente antes de continuar * [ ] Verifique que haya suficiente espacio en disco para el proceso de actualización * [ ] Confirme que todos los nodos sean accesibles y respondan ## Fase de ejecución ### Instalando la actualización El proceso real de actualización: 1. Navegue a **Sistema > Actualizaciones** 2. Haga clic en **Instalar** para comenzar el proceso de actualización 3. **Supervise el Nodo 1** mientras automáticamente: * Se pone en modo de mantenimiento * Se reinicia y aplica la actualización * Vuelve al servicio 4. **Observe los nodos posteriores** mientras el sistema continúa actualizando y reiniciando nodos 5. **Supervise las cargas de trabajo** y el uso de recursos del sistema durante todo el proceso 6. **Siga el progreso** - cada nodo se actualizará secuencialmente para mantener la disponibilidad del servicio {% hint style="success" %} **Supervisión de la actualización** Durante el proceso de actualización, puede supervisar el progreso en la sección Sistema > Actualizaciones. Cada nodo mostrará su estado actual y el progreso a través de las etapas de actualización. {% endhint %} {% hint style="warning" %} **No interrumpir** No apague los nodos ni interrumpa el proceso de actualización una vez que haya comenzado. Permita que cada nodo complete su ciclo de actualización de forma natural. {% endhint %} ## Verificación posterior a la actualización Después de que la actualización finalice, verifique que el sistema funcione correctamente: ### Confirmación de versión * [ ] Confirme la versión esperada en **Sistema > Actualizaciones** * Verifique que los siguientes paquetes estén en la versión esperada: * **osm** (datos de OpenStreetMap) * **yb** (conjunto de software en la nube de Verge.io) * **yb-help** (ayuda y documentación integradas) * **ybos** (sistema operativo Verge.io) ### Comprobaciones de estado del sistema * [ ] Confirme que el mosaico "Nodes Updated" en **Sistema > Actualizaciones** esté en verde y todos los nodos hayan finalizado * [ ] Asegúrese de que todos los niveles de vSAN muestren estado verde * [ ] Verifique que todos los nodos muestren estado verde "Running" * Confirme que los nodos no tengan reinicios pendientes * [ ] Pruebe/confirme los sistemas invitados según sea necesario de acuerdo con sus criterios de éxito * [ ] Tome una instantánea manual con varios días de retención * [ ] Revise los registros en busca de eventos nuevos o inesperados * [ ] Verifique todos los criterios de éxito descritos en sus pasos de preparación * [ ] Confirme que el rendimiento del sistema coincide con la línea base o la supera ### Pruebas de funcionalidad * [ ] Pruebe las operaciones críticas de VM (iniciar, detener, migrar) * [ ] Verifique la conectividad y el rendimiento de la red * [ ] Confirme que las operaciones de copia de seguridad y de instantáneas funcionan * [ ] Pruebe cualquier integración o automatización personalizada ## Solución de problemas ### Problemas comunes **El proceso de actualización se atasca en un nodo** * Compruebe la accesibilidad del nodo mediante IPMI * Revise los registros del sistema en busca de mensajes de error * Verifique la conectividad de red con el nodo atascado * Póngase en contacto con soporte si el nodo sigue sin responder **Desajuste de versión después de la actualización** * Permita tiempo adicional para que todos los componentes se sincronicen * Compruebe si alguna instalación de paquetes falló * Verifique la conectividad de red entre nodos * Revise los registros de actualización en busca de errores específicos **Degradación del rendimiento después de la actualización** * Compare con la línea base previa a la actualización * Compruebe si hay nuevas limitaciones de recursos * Revise el estado y el rendimiento de los niveles vSAN * Monitoree durante 24-48 horas para establecer una nueva línea base **Las VMs no se inician después de la actualización** * Compruebe la compatibilidad de la configuración de la VM * Verifique la accesibilidad del nivel de almacenamiento * Revise los registros específicos de la VM en busca de errores * Pruebe las operaciones de la VM de forma individual ## Procedimiento de reversión {% hint style="warning" %} **Consideraciones sobre la reversión** Si se producen problemas, el enfoque más seguro es pausar, investigar el comportamiento inesperado y luego continuar de nuevo con una comprensión clara del problema. Las actualizaciones de VergeOS están diseñadas para ser compatibles hacia adelante, y la reversión no siempre puede ser posible. {% endhint %} ### Si se producen problemas 1. **Documente el problema** detalladamente con capturas de pantalla y registros 2. **Aísle el problema** - determine si afecta a todos los nodos o a componentes específicos 3. **Contacte con soporte** antes de intentar cualquier procedimiento de reversión 4. **Conserve el estado del sistema** para el análisis de solución de problemas 5. **Siga las indicaciones del soporte** para los procedimientos de resolución o reversión ## Próximos pasos Después de completar con éxito la actualización: * [ ] Actualice la documentación del sistema con la nueva información de la versión * [ ] Programe un monitoreo rutinario para garantizar la estabilidad * [ ] Revise cualquier nueva función o cambio introducido en la actualización * [ ] Planifique futuras actualizaciones según los calendarios de versiones * [ ] Actualice los procedimientos de copia de seguridad y recuperación ante desastres si es necesario {% hint style="danger" %} **Soporte de emergencia** Si tiene algún problema con su actualización de software VergeOS, póngase en contacto con [nuestro equipo de soporte](/overview/es/support-and-services.md) para asistencia inmediata. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/es/operaciones/sop-update.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.