Запуск JAR-файла Glarus BI¶
Примечание
Если вам нужно самостоятельно разместить Glarus BI, вы можете запустить его как отдельный JAR-файл, но мы рекомендуем запускать Glarus BI в контейнере Docker.
Для запуска версии Glarus BI с открытым исходным кодом через JAR-файл в вашей системе должна быть установлена среда выполнения Java (JRE).
Быстрый запуск¶
Примечание
Быстрый запуск предназначен для локального запуска Glarus BI. Инструкции по запуску Glarus BI в промышленной эксплуатации см. ниже.
Если у вас установлена Java:
- Получите JAR-файл и другие детали Glarus BI в техподдержке. Адрес ниже — синтетический, для примера.
- Перейдите в терминал или командную строку и введите команду запуска в рабочем каталоге Glarus BI:
Ожидайте, пока процесс запуска не завершится. Когда 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¶
Используйте диспетчер пакетов вашей системы, например:
Чтобы установить Java в MacOS¶
Мы рекомендуем установить Homebrew, а затем запустить:
Запуск для промышленной эксплуатации¶
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.