Расширенное руководство¶
Разветвление¶
Существует множество инструментов, пакетов и скриптов, которые можно использовать для Braiins OS. Для лучшей навигации используйте следующее:
Установка Braiins OS
Используя BOS Toolbox (Установка Braiins OS с помощью BOS Toolbox)
Используя веб-пакет (Установите Braiins OS с помощью веб-пакета)
Используя SD карту (Установка Braiins OS с помощью SD карты)
Используя SD карту и miner tool (SD на NAND установка с помощью Miner tool)
Используя SSH скрипты (Установка Braiins OS с помощью SSH-пакета)
Обновление Braiins OS
Используя BOS Toolbox (Обновление Braiins OS с помощью BOS Toolbox)
Используя OPKG (Обновление Braiins OS с помощью OPKG)
Используя пакет sysupgrade (Переход на Braiins OS из других версий с помощью Sysupgrade)
Используя bos2bos скрипт (Bos2Bos скрипт)
Переход на Braiins OS (версия без автонастройки)
Используя пакет sysupgrade (Переход на Braiins OS (без автонастройки) из других версий с помощью Sysupgrade)
Используя bos2bos скрипт (Bos2Bos скрипт)
Переход на Braiins
(версия с автонастройкой)
Используя OPKG (Переход на Braiins OS с другой версии с помощью OPKG)
Используя пакет sysupgrade (Переход на Braiins OS из других версий с помощью Sysupgrade)
Используя bos2bos скрипт (Bos2Bos скрипт)
Сброс к исходной версии Braiins OS (версия, которая была впервые установлена на устройстве) - возврат к заводским настройкам
Используя OPKG (Braiins OS сброс настроек с помощью OPKG)
Используя SD карту (Braiins OS сброс настроек с помощью SD-карты)
Используя "miner" tool (Braiins OS сброс настроек с помощью Miner tool)
Используя bos2bos скрипт (Bos2Bos скрипт)
Деинсталляция Braiins OS
Используя BOS Toolbox (Деинсталляция Braiins OS с помощью BOS Toolbox)
Используя SSH скрипты (Деинсталляция Braiins OS с помошью SSH-пакета)
BOS Toolbox¶
BOS Toolbox - это новый инструмент, который позволяет пользователю легко устанавливать, удалять, обновлять, обнаруживать и настраивать Braiins OS. Это также позволяет делать это в пакетном режиме, что упрощает управление большим количеством устройств. Это рекомендуемый способ управления вашими устройствами.
Применение¶
Скачайте BOS Toolbox с нашего веб-сайта.
Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox. Используйте только один IP-адрес в строке!
Следуйте разделам ниже
Особенности, плюсы и минусы этого метода:¶
дистанционная установка Braiins OS
дистанционное обновление Braiins OS
дистанционное удаление Braiins OS
дистанционная конфигурация Braiins OS
сканирование сети на наличие устройств
переносит всю конфигурацию по умолчанию (можно настроить) при установке Braiins OS
переносит конфигурацию сети по умолчанию (можно настроить) при удалении Braiins OS
параметры доступны для настройки процесса
пакетный режим доступен для управления несколькими устройствами одновременно
простота использования
не работает на майнере с заблокированным SSH
Установка Braiins OS с помощью BOS Toolbox¶
Скачайте BOS Toolbox с нашего веб-сайта.
Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox. Используйте только один IP-адрес в строке!
После того, как вы загрузили BOS Toolbox, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
Замените FILE_PATH_TO_BOS_TOOLBOX заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS Toolbox. Затем переключитесь на путь к файлу, выполнив команду:
cd FILE_PATH_TO_BOS_TOOLBOXТеперь замените listOfMiners.csv заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:
Для командной строки Windows:
bos-toolbox.exe install ARGUMENTS HOSTNAMEДля командной строки Linux:
./bos-toolbox install ARGUMENTS HOSTNAME **Примечание:** *при использовании BOS Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):* :: chmod u+x ./bos-toolbox
Вы можете использовать следующие аргументы, чтобы настроить процесс:
Важная заметка: При установке Braiins OS на одно устройство, используйте аргумент HOSTNAME (IP-адрес). При установке Braiins OS на несколько устройств, НЕ используйте аргумент HOSTNAME, вместо этого, используйте аргумент --batch BATCH.
Аргументы |
Описание |
---|---|
-h, --help |
показать это справочное сообщение и выйти |
--batch BATCH |
путь к файлу со списком хостов (IP-адресов) для установки |
--backup |
сделать резервную копию майнера перед обновлением |
--no-nand-backup |
пропустить полное резервное копирование NAND (конфигурация все еще копируется) |
--pool-user [POOL_USER] |
установить имя пользователя и воркера для пула по умолчанию |
--psu-power-limit [PSU_POWER_LIMIT] |
установить предел мощности блока питания (в ваттах) |
--no-keep-network |
не сохранять конфигурацию сети майнера (использование DHCP) |
--no-keep-pools |
не сохранять конфигурацию пула |
--no-keep-hostname |
не сохраняйте имя хоста и генерировать новое на основе MAC |
--keep-hostname |
заставить оставлять любое имя хоста |
--no-wait |
не ждать, пока система полностью обновится |
--dry-run |
сделать все шаги обновления без фактического обновления |
--post-upgrade [POST_UPGRADE] |
путь к каталогу с stage3.sh скриптом |
--install-password INSTALL_PASSWORD |
ssh пароль для установки |
Пример:
bos-toolbox.exe install --batch listOfMiners.csv --install-password admin
Эта команда установит Braiins OS на майнеры, указанные в файле listOfMiners.csv. Команда также автоматически вставит пароль SSH admin, когда майнер запросит его.
Обновление Braiins OS с помощью BOS Toolbox¶
Скачайте BOS Toolbox с нашего веб-сайта.
Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox.
После того, как вы загрузили BOS Toolbox, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
Замените FILE_PATH_TO_BOS_TOOLBOX заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS Toolbox. Затем переключитесь на путь к файлу, выполнив команду:
cd FILE_PATH_TO_BOS_TOOLBOX
Теперь замените listOfMiners.csv заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:
Для командной строки Windows:
bos-toolbox.exe update ARGUMENTS HOSTNAMEДля командной строки Linux:
./bos-toolbox update ARGUMENTS HOSTNAME **Примечание:** *при использовании BOS Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):* :: chmod u+x ./bos-toolbox
Вы можете использовать следующие аргументы, чтобы настроить процесс:
Важная заметка: При установке Braiins OS на одно устройство, используйте аргумент HOSTNAME (IP-адрес). При установке Braiins OS на несколько устройств, НЕ используйте аргумент HOSTNAME, вместо этого, используйте аргумент --batch BATCH.
Аргументы |
Описание |
---|---|
--h, --help |
показать это справочное сообщение и выйти |
--batch BATCH |
путь к файлу со списком хостов для установки |
-p PASSWORD, --password PASSWORD |
пароль администратора |
-i, --ignore |
не останавливаться на ошибках |
Пример:
bos-toolbox.exe update --batch listOfMiners.csv
Эта команда будет искать обновление для майнеров, указанных в listOfMiners.csv, и обновлять их, если появится новая версия прошивки.
Деинсталляция Braiins OS с помощью BOS Toolbox¶
Скачайте BOS Toolbox с нашего веб-сайта.
Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".
После того, как вы загрузили BOS Toolbox и сохранили .csv фаил, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
Замените FILE_PATH_TO_BOS_TOOLBOX заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS Toolbox. Затем переключитесь на путь к файлу, выполнив команду:
cd FILE_PATH_TO_BOS_TOOLBOX
Теперь замените listOfMiners.csv заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:
Для командной строки Windows:
bos-toolbox.exe uninstall ARGUMENTS HOSTNAMEДля командной строки Linux:
./bos-toolbox uninstall ARGUMENTS HOSTNAMEПримечание: при использовании BOS Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):
chmod u+x ./bos-toolbox
Вы можете использовать следующие аргументы, чтобы настроить процесс:
Важная заметка: При установке Braiins OS на одно устройство, используйте аргумент HOSTNAME (IP-адрес). При установке Braiins OS на несколько устройств, НЕ используйте аргумент HOSTNAME, вместо этого, используйте аргумент --batch BATCH.
Аргументы |
Описание |
---|---|
-h, --help |
показать это справочное сообщение и выйти |
--batch BATCH |
путь к файлу со списком хостов для установки |
--factory-image FACTORY_IMAGE |
путь/URL к исходному образу обновления прошивки (дефолт: Antminer-S9-all-201812051512-autofreq-user-Update2UBI- NF.tar.gz) |
Пример:
bos-toolbox.exe uninstall --batch listOfMiners.csv
Эта команда удалит Braiins OS из майнеров, указанных в файле listOfMiners.csv, и установит стандартную прошивку по умолчанию. (Antminer-S9-all-201812051512-autofreq-user-Update2UBI-NF.tar.gz).
Настройка Braiins OS с помощью BOS Toolbox¶
Скачайте BOS Toolbox с нашего веб-сайта.
Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".
После того, как вы загрузили BOS Toolbox и сохранили .csv фаил, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
Замените FILE_PATH_TO_BOS_TOOLBOX заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS Toolbox. Затем переключитесь на путь к файлу, выполнив команду:
cd FILE_PATH_TO_BOS_TOOLBOXТеперь замените *listOfMiners.csv заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы
Для командной строки Windows:
bos-toolbox.exe config ARGUMENTS ACTION TABLEДля командной строки Linux:
./bos-toolbox config ARGUMENTS ACTION TABLEПримечание:* при использовании BOS Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):
chmod u+x ./bos-toolbox
ы можете использовать следующие аргументы, чтобы настроить процесс:
Аргументы |
Описание |
---|---|
-h, --help |
показать это справочное сообщение и выйти |
-u USER, --user USER |
Имя пользователя администратора |
-p PASSWORD, --password PASSWORD |
Пароль администратора или "prompt" |
-c, --check |
пробный прогон sans |
-i, --ignore |
не останавливаться на ошибках |
Вам необходимо использовать одно из следующих действий чтобы отрегулировать процесс:
Аргументы |
Описание |
---|---|
load |
загрузить текущую конфигурацию майнеров (указанную в файле CSV) и вставить их в файл CSV |
save |
сохранить настройки из файла CSV для майнеров (без применения) |
apply |
применить настройки, которые были скопированы из файла CSV к майнерам |
save_apply |
сохранить и применить настройки из файла CSV к майнерам |
Пример:
bos-toolbox.exe config --user root load listOfMiners.csv
#отредактируйте файл CSV с помощью редактора электронных таблиц (например: Office Excel, LibreOffice Calc, etc.)
bos-toolbox.exe config --user root save_apply listOfMiners.csv
Первая команда загрузит конфигурацию майнеров, указанную в listOfMiners.csv (используя логин root) и сохранит ее в CSV-файле. Теперь вы можете открыть файл и редактировать то, что вам нужно. После редактирования файла вторая команда скопирует настройки обратно в майнеры и применит их.
Сканирование сети для выявления майнеров с помощью BOS Toolbox¶
Скачайте BOS Toolbox с нашего веб-сайта.
Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".
После того, как вы загрузили BOS Toolbox и сохранили .csv фаил, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
Замените FILE_PATH_TO_BOS_TOOLBOX заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS Toolbox. Затем переключитесь на путь к файлу, выполнив команду:
cd FILE_PATH_TO_BOS_TOOLBOX
Теперь замените listOfMiners.csv заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:
Для командной строки Windows:
bos-toolbox.exe discover ARGUMENTSДля командной строки Linux:
./bos-toolbox discover ARGUMENTSПримечание: при использовании BOS Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):
chmod u+x ./bos-toolbox
Вы можете использовать следующие аргументы, чтобы настроить процесс:
Аргументы |
Описание |
---|---|
-h, --help |
показать это справочное сообщение и выйти |
Вам необходимо использовать одно из следующих действий чтобы отрегулировать процесс:
Аргументы |
Описание |
---|---|
scan |
активно сканировать предоставленный диапазон адресов |
listen |
прослушивание входящей трансляции с устройств (при нажатии кнопки отчета IP) |
Пример:
bos-toolbox.exe discover scan 10.10.10.0/24
Эта команда будет сканировать сеть, в диапазоне 10.10.10.0 - 10.10.10.255 и выведет список найденных майнеров с их IP-адресами.
Веб-пакет¶
Веб-пакет можно использовать для переключения со стоковой прошивки, выпущенной до 2019 года. Он также должен работать на других прошивках, основанных на стоковой версии. Этот пакет нельзя использовать на стоковой прошивке, выпущенной в 2019 году и позже, из-за проверки подписи, которая была реализована. Проверка подписи предотвращает использование иных, чем оригинальные стоковые прошивки.
Особенности, плюсы и минусы этого метода:¶
заменяет стоковую прошивку на Braiins OS без использования дополнительных инструментов
переносит конфигурацию сети
переносит пул URL, имена пользователей и пароли
не может использоваться на стоковой прошивке, выпущенной в 2019 году и позже
невозможно настроить установку (например, он всегда будет переносить настройки сети)
нет пакетного режима (для массовой установки), если вы не создаете свои собственные скрипты
Образ SD карты¶
Если вы используете стандартную прошивку, выпущенную в 2019 году и позже, единственный способ установить Braiins OS - это вставить SD-карту с прошивкой Braiins OS. В 2019 году SSH-соединение было заблокировано, и проверка подписи в веб-интерфейсе предотвращает использование других программных прошивок.
Особенности, плюсы и минусы этого метода:¶
заменяет SSH заблокированную стоковую прошивку на Braiins OS
использует конфигурацию сети, хранящуюся в NAND (это можно отключить, см. раздел Настройки сети ниже)
не переносит пул URL, имена пользователей и пароли
нет пакетного режима (для массовой установки)
Установка Braiins OS с помощью SD карты¶
Скачайте Образ SD карты с нашего веб-сайта.
Перенесите загруженный образ на SD-карту (например, используя Etcher). Примечание. Простое копирование на SD-карту не будет работать. SD-карта должна быть перепрошита!
Настройте перемычки для загрузки с SD-карты (вместо памяти NAND), как показано ниже.
Вставьте SD-карту в устройство, затем запустите устройство.
Через некоторое время вы сможете получить доступ к интерфейсу Braiins OS через IP-адрес устройства.
[Необязательно]: Теперь вы можете установить Braiins OS на NAND (см. раздел NAND установка)
Настройки сети¶
По умолчанию используется конфигурация сети, хранящаяся в NAND, при запуске Braiins OS с SD-карты. Эта функция может быть отключена, следуя инструкциям ниже:
Смонтируйте первый раздел FAT на SD-карте
Откройте файл uEnv.txt и вставьте следующий стринг (убедитесь, что в на каждой строке только один стринг)
cfg_override=no
Отключение использования старых сетевых настроек полезно для пользователей, у которых есть проблемы с тем, что майнер не виден в сети (например, статический IP-адрес, используемый в NAND, находится вне зоны действия сети). При этом используется DHCP.
NAND установка¶
- SD-карту можно использовать для замены встроенного программного обеспечения NAND на Braiins OS. Это можно сделать либо:
используя веб-интерфейс - раздел System -> Install current system to device (NAND)
используя miner tool через SSH - следуйте этому разделу руководства SD на NAND установка с помощью Miner tool
Braiins OS сброс настроек с помощью SD-карты¶
Вы можете сделать сброс до заводских настроек, следуя инструкциям ниже:
Смонтируйте первый раздел FAT на SD-карте
Откройте файл uEnv.txt и вставьте следующий стринг (убедитесь, что в на каждой строке только один стринг)
factory_reset=yes
Пакет удаленной установки (SSH)¶
С помощью Пакета удаленной установки (SSH) вы можете установить или удалить Braiins OS. Этот метод не рекомендуется, так как требует установки Python. Вместо этого используйте BOS Toolbox.
Особенности, плюсы и минусы этого метода:¶
дистанционная установка Braiins OS
дистанционное удаление Braiins OS
переносит всю конфигурацию по умолчанию (можно настроить) при установке Braiins OS
переносит конфигурацию сети по умолчанию (можно настроить) при удалении Braiins OS
параметры доступны для настройки процесса
нет пакетного режима (для массовой установки), если вы не создаете свои собственные скрипты
требует долгой установки
не работает на майнере с заблокированным SSH
Подготовка среды¶
Во-первых, вам нужно подготовить среду Python. Это состоит из следующих шагов:
(Только Windows) Устонавите Ubuntu for Windows 10 доступный в Microsoft Store здесь.
Выполните следующие команды в терминале командной строки:
(Обратите внимание, что команды совместимы с Ubuntu и Ubuntu для Windows 10. Если вы используете другой дистрибутив Linux или другую ОС, пожалуйста, ознакомьтесь с соответствующей документацией и отредактируйте команды при необходимости.)
#Обновите репозитории и установите зависимости
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
#Скачайте и распакуйте пакет прошивки
wget -c https://feeds.braiins-os.org/20.04/braiins-os_am1-s9_ssh_2020-04-30-0-259943b5.tar.gz -O - | tar -xz
#Change the directory to the unpacked firmware folder
cd ./braiins-os_am1-s9_ssh_2020-04-30-0-259943b5
#Создайте виртуальную среду и активируйте ее
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#Установите необходимые пакеты Python
python3 -m pip install -r requirements.txt
Установка Braiins OS с помощью SSH-пакета¶
Установка Braiins OS с использованием так называемого Метода SSH состоит из следующих шагов:
(Кастомная прошивка) Перепрошейте на заводскую прошивкую Этот шаг можно пропустить, если устройство работает на заводской прошивке или на предыдущих версиях Braiins OS. (Примечание: вполне возможно, что Braiins OS может быть установлен непосредственно поверх кастомной прошивки, но, поскольку они отличаются от стоковой версии, может потребоваться сначала прошить стоковую прошивку.)
(Только Windows) Установите Ubuntu for Windows 10 оступный в Microsoft Store здесь.
Подготовьте среду Python, которая описана в разделе Подготовка среды.
Выполните следующие команды в терминале командной строки (заменить заполнитель
IP_ADDRESS
соответственно) :
(Обратите внимание, что команды совместимы с Ubuntu и Ubuntu для Windows 10. Если вы используете другой дистрибутив Linux или другую ОС, пожалуйста, ознакомьтесь с соответствующей документацией и отредактируйте команды при необходимости.)
#Измените каталог на распакованную папку с прошивкой (если ее еще нет в папке с прошивкой)
cd ./braiins-os_am1-s9_ssh_2019-02-21-0-572dd48c_2020-03-29-1-6b4a0f46
#Активируйте виртуальную среду (если она еще не активирована)
source .env/bin/activate
##Запустите скрипт для установки Braiins OS
python3 upgrade2bos.py IP_ADDRESS
Деинсталляция Braiins OS с помошью SSH-пакета¶
Использование заводского образа прошивки¶
Во-первых, вам нужно подготовить среду Python, которая описана в разделе Подготовка среды.
На Antminer S9, вы можете прошить заводской образ прошивки с сайта производителя, с тем, что``FACTORY_IMAGE`` это bпуть к файлу или URL к tar.gz
(не извлеченному!) файлу. Поддерживаемые изображения с соответствующими хэшами MD5 перечислены в
platform.py
file.
Запустите (заменив заполнители FACTORY_IMAGE
и IP_ADDRESS
соответственно):
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 FACTORY_IMAGE IP_ADDRESS
Использование ранее созданной резервной копии¶
Во-первых, вам нужно подготовить среду Python, которая описана в разделе Подготовка среды.
Если вы создали резервную копию оригинальной прошивки во время установки Braiins OS, вы можете восстановить ее с помощью следующих команд (замените заполнители BACKUP_ID_DATE
и IP_ADDRESS
соответственно):
cd ~/braiins-os_am1-s9_ssh_2019-02-21-0-572dd48c_2020-03-29-1-6b4a0f46 && source .env/bin/activate
python3 restore2factory.py backup/BACKUP_ID_DATE/ IP_ADDRESS
Примечание: Этот метод не рекомендуется, так как создание резервной копии очень сложно. Резервная копия может быть повреждена, и проверить ее невозможно. Используйте на свой страх и риск и убедитесь, что вы можете получить доступ к майнеру и вставить в него SD-карту, если восстановление не завершится успешно!
OPKG¶
OPKG команды можно использовать после подключения к майнеру через SSH. Существует много команд OPKG, но в отношении Braiins OS вам нужно использовать только следующее:
opkg update - обновляет списки пакетов. Рекомендуется использовать эту команду перед другими командами OPKG.
opkg install PACKAGE_NAME установить определенный пакет. Рекомендуется использовать opkg update для обновления списков пакетов перед установкой пакетов.
opkg remove PACKAGE_NAME
Поскольку смена прошивки приводит к перезагрузке, ожидается следующий вывод:
...
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.
Особенности, плюсы и минусы этого метода:¶
дистанционное обновление Braiins OS
дистанционный переход на Braiins OS с других версий
дистанционный возврат к первоначальной версии of Braiins OS
перенос конфигурации и продолжение майнинга без необходимости что-либо настраивать (при обновлении или переходе на Braiins OS с других версий)
нет пакетного режима (для массовой установки), если вы не создаете свои собственные скрипты
Обновление Braiins OS с помощью OPKG¶
С OPKG вы можете легко обновить текущую установку Braiins OS, подключившись к майнеру через SSH и используя следующие команды:
opkg update
opkg install firmware
#Вы также можете подключиться к майнеру и одновременно запускать команды
ssh root@IP_ADDRESS "opkg update && opkg install firmware"
Это перенесет конфигурацию и продолжит работу без необходимости что-либо настраивать.
Переход на Braiins OS с другой версии с помощью OPKG¶
С OPKG вы можете легко переключиться на Braiins OS, подключившись к майнеру через SSH и используя следующие команды:
opkg update
opkg install bos_plus
#Вы также можете подключиться к майнеру и одновременно запускать команды
ssh root@IP_ADDRESS "opkg update && opkg install bos_plus"
Это перенесет конфигурацию и продолжит работу без необходимости что-либо настраивать.
Braiins OS сброс настроек с помощью OPKG¶
С помощью OPKG вы можете легко вернуться к первоначальной версии Braiins OS (версии, которая была впервые установлена на этом устройстве), подключившись к майнеру по SSH и используя следующие команды:
opkg update
opkg remove firmware
#Вы также можете подключиться к майнеру и одновременно запускать команды
ssh root@IP_ADDRESS "opkg update && opkg remove firmware"
Это вернет конфигурацию в состояние после первой установки Braiins OS.
Sysupgrade пакет¶
Sysupgrade используется для обновления системы, работающей на устройстве. С помощью этого метода вы можете установить различные версии Braiins OS или создать резервную копию системы. При установке прошивки с использованием Braiins OS веб интерфейс или opkg install firmware используется этот метод. Вместо этого метода рекомендуется использовать Braiins OS веб интерфейс или opkg install firmware.
Применение¶
Чтобы использовать sysupgrade, вам нужно подключиться к майнеру по SSH. Синтаксис следующий:
sysupgrade [parameters] <image file or URL>
Наиболее важные параметры: --help (вывести справку) и -F для запуска установки. Рекомендуется использовать этот метод (кроме того, как описано ниже), только если вы действительно знаете, что делаете.
Особенности, плюсы и минусы этого метода:¶
устанавливает различные версии Braiins OS при одновременном подключении к майнеру
переносит конфигурацию
параметры доступны для настройки процесса
нет пакетного режима (для массовой установки), если вы не создаете свои собственные скрипты
не может переключиться на более старую версию Braiins OS (выпущенную ранее 2020)
Переход на Braiins OS (без автонастройки) из других версий с помощью Sysupgrade¶
Чтобы обновить более старую версию Braiins OS или перейти с более ранней версии Braiins OS, используйте следующую команду (замените заполнитель IP_ADDRESS
соответственно):
ssh root@IP_ADDRESS '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'
Эта команда содержит следующие команды:
ssh - подключиться к майнеру
wget - используется для загрузки файлов, в данном случае пакета прошивки
sysupgrade - фактически прошить скачанный пакет прошивки
Переход на Braiins OS из других версий с помощью Sysupgrade¶
Чтобы обновить более старую версию Braiins OS, используйте следующую команду (замените заполнитель IP_ADDRESS
соответственно):
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'
Эта команда содержит следующие команды:
ssh - подключиться к майнеру
wget - используется для загрузки файлов, в данном случае пакета прошивки
sysupgrade - фактически прошить скачанный пакет прошивки
Примечание: Рекомендуется использовать BOS Toolbox, Braiins OS веб интерфейс или opkg install bos_plus вместо этого метода.
Bos2Bos скрипт¶
Bos2Bos Скрипт не рекомендуется использовать, если только у вас не возникли проблемы с установкой с использованием других методов. Этот метод работает, только если на устройстве уже запущена Braiins OS.
Особенности, плюсы и минусы этого метода:¶
дистанционная установка любой версии Braiins OS
установка чистой версии Braiins OS
параметры доступны для настройки процесса
нет пакетного режима (для массовой установки), если вы не создаете свои собственные скрипты
Применение¶
Использование скрипта Bos2Bos требует следующей настройки:
(Только Windows) Установить Ubuntu for Windows 10 доступен в Microsoft Store здесь.
Выполните следующие команды в терминале командной строки:
(Обратите внимание, что команды совместимы с Ubuntu и Ubuntu для Windows 10. Если вы используете другой дистрибутив Linux или другую ОС, пожалуйста, ознакомьтесь с соответствующей документацией и отредактируйте команды при необходимости.)
#Обновите репозитории и установите зависимости
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
#Клонируйте хранилище
git clone https://github.com/braiins/braiins-os.git
#Измените каталог
cd ./braiins-os/braiins-os/
#Создайте виртуальную среду и активируйте ее
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#Установите необходимые пакеты Python
python3 -m pip install -r requirements.txt
После успешного завершения настройки вы можете использовать следующие команды:
#активировать виртуальную среду
source .env/bin/activate
#основное использование заключается в следующем
python3 bos2bos.py FIRMWARE_URL IP_ADDRESS
#описание всех доступных параметров может быть отображено с помощью следующей команды
python3 bos2bos.py -h
Miner tool¶
SD на NAND установка с помощью Miner tool¶
SD-карту можно использовать для замены встроенного программного обеспечения NAND на Braiins OS. Это можно сделать, подключившись к майнеру по SSH и используя следующую команду:
miner nand_install
Braiins OS сброс настроек с помощью Miner tool¶
Сброс к заводским настройкам также можно выполнить с помощью Miner tool. Используйте следующую команду, чтобы сделать это:
miner nand_install
Обнаружение устройств с светодиодами с Miner tool¶
Вы можете найти устройство, включив мигающий светодиод, используя Miner tool. Используйте следующую команду, чтобы сделать это:
#turn on LED blinking miner fault_light on #turn off LED blinking miner fault_light off