Configuración y Mantenimiento del Nodo

Configuración Avanzada del Nodo

Sin argumentos adicionales, el script instala el nodo en una configuración más común. Pero el script también habilita varias opciones avanzadas para ser configuradas, a través de los mensajes en la línea de comandos. A continuación se muestra una lista de opciones avanzadas y su uso:

• admin - se habilitará la API de Administración
• archival - desactiva la poda de la base de datos y preserva el historial completo de transacciones
• state-sync - si se usa on, se utiliza state-sync para la C-Chain, si se usa off, se utiliza la reproducción regular de transacciones para el arranque; state-sync es mucho más rápido, pero no tiene datos históricos
• db-dir - se utiliza para proporcionar la ruta completa a la ubicación donde se almacenará la base de datos
• fuji - el nodo se conectará a la red de prueba Fuji en lugar de la Mainnet
• index - se habilitará la API de Índice
• ip - utiliza los argumentos dynamic, static, o ingresa una IP deseada directamente para ser utilizada como la IP pública que el nodo anunciará a la red
• rpc - utiliza los argumentos any o local para seleccionar cualquier interfaz de red o la interfaz de red local que se utilizará para escuchar llamadas RPC
• version - instala una versión específica del nodo, en lugar de la última. Consulta aquí para ver el uso.

note

Ten en cuenta que configurar las opciones index y archival en un nodo existente requerirá un arranque nuevo para recrear la base de datos.

La forma de uso completa del script se puede mostrar ingresando:

./avalanchego-installer.sh --help

Instalación Automatizada

Si deseas utilizar el script en un entorno automatizado donde no puedes ingresar los datos en los mensajes, debes proporcionar al menos las opciones rpc e ip. Por ejemplo:

./avalanchego-installer.sh --ip 1.2.3.4 --rpc local

Ejemplos de Uso

• Para ejecutar un nodo Fuji con indexación habilitada y IP estática autodetectada:

  ./avalanchego-installer.sh --fuji --ip static --index

• Para ejecutar un nodo Mainnet de archivo con IP dinámica y base de datos ubicada en /home/node/db:

  ./avalanchego-installer.sh --archival --ip dynamic --db-dir /home/node/db

• Para usar state-sync de C-Chain para arrancar rápidamente un nodo Mainnet, con IP dinámica y solo RPC local:

  ./avalanchego-installer.sh --state-sync on --ip dynamic --rpc local

• Para reinstalar el nodo usando la versión del nodo 1.7.10 y usar una IP específica y solo RPC local:

  ./avalanchego-installer.sh --reinstall --ip 1.2.3.4 --version v1.7.10 --rpc local

Configuración del Nodo

El archivo que configura la operación del nodo es ~/.avalanchego/configs/node.json. Puedes editarlo para agregar o cambiar opciones de configuración. La documentación de las opciones de configuración se puede encontrar aquí. La configuración puede verse así:

{
  "public-ip-resolution-service": "opendns",
  "http-host": ""
}

Ten en cuenta que el archivo de configuración debe ser un archivo JSON formateado correctamente, por lo que los interruptores se formatean de manera diferente que en la línea de comandos, así que no ingreses opciones como --public-ip-resolution-service=opendns sino como en el ejemplo anterior.

El script también crea un archivo de configuración vacío de C-Chain, ubicado en ~/.avalanchego/configs/chains/C/config.json. Al editar ese archivo, puedes configurar la C-Chain, como se describe en detalle aquí.

Usando una Versión Anterior

El script de instalación también se puede utilizar para instalar una versión de AvalancheGo que no sea la última versión.

Para ver una lista de versiones disponibles para la instalación, ejecuta:

./avalanchego-installer.sh --list

Imprimirá una lista, algo como esto:

Instalador de AvalancheGo
---------------------
Versiones disponibles:
v1.3.2
v1.3.1
v1.3.0
v1.2.4-arm-fix
v1.2.4
v1.2.3-signed
v1.2.3
v1.2.2
v1.2.1
v1.2.0

Para instalar una versión específica, ejecuta el script con --version seguido de la etiqueta de la versión. Por ejemplo:

./avalanchego-installer.sh --version v1.3.1

warning

Ten en cuenta que no todas las versiones de AvalancheGo son compatibles. Generalmente deberías ejecutar la última versión. Ejecutar una versión que no sea la última puede hacer que tu nodo no funcione correctamente y, para los validadores, no recibir una recompensa de staking.

Gracias al miembro de la comunidad Jean Zundel por la inspiración y la ayuda para implementar el soporte para instalar versiones de nodo que no son las últimas.

Reinstalación y Actualización del Script

El script de instalación se actualiza de vez en cuando, con nuevas características y capacidades agregadas. Para aprovechar las nuevas características o para recuperarse de modificaciones que hicieron que el nodo fallara, es posible que desees reinstalar el nodo. Para hacer eso, obtén la última versión del script de la web con:

wget -nd -m https://raw.githubusercontent.com/ava-labs/avalanche-docs/master/scripts/avalanchego-installer.sh

Después de que el script se haya actualizado, ejecútalo nuevamente con la bandera de configuración --reinstall:

./avalanchego-installer.sh --reinstall

Esto eliminará el archivo de servicio existente y ejecutará el instalador desde cero, como si se hubiera iniciado por primera vez. Ten en cuenta que la base de datos y el NodeID se dejarán intactos.

Eliminación de la Instalación del Nodo

Si deseas eliminar la instalación del nodo de la máquina, puedes ejecutar el script con la opción --remove, así:

./avalanchego-installer.sh --remove

Esto eliminará el servicio, el archivo de definición del servicio y los binarios del nodo. No eliminará el directorio de trabajo, la definición del ID del nodo o la base de datos del nodo. Para eliminar también esos, puedes escribir:

rm -rf ~/.avalanchego/

warning

¡Ten en cuenta que esto es irreversible y la base de datos y el ID del nodo se eliminarán!

¿Qué Sigue?

¡Eso es todo, estás ejecutando un nodo AvalancheGo! ¡Felicitaciones! Háznoslo saber en nuestro Twitter, Telegram o Reddit!

Si estás en una red residencial (IP dinámica), no olvides configurar el reenvío de puertos. Si estás en un proveedor de servicios en la nube, estás listo para continuar.

Ahora puedes interactuar con tu nodo, apostar tus tokens, o mejorar tu instalación configurando monitoreo del nodo para obtener una mejor visión de lo que está haciendo tu nodo. Además, es posible que desees usar nuestra Colección de Postman para emitir comandos más fácilmente a tu nodo.

Finalmente, si aún no lo has hecho, es una buena idea hacer una copia de seguridad de archivos importantes en caso de que alguna vez necesites restaurar tu nodo en una máquina diferente.

Si tienes alguna pregunta o necesitas ayuda, no dudes en contactarnos en nuestro servidor de Discord.