Saltar al contenido principal

Mantenimiento

Mantenimiento aquí se refiere a cualquier cosa que implique sacar temporalmente tu validador de la red (para aplicar parches de seguridad, actualizar el sistema, etc.).

Como administrador de un validador, debes asegurarte de que el mantenimiento que vas a aplicar al validador sea seguro para la red en general y para tu validador.

Seguro significa que los otros validadores que dependen del tuyo no se verán demasiado afectados cuando apagues tu validador para mantenimiento y que tu validador seguirá operando como parte de la red cuando vuelva a estar en línea.

Si estás cambiando algunas configuraciones que pueden impactar configuraciones a nivel de red como la versión del protocolo, revisa la página de actualizaciones de la red.

Si estás cambiando la configuración de tu conjunto de quorum, también lee la sección sobre qué hacer.

Pasos recomendados para realizar como parte de un mantenimiento​

Recomendamos realizar los siguientes pasos en orden (repetir secuencialmente según sea necesario si ejecutas múltiples nodos).

  1. Anuncia tu intención a otros que puedan depender de ti. Se requiere algo de coordinación para evitar situaciones donde demasiados nodos se apaguen al mismo tiempo.
  2. Las dependencias deben evaluar la salud de su quorum
  3. Si no hay objeciones, apaga tu instancia
  4. Cuando termines, inicia tu instancia que debería reincorporarse a la red
  5. La instancia estará completamente sincronizada cuando esté tanto Sincronizada como no haya retrasos en la subida de historial.

Aviso a la comunidad: Acción requerida antes de la actualización de Stellar Core​

Hemos identificado un escenario específico en Ubuntu donde la actualización del paquete Stellar Core puede desencadenar inadvertidamente una actualización automática y no planificada de PostgreSQL. Esto puede ocurrir si una versión más reciente de PostgreSQL está disponible en tus repositorios. Esto se debe a que el paquete Stellar Core lo lista como dependencia, y "apt" instala automáticamente el paquete más reciente de PostgreSQL en la misma transacción que la actualización de Stellar Core, lo que puede provocar un reinicio inesperado de la base de datos y causar que el proceso Core se bloquee.

Acción: Para evitar interrupciones en el servicio y asegurar la integridad de los datos, los operadores del nodo deben aplicar manualmente el parche de PostgreSQL ANTES de ejecutar la actualización del paquete Stellar Core.

Pasos previos a la actualización​

Antes de ejecutar cualquier comando apt que incluya el paquete stellar-core, sigue estos pasos para gestionar la actualización de PostgreSQL de forma segura:

  1. Apaga stellar-core correctamente: sudo systemctl stop stellar-core
  2. apt list --upgradable | grep postgresql
  3. sudo apt-get install postgresql-16 postgresql-client-16 # o el paquete de versión específica
  4. Reinicia stellar-core: sudo systemctl start stellar-core
  5. Espera a que el core se sincronice: stellar-core-cmd info

Luego, puedes proceder a desplegar la versión más reciente del paquete stellar-core de la manera habitual (apt, herramienta de gestión de configuración, etc.)

Consideraciones especiales durante las actualizaciones de conjunto de quorum​

Cuando te unas a las filas de los operadores de nodos, también es importante unirse a la conversación. La mejor manera de hacerlo: sigue el canal #validators en el Discord de Desarrolladores de Stellar. Si no puedes hacer esto por alguna razón, inscríbete en el Grupo de Google de Validadores de Stellar.

A veces, una organización necesita hacer cambios que impactarán los conjuntos de quorum de otros:

  • sacar un validador por un largo período de tiempo
  • agregar nuevos validadores a su grupo

En ambos casos, es crucial organizar los cambios para preservar la intersección de quorum y la buena salud general de la red:

  • Ten cuidado al eliminar demasiados nodos de tu conjunto de quorum antes de que los nodos sean apagados. Si diferentes personas eliminan diferentes conjuntos, los conjuntos restantes pueden no superponerse entre nodos y pueden causar divisiones en la red.
  • Ten cuidado al agregar demasiados nodos a tu conjunto de quorum al mismo tiempo. Si no se hace con cuidado, esto puede hacer que esos nodos superen tu configuración.

Los pasos recomendados son que la entidad que agrega/elimina nodos lo haga primero entre sus propios nodos, y luego haga que las personas reflejen esos cambios gradualmente (a lo largo de varias rondas) en sus respectivas configuraciones de quorum.