BSS. Руководство администратора: различия между версиями

Версия от 15:45, 18 февраля 2025

BSS. Руководство администратора

Общее описание

Сервис Backup Service System (BSS) предназначен

Термины и определения

Сервис Backup Service System (BSS) – сервис резервного копирования.

Системные требования

Для нормальной работы сервиса необходимо обеспечить не менее 2 потоков CPU >= 2.20GHz. Оперативной памяти необходимо не менее 2Gb.

Установка/обновление сервиса

Дистрибутив распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо установить сервисный пакет окружения.

Установка/обновление BSS осуществляется скриптом chmod +x ./bss-<версия>-<релиз>.sh && ./bss-<версия>-<релиз>.sh -i с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор ./bss-<версия>-<релиз>.sh без ключей.
Загрузить последнюю версию продукта curl -s "https://repo.connect2ai.net/api/bss/new" --user '[user]:[pass]' 2>&1 | bash или в интерактивном режиме bash -c "$(curl -s https://repo.connect2ai.net/api/bss --user '[user]:[pass]' 2>&1)".
Обновить BSS /opt/bss/inupdate в интерактивном режиме. Или запустить с ключом:
- /opt/bss/inupdate -b - обновить до последней beta версии;
- /opt/bss/inupdate -r - обновить до последней release версии;
- /opt/bss/inupdate -n - обновить до последней версии (не важно beta или release).
Проверить актуальную версию продукта curl -s "https://repo.connect2ai.net/api/bss/version.
Посмотреть лог изменений curl -s "https://repo.connect2ai.net/api/bss/changelog" --user '[user]:[pass]'.
Полное описание всех команд API репозитория можно найти по ссылке https://repo.connect2ai.net/api. [user]:[pass] - это тот же логин и пароль, что и от Nextcloud.
В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
- echo -n "[user]:[pass]" > /opt/bss/.userapi (это файл авторизации в API, нужен для обновления)
- echo -n "http://example.com:3128 [user] [password]" > /opt/bss/.proxy (это файл конфигурации proxy необходим для обновления, при отсутствующем прямом подключение к интернету)

При обновление следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

sudo systemctl enable bss.service && sudo systemctl start bss.service

Удостоверьтесь, что сервис стартовал:

systemctl status bss.service

Разрешите доступ к порту 6184 на нужном интерфейсе по протоколу tcp.

Конфигурирование параметров сервиса

Настройка параметров сервиса bss производится в файле /opt/bss/config.json

Описание параметров приведено в таблице


Параметр	По умолчанию	Назначение
logs.path	logs/	Дерриктория для хранения логов. Примеры абсолютного пути: "/var/log/bss/"
logs.backups	10	Количество файлов ротации
logs.maxSize	5242880	Максимальный размер файла в байтах, триггер для ротации
stricts	[ "не" ]	"Строгие частицы" - частицы речи меняющие смысл фразы. После применения настройки, если сущность содержит такую частицу, то фраза без этой частицы не вызовет положительного срабатывания.

Сбор данных об ошибках

Логи сервиса по умолчанию находятся в файле /opt/ups/logs/log.txt

Удаление

Для удаления выполните команду: /opt/bss/uninstall. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

@@ Строка 1: / Строка 1: @@
 BSS. Руководство администратора
+===== '''Общее описание''' =====
+Сервис Backup Service System (BSS) предназначен
+===== '''Термины и определения''' =====
+Сервис Backup Service System (BSS) – сервис резервного копирования.
+===== '''Системные требования''' =====
+Для нормальной работы сервиса необходимо обеспечить не менее 2 потоков CPU  >= 2.20GHz.
+Оперативной памяти необходимо не менее 2Gb.
+===== '''Установка/обновление сервиса''' =====
+[https://cloud.connect2ai.net/index.php/apps/files/?dir=/bss&fileid=581 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.
+Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].
+* Установка/обновление BSS осуществляется скриптом <code>chmod +x ./bss-<версия>-<релиз>.sh && ./bss-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./bss-<версия>-<релиз>.sh</code> без ключей.
+* Загрузить последнюю версию продукта  <code>curl -s "<nowiki>https://repo.connect2ai.net/api/bss/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/bss</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
+* Обновить BSS <code>/opt/bss/inupdate</code> в интерактивном режиме. Или запустить с ключом:
+** <code>/opt/bss/inupdate -b</code> - обновить до последней beta версии;
+** <code>/opt/bss/inupdate -r</code> - обновить до последней release версии;
+** <code>/opt/bss/inupdate -n</code> - обновить до последней версии (не важно beta или release).
+* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/bss/version</nowiki></code>.
+* Посмотреть лог изменений  <code>curl -s "<nowiki>https://repo.connect2ai.net/api/bss/changelog</nowiki>" --user '[user]:[pass]'</code>.
+* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> - это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
+* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
+** echo -n <code>"[user]:[pass]"</code>  > /opt/bss/.userapi (это файл авторизации в API, нужен для обновления)
+** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code>  > /opt/bss/.proxy (это файл конфигурации proxy необходим для обновления, при отсутствующем прямом подключение к интернету)
+При обновление следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.
+Не забудьте запустить сервис и включить в автозапуск в системе:
+<code>sudo systemctl enable bss.service && sudo systemctl start bss.service</code>
+Удостоверьтесь, что сервис стартовал:
+<code>systemctl status bss.service</code>
+Разрешите доступ к порту 6184 на нужном интерфейсе по протоколу tcp.
+===== '''Конфигурирование параметров сервиса''' =====
+Настройка параметров сервиса bss производится в файле /opt/bss/config.json
+Описание параметров приведено в таблице
+{| class="wikitable"
+|+
+!Параметр
+!По умолчанию
+!Назначение
+|-
+|logs.path
+|logs/
+|Дерриктория для хранения логов. Примеры абсолютного пути: "/var/log/bss/"
+|-
+|logs.backups
+|10
+|Количество файлов ротации
+|-
+|logs.maxSize
+|5242880
+|Максимальный размер файла в байтах, триггер для ротации
+|-
+|stricts
+|[  "не"  ]
+|"Строгие частицы" - частицы речи меняющие смысл фразы. После применения настройки, если сущность содержит такую частицу, то фраза без этой частицы не вызовет положительного срабатывания.
+|}
+===== '''Сбор данных об ошибках''' =====
+Логи сервиса по умолчанию находятся в файле /opt/ups/logs/log.txt
+===== '''Удаление''' =====
+Для удаления выполните команду: <code>/opt/bss/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.