Расширенное руководство

Разветвление

Существует множество инструментов, пакетов и скриптов, которые можно использовать для Braiins OS. Для лучшей навигации используйте следующее:

  • Установка Braiins OS+

  • Разблокировка SSH на Antminer S9

  • Обновление Braiins OS+

  • Переход на Braiins OS (версия без автонастройки)

  • Переход на Braiins OS+ (версия с автонастройкой)

  • Сброс к исходной версии Braiins OS (версия, которая была впервые установлена на устройстве) - возврат к заводским настройкам

  • Деинсталляция Braiins OS+

  • Включить/Выключить Nightly feeds

  • Включить/Выключить автоматическое обновление

  • Выполнить пользовательские команды shell на майнере

  • Сканируйте сеть для идентификации майнеров с помощью BOS Toolbox

  • Слушайте входящую трансляцию с устройств с помощью BOS Toolbox

BOS Toolbox

BOS Toolbox - это новый инструмент, который позволяет пользователю легко устанавливать, удалять, обновлять, обнаруживать и настраивать Braiins OS+, а также запускать пользовательские команды на устройстве. Это также позволяет делать это в пакетном режиме, что упрощает управление большим количеством устройств. BOS Toolbox также автоматически загружает последнюю версию прошивки. Это рекомендуемый способ управления вашими устройствами.

Применение

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox. Используйте только один IP-адрес в строке!

  • Следуйте разделам ниже

Особенности, плюсы и минусы этого метода:

  • дистанционная установка Braiins OS+ и автоматическая разблокировка SSH на Antminer S9 во время установки

  • дистанционное обновление Braiins OS+

  • дистанционное удаление Braiins OS+

  • дистанционная конфигурация Braiins OS+

  • запуск пользовательских команд на машинах

  • сканирование сети на наличие устройств

  • переносит всю конфигурацию по умолчанию (можно настроить) при установке Braiins OS+

  • переносит конфигурацию сети по умолчанию (можно настроить) при удалении Braiins OS+

  • параметры доступны для настройки процесса

  • настраивает ограничения мощности по умолчанию для автонастройки при установке Braiins OS+

  • пакетный режим доступен для управления несколькими устройствами одновременно

  • простота использования

  • не работает на майнерах x17 серии с заблокированным SSH

Установка Braiins OS с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox. Используйте только один IP-адрес в строке!

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Install заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы командной строки

Описание

Password

-p PASSWORD, --password PASSWORD

Пароль администратора

Farm-ID

--bos-mgmt-id [BOS_MGMT_ID]

Установить идентификатор Braiins OS+ Manager

Set Power limit

--psu-power-limit [PSU_POWER_LIMIT]

Установить ограничение мощности блока питания (в ваттах)

Set Pool user

--pool-user [POOL_USER]

Установить имя пользователя и имя воркера для Slush Pool

Latest Stable release

N/A - Default Option

Выбрано по умолчанию, рекомендуемый вариант

Open-Source version

--open-source

Используется для установки версии с открытым исходным кодом (кроме nightly и feed-url)

Nightly version

--nightly

Используется для установки Nightly версии (кроме open-source и feed-url)

Custom Feeds-URL

--feeds-url [FEEDS_URL]

Переопределить URL-адрес сервера каналов по умолчанию (кроме open-source и feed-url)

Firmware version

--fw-version [FW_VERSION]

Выбрать конкретную версию прошивки

No Auto-Upgrade

--no-auto-upgrade

Отключить авто-обновление (не рекомендуется)

Don't migrate pool settings

--no-keep-pools

Не сохранять конфигурацию пула

Migrate network settings

N/A - Default Option

Сохранить конфигурацию сети майнера, выбранную по умолчанию (рекомендуется)

Don't migrate network settings

--no-keep-network

Не сохранять конфигурацию сети майнера (использовать DHCP)

Don't keep hostname

--no-keep-hostname

Не сохранять имя хоста майнера и генерировать новое на основе MAC

Keep hostname

--keep-hostname

Сохранить имя хоста майнера

Post-upgrade

--post-upgrade [POST_UPGRADE]

Путь к каталогу со скриптом stage3.sh

N/A - Не реализованы

-h, --help

показать это справочное сообщение и выйти

N/A - Не реализованы

--backup

Бэкап майнера перед установкой (NAND и настройка)

N/A - Не реализованы

