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

Примечание

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

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

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

Примечание

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

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

Получите JAR-файл и другие детали Glarus BI в техподдержке. Адрес ниже — синтетический, для примера.

curl -L https://storage.glarus-bi.ru/downloads/glarus-bi.jar > glarus-bi.jar

Перейдите в терминал или командную строку и введите команду запуска в рабочем каталоге Glarus BI:

java --add-opens java.base/java.nio=ALL-UNNAMED -jar glarus-bi.jar

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

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

Рекомендуется Java 21 или новее, но совместимы все версии JRE, начиная с Java 11.

Чтобы установить 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/glarus-bi.jar https://storage.glarusbi.ru/downloads/glarus-bi.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/glarus-bi.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.