Запуск JAR-файла Glarus BI¶
Чтобы запустить Glarus BI через JAR-файл, в вашей системе должна быть установлена среда выполнения Java (JRE).
Быстрый запуск¶
Примечание
Быстрый запуск предназначен для локального запуска Glarus BI. Инструкции по запуску Glarus BI для промышленной эксплуатации см. ниже.
Если у вас установлена Java:
-
Загрузите JAR-файл для Glarus BI glarusBI.jar.
-
Создайте новый каталог и переместите в него файл glarusBI.jar.
-
Перейдите в новый каталог Glarus BI и запустите JAR.
В окне терминала, в котором вы выполнили команду, можно посмотреть журнал запуска Glarus BI. Подождите, пока не появится сообщение «Инициализация Glarus BI завершена», и перейдите на http://localhost:3000/setup.
Локальная установка¶
Если вы просто хотите попробовать Glarus BI или использовать Glarus BI на своём локальном компьютере, вы можете использовать базу данных H2 по умолчанию. Эта установка не предназначена для промышленной эксплуатации. Если вы намерены запустить Glarus BI в промышленной эксплуатации, см. Установка для промышленной эксплуатации.
Приведённые ниже инструкции содержат больше информации о каждом шаге установки.
1. Установка Java JRE¶
Возможно, у вас уже установлена Java. Чтобы проверить версию, откройте терминал и выполните:
Если Java не установлена, вам необходимо установить её, прежде чем вы сможете запустить Glarus BI. Мы рекомендуем последнюю LTS-версию JRE от Eclipse Temurin с HotSpot JVM и архитектурой x64, но также поддерживаются и другие версии Java.
2. Создайте новый каталог и переместите в него JAR-файл Glarus BI¶
Когда вы запускаете Glarus BI, он создаст несколько новых файлов, поэтому важно поместить JAR-файл в новый каталог перед его запуском.
В POSIX-системах команды будут выглядеть примерно так:
Предполагая, что вы загрузили в /Users/person/Downloads:
потом
3. Перейдите в новый каталог Glarus BI и запустите свой экземпляр¶
Перейдите в каталог, который вы создали:
Теперь, когда у вас установлена Java, вы можете запустить JAR из терминала с помощью:
Glarus BI начнет использовать настройки по умолчанию. Вы увидите появление логов в окне терминала и прогресс по мере запуска Glarus BI. После полного запуска вы увидите подтверждение о завершении инициализации:
...
06-19 10:29:34 INFO metabase.task :: Initializing task CheckForNewVersions
06-19 10:29:34 INFO metabase.task :: Initializing task SendAnonymousUsageStats
06-19 10:29:34 INFO metabase.task :: Initializing task SendAbandomentEmails
06-19 10:29:34 INFO metabase.task :: Initializing task SendPulses
06-19 10:29:34 INFO metabase.task :: Initializing task SendFollowUpEmails
06-19 10:29:34 INFO metabase.task :: Initializing task TaskHistoryCleanup
06-19 10:29:34 INFO metabase.core :: Glarus BI Initialization COMPLETE
Теперь всё готово к работе! Вы можете получить доступ к своему новому серверу Glarus BI через порт 3000, скорее всего, через http://localhost:3000.
Вы можете использовать порт, отличный от 3000, установив переменную среды MB_JETTY_PORT перед запуском jar.
Обратите внимание, что в конфигурации по умолчанию Glarus BI будет использовать локальную базу данных H2 для хранения всех данных своего приложения. Как упоминалось выше, это предназначено для быстрого запуска или личного использования Glarus BI. Если же вы хотите запустить Glarus BI в производственной среде, мы рекомендуем вам мигрировать с H2.
Запуск для промышленной эксплуатации¶
Шаги аналогичны шагам выше с двумя важными отличиями: если вы хотите запустить Glarus BI в промышленной эксплуатации, вам нужно:
- Использовать базу данных уровня промышленной эксплуатации для хранения метаданных.
- Запустить Glarus BI как сервис.
Если вы предпочитаете использовать Docker, ознакомьтесь с запуском Glarus BI в Docker.
База данных для хранения метаданных¶
Вот некоторые поддерживаемые базы данных.
Например, предположим, что вы хотите использовать PostgreSQL. Запустите сервис PostgreSQL и создайте пустую базу данных:
Вы можете назвать свою базу данных как хотите. При этом нет необходимости создавать какие-либо таблицы в этой базе данных; Glarus BI сделает это за вас. Вам просто нужно установить переменные среды, которые Glarus BI будет использовать при запуске для подключения к этой базе данных.
Создайте каталог для своей Glarus BI, аналогично описанию в подразделе о локальной установке, но перед запуском команды java -jar укажите следующие переменные среды, чтобы сообщить Glarus BI, как подключиться к созданной вами metabaseappdb:
export MB_DB_TYPE=postgres
export MB_DB_DBNAME=metabaseappdb
export MB_DB_PORT=5432
export MB_DB_USER=username
export MB_DB_PASS=password
export MB_DB_HOST=localhost
java -jar glarusBI.jar
Эти команды подключат Glarus BI к вашей базе данных Postgres, metabaseappdb через localhost:5432 с учётной записью пользователя username и паролем password. Если вы используете Glarus BI как службу, вы также можете поместить эти переменные среды в отдельный файл конфигурации.
Запуск Glarus BI как службы (сервиса)¶
Если вам нужно запустить JAR в промышленной эксплуатации, вы должны запустить Glarus BI как службу. Это позволяет запускать Glarus BI:
- автоматически;
- от непривилегированного пользователя (хорошо для безопасности).
Точные инструкции по запуску Glarus BI как службы будут различаться в зависимости от вашей операционной системы. Пример того, как настроить Glarus BI как службу, см. в разделе Запуск Glarus BI в Debian.
Миграция на производственную среду¶
Если вы использовали Glarus BI с базой данных приложения H2 по умолчанию, и ваши пользователи уже создали запросы, дашборды, коллекции и т.д., вы захотите перенести эти данные в производственную базу данных приложения. И чем раньше вы это сделаете, тем лучше. См. Миграция из базы данных H2.
Поиск неисправностей¶
Если у вас возникнут проблемы во время установки, обратитесь к странице устранения неполадок.
Обновление Glarus BI¶
См. Обновление Glarus BI.
Продолжение конфигурации¶
Теперь, когда Glarus BI установлен, вы можете перейти к настройке и подключению к вашей базе данных.