Перейти к содержанию

Запуск JAR-файла Glarus BI

Примечание

Если вам нужно самостоятельно разместить Glarus BI, вы можете запустить его как отдельный JAR-файл, но мы рекомендуем запускать Glarus BI в контейнере Docker.

Для запуска версии Glarus BI с открытым исходным кодом через JAR-файл в вашей системе должна быть установлена среда выполнения Java (JRE).

Технологический стек серверной части

Серверная часть Glarus BI 0.57 написана на Clojure и работает на JVM. Для запуска используется Java 21; официальный Docker-образ содержит Eclipse Temurin 21 JRE. Встроенный HTTP-сервер входит в JAR-файл, отдельная установка сервера приложений не требуется.

КомпонентВерсияНазначение
Clojure1.12.2Основной язык серверной части на JVM.
Java21; Eclipse Temurin 21 JRE в Docker-образеСреда выполнения приложения.
Ring, ring-jetty-adapter1.14.2Обработка HTTP-запросов и интеграция с веб-сервером.
Eclipse Jetty12.0.24Встроенный веб-сервер.
Compojure1.7.1Маршрутизация HTTP-запросов.
Toucan21.0.568Работа с моделями и таблицами базы данных приложения.
HoneySQL2.7.1340Построение SQL из структур данных Clojure.
c3p00.11.2Пул JDBC-соединений базы данных приложения.
Liquibase4.33.0Миграции схемы базы данных приложения.
Quartz через QuartziteQuartzite 2.2.0Планирование фоновых заданий. Используется JDBC JobStore; кластерный режим включён в конфигурации планировщика.
Malli0.20.0Описание и проверка структур данных.
Log4j22.25.1Журналирование событий приложения.
Cheshire6.0.0Чтение и формирование JSON.
Buddy Core1.12.0-430Криптографические операции.
Buddy Sign3.6.1-359Библиотека подписи сообщений.

Кластерный режим планировщика требует общей базы данных приложения и согласованной конфигурации узлов; наличие JDBC JobStore само по себе не создаёт кластер. Подключение базы данных описано на странице «Настройка базы данных приложения Glarus BI», параметры веб-сервера — в разделе «Версия сервера приложений».

Быстрый запуск

Примечание

Быстрый запуск предназначен для локального запуска Glarus BI. Инструкции по запуску Glarus BI в промышленной эксплуатации см. ниже.

Если у вас установлена Java:

  1. Получите JAR-файл и другие детали Glarus BI в техподдержке. Адрес ниже — синтетический, для примера.
curl -L https://storage.glarus-bi.ru/downloads/metabase.jar > metabase.jar
  1. Перейдите в терминал или командную строку и введите команду запуска в рабочем каталоге Glarus BI:
java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar

Ожидайте, пока процесс запуска не завершится. Когда Glarus BI полностью запустится, вы увидите некоторый текст со ссылкой, на которую вы можете нажать, и доступ к Glarus BI будет по http://localhost:3000 (если не настроено иное).

Поддерживаемые версии Java

Мы рекомендуем Java 21 (JRE) с HotSpot JVM. Более ранние версии Java не поддерживаются.

Чтобы установить Java под Docker

Мы рекомендуем запускать Glarus BI в контейнере Docker. Java входит в состав официального образа Docker Glarus BI, поэтому вам не нужно устанавливать Java отдельно.

Чтобы установить Java для Windows

Загрузите OpenJDK и запустите установщик.

Чтобы установить Java в Linux

Используйте диспетчер пакетов вашей системы, например:

sudo apt-get update
sudo apt install openjdk-21-jre

Чтобы установить Java в MacOS

Мы рекомендуем установить Homebrew, а затем запустить:

brew update
brew install java

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

Glarus BI поставляется со встроенной базой данных H2, которая использует файловую систему для хранения своих собственных данных приложения (не путать с вашими собственными базами данных, к которым он подключается). По умолчанию база данных H2 хранится в каталоге метаданных Glarus BI (~/.glarusbi/).

Это нормально для локального запуска Glarus BI, но если вы хотите запустить Glarus BI в промышленной эксплуатации, вам необходимо использовать базу данных уровня промышленной эксплуатации.

СУБД должна поставляться со службой, которая автоматически перезапускает приложение в случае его сбоя или остановки, и процессом, который следит за защитой и поддержанием работоспособности базы данных приложения.

Миграция с H2 на СУБД уровня промышленной эксплуатации

После того как вы запустили Glarus BI и создали базу данных, готовую к промышленной эксплуатации для хранения ваших данных приложения, вы можете переключиться на эту базу данных, следуя руководству по миграции с H2 на базу данных уровня промышленной эксплуатации.

Рассмотрите возможность запуска как службы

Запуск Glarus BI как службы поможет вам:

  • автоматически запускать Glarus BI при перезагрузке системы;
  • держать Glarus BI в непрерывном режиме работы (например, при завершении сеанса SSH);
  • контролировать его через инструменты systemd.

Пример: Запуск Glarus BI как службы systemd

От установки Java к настройкам systemd и запуску службы systemd:

# Установка Java
sudo apt update
sudo apt install default-jre

# Создание непривилегированного пользователя для запуска Glarus BI
sudo useradd -r glarusbi

# Создание каталога для БД приложения
sudo mkdir /var/lib/glarusbi
sudo chown glarusbi:glarusbi /var/lib/glarusbi

# Создание каталога для плагинов с корректными разрешениями
sudo mkdir -p /var/lib/glarusbi/plugins
sudo chown -R glarusbi:glarusbi /var/lib/glarusbi/plugins

# Создание каталога для журналов с корректными разрешениями
sudo mkdir -p /var/log/glarusbi
sudo chown glarusbi:glarusbi /var/log/glarusbi

# Загрузка Glarus BI
curl -L -o /opt/metabase.jar https://storage.glarusbi.ru/downloads/metabase.jar

# Создание файла службы для systemd
cat <<EOF | sudo tee /etc/systemd/system/glarusbi.service
[Unit]
Description=Glarus BI server
After=network.target
After=postgresql.service

[Service]
Type=simple
User=glarusbi
Group=glarusbi
ExecStart=/usr/bin/java --add-opens java.base/java.nio=ALL-UNNAMED -Dlog4j.configurationFile=file:/var/lib/glarusbi/log4j2.xml -jar /opt/metabase.jar
Environment=MB_DB_TYPE=postgres
Environment=MB_DB_DBNAME=glarusbi
Environment=MB_DB_PORT=5432
Environment=MB_DB_USER=metabase
Environment=MB_DB_PASS=yourpassword
Environment=MB_DB_HOST=localhost
Environment=MB_PLUGINS_DIR=/var/lib/glarusbi/plugins
Restart=on-failure
RestartSec=30

[Install]
WantedBy=multi-user.target
EOF

# Перезагрузка настроек systemd и включение службы для автозапуска и управления
sudo systemctl daemon-reload
sudo systemctl enable glarusbi

# Запуск службы
sudo systemctl start glarusbi

# Просмотр результата запуска службы
sudo systemctl status glarusbi

# Просмотр журналов
sudo journalctl -u glarusbi

Замените данные подключения к базе данных, пути к файлам и другие параметры в соответствии с вашим окружением. Приведённый выше пример предполагает, что вы используете PostgreSQL, работающую локально.

Обновление Glarus BI

При обновлении Glarus BI мы рекомендуем вам загрузить новую версию JAR-файла и перезапустить процесс.

Смотрите Обновление Glarus BI для получения подробной информации.

Устранение неполадок

Продолжение установки Glarus BI

Теперь, когда вы установили Glarus BI, пришло время настроить Glarus BI.