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+ (Instalar Braiins OS+ con la Caja de herramientas BOS+)
Usando el paquete web (Instalar Braiins OS+ usando el Paquete web)
Usando la tarjeta SD (Instalar Braiins OS+ usando la tarjeta SD card)
Usando la tarjeta SD y la herramienta miner (Instalar SD a NAND usando la herramienta Miner)
Usando scripts SSH (Instalar Braiins OS+ usando el paquete SSH)
Actualizar Braiins OS+
Usando la Caja de herramientas BOS+ (Actualizar Braiins OS+ con la Caja de herramientas BOS+)
Usando OPKG (Actualizar Braiins OS+ usando OPKG)
Usando el paquete sysupgrade (Cambiar a Braiins OS+ desde otras versiones usando Sysupgrade)
Usando el script bos2bos (Script Bos2Bos)
Cambiar a Braiins OS (versión sin autoajuste)
Usando el paquete sysupgrade (Cambiar a Braiins OS (sin autoajuste) desde otras versiones usando Sysupgrade)
Usando el script bos2bos (Script Bos2Bos)
Cambiar a Braiins OS+ (versión con autoajuste)
Usando OPKG (Cambiar a Braiins OS+ desde otras versiones usando OPKG)
Usando el paquete sysupgrade (Cambiar a Braiins OS+ desde otras versiones usando Sysupgrade)
Usando el script bos2bos (Script 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 (Restablecer de fábrica Braiins OS+ usando OPKG)
Usando la tarjeta SD (Restablecer de fábrica Braiins OS+ usando la tarjeta SD)
Usando la herramienta "miner" (Restablecer de fábrica Braiins OS+ usando la herramienta Miner)
Usando el script bos2bos (Script Bos2Bos)
Desinstalar Braiins OS+
Usando la Caja de herramientas BOS+ (Desinstalar Braiins OS+ con la Caja de herramientas BOS+)
Usando scripts SSH (Desinstalar Braiins OS+ usando el paquete SSH)
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 (1420W) 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 (1420W)
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 (1420W)
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 Instalar a NAND)
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 Instalar SD a NAND usando la herramienta Miner
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 (1420W) 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 Preparando el ambiente.
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_2019-02-21-0-572dd48c_2020-03-29-1-6b4a0f46
#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 Preparando el ambiente.
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_2019-02-21-0-572dd48c_2020-03-29-1-6b4a0f46 && 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 Preparando el ambiente.
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_2019-02-21-0-572dd48c_2020-03-29-1-6b4a0f46 && 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 facilmente 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 (1420W).
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