Cómo mantener su nodo Bitxor en funcionamiento de manera saludable.

Mantenimiento de un nodo

Una vez que hayas creado un nodo de Bitxor, ya sea manualmente o usando el arranque de Bitxor, el nodo es en su mayoría autónomo. Sin embargo, aún se requiere un poco de mantenimiento, que se explica en esta guía.

Actualizaciones del cliente

Nuevas versiones del cliente de Bitxor se lanzarán periódicamente. Si deseas aprovechar las nuevas funciones y correcciones de errores, deberás actualizar tu nodo a la última versión del cliente.

Además, si la versión del cliente de tu nodo queda muy rezagada, es posible que otros nodos se nieguen a conectarse a él.

La versión principal a tener en cuenta es la versión del cliente de BitxorCore, ya que este componente es utilizado por todos los nodos pares. Además, los nodos de API también deben tener en cuenta la versión del componente REST.

  • Cómo averiguar cuáles son las últimas versiones:

    Cada vez que se lance una nueva versión del cliente, se anunciará a través de la cuenta de Twitter de Bitxor y el canal de Discord. También puedes estar atento a los diferentes repositorios de GitHub y a la página de la matriz de compatibilidad para conocer las últimas versiones del cliente y REST.

  • Cómo averiguar las versiones de tu nodo:

    Puedes encontrar las versiones utilizadas por tu nodo en la lista de nodos de Bitxor Explorer.

    Además, si tu nodo es un nodo de API, también puedes consultarlo directamente:

    • Versión del cliente: punto final /node/info, propiedad version.

      Note

      La version se codifica como un único entero de 4 bytes, donde el byte más significativo codifica la versión principal y los demás bytes son la versión menor, la versión micro y la versión de parche.

      Por ejemplo, la versión 16777472 (decimal) es 01000100h (hexadecimal), lo que corresponde a la versión 1.0.1.0.

    • Versión de REST: punto final /node/server, propiedad restVersion.

      restVersion es una cadena de versión como �?.3.6�?/strong>, por ejemplo.

El procedimiento exacto para actualizar tu nodo depende de cómo lo hayas creado. Lee la sección correspondiente a continuación.

Actualizar nodos creados con Bootstrap

Si utilizaste Bitxor Bootstrap para crear tu nodo (siguiendo la guía Ejecutar un nodo), mantenerlo actualizado es muy sencillo.

  1. Actualiza Bitxor Bootstrap primero (consulta la guía Uso de Bitxor Bootstrap para obtener más detalles):

    npm install -g bitxor-bootstrap

  2. Luego, dirígete a la carpeta donde se encuentra la carpeta de datos del nodo (normalmente target) y detén el nodo.

    El comando exacto para detenerlo depende de si tu nodo se ejecutaba en modo desvinculado o no:

    • Si iniciaste en modo desvinculado con bitxor-bootstrap start --detached:

      Desde la carpeta que contiene la carpeta target, escribe:

      bitxor-bootstrap stop

    • Si no iniciaste en modo desvinculado:

      Debes tener una terminal ejecutándose en algún lugar con toda la salida del cliente. Detenlo presionando Ctrl+C.

  3. A continuación, realiza una copia de seguridad de la carpeta de datos del nodo:

    cp -r target target.BAK

  4. Finalmente, vuelve a iniciar el nodo con la opción --upgrade para actualizar todas las versiones de los componentes necesarios.

    Agrega también la opción --detached para iniciar en modo desvinculado si es necesario.

    bitxor-bootstrap start --upgrade -c custom-presets.yml

  5. Una vez que el nodo esté en funcionamiento nuevamente y verifiques que se hayan actualizado las versiones de los componentes, puedes eliminar la copia de seguridad.

Actualizar nodos creados manualmente

Si seguiste la guía Ejecutar un nodo manualmente, debes reconstruir el cliente BitxorCore y mantener la carpeta de datos anterior para reutilizar las mismas cuentas y datos en caché.

En resumen, debes hacer lo siguiente:

  • Detén el cliente de BitxorCore en ejecución con Ctrl+C.

  • Actualiza el repositorio fuente del cliente BitxorCore con la última versión y constrúyelo nuevamente siguiendo las instrucciones de BitxorCore client.

  • Reinicia el cliente desde la misma carpeta desde la que se inició inicialmente. Se reutilizarán los archivos de datos y configuración.

Note

El procedimiento anterior funciona, pero hace que el cliente esté fuera de línea mientras se construye la nueva versión, lo cual podría llevar tiempo.

Si instalas el cliente (con make install) en lugar de ejecutarlo desde la misma carpeta donde se construye, tendrás la opción de construir la nueva versión mientras la anterior sigue en ejecución. De esta manera, la interrupción del servicio debería ser mínima.

Los pasos serían los siguientes:

  • Actualiza el repositorio fuente del cliente BitxorCore y constrúyelo nuevamente.

  • Detén el cliente de BitxorCore en ejecución.

  • Instala la nueva versión del cliente.

  • Reinicia el cliente.

Renovación de la clave de votación

Si tu nodo es un nodo de votación, requiere una clave de votación válida para funcionar. Por motivos de seguridad, estas claves caducan después de 6 meses, por lo que debes renovarlas como parte del mantenimiento regular del nodo.

Lee la sección correspondiente sobre la renovación de las claves de votación, dependiendo de si utilizaste Bitxor Bootstrap o no para construir tu nodo: