Установка сервера приложений из apt-репозитория

В случае наличия доступа в интернет, для ОС семейства Debian возможна установка сервера приложений Колибри из apt-репозитория.

Для того, чтобы установить и запустить сервер Колибри из apt-репозитория требуется выполнить следующие шаги:

  1. Получить доступ к apt-репозиторию.
Замечание

Репозиторий закрытый. Доступ можем предоставить по вашему запросу.

  1. Добавить адрес репозитория в список репозиториев пакетного менеджера apt и добавить ключ репозитория в список доверенных.
  2. Обновить список пакетов apt.
  3. Установить сервер приложений Колибри из apt.
  4. Запустить службу Колибри
    4.1. Установить файл лицензии
    4.2. Распаковать настройки моделей (настройки конкретного приложения, построенного на базе системы Колибри) в любую папку на сервере
    4.3. Внести изменения в colibriSettings.json

Шаги 2-4 можно выполнить последовательным запуском следующих команд:

RUN apt update && apt install wget gnupg2 -y
RUN wget https://apt.octonica.com/repo/pubkey.gpg -O pubkey.gpg
RUN apt-key add pubkey.gpg
RUN rm pubkey.gpg
echo "deb https://apt.octonica.com/repo focal main" | sudo tee /etc/apt/sources.list.d/octonica.list > /dev/null
sudo apt update
sudo apt install colibri -y

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

Запуск службы Колибри

Запуск службы Колибри производится при помощи команды systemctl start colibri, которая должна отобразить информацию о службе и её статус, см. рисунок ниже.
service status

Совет

Для добавления службы Колибри в автозапуск выполни команду:

sudo systemctl enable colibri

Добавление службы в автозапуск выполняется один раз, повторение операции не требуется после обновления службы.

Установка файла лицензии

Для работы с Колибри требуется файл действующей лицензии *.colibrikey.
Файл лицензии *.colibrikey должен находиться в том же каталоге, что и папка с настройками модели, то есть в /var/opt/colibri.

Сохранение настроек моделей

Конкретные приложения (модели), построенным на базе системы Колибри, обладают своими уникальными настройками. Для работы с такими приложениями у разработчиков необходимо получить папку с данными настройками.
Настройки моделей должны находиться в /var/opt/colibri/app.

Настройки сервера приложений

Все настройки сервера приложений вне зависимости от вида инсталляции находятся в файле конфигурации colibriSettings.json и описаны в соответствующем разделе.

После настройки сервера приложений необходимо убедиться, что пользователь, от имени которого запущена служба Колибри, является владельцем файлов настроек моделей, расположенных в /var/opt/colibri/app.
Проверку можно выполнить, вызвав в терминале следующую команду:

$ ls -la /var/opt/colibri/app/

В результате вызова должна отобразиться информация о владельцах папок и файлов:

Если файлы настроек имеют другого владельца, необходимо его сменить при помощи команды:

$ sudo chown -R colibri /var/opt/colibri/app/

Просмотр журнала

В случае ошибок запуска службы или необходимости просмотреть системный журнал следует воспользоваться утилитой journalctl.
Для отображения журнала службы Колибри, необходимо выполнить следующую команду, отображающую 30 последних записей службы Колибри:

sudo journalctl -u colibri -n 30

Пример результатов выполнения приведен на рисунке ниже.
service status

Установка дополнительных шрифтов

В ряде приложений, построенных на базе системы Колибри, могут использоваться шрифты TrueType.
Для их корректного отображения необходимо добавить шрифты Microsoft TrueType Core (Arial, Times New Roman, Courier New и др), выполнив команду:

sudo apt-get install ttf-mscorefonts-installer
Совет

Для отображения списка установленных в системе шрифтов выполните команду fc-list.

Обновление

Обновление службы выполняется штатными средствами: для обновления требуется выполнить обновление списка пакетов apt и установленного пакета colibri:

sudo apt update
sudo apt upgrade colibri

Все настройки Колибри сохранятся.