--no-nand-backup

Пропустить полное резервное копирование NAND (конфигурация все еще копируется)

N/A - Не реализованы

--no-wait

Не ждать, пока система полностью обновится и перезагрузится

N/A - Не реализованы

--dry-run

Выполните все шаги обновления без фактического обновления

Пример команды:

bos-toolbox.bat install --password root listOfMiners.csv

Эта команда установит Braiins OS+ на майнеры, указанные в файле listOfMiners.csv, и установит ограничение мощности 1200 для всех из них. Команда также автоматически разблокирует Antminer S9 и вставит пароль SSH admin, когда майнер запросит его.

Обновление Braiins OS+ с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox.

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Update заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы

Описание

Package

PACKAGE_NAME

Название пакета для обновления (выберите 'firmware' ('прошивка') для обновления прошивки)

Password

-p PASSWORD, --password PASSWORD

Пароль администратора

Farm-ID

--bos-mgmt-id [BOS_MGMT_ID]

Установить идентификатор Braiins OS+ Manager

Ignore non-responsive miners

-i, --ignore

Не останавливаться на ошибках

N/A - Не реализованы

--h, --help

показать это справочное сообщение и выйти

Пример команды:

bos-toolbox.bat update listOfMiners.csv firmware

Эта команда будет искать обновление для майнеров, указанных в listOfMiners.csv, и обновлять их, если появится новая версия прошивки.

Деинсталляция Braiins OS с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Uninstall заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

Важная заметка: При установке Braiins OS+ на одно устройство, используйте аргумент HOSTNAME (IP-адрес). При установке Braiins OS+ на несколько устройств, НЕ используйте аргумент HOSTNAME, вместо этого, используйте аргумент --batch BATCH.

GUI Опции

Аргументы

Описание

Password

-p PASSWORD, --password PASSWORD

Пароль администратора

Default stock firmware

N/A - Default Option

Настройки по умолчанию

Custom Feeds-URL

--feeds-url [FEEDS_URL]

Переопределить URL-адрес сервера каналов по умолчанию

N/A - Не реализованы

--nand-restore

Использовать полное восстановление NAND из предыдущей резервной копии

N/A - Не реализованы

BACKUP_PATH

Путь к директории или tgz-файлу с данными для восстановления майнера

N/A - Не реализованы

--h, --help

Показать это справочное сообщение и выйти

Пример команды:

bos-toolbox.bat uninstall listOfMiners.csv

Эта команда удалит Braiins OS+ из майнеров, указанных в файле listOfMiners.csv, и установит стандартную прошивку по умолчанию.

Предупреждение: стандартная прошивка, которая устанавливается при удалении Braiins OS+, не подходит для майнинга! Перед началом майнинга обновите стандартную прошивку до более новой версии для вашей конкретной модели оборудования.

Важная заметка: BACKUP_PATH не является обязательным. Используйте только вместе с аргументом --nand-restore. Восстановление прошивки из резервной копии не рекомендуется.

Настройка Braiins OS с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Config заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вам необходимо использовать одно из следующих действий чтобы отрегулировать процесс:

Аргументы

Описание

load

загрузить текущую конфигурацию майнеров (указанную в файле CSV) и вставить их в файл CSV

save

сохранить настройки из файла CSV для майнеров (без применения)

apply

применить настройки, которые были скопированы из файла CSV к майнерам

save_apply

сохранить и применить настройки из файла CSV к майнерам

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы

Описание

Username

-u USER, --user USER

Имя пользователя администратора

Password

-p PASSWORD, --password PASSWORD

Пароль администратора

Change Password

--change-password

Разрешить смену пароля (на тот, который указан в listOfMiners.csv)

Ignore

-i, --ignore

нет остановки на ошибках

N/A - Не реализованы

-h, --help

показать это справочное сообщение и выйти

N/A - Не реализованы

-c, --check

сухой прогон без записи

Пример команды:

bos-toolbox.bat config --user root load listOfMiners.csv

#отредактируйте файл CSV с помощью редактора электронных таблиц (например: Office Excel, LibreOffice Calc, etc.)

bos-toolbox.bat config --user root -p admin -P 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, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Scan заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы

Описание

Password

-p PASSWORD, --password PASSWORD

Пароль администратора

Save output

-o OUTPUT, --output OUTPUT

Сохранить список найденных IP-адресов в файл

Verbose

-v, --verbose

Сообщать об ошибках в сети

N/A - Не реализованы

-h, --help

Показать это справочное сообщение и выйти

N/A - Не реализованы

-j JOBS, --jobs JOBS

Количество одновременных заданий для сканирования сети

Пример команды:

#scan the network, in the range 10.10.10.0 - 10.10.10.255
bos-toolbox.bat scan 10.10.10.0/24

#scan the network, in the range 10.10.0.0 - 10.10.255.255
bos-toolbox.bat scan 10.10.0.0/16

#scan the network, in the range 10.0.0.0 - 10.255.255.255
bos-toolbox.bat scan 10.0.0.0/8

Прослушивать входящую трансляцию с устройств с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Listen заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы

Описание

Save output

-o OUTPUT, --output OUTPUT

Сохранить список найденных IP-адресов в файл

Format

--format FORMAT

изменить строку форматирования по умолчанию для информации об устройстве; теги '{IP}' и '{MAC}' будут заменены фактическими данными

N/A - Не реализованы

-h, --help

Показать это справочное сообщение и выйти

Запуск пользовательских команд на майнерах с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл в своем текстовом редакторе и вставьте IP-адреса, на которых вы хотите выполнить команды. Каждый IP-адрес должен быть разделен запятой. (Обратите внимание, что вы можете найти IP-адрес в веб-интерфейсе Braiins OS, перейдя в Status -> Overview.) Затем сохраните файл в том же каталоге, в котором вы сохранили BOS Toolbox, и измените ".txt" окончание на ".csv".

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Command заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы

Описание

Show remote output

-o, --output

Захват и печать удаленного вывода

Show hostname output

-O, --output-hostname

Захват и печать удаленного вывода

Password

-p PASSWORD, --password PASSWORD

Пароль администратора

N/A - Не реализованы

-h, --help

показать это справочное сообщение и выйти

N/A - Не реализованы

-j JOBS, --jobs JOBS

Количество одновременных job

N/A - Не реализованы

-a, --auto

Использовать ssh, если rpc недоступен

N/A - Не реализованы

-l, --legacy

Использовать ssh

N/A - Не реализованы

-L, --no-legacy

Использовать rpc

Пример команды:

#остановить BOSminer, эффективно останавливая майнинг и уменьшая потребляемую мощность до минимума
bos-toolbox.bat command -o list.csv stop

Разблокировка SSH на Antminer S9 с помощью BOS Toolbox

  • Скачайте BOS Toolbox с нашего веб-сайта.

  • Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS Toolbox. Используйте только один IP-адрес в строке!

  • После того, как вы загрузили BOS Toolbox, запустите его в режиме GUI, дважды щелкнув (Windows) или запустив ./bos-toolbox в интерпретаторе командной строки (Linux).

  • В разделе Unlock заполните опцию Miner(s), выбрав созданный текстовый файл и нажав Start.

Вы можете использовать следующие аргументы, чтобы настроить процесс:

GUI Опции

Аргументы

Описание

Username

-u USERNAME, --username USERNAME

имя пользователя для веб-интерфейса

Password

-p PASSWORD, --password PASSWORD

пароль для веб-интерфейса

N/A - Не реализованы

--h, --help

показать это справочное сообщение и выйти

N/A - Не реализованы

--port PORT

порт для веб-интерфейса antminer

N/A - Не реализованы

--ssl

использовать ли SSL

Пример команды:

bos-toolbox.bat unlock -p root listOfMiners.csv

Эта команда разблокирует SSH на майнерах, указанных в listOfMiners.csv.

Веб-пакет

Веб-пакет можно использовать для переключения со стоковой прошивки, выпущенной до 2019 года. Он также должен работать на других прошивках, основанных на стоковой версии. Этот пакет нельзя использовать на стоковой прошивке, выпущенной в 2019 году и позже, из-за проверки подписи, которая была реализована. Проверка подписи предотвращает использование иных, чем оригинальные стоковые прошивки.

Применение

  • Скачайте Веб-пакет с нашего веб-сайта.

  • Следуйте разделам ниже

Особенности, плюсы и минусы этого метода:

  • заменяет стоковую прошивку на Braiins OS+ без использования дополнительных инструментов

  • переносит конфигурацию сети

  • переносит пул URL, имена пользователей и пароли

  • настраивает ограничения мощности по умолчанию для автонастройки

  • не может использоваться на стоковой прошивке, выпущенной в 2019 году и позже

  • невозможно настроить установку (например, он всегда будет переносить настройки сети)

  • нет пакетного режима (для массовой установки), если вы не создаете свои собственные скрипты

Установите Braiins OS+ с помощью веб-пакета

  • Скачайте Веб-пакет с нашего веб-сайта.

  • Войдите на свой майнер и перейдите в раздел System -> Upgrade.

  • Загрузите загруженный пакет и прошейте образ.

Образ SD карты

Если вы используете стандартную прошивку, выпущенную в 2019 году и позже, единственный способ установить Braiins OS+ - это вставить SD-карту с прошивкой Braiins OS+. В 2019 году SSH-соединение было заблокировано, и проверка подписи в веб-интерфейсе предотвращает использование других программных прошивок.

Применение

  • Скачайте Образ SD карты с нашего веб-сайта.

  • Следуйте разделам ниже

Особенности, плюсы и минусы этого метода:

  • заменяет SSH заблокированную стоковую прошивку на Braiins OS+

  • использует конфигурацию сети, хранящуюся в NAND (это можно отключить, см. раздел Настройки сети ниже)

  • настраивает ограничения мощности по умолчанию для автонастройки

  • не переносит пул URL, имена пользователей и пароли

  • нет пакетного режима (для массовой установки)

Установка Braiins OS+ с помощью SD карты

  • Скачайте Образ SD карты с нашего веб-сайта.

  • Перенесите загруженный образ на SD-карту (например, используя Etcher). Примечание. Простое копирование на SD-карту не будет работать. SD-карта должна быть перепрошита!

  • (Только Antminer S9) Настройте перемычки для загрузки с SD-карты (вместо памяти NAND), как показано ниже.

S9 Jumpers S9 Jumpers Board

  • Вставьте SD-карту в устройство, затем запустите устройство.

  • Через некоторое время вы сможете получить доступ к интерфейсу Braiins OS+ через IP-адрес устройства.

  • Если использовалась автоматически устанавливаемая версия образа SD, система будет автоматически установлена во внутреннюю память (NAND). Установка завершена, когда оба светодиода начнут мигать одновременно. После завершения установки извлеките SD-карту, чтобы загрузить Braiins OS+ из NAND.

Настройки сети

По умолчанию используется конфигурация сети, хранящаяся в NAND, при запуске Braiins OS+ с SD-карты. Эта функция может быть отключена, следуя инструкциям ниже:

  • Смонтируйте первый раздел FAT на SD-карте

  • Откройте файл uEnv.txt и вставьте следующий стринг (убедитесь, что в на каждой строке только один стринг)

cfg_override=no

Отключение использования старых сетевых настроек полезно для пользователей, у которых есть проблемы с тем, что майнер не виден в сети (например, статический IP-адрес, используемый в NAND, находится вне зоны действия сети). При этом используется DHCP.

NAND установка

SD-карту можно использовать для замены встроенного программного обеспечения NAND на Braiins OS+. Это можно сделать либо:
  • Добавьте nand_install=yes в uEnv.txt файл для автоматической установки NAND.

  • используя веб-интерфейс - раздел 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.

Применение

  • Скачайте Пакет удаленной установки (SSH) с нашего веб-сайта.

  • Следуйте разделам ниже

Особенности, плюсы и минусы этого метода:

  • дистанционная установка Braiins OS+

  • дистанционное удаление 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

#Скачайте и распакуйте пакет прошивки
#Antminer S9
wget -c https://feeds.braiins-os.com/20.10/braiins-os_am1-s9_ssh_2020-10-25-0-908ca41d-20.10-plus.tar.gz -O - | tar -xz

#Antminer S17
wget -c https://feeds.braiins-os.com/20.11/braiins-os_am2-s17_ssh_2020-11-27-0-5eb922d4-20.11-plus.tar.gz -O - | tar -xz

#Измените каталог на распакованную папку с прошивкой
#Antminer S9
cd ./braiins-os_am1-s9_ssh_VERSION

#Antminer S17
cd ./braiins-os_am2-s17_ssh_VERSION

#Создайте виртуальную среду и активируйте ее
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 или другую ОС, пожалуйста, ознакомьтесь с соответствующей документацией и отредактируйте команды при необходимости.)

#Измените каталог на распакованную папку с прошивкой (если ее еще нет в папке с прошивкой)
#Antminer S9
cd ./braiins-os_am1-s9_ssh_VERSION

#Antminer S17
cd ./braiins-os_am2-s17_ssh_VERSION

#Активируйте виртуальную среду (если она еще не активирована)
source .env/bin/activate

#Запустите скрипт для установки Braiins OS+
python3 upgrade2bos.py IP_ADDRESS

Примечание: для получения дополнительной информации об аргументах, которые можно использовать, используйте --help аргумент.

Деинсталляция Braiins OS+ с помошью SSH-пакета

Использование заводского образа прошивки

Во-первых, вам нужно подготовить среду Python, которая описана в разделе Подготовка среды.

На Antminer S9, вы можете прошить заводской образ прошивки с сайта производителя, с тем, что``FACTORY_IMAGE`` это bпуть к файлу или URL к tar.gz (не извлеченному!) файлу. Поддерживаемые изображения с соответствующими хэшами MD5 перечислены в platform.py файле.

Запустите (заменив заполнители FACTORY_IMAGE и IP_ADDRESS соответственно):

#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 FACTORY_IMAGE IP_ADDRESS

#Antminer S17
cd ~/braiins-os_am2-s17_ssh_2020-11-27-0-5eb922d4-20.11-plus && source .env/bin/activate
python3 restore2factory.py --factory-image FACTORY_IMAGE IP_ADDRESS

Примечание: для получения дополнительной информации об аргументах, которые можно использовать, используйте --help аргумент.

Использование ранее созданной резервной копии

Во-первых, вам нужно подготовить среду Python, которая описана в разделе Подготовка среды.

Если вы создали резервную копию оригинальной прошивки во время установки Braiins OS+, вы можете восстановить ее с помощью следующих команд (замените заполнители BACKUP_ID_DATE и IP_ADDRESS соответственно):

#Antminer S9
cd ~/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py backup/BACKUP_ID_DATE/ IP_ADDRESS

#Antminer S17
cd ~/braiins-os_am2-s17_ssh_2020-11-27-0-5eb922d4-20.11-plus && 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"

Это перенесет конфигурацию и продолжит работу без необходимости что-либо настраивать. Предел мощности по умолчанию будет установлен на 1420W.

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 соответственно):

#Antminer S9
ssh root@IP_ADDRESS '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@IP_ADDRESS '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'

Эта команда содержит следующие команды:

  • ssh - подключиться к майнеру

  • wget - используется для загрузки файлов, в данном случае пакета прошивки

  • sysupgrade - фактически прошить скачанный пакет прошивки

Переход на Braiins OS+ из других версий с помощью Sysupgrade

Чтобы обновить более старую версию Braiins OS, используйте следующую команду (замените заполнитель IP_ADDRESS соответственно):

#Antminer S9
ssh root@IP_ADDRESS '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@IP_ADDRESS 'wget -O /tmp/firmware.tar https://feeds.braiins-os.com/am2-s17/firmware_2020-11-27-0-5eb922d4-20.11-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 factory_reset

Обнаружение устройств с светодиодами с Miner tool

Вы можете найти устройство, включив мигающий светодиод, используя Miner tool. Используйте следующую команду, чтобы сделать это:

#turn on LED blinking
miner fault_light on

#turn off LED blinking
miner fault_light off

Turn on/off Nightly feeds using the Miner tool

You can turn on Nightly feeds to get updated to the latest nightly builds. These builds aim to fix crucial issues as fast as possible and, because of that, they are not tested as thoroughly as major releases before being published. Use these builds with caution and only if it solves your issues. In order to turn on/off the nightly feeds, use the following command:

#turn on nightly feeds
miner nightly_feeds on

#turn off nightly feeds
miner nightly_feeds off

Включить/Выключить автоматическое обновление с использованием Miner tool

Вы можете включить функцию автоматического обновления, которая автоматически обновит систему до последней версии. Эта функция включена по умолчанию после перехода с стоковой прошивки и выключена по умолчанию после обновления с более старых версий Braiins OS или Braiins OS+. Чтобы вручную включить/отключить автоматическое обновление, используйте следующую команду:

#включить автоматическое обновление
miner auto_upgrade on

#отключить автоматическое обновление
miner auto_upgrade off