Guía Avanzada¶
Mapa de ruta¶
Hay muchas herramientas, paquetes y scripts que pueden usarse para gestionar Braiins OS+. Use el siguiente árbol para una mejor navegación:
Instalar Braiins OS+
Usando la Caja de herramientas BOS+ (bosbox_install)
Usando el paquete web (web_package_install)
Usando la tarjeta SD (sd_install)
Usando la tarjeta SD y la herramienta miner (miner_nand_install)
Usando scripts SSH (ssh_package_install)
Actualizar Braiins OS+
Usando la Caja de herramientas BOS+ (bosbox_update)
Usando OPKG (opkg_update)
Usando el paquete sysupgrade (sysupgrade_switch_braiinsplus)
Usando el script bos2bos (bos2bos)
Cambiar a Braiins OS (versión sin autoajuste)
Usando el paquete sysupgrade (sysupgrade_switch_braiinsos)
Usando el script bos2bos (bos2bos)
Cambiar a Braiins OS+ (versión con autoajuste)
Usando OPKG (opkg_switch_to_braiinsplus)
Usando el paquete sysupgrade (sysupgrade_switch_braiinsplus)
Usando el script bos2bos (bos2bos)
Restablecer a la versión Braiins OS inicial (la versión que instaló en su dispositivo por primera vez) - restablecimiento de fabrica
Usando OPKG (opkg_factory_reset)
Usando la tarjeta SD (sd_factory_reset)
Usando la herramienta "miner" (miner_factory_reset)
Usando el script bos2bos (bos2bos)
Desinstalar Braiins OS+
Usando la Caja de herramientas BOS+ (bosbox_uninstall)
Usando scripts SSH (ssh_package_uninstall)
Encender/apagar alimentaciones nocturnas
Usando la herramienta "miner" (miner_nightly)
Encender/apagar auto-actualizar
Usando la herramienta "miner" (miner_autoupgrade)
Correr comandos personalizados de consola en el minero
Usando la Caja de Herramientas BOS+ (Correr comandos personalizados en mineros usando la Caja de Herramientas BOS+)
Caja de herramientas BOS+¶
La Caja de herramientas BOS+ es una nueva herramienta que permite a los usuarios instalar, desinstalar, actualizar, detectar, configurar Braiins OS+ y correr comandos personalizados fácilmente. También permite que los comandos sean ejecutados en modo por lotes, lo que hace mas fácil la gestión de un gran número de dispositivos. Esta es la manera recomendada de gestionar sus máquinas.
Uso¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto, cambie la extensión ".txt" a ".csv" e inserte las direcciones IP en las que desea ejecutar los comandos. Coloque el archivo en el directorio donde se encuentra la Caja de herramientas BOS+. ¡Use solo una dirección IP por línea!
Siga las instrucciones abajo
Características, PROs y CONs de este método:¶
instala Braiins OS+ remotamente
actualiza Braiins OS+ remotamente
desinstala Braiins OS+ remotamente
configura Braiins OS+ remotamente
busca las máquinas en la red
corre comandos personalizados en las máquinas
por defecto migra toda la configuración (puede ajustarse) al instalar Braiins OS+
por defecto migra la configuración de red (puede ajustarse) al desinstalar Braiins OS+
hay parámetros disponibles para personalizar el proceso
activa el autoajuste al límite de energía por defecto al instalar Braiins OS+
modo-por-lotes disponible para gestionar múltiples dispositivos a la vez
fácil de usar
no funciona en un minero con SSH bloqueado
Instalar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto, cambie la extensión ".txt" a ".csv" e inserte las direcciones IP en las que desea ejecutar los comandos. Coloque el archivo en el directorio donde se encuentra la Caja de herramientas BOS+. ¡Use solo una dirección IP por línea!
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe install ARGUMENTOS NOMBREHOSTPara terminal de comandos en Linux:
./bos-plus-toolbox install ARGUMENTOS NOMBREHOSTNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Nota importante: Al instalar Braiins OS+ en un solo dispositivo, use el argumento NOMBREHOST (dirección IP). Al instalar Braiins OS+ en varios dispositivos, NO use el argumento NOMBREHOST, sino el argumento --batch LOTE en su lugar.
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
--batch LOTE |
ruta al archivo con la lista de hosts (direcciones IPs) a instalar |
--backup |
hacer el respaldo al minero antes de actualizar |
--no-auto-upgrade |
apagar auto-actualizar del firmware instalado |
--no-nand-backup |
saltar respaldo completo NAND (la configuración aun se respalda) |
--pool-user [USUARIO_POOL] |
fijar nombre de usuario y minero al pool por defecto |
--psu-power-limit [LÍMITE_ENERGÍA] |
fijar límite de energía (en vatios) para la fuente de poder |
--no-keep-network |
no mantener la configuración de red (usar DHCP) |
--no-keep-pools |
no mantener la configuración del pool del minero |
--no-keep-hostname |
no mantener el nombre de host y generar uno nuevo basado en MAC |
--keep-hostname |
forzar mantener cualquier nombre host del minero |
--no-wait |
no esperar a que el sistema esté completamente actualizado |
--dry-run |
hacer todos los pasos de actualización sin realmente actualizar |
--post-upgrade [POST_ACTUALIZADO] |
ruta al directorio con el script stage3.sh |
--install-password CLAVE_INSTALACIÓN |
palabra clave ssh para la instalación |
Ejemplo:
bos-plus-toolbox.exe install --batch listaDeMineros.csv --psu-power-limit 1200 --install-password clave
Este comando instalará Braiins OS+ en los mineros, que estén especificados en el archivo listaDeMineros.csv y fija el límite de energía a 1200 en todos ellos. El comando también usará automáticamente la palabra clave SSH clave, cuando el minero la pida.
Actualizar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto, cambie la extensión ".txt" a ".csv" e inserte las direcciones IP en las que desea ejecutar los comandos. Coloque el archivo en el directorio donde se encuentra la Caja de herramientas BOS+. ¡Use solo una dirección IP por línea!
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe update ARGUMENTOS NOMBREHOSTPara terminal de comandos en Linux:
./bos-plus-toolbox update ARGUMENTOS NOMBREHOSTNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Nota importante: Al actualizar Braiins OS+ en un solo dispositivo, use el argumento NOMBREHOST (dirección IP). Al actualizar Braiins OS+ en varios dispositivos, NO use el argumento NOMBREHOST, sino el argumento --batch LOTE en su lugar.
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
--batch LOTE |
ruta al archivo con la lista de hosts (direcciones IPs) a instalar |
-p PASSWORD, --password PASSWORD |
palabra clave administrativa |
-i, --ignore |
no detener en errores |
Ejemplo:
bos-plus-toolbox.exe update --batch listaDeMineros.csv
Este comando buscará actualizaciones para los mineros, que están especificados en la listaDeMineros.csv y los actualizará si hay una nueva versión del firmware.
Desinstalar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. ¡Use una sola dirección IP por línea! (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe uninstall ARGUMENTOS NOMBREHOSTPara terminal de comandos en Linux:
./bos-plus-toolbox uninstall ARGUMENTOS NOMBREHOSTNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Nota importante: Al desinstalar Braiins OS+ en un solo dispositivo, use el argumento NOMBREHOST (dirección IP). Al desinstalar Braiins OS+ en varios dispositivos, NO use el argumento NOMBREHOST, sino el argumento --batch LOTE en su lugar.
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
--batch LOTE |
ruta al archivo con la lista de hosts (direcciones IPs) a instalar |
--install-password CLAVE_INSTALACIÓN |
palabra clave ssh para la (des)instalación |
--factory-image IMAGEN_DE_FÁBRICA |
ruta/url a imagen de actualización de firmware original (defecto: Antminer-S9-all-201812051512-autofreq-user-Update2UBI-NF.tar.gz) |
Ejemplo:
bos-plus-toolbox.exe uninstall --batch listaDeMineros.csv
Este comando desinstalará Braiins OS+ de los mineros, que están especificados en el archivo listaDeMineros.csv e instala un firmware de serie (Antminer-S9-all-201812051512-autofreq-user-Update2UBI-NF.tar.gz).
Configurar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. ¡Use una sola dirección IP por línea! (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe config ARGUMENTOS ACCIÓN TABLAPara terminal de comandos en Linux:
./bos-plus-toolbox config ARGUMENTOS ACCIÓN TABLANota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
-u USER, --user USER |
nombre administrativo |
-p PASSWORD, --password PASSWORD |
palabra clave administrativa o "preguntarla" |
-c, --check |
ensayo sin escrituras |
-i, --ignore |
no detener en errores |
Debe usar una de las siguientes acciones para ajustar el proceso:
Acciones |
Descripción |
---|---|
load |
cargar la configuración actual de los mineros (especificados en el archivo CSV) e insertarla al archivo CSV |
save |
guardar la configuración desde el archivo CSV a los mineros (esto no la aplica) |
apply |
aplicar la configuración, que fue copiada desde el archivo CSV a los mineros |
save_apply |
guardar y aplicar la configuración del archivo CSV a los mineros |
Ejemplo:
bos-plus-toolbox.exe config --user root load listaDeMineros.csv
#edite el archivo CSV con un editor de hojas de cálculo (ej: Office Excel, LibreOffice Calc, etc.)
bos-plus-toolbox.exe config --user root save_apply listaDeMineros.csv
El primer comando va a cargar la configuración de los mineros, que estén especificados en la listaDeMineros.csv (usando el usuario root) y la guardará en ese archivo CSV. Ahora puede abrir el archivo y editar lo que necesite. Luego de que el archivo esté editado, el segundo comando copiará la configuración de vuelta a los mineros y la aplicará.
Explorar la red para identificar mineros usando la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. ¡Use una sola dirección IP por línea! (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe scan ARGUMENTOSPara terminal de comandos en Linux:
./bos-plus-toolbox scan ARGUMENTOSNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
Debe usar una de las siguientes acciones para ajustar el proceso:
Acciones |
Descripción |
---|---|
scan |
explorar activamente el rango provisto de direcciones |
listen |
escuchar transmisión entrante desde los dispositivos (al presionar el botón IP report) |
Ejemplo:
#explorar la red, en el rango 10.10.10.0 - 10.10.10.255
bos-plus-toolbox.exe discover scan 10.10.10.0/24
#explorar la red, en el rango 10.10.0.0 - 10.10.255.255
bos-plus-toolbox.exe discover scan 10.10.0.0/16
#explorar la red, en el rango 10.0.0.0 - 10.255.255.255
bos-plus-toolbox.exe discover scan 10.0.0.0/8
Correr comandos personalizados en mineros usando la Caja de Herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. ¡Use una sola dirección IP por línea! (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe command ARGUMENTOSPara terminal de comandos en Linux:
./bos-plus-toolbox command ARGUMENTOSNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Acciones |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
-a, --auto |
Usar ssh si rpc no está disponible |
-l, --legacy |
Usar ssh |
-L, --no-legacy |
Usar rpc |
-o, --output |
Capturar e imprimir la salida remota |
-O, --output-hostname |
Capturar e imprimir la salida remota |
-p PASSWORD, --password PASSWORD |
palabra clave administrativa |
-j JOBS, --jobs JOBS |
número de trabajos concurrentes |
Debe usar una de las siguientes acciones para ajustar el proceso:
Acciones |
Descripción |
---|---|
start |
Iniciar BOSminer |
stop |
Detener BOSminer |
comando_personalizado |
Reemplace comando_personalizado con su propio comando de consola (ej: cat /etc/bosminer.toml para mostrar el contenido del archivo de configuración bosminer.toml) |
Ejemplo:
#detiene BOSminer, deteniendo efectivamente el minado y reduciendo el consumo de energía al mínimo
bos-plus-toolbox.exe command -o list.csv stop
Paquete Web¶
El paquete Web puede usarse para cambiar el firmware de serie, liberado antes de 2019. También debería funcionar con otros basados en firmware de serie. Este paquete no puede usarse con firmware de serie, liberado en 2019 o posterior, debido a la verificación de firma, que fue implementada. La verificación de firma previene el uso de otro firmware que no sea firmware de serie originales.
Características, PROs y CONs de este método:¶
reemplaza el firmware de serie con Braiins OS+ sin herramientas adicionales
migra la configuración de red
migra las direcciones (URL) de los pool, usuarios y claves
activa el autoajuste al límite de energía por defecto
no puede usarse con firmware de serie liberado en 2019 o luego
no puede configurar la instalación (ej: siempre migrará la configuración de red)
no hay modo-por-lotes (a menos que se cree sus propios scripts)
Imagen para tarjeta SD¶
Si está corriendo firmware de serie, que fue liberado en 2019 o luego, la única forma de instalar Braiins OS+ es insertar una tarjeta SD con Braiins OS+ escrito en ella. En 2019, la conexión SSH fue bloqueada y la verificación de firma en la interfaz web impide el uso de otro firmware distinto al de serie.
Características, PROs y CONs de este método:¶
reemplaza el firmware de serie con SSH bloqueado con Braiins OS+
usa la configuración de red almacenada en la NAND (esto puede apagarse, vea la sección Network settings abajo)
activa el autoajuste al límite de energía por defecto
no migra direcciones (URL) de pool, usuarios o claves
no hay modo-por-lotes
Instalar Braiins OS+ usando la tarjeta SD card¶
Descargue la Imagen para tarjeta SD desde nuestro sitio web.
Escriba la imagen descargada a una tarjeta SD (ej: usando Etcher). Nota: Una simple copia no funcionará. ¡La tarjeta SD debe ser escrita!
(Solo Antminer S9) Ajuste los jumpers para arrancar desde la tarjeta SD (en lugar de la memoria NAND), como se muestra abajo.
Inserte la tarjeta SD card en el dispositivo, luego inicie el dispositivo.
Tras un momento, debe poder acceder la interfaz de Braiins OS+ a través de la dirección IP del dispositivo.
[Opcional]: Ahora puede instalar Braiins OS+ a la NAND (ver la sección sd_nand_install)
Configuración de red¶
Por defecto, la configuración almacenada en la NAND se utilizará, mientras esté corriendo Braiins OS+ desde una tarjeta SD. Esta característica puede apagarse, siguiendo los pasos abajo:
Monte la primera partición FAT de la tarjeta SD
Abra el archivo uEnv.txt e inserte la frase siguiente (asegúrese de que solo hay una frase por línea)
cfg_override=no
Deshabilitar el uso de la vieja configuración de red es beneficioso para los usuarios, que tienen problemas con el minero no estar visible en la red (ej: la dirección IP estática usada en la NAND está fuera del rango de la red). Al hacerlo, se usa DHCP.
Instalar a NAND¶
- La tarjeta SD puede usarse para reemplazar el firmware corriendo en la NAND con Braiins OS+. Eso se hace:
usando la interfaz web - sección System -> Install current system to device (NAND)
usando la herramienta miner, via SSH - siga esta sección de la guía miner_nand_install
Restablecer de fábrica Braiins OS+ usando la tarjeta SD¶
Puede hacer un restablecimiento de fábrica, siguiendo los pasos abajo:
Monte la primera partición FAT de la tarjeta SD
Abra el archivo uEnv.txt e inserte la frase siguiente (asegúrese de que solo hay una frase por línea)
factory_reset=yes
Paquete de instalación remota (SSH)¶
Con el paquete de instalación remota (SSH) puede instalar o desinstalar Braiins OS+. Este método no es recomendado, ya que requiere una instalación Python. Use la caja de herramientas BOS+ en su lugar.
Uso¶
Descargue el Paquete de instalación remota (SSH) desde nuestro sitio web.
Siga las instrucciones abajo
Características, PROs y CONs de este método:¶
instala Braiins OS+ remotamente
desinstala Braiins OS+ remotamente
migra toda la configuración por defecto (puede ajustarse) al instalar Braiins OS+
migra la configuración de red por defecto (puede ajustarse) al desinstalar Braiins OS+
parámetros disponibles para personalizar el proceso
enciende el autoajuste a un límite de energía por defecto al instalar Braiins OS+
no hay modo-por-lotes (a menos que cree sus propios scripts)
requiere una larga instalación
no funciona en un minero con SSH bloqueado
Preparando el ambiente¶
Primero, necesita preparar el ambiente Python. Esto consiste en los siguientes pasos:
(Solo Windows) Instalar Ubuntu para Windows 10 disponible desde la Tienda Microsoft aquí.
Corra los siguientes comandos en su terminal de línea de comandos:
(Note que los comandos son compatibles con Ubuntu y Ubuntu para Windows 10. Si está usando una distribución diferente de Linux o un sistema operativo diferente, por favor verifique la documentación correspondiente y edite los comandos según sea necesario.)
#Actualizar los repositorios e instalar dependencias
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
#Descargar y extraer el paquete de firmware
#Antminer S9
wget -c https://feeds.braiins-os.com/20.09/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus.tar.gz -O - | tar -xz
#Antminer S17
wget -c https://feeds.braiins-os.com/20.09/braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus.tar.gz -O - | tar -xz
#Cambiar el directorio a la carpeta donde desempacó el firmware
#Antminer S9
cd ./braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus
#Antminer S17
cd ./braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus
#Crear un ambiente virtual y activarlo
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#Instalar los paquetes Python requeridos
python3 -m pip install -r requirements.txt
Instalar Braiins OS+ usando el paquete SSH¶
La instalación de Braiins OS+ usando el asi-llamado Método SSH consiste en los siguientes pasos:
(Firmware Personalizado) Escribir firmware de serie. Este paso puede omitirse si el dispositivo está corriendo el firmware de serie o una versión previa de Braiins OS. (Nota: Es posible, que Braiins OS+ pueda ser instalado directamente sobre un firmware personalizado, pero como difieren de la versión de serie, podría ser necesario escribir la versión de serie primero.)
(Solo Windows) Instalar Ubuntu para Windows 10 disponible desde la Tienda Microsoft aquí.
Prepare el ambiente Python, como se describe en la sección ssh_package_environment.
Corra los siguientes comandos en su terminal de línea de comandos (reemplace
DIRECCIÓN_IP
por la correspondiente) :
(Note que los comandos son compatibles con Ubuntu y Ubuntu para Windows 10. Si está usando una distribución diferente de Linux o un sistema operativo diferente, por favor verifique la documentación correspondiente y edite los comandos según sea necesario.)
#Cambiar al directorio de la carpeta con el firmware desempacado (si no está ya en la carpeta del firmware)
#Antminer S9
cd ./braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus
#Antminer S17
cd ./braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus
#Activar el ambiente virtual (si no está ya activado)
source .env/bin/activate
#Correr el script para instalar Braiins OS+
python3 upgrade2bos.py DIRECCIÓN_IP
Nota: para mas información acerca de los argumentos que pueden usarse, use el argumento --help.
Desinstalar Braiins OS+ usando el paquete SSH¶
Usando imagen de fábrica¶
Primero, debe preparar el ambiente Python, que está descrito en la sección ssh_package_environment.
En un Antminer S9, puede escribir una imagen de fábrica del sitio web del fabricante, con la IMAGEN_DE_FÁBRICA
siendo la ruta al archivo o la dirección (URL) al archivo tar.gz
(¡sin extraer!). Las imágenes soportadas con sus correspondientes hashes MD5 están listadas en el archivo
platform.py.
Corra (reemplace los marcadores IMAGEN_DE_FÁBRICA
y DIRECCIÓN_IP
como corresponda):
#Antminer S9
cd ~/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py --factory-image IMAGEN_DE_FÁBRICA DIRECCIÓN_IP
#Antminer S17
cd ~/braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py --factory-image IMAGEN_DE_FÁBRICA DIRECCIÓN_IP
Nota: para mas información acerca de los argumentos que pueden usarse, use el argumento --help.
Usando respaldo previamente creado¶
Primero, debe preparar el ambiente Python, que está descrito en la sección ssh_package_environment.
Si creo un respaldo del firmware original durante la instalación de Braiins OS+, puede restaurarlo mediante el uso de los siguientes comandos (reemplace los marcadores ID_RESPALDO_FECHA
y DIRECCIÓN_IP
como corresponda):
#Antminer S9
cd ~/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py backup/ID_RESPALDO_FECHA/ DIRECCIÓN_IP
#Antminer S17
cd ~/braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py backup/ID_RESPALDO_FECHA/ DIRECCIÓN_IP
Nota: Este método no es recomendado ya que la creación del respaldo es muy quisquillosa. El respaldo puede corromperse y no hay manera de comprobarlo. ¡Use a su propio riesgo y asegúrese, de tener acceso al minero e insertar una tarjeta SD al mismo en caso de que la restauración no finalice exitosamente!
OPKG¶
Los comandos OPKG pueden usarse luego de conectarse al minero vía SSH. Hay muchos comandos OPKG, pero respecto a Braiins OS+, solo necesita usar los siguientes:
opkg update - actualiza la lista de paquetes. Se recomienda usar este comando antes de otros comandos OPKG.
opkg install NOMBRE_DE_PAQUETE instala el paquete definido. Se recomienda usar opkg update para actualizar la lista de paquetes antes de instalar paquetes.
opkg remove NOMBRE_DE_PAQUETE
Ya que los cambios de firmware resultan en un reinicio, se espera la siguiente salida:
...
Collected errors:
* opkg_conf_load: Could not lock /var/lock/opkg.lock: Resource temporarily unavailable.
Saving config files...
Connection to 10.10.10.1 closed by remote host.
Connection to 10.10.10.1 closed.
Características, PROs y CONs de este método:¶
actualiza Braiins OS+ remotamente
cambia a Braiins OS+ desde otras versiones remotamente
revierte a la versión inicial de Braiins OS remotamente
migra la configuración y continua minando sin necesidad de configurar nada (al actualizar o cambiar a Braiins OS+)
no hay modo-por-lotes (a menos que cree sus propios scripts)
Actualizar Braiins OS+ usando OPKG¶
Con OPKG puede actualizar fácilmente su instalación actual de Braiins OS+, conectándose al minero vía SSH y usando los siguientes comandos:
opkg update
opkg install firmware
#también se puede conectar al minero y correr los comandos al mismo tiempo
ssh root@DIRECCIÓN_IP "opkg update && opkg install firmware"
Esto migrará la configuración y continuará minando sin necesidad de configurar nada.
Cambiar a Braiins OS+ desde otras versiones usando OPKG¶
Con OPKG puede fácilmente cambiar a Braiins OS+, conectándose al minero vía SSH y usando los siguientes comandos:
opkg update
opkg install bos_plus
#también se puede conectar al minero y correr los comandos al mismo tiempo
ssh root@DIRECCIÓN_IP "opkg update && opkg install bos_plus"
Esto migrará la configuración y continuará minando sin necesidad de configurar nada. El límite de energía por defecto se pone a.
Restablecer de fábrica Braiins OS+ usando OPKG¶
Con OPKG puede revertir fácilmente a la versión inicial de Braiins OS (la versión que fue instalada por primera vez en ese dispositivo), conectándose al minero vía SSH y usando los siguientes comandos:
opkg update
opkg remove firmware
#también se puede conectar al minero y correr los comandos al mismo tiempo
ssh root@DIRECCIÓN_IP "opkg update && opkg remove firmware"
Esto restablecerá la configuración al estado luego de la primera instalación de Braiins OS.
Paquete sysupgrade¶
Sysupgrade se usa para actualizar el sistema corriendo en el dispositivo. Con este método, puede instalar varias versiones de Braiins OS o crear un respaldo del sistema. La instalación de un firmware usando la interfaz web Braiins OS o usar opkg install firmware usan este método. Es recomendado usar la interfaz web Braiins OS u opkg install firmware en lugar de este método.
Uso¶
Para poder usar sysupgrade, necesita conectarse al minero vía SSH. La sintaxis es la siguiente:
sysupgrade [parámetros] <archivo imagen o dirección (URL)>
Los parámetros mas importantes son --help (para mostrar la ayuda) y -F para forzar la instalación. No es recomendado usar este método (a pesar de la forma, se describe abajo), a menos que realmente sepa, lo que está haciendo.
Características, PROs y CONs de este método:¶
instala varias versiones de Braiins OS, estando conectado al minero
migra la configuración
parámetros disponibles para personalizar el proceso
no hay modo-por-lotes (a menos que cree sus propios scripts)
no puede cambiar a una versión vieja de Braiins OS (liberada antes de 2020)
Cambiar a Braiins OS (sin autoajuste) desde otras versiones usando Sysupgrade¶
Para actualizar desde una versión anterior de Braiins OS o desactualizar desde Braiins OS+, use el siguiente comando (reemplace el marcador DIRECCIÓN_IP
como corresponda):
#Antminer S9
ssh root@DIRECCIÓN_IP 'wget -O /tmp/firmware.tar https://feeds.braiins-os.org/am1-s9/firmware_2020-09-07-0-e50f2a1b-20.09_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
#Antminer S17
ssh root@DIRECCIÓN_IP 'wget -O /tmp/firmware.tar https://feeds.braiins-os.org/am2-s17/firmware_2020-09-07-0-e50f2a1b-20.09_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
Este comando contiene los siguientes comandos:
ssh - para conectarse al minero
wget - usado para descargar archivos, en este caso el paquete firmware
sysupgrade - para propiamente escribir el paquete de firmware descargado
Cambiar a Braiins OS+ desde otras versiones usando Sysupgrade¶
Para actualizar desde una versión anterior de Braiins OS, use el siguiente comando (reemplace el marcador DIRECCIÓN_IP
como corresponda):
#Antminer S9
ssh root@DIRECCIÓN_IP 'wget -O /tmp/firmware.tar https://feeds.braiins-os.com/am1-s9/firmware_2020-09-07-1-463cb8d0-20.09-plus_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
#Antminer S17
ssh root@DIRECCIÓN_IP 'wget -O /tmp/firmware.tar https://feeds.braiins-os.com/am2-s17/firmware_2020-09-07-1-1f02b3bd-20.09-plus_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
Este comando contiene los siguientes comandos:
ssh - para conectarse al minero
wget - usado para descargar archivos, en este caso el paquete firmware
sysupgrade - para propiamente escribir el paquete de firmware descargado
Nota: Se recomienda usar la Caja de herramientas BOS+, Interfaz web Braiins OS u opkg install bos_plus en lugar de este método.
Script Bos2Bos¶
Bos2Bos script is not recommended to use, unless you experience problems with the installation using the other methods. This method works, only if Braiins OS is already running on the device.
Características, PROs y CONs de este método:¶
instala cualquier versión de Braiins OS remotamente
instala una versión limpia de Braiins OS
parámetros disponibles para personalizar el proceso
no hay modo-por-lotes (a menos que cree sus propios scripts)
Uso¶
Usage of the Bos2Bos script requires the following setup:
(Solo Windows) Instalar Ubuntu para Windows 10 disponible desde la Tienda Microsoft aquí.
Corra los siguientes comandos en su terminal de línea de comandos:
(Note que los comandos son compatibles con Ubuntu y Ubuntu para Windows 10. Si está usando una distribución diferente de Linux o un sistema operativo diferente, por favor verifique la documentación correspondiente y edite los comandos según sea necesario.)
#Actualizar los repositorios e instalar dependencias
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
# clonar repositorio
git clone https://github.com/braiins/braiins-os.git
#cambiar el directorio
cd ./braiins-os/braiins-os/
#Crear un ambiente virtual y activarlo
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#Instalar los paquetes Python requeridos
python3 -m pip install -r requirements.txt
Luego de finalizar la instalación exitosamente, puede usar los siguientes comandos:
#activar el ambiente virtual
source .env/bin/activate
#su uso básico es el siguiente
python3 bos2bos.py URL_FIRMWARE DIRECCIÓN_IP
#la descripción de todos los parámetros disponibles puede verse usando el siguiente comando
python3 bos2bos.py -h
python3 bos2bos.py -h
Herramienta Miner¶
Instalar SD a NAND usando la herramienta Miner¶
La tarjeta SD puede usarse para reemplazar el firmware corriendo en la NAND con Braiins OS+. Esto puede hacerse conectándose al minero via SSH y usando el siguiente comando:
miner nand_install
Restablecer de fábrica Braiins OS+ usando la herramienta Miner¶
Restablecer de fábrica también puede hacerse con la herramienta Miner. Use el siguiente comando para hacerlo:
miner factory_reset
Detectar el dispositivo mediante LEDs usando la herramienta Miner¶
Puede conseguir un dispositivo encendiendo el parpadeo LED, usando la herramienta Miner. Use el siguiente comando para hacerlo:
#encender parpadeo LED miner fault_light on #apagar parpadeo LED miner fault_light off
Encender/apagar alimentaciones nocturnas usando la herramienta Miner¶
Puede encender las alimentaciones Nocturnas para poder actualizar a las últimas versiones nocturnas. Estas versiones son para arreglar problemas cruciales tan rápido como sea posible y por ello, no se hacen pruebas a fondo en estas versiones. Use estas versiones con precaución y solo si resuelve sus problemas. Para poder encender/apagar las alimentaciones nocturnas, use el siguiente comando:
#encender alimentaciones nocturnas miner nightly_feeds on #apagar alimentaciones nocturnas miner nightly_feeds off
Encender/apagar auto-actualizar usando la herramienta Miner¶
Puede encender la característica de auto-actualizar, que actualizará el sistema automáticamente a la última versión. Esta característica está encendida por defecto, en transición desde un firmware de serie y apagada al actualizar desde versiones anteriores de Braiins OS o Braiins OS+. Para poder encender/apagar auto-actualizar, use el siguiente comando:
#encender auto-actualizar miner auto_upgrade on #apagar auto-actualizar miner auto_upgrade off
Usando el paquete sysupgrade (sysupgrade_switch_braiinsplus)
Usando el script bos2bos (bos2bos)
Restablecer a la versión Braiins OS inicial (la versión que instaló en su dispositivo por primera vez) - restablecimiento de fabrica
Usando OPKG (opkg_factory_reset)
Usando la tarjeta SD (sd_factory_reset)
Usando la herramienta "miner" (miner_factory_reset)
Usando el script bos2bos (bos2bos)
Desinstalar Braiins OS+
Usando la Caja de herramientas BOS+ (bosbox_uninstall)
Usando scripts SSH (ssh_package_uninstall)
Encender/apagar alimentaciones nocturnas
Usando la herramienta "miner" (miner_nightly)
Encender/apagar auto-actualizar
Usando la herramienta "miner" (miner_autoupgrade)
Caja de herramientas BOS+¶
La Caja de herramientas BOS+ es una nueva herramienta, que permite al usuario instalar, desinstalar, actualizar, detectar y configurar fácilmente Braiins OS+. También permite hacerlo en modo por lotes, lo que hace la gestión de un gran número de dispositivos mas fácil. Esta es la manera recomendada de gestionar sus máquinas.
Uso¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto, cambie la extensión ".txt" a ".csv" e inserte las direcciones IP en las que desea ejecutar los comandos. Coloque el archivo en el directorio donde se encuentra la Caja de herramientas BOS+. ¡Use solo una dirección IP por línea!
Siga las instrucciones abajo
Características, PROs y CONs de este método:¶
instala Braiins OS+ remotamente
actualiza Braiins OS+ remotamente
desinstala Braiins OS+ remotamente
configura Braiins OS+ remotamente
busca las máquinas en la red
por defecto migra toda la configuración (puede ajustarse) al instalar Braiins OS+
por defecto migra la configuración de red (puede ajustarse) al desinstalar Braiins OS+
hay parámetros disponibles para personalizar el proceso
activa el autoajuste al límite de energía por defecto al instalar Braiins OS+
modo-por-lotes disponible para gestionar múltiples dispositivos a la vez
fácil de usar
no funciona en un minero con SSH bloqueado
Instalar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto, cambie la extensión ".txt" a ".csv" e inserte las direcciones IP en las que desea ejecutar los comandos. Coloque el archivo en el directorio donde se encuentra la Caja de herramientas BOS+. ¡Use solo una dirección IP por línea!
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe install ARGUMENTOS NOMBREHOSTPara terminal de comandos en Linux:
./bos-plus-toolbox install ARGUMENTOS NOMBREHOSTNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Nota importante: Al instalar Braiins OS+ en un solo dispositivo, use el argumento NOMBREHOST (dirección IP). Al instalar Braiins OS+ en varios dispositivos, NO use el argumento NOMBREHOST, sino el argumento --batch LOTE en su lugar.
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
--batch LOTE |
ruta al archivo con la lista de hosts (direcciones IPs) a instalar |
--backup |
hacer el respaldo al minero antes de actualizar |
--no-nand-backup |
saltar respaldo completo NAND (la configuración aun se respalda) |
--pool-user [USUARIO_POOL] |
fijar nombre de usuario y minero al pool por defecto |
--psu-power-limit [LÍMITE_ENERGÍA] |
fijar límite de energía (en vatios) para la fuente de poder |
--no-keep-network |
no mantener la configuración de red (usar DHCP) |
--no-keep-pools |
no mantener la configuración del pool del minero |
--no-keep-hostname |
no mantener el nombre de host y generar uno nuevo basado en MAC |
--keep-hostname |
forzar mantener cualquier nombre host del minero |
--no-wait |
no esperar a que el sistema esté completamente actualizado |
--dry-run |
hacer todos los pasos de actualización sin realmente actualizar |
--post-upgrade [POST_ACTUALIZADO] |
ruta al directorio con el script stage3.sh |
--install-password CLAVE_INSTALACIÓN |
palabra clave ssh para la instalación |
Ejemplo:
./bos-plus-toolbox.exe install --batch listaDeMineros.csv --psu-power-limit 1200 --install-password clave
Este comando instalará Braiins OS+ en los mineros, que estén especificados en el archivo listaDeMineros.csv y fija el límite de energía a 1200 en todos ellos. El comando también usará automáticamente la palabra clave SSH clave, cuando el minero la pida.
Actualizar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto, cambie la extensión ".txt" a ".csv" e inserte las direcciones IP en las que desea ejecutar los comandos. Coloque el archivo en el directorio donde se encuentra la Caja de herramientas BOS+.
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe update ARGUMENTOS NOMBREHOSTPara terminal de comandos en Linux:
./bos-plus-toolbox update ARGUMENTOS NOMBREHOSTNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Nota importante: Al actualizar Braiins OS+ en un solo dispositivo, use el argumento NOMBREHOST (dirección IP). Al actualizar Braiins OS+ en varios dispositivos, NO use el argumento NOMBREHOST, sino el argumento --batch LOTE en su lugar.
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
--batch LOTE |
ruta al archivo con la lista de hosts (direcciones IPs) a instalar |
-p PASSWORD, --password PASSWORD |
palabra clave administrativa |
-i, --ignore |
no detener en errores |
Ejemplo:
./bos-plus-toolbox.exe update --batch listaDeMineros.csv
Este comando buscará actualizaciones para los mineros, que están especificados en la listaDeMineros.csv y los actualizará si hay una nueva versión del firmware.
Desinstalar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. Cada dirección IP debe ser separada por una coma. (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe uninstall ARGUMENTOS NOMBREHOSTPara terminal de comandos en Linux:
./bos-plus-toolbox uninstall ARGUMENTOS NOMBREHOSTNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Nota importante: Al desinstalar Braiins OS+ en un solo dispositivo, use el argumento NOMBREHOST (dirección IP). Al desinstalar Braiins OS+ en varios dispositivos, NO use el argumento NOMBREHOST, sino el argumento --batch LOTE en su lugar.
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
--batch LOTE |
ruta al archivo con la lista de hosts (direcciones IPs) a instalar |
--factory-image IMAGEN_DE_FÁBRICA |
ruta/url a imagen de actualización de firmware original (defecto: Antminer-S9-all-201812051512-autofreq-user-Update2UBI-NF.tar.gz) |
Ejemplo:
./bos-plus-toolbox.exe uninstall --batch listaDeMineros.csv
Este comando desinstalará Braiins OS+ de los mineros, que están especificados en el archivo listaDeMineros.csv e instala un firmware de serie (Antminer-S9-all-201812051512-autofreq-user-Update2UBI-NF.tar.gz).
Configurar Braiins OS+ con la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. Cada dirección IP debe ser separada por una coma. (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe config ARGUMENTOS ACCIÓN TABLAPara terminal de comandos en Linux:
./bos-plus-toolbox config ARGUMENTOS ACCIÓN TABLANota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
-u USER, --user USER |
nombre administrativo |
-p PASSWORD, --password PASSWORD |
palabra clave administrativa o "preguntarla" |
-c, --check |
ensayo sin escrituras |
-i, --ignore |
no detener en errores |
Debe usar una de las siguientes acciones para ajustar el proceso:
Acciones |
Descripción |
---|---|
load |
cargar la configuración actual de los mineros (especificados en el archivo CSV) e insertarla al archivo CSV |
save |
guardar la configuración desde el archivo CSV a los mineros (esto no la aplica) |
apply |
aplicar la configuración, que fue copiada desde el archivo CSV a los mineros |
save_apply |
guardar y aplicar la configuración del archivo CSV a los mineros |
Ejemplo:
./bos-plus-toolbox.exe config --user root load listaDeMineros.csv
#edite el archivo CSV con un editor de hojas de cálculo (ej: Office Excel, LibreOffice Calc, etc.)
./bos-plus-toolbox.exe config --user root save_apply listaDeMineros.csv
El primer comando va a cargar la configuración de los mineros, que estén especificados en la listaDeMineros.csv (usando el usuario root) y la guardará en ese archivo CSV. Ahora puede abrir el archivo y editar lo que necesite. Luego de que el archivo esté editado, el segundo comando copiará la configuración de vuelta a los mineros y la aplicará.
Explorar la red para identificar mineros usando la Caja de herramientas BOS+¶
Descargue la Caja de herramientas BOS+ desde nuestro sitio web.
Cree un nuevo archivo de texto en su editor de texto e inserte las direcciones IP en las cuales desea ejecutar los comandos. Cada dirección IP debe ser separada por una coma. (Note que puede encontrar la dirección IP en la interfaz web de Braiins OS+ yendo a Status -> Overview.) Luego guarde el archivo en el mismo directorio donde guardó la Caja de herramientas BOS+ y cambie la extensión ".txt" a ".csv".
Una vez descargada la Caja de herramientas BOS+, abra su interprete de línea de comandos (ej: CMD en windows, Terminal en Ubuntu, etc.)
Reemplace el marcador RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+ del comando siguiente con la verdadera ruta de archivo donde guardó la Caja de Herramientas BOS+. Luego cámbiese a esa ruta ejecutando el comando:
cd RUTA_A_LA_CAJA_DE_HERRAMIENTAS_BOS+Ahora reemplace el marcador listaDeMineros.csv con su nombre de archivo en el comando siguiente y ejecute el comando apropiado para su sistema operativo:
Para terminal de comandos en Windows:
bos-plus-toolbox.exe scan ARGUMENTOSPara terminal de comandos en Linux:
./bos-plus-toolbox scan ARGUMENTOSNota: al usar la la Caja de herramientas BOS+ en Linux, necesitará hacerla ejecutable mediante el comando siguiente (esto solo debe hacerse una vez):
chmod u+x ./bos-plus-toolbox
Puede usar los argumentos siguientes para ajustar el proceso:
Argumentos |
Descripción |
---|---|
-h, --help |
muestra este mensaje de ayuda y sale |
Debe usar una de las siguientes acciones para ajustar el proceso:
Acciones |
Descripción |
---|---|
scan |
explorar activamente el rango provisto de direcciones |
listen |
escuchar transmisión entrande desde los dispositivos (al presionar el botón IP report) |
Ejemplo:
./bos-plus-toolbox.exe discover scan 10.10.10.0/24
Este comando va explorar la red, en el rango 10.10.10.0 - 10.10.10.255 y mostrará los mineros que encuentre con sus direcciones IP.
Paquete Web¶
El paquete Web puede usarse para cambiar el firmware de serie, liberado antes de 2019. También debería funcionar con otros basados en firmware de serie. Este paquete no puede usarse con firmware de serie, liberado en 2019 o posterior, debido a la verificación de firma, que fue implementada. La verificación de firma previene el uso de otro firmware que no sea firmware de serie originales.
Características, PROs y CONs de este método:¶
reemplaza el firmware de serie con Braiins OS+ sin herramientas adicionales
migra la configuración de red
migra las direcciones (URL) de los pool, usuarios y claves
activa el autoajuste al límite de energía por defecto
no puede usarse con firmware de serie liberado en 2019 o luego
no puede configurar la instalación (ej: siempre migrará la configuración de red)
no hay modo-por-lotes (a menos que se cree sus propios scripts)
Imagen para tarjeta SD¶
Si está corriendo firmware de serie, que fue liberado en 2019 o luego, la única forma de instalar Braiins OS+ es insertar una tarjeta SD con Braiins OS+ escrito en ella. En 2019, la conexión SSH fue bloqueada y la verificación de firma en la interfaz web impide el uso de otro firmware distinto al de serie.
Características, PROs y CONs de este método:¶
reemplaza el firmware de serie con SSH bloqueado con Braiins OS+
usa la configuración de red almacenada en la NAND (esto puede apagarse, vea la sección Network settings abajo)
activa el autoajuste al límite de energía por defecto
no migra direcciones (URL) de pool, usuarios o claves
no hay modo-por-lotes
Instalar Braiins OS+ usando la tarjeta SD card¶
Descargue la Imagen para tarjeta SD desde nuestro sitio web.
Escriba la imagen descargada a una tarjeta SD (ej: usando Etcher). Nota: Una simple copia no funcionará. ¡La tarjeta SD debe ser escrita!
Ajuste los jumpers para arrancar desde la tarjeta SD (en lugar de la memoria NAND), como se muestra abajo.
Inserte la tarjeta SD card en el dispositivo, luego inicie el dispositivo.
Tras un momento, debe poder acceder la interfaz de Braiins OS+ a través de la dirección IP del dispositivo.
[Opcional]: Ahora puede instalar Braiins OS+ a la NAND (ver la sección sd_nand_install)
Configuración de red¶
Por defecto, la configuración almacenada en la NAND se utilizará, mientras esté corriendo Braiins OS+ desde una tarjeta SD. Esta característica puede apagarse, siguiendo los pasos abajo:
Monte la primera partición FAT de la tarjeta SD
Abra el archivo uEnv.txt e inserte la frase siguiente (asegúrese de que solo hay una frase por línea)
cfg_override=no
Deshabilitar el uso de la vieja configuración de red es beneficioso para los usuarios, que tienen problemas con el minero no estar visible en la red (ej: la dirección IP estática usada en la NAND está fuera del rango de la red). Al hacerlo, se usa DHCP.
Instalar a NAND¶
- La tarjeta SD puede usarse para reemplazar el firmware corriendo en la NAND con Braiins OS+. Eso se hace:
usando la interfaz web - sección System -> Install current system to device (NAND)
usando la herramienta miner, via SSH - siga esta sección de la guía miner_nand_install
Restablecer de fábrica Braiins OS+ usando la tarjeta SD¶
Puede hacer un restablecimiento de fábrica, siguiendo los pasos abajo:
Monte la primera partición FAT de la tarjeta SD
Abra el archivo uEnv.txt e inserte la frase siguiente (asegúrese de que solo hay una frase por línea)
factory_reset=yes
Paquete de instalación remota (SSH)¶
Con el paquete de instalación remota (SSH) puede instalar o desinstalar Braiins OS+. Este método no es recomendado, ya que requiere una instalación Python. Use la caja de herramientas BOS+ en su lugar.
Uso¶
Descargue el Paquete de instalación remota (SSH) desde nuestro sitio web.
Siga las instrucciones abajo
Características, PROs y CONs de este método:¶
instala Braiins OS+ remotamente
desinstala Braiins OS+ remotamente
migra toda la configuración por defecto (puede ajustarse) al instalar Braiins OS+
migra la configuración de red por defecto (puede ajustarse) al desinstalar Braiins OS+
parámetros disponibles para personalizar el proceso
enciende el autoajuste a un límite de energía por defecto al instalar Braiins OS+
no hay modo-por-lotes (a menos que cree sus propios scripts)
requiere una larga instalación
no funciona en un minero con SSH bloqueado
Preparando el ambiente¶
Primero, necesita preparar el ambiente Python. Esto consiste en los siguientes pasos:
(Solo Windows) Instalar Ubuntu para Windows 10 disponible desde la Tienda Microsoft aquí.
Corra los siguientes comandos en su terminal de línea de comandos:
(Note que los comandos son compatibles con Ubuntu y Ubuntu para Windows 10. Si está usando una distribución diferente de Linux o un sistema operativo diferente, por favor verifique la documentación correspondiente y edite los comandos según sea necesario.)
#Actualizar los repositorios e instalar dependencias
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
#Descargar y extraer el paquete de firmware
wget -c http://feeds.braiins-os.com/20.04/braiins-os_am1-s9_ssh_2020-04-30-1-cbf99510-plus.tar.gz -O - | tar -xz
#Cambiar el directorio a la carpeta donde desempacó el firmware
cd ./braiins-os_am1-s9_ssh_2020-04-30-1-cbf99510-plus
#Crear un ambiente virtual y activarlo
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#Instalar los paquetes Python requeridos
python3 -m pip install -r requirements.txt
Instalar Braiins OS+ usando el paquete SSH¶
La instalación de Braiins OS+ usando el asi-llamado Método SSH consiste en los siguientes pasos:
(Firmware Personalizado) Escribir firmware de serie. Este paso puede omitirse si el dispositivo está corriendo el firmware de serie o una versión previa de Braiins OS. (Nota: Es posible, que Braiins OS+ pueda ser instalado directamente sobre un firmware personalizado, pero como difieren de la versión de serie, podría ser necesario escribir la versión de serie primero.)
(Solo Windows) Instalar Ubuntu para Windows 10 disponible desde la Tienda Microsoft aquí.
Prepare el ambiente Python, como se describe en la sección ssh_package_environment.
Corra los siguientes comandos en su terminal de línea de comandos (reemplace
DIRECCIÓN_IP
por la correspondiente) :
(Note que los comandos son compatibles con Ubuntu y Ubuntu para Windows 10. Si está usando una distribución diferente de Linux o un sistema operativo diferente, por favor verifique la documentación correspondiente y edite los comandos según sea necesario.)
#Cambiar al directorio de la carpeta con el firmware desempacado (si no está ya en la carpeta del firmware)
cd ./braiins-os_am1-s9_ssh_2020-04-30-1-cbf99510-plus
#Activar el ambiente virtual (si no está ya activado)
source .env/bin/activate
#Correr el script para instalar Braiins OS+
python3 upgrade2bos.py DIRECCIÓN_IP
Nota: para mas información acerca de los argumentos que pueden usarse, use el argumento --help.
Desinstalar Braiins OS+ usando el paquete SSH¶
Usando imagen de fábrica¶
Primero, debe preparar el ambiente Python, que está descrito en la sección ssh_package_environment.
En un Antminer S9, puede escribir una imagen de fábrica del sitio web del fabricante, con la IMAGEN_DE_FÁBRICA
siendo la ruta al archivo o la dirección (URL) al archivo tar.gz
(¡sin extraer!). Las imágenes soportadas con sus correspondientes hashes MD5 están listadas en el archivo
platform.py.
Corra (reemplace los marcadores IMAGEN_DE_FÁBRICA
y DIRECCIÓN_IP
como corresponda):
cd ~/braiins-os_am1-s9_ssh_2020-04-30-1-cbf99510-plus && source .env/bin/activate
python3 restore2factory.py --factory-image IMAGEN_DE_FÁBRICA DIRECCIÓN_IP
Nota: para mas información acerca de los argumentos que pueden usarse, use el argumento --help.
Usando respaldo previamente creado¶
Primero, debe preparar el ambiente Python, que está descrito en la sección ssh_package_environment.
Si creo un respaldo del firmware original durante la instalación de Braiins OS+, puede restaurarlo mediante el uso de los siguientes comandos (reemplace los marcadores ID_RESPALDO_FECHA
y DIRECCIÓN_IP
como corresponda):
cd ~/braiins-os_am1-s9_ssh_2020-04-30-1-cbf99510-plus && source .env/bin/activate
python3 restore2factory.py backup/ID_RESPALDO_FECHA/ DIRECCIÓN_IP
Nota: Este método no es recomendado ya que la creación del respaldo es muy quisquillosa. El respaldo puede corromperse y no hay manera de comprobarlo. ¡Use a su propio riesgo y asegúrese, de tener acceso al minero e insertar una tarjeta SD al mismo en caso de que la restauración no finalice exitosamente!
OPKG¶
Los comandos OPKG pueden usarse luego de conectarse al minero vía SSH. Hay muchos comandos OPKG, pero respecto a Braiins OS+, solo necesita usar los siguientes:
opkg update - actualiza la lista de paquetes. Se recomienda usar este comando antes de otros comandos OPKG.
opkg install NOMBRE_DE_PAQUETE instala el paquete definido. Se recomienda usar opkg update para actualizar la lista de paquetes antes de instalar paquetes.
opkg remove NOMBRE_DE_PAQUETE
Ya que los cambios de firmware resultan en un reinicio, se espera la siguiente salida:
...
Collected errors:
* opkg_conf_load: Could not lock /var/lock/opkg.lock: Resource temporarily unavailable.
Saving config files...
Connection to 10.10.10.1 closed by remote host.
Connection to 10.10.10.1 closed.
Características, PROs y CONs de este método:¶
actualiza Braiins OS+ remotamente
cambia a Braiins OS+ desde otras versiones remotamente
revierte a la versión inicial de Braiins OS remotamente
migra la configuración y continua minando sin necesidad de configurar nada (al actualizar o cambiar a Braiins OS+)
no hay modo-por-lotes (a menos que cree sus propios scripts)
Actualizar Braiins OS+ usando OPKG¶
Con OPKG puede actualizar fácilmente su instalación actual de Braiins OS+, conectándose al minero vía SSH y usando los siguientes comandos:
opkg update
opkg install firmware
#también se puede conectar al minero y correr los comandos al mismo tiempo
ssh root@DIRECCIÓN_IP "opkg update && opkg install firmware"
Esto migrará la configuración y continuará minando sin necesidad de configurar nada.
Cambiar a Braiins OS+ desde otras versiones usando OPKG¶
Con OPKG puede fácilmente cambiar a Braiins OS+, conectándose al minero vía SSH y usando los siguientes comandos:
opkg update
opkg install bos_plus
#también se puede conectar al minero y correr los comandos al mismo tiempo
ssh root@DIRECCIÓN_IP "opkg update && opkg install bos_plus"
Esto migrará la configuración y continuará minando sin necesidad de configurar nada. El límite de energía por defecto se pone a.
Restablecer de fábrica Braiins OS+ usando OPKG¶
Con OPKG puede revertir fácilmente a la versión inicial de Braiins OS (la versión que fue instalada por primera vez en ese dispositivo), conectándose al minero vía SSH y usando los siguientes comandos:
opkg update
opkg remove firmware
#también se puede conectar al minero y correr los comandos al mismo tiempo
ssh root@DIRECCIÓN_IP "opkg update && opkg remove firmware"
Esto restablecerá la configuración al estado luego de la primera instalación de Braiins OS.
Paquete sysupgrade¶
Sysupgrade se usa para actualizar el sistema corriendo en el dispositivo. Con este método, puede instalar varias versiones de Braiins OS o crear un respaldo del sistema. La instalación de un firmware usando la interfaz web Braiins OS o usar opkg install firmware usan este método. Es recomendado usar la interfaz web Braiins OS u opkg install firmware en lugar de este método.
Uso¶
Para poder usar sysupgrade, necesita conectarse al minero vía SSH. La sintaxis es la siguiente:
sysupgrade [parámetros] <archivo imagen o dirección (URL)>
Los parámetros mas importantes son --help (para mostrar la ayuda) y -F para forzar la instalación. No es recomendado usar este método (a pesar de la forma, se describe abajo), a menos que realmente sepa, lo que está haciendo.
Características, PROs y CONs de este método:¶
instala varias versiones de Braiins OS, estando conectado al minero
migra la configuración
parámetros disponibles para personalizar el proceso
no hay modo-por-lotes (a menos que cree sus propios scripts)
no puede cambiar a una versión vieja de Braiins OS (liberada antes de 2020)
Cambiar a Braiins OS (sin autoajuste) desde otras versiones usando Sysupgrade¶
Para actualizar desde una versión anterior de Braiins OS o desactualizar desde Braiins OS+, use el siguiente comando (reemplace el marcador DIRECCIÓN_IP
como corresponda):
ssh root@DIRECCIÓN_IP 'wget -O /tmp/firmware.tar https://feeds.braiins-os.org/am1-s9/firmware_2020-04-30-0-259943b5_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
Este comando contiene los siguientes comandos:
ssh - para conectarse al minero
wget - usado para descargar archivos, en este caso el paquete firmware
sysupgrade - para propiamente escribir el paquete de firmware descargado
Cambiar a Braiins OS+ desde otras versiones usando Sysupgrade¶
Para actualizar desde una versión anterior de Braiins OS, use el siguiente comando (reemplace el marcador DIRECCIÓN_IP
como corresponda):
ssh root@IP_ADDRESS 'wget -O /tmp/firmware.tar http://feeds.braiins-os.com/am1-s9/firmware_2020-04-30-1-cbf99510-plus_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
Este comando contiene los siguientes comandos:
ssh - para conectarse al minero
wget - usado para descargar archivos, en este caso el paquete firmware
sysupgrade - para propiamente escribir el paquete de firmware descargado
Nota: Se recomienda usar la Caja de herramientas BOS+, Interfaz web Braiins OS u opkg install bos_plus en lugar de este método.
Script Bos2Bos¶
Bos2Bos script is not recommended to use, unless you experience problems with the installation using the other methods. This method works, only if Braiins OS is already running on the device.
Características, PROs y CONs de este método:¶
instala cualquier versión de Braiins OS remotamente
instala una versión limpia de Braiins OS
parámetros disponibles para personalizar el proceso
no hay modo-por-lotes (a menos que cree sus propios scripts)
Uso¶
Usage of the Bos2Bos script requires the following setup:
(Solo Windows) Instalar Ubuntu para Windows 10 disponible desde la Tienda Microsoft aquí.
Corra los siguientes comandos en su terminal de línea de comandos:
(Note que los comandos son compatibles con Ubuntu y Ubuntu para Windows 10. Si está usando una distribución diferente de Linux o un sistema operativo diferente, por favor verifique la documentación correspondiente y edite los comandos según sea necesario.)
#Actualizar los repositorios e instalar dependencias
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
# clonar repositorio
git clone https://github.com/braiins/braiins-os.git
#cambiar el directorio
cd ./braiins-os/braiins-os/
#Crear un ambiente virtual y activarlo
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#Instalar los paquetes Python requeridos
python3 -m pip install -r requirements.txt
Luego de finalizar la instalación exitosamente, puede usar los siguientes comandos:
#activar el ambiente virtual
source .env/bin/activate
#su uso básico es el siguiente
python3 bos2bos.py URL_FIRMWARE DIRECCIÓN_IP
#la descripción de todos los parámetros disponibles puede verse usando el siguiente comando
python3 bos2bos.py -h
python3 bos2bos.py -h
Herramienta Miner¶
Instalar SD a NAND usando la herramienta Miner¶
La tarjeta SD puede usarse para reemplazar el firmware corriendo en la NAND con Braiins OS+. Esto puede hacerse conectándose al minero via SSH y usando el siguiente comando:
miner nand_install
Restablecer de fábrica Braiins OS+ usando la herramienta Miner¶
Restablecer de fábrica también puede hacerse con la herramienta Miner. Use el siguiente comando para hacerlo:
miner factory_reset
Detectar el dispositivo mediante LEDs usando la herramienta Miner¶
Puede conseguir un dispositivo encendiendo el parpadeo LED, usando la herramienta Miner. Use el siguiente comando para hacerlo:
#encender parpadeo LED miner fault_light on #apagar parpadeo LED miner fault_light off
Encender/apagar alimentaciones nocturnas usando la herramienta Miner¶
Puede encender las alimentaciones Nocturnas para poder actualizar a las últimas versiones nocturnas. Estas versiones son para arreglar problemas cruciales tan rápido como sea posible y por ello, no se hacen pruebas a fondo en estas versiones. Use estas versiones con precaución y solo si resuelve sus problemas. Para poder encender/apagar las alimentaciones nocturnas, use el siguiente comando:
#encender alimentaciones nocturnas miner nightly_feeds on #apagar alimentaciones nocturnas miner nightly_feeds off
Encender/apagar auto-actualizar usando la herramienta Miner¶
Puede encender la característica de auto-actualizar, que actualizará el sistema automáticamente a la última versión. Esta característica está encendida por defecto, en transición desde un firmware de serie y apagada al actualizar desde versiones anteriores de Braiins OS o Braiins OS+. Para poder encender/apagar auto-actualizar, use el siguiente comando:
#encender auto-actualizar miner auto_upgrade on #apagar auto-actualizar miner auto_upgrade off