Skip to content

Дополнительные параметры установки

Иногда нельзя просто так взять и установить Hive из бандла на целевую машину. Может потребоваться:

  • изучить содержимое, чтобы убедиться, что компоненты не конфликтуют друг с другом;
  • задать дополнительные параметры ещё до первой установки;
  • получить дополнительную информацию о процессе инсталляции в случае каких-либо проблем при установке.

В этой главе описано, как разобраться с подобными проблемами.

Что представляет собой бандл

Бандл представляет собой shell-скрипт и архив в формате .tar.gz в одном файле. Он создан при помощи makeself, и его задача — просто распаковать во временную директорию содержимое архива и запустить скрипт инсталляции (embedded script в терминологии makeself).

Вы можете просмотреть текст скрипта makeself в любом текстовом редакторе, чтобы убедиться, что в нём нет ничего подозрительного.

Бандл содержит различные опции. Вы можете посмотреть все опции, выполнив команду:

sudo bash ./install_hw_bw_en-US_2026.9.5.run --help

Наиболее интересные с практической точки зрения опции:

  • --noexec — не запускать скрипт инсталляции после распаковки;
  • --target — распаковать содержимое в указанную директорию вместо временной;
  • -- — все последующие аргументы передать в скрипт инсталляции.

Извлечение файлов инсталляции

Иногда требуется извлечь файлы из бандла. Это может потребоваться для того, чтобы изучить его содержимое или для того, чтобы провести диагностику ошибки в случае, если инсталляция ломается по непонятной причине.

Пользуясь опциями из предыдущего параграфа, вы можете просто распаковать весь архив с Hive таким образом:

sudo bash ./install_hw_bw_en-US_2026.9.5.run --noexec --target 2026.9.5

После выполнения этой команды создается директория 2026.9.5, куда будет распаковано всё содержимое архива.

Инсталляция из распакованного бандла

Если вы распаковали бандл, как описано в предыдущем параграфе, то вы можете перейти в директорию, куда распаковали бандл, и запустить инсталлятор из неё. Выполните команду:

sudo ./installer

Если требуется диагностировать работу инсталлятора, выполните команду:

sudo bash -x ./installer

Содержимое архива бандла

Рассмотрим содержимое бандла.

Имя файла или директории Назначение Примечания
ascii-logo.txt Логотип, которое отображается в консоли при установке
bin/ Директория с bash-скриптами для распаковки в /opt/hw-bw/bin Копируются в /opt/hw-bw/bin
config/defaults.ini Глобальная конфигурация версии приложения Копируется в /opt/hw-bw/config/
config/user-template.ini Пример всех настроек приложения, доступных пользователю Копируется в /opt/hw-bw/config/
images_list.txt Список образов контейнеров, входящих в состав Hive
installer Скрипт инсталляции
installer.sh Дополнительные инсталляции, используемые скриптом
kb/ Шаблоны отчётов и ишью Копируется в /opt/hw-bw/kb
ssl/ Дефолтные директории для SSL-сертификатов и приватных ключей для HTTPS
systemd/ Директория с шаблонами модулей systemd Копируется в /opt/hw-bw/systemd
*.tgz Образы контейнеров Только для оффлайн-бандла

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

Опции скрипта инсталляции

Опции есть не только у makeself, но еще и у скрипта инсталляции. Чтобы увидеть их, выполните команду:

sudo bash ./install_hw_bw_en-US_2026.9.5.run -- --help

Наиболее интересные с практической точки зрения опции:

  • --nostart — не стартовать автоматически Hive после установки;

  • --noconfig — не выполнять автоматическую реконфигурацию Hive в процессе инсталляции (подразумевается 'nostart').

  • --restore-backup <backup_file> — восстановить данные из указанного файла резервной копии вместо выполнения обновления;

  • --check-backup <backup_file> — восстановить данные из указанного файла резервной копии и проверить целостность данных после восстановления;

  • --no-backup — не создавать резервную копию данных при обновлении.

  • --collect-logs — собрать системную информацию и логи. Поддерживает следующие флаги:

    • --output — обязательный параметр. Абсолютный путь до результирующего файла. Например, ${PWD}/system_logs_$(date +%Y%m%d_%H%M%S).tar.gz;
    • --since — используется для journalctl. Значение по умолчанию — '-1d'.

Экспериментальные опции (не рекомендуем для производственного окружения):

  • --foreign-docker-host — указать docker host для rootless-докера;

  • --foreign-docker-user — указать пользователя, под которым работает rootless docker.

Рассмотрим пример. Вы хотите произвести установку без запуска и без конфигурации Hive, чтобы задать свой собственный начальный пароль или произвести другие тонкие настройки.
Выполните команду:

sudo bash ./install_hw_bw_en-US_2026.9.5.run -- --nostart --noconfig

После этого можно открыть файл /opt/hw-bw/config/users.ini для редактирования. В секции [main] добавьте такую строку:

[main]
b.root.password = <new_password>

Чтобы изменения вступили в силу, выполните следующую команду:

sudo /opt/hw-bw/bin/reconfig

Hive автоматически запустится, и у пользователя root будет установлен указанный дефолтный пароль.

Подробнее про настройки, которые можно выполнить в файле /opt/hw-bw/config/users.ini, смотрите здесь.