Запуск jar файла GlarusBI¶
Чтобы запустить GlarusBI через JAR файл, в вашей системе должна быть установлена среда выполнения Java (JRE).
Быстрый запуск¶
Быстрый запуск предназначен для локального запуска GlarusBI. Инструкции по запуску GlarusBI в рабочей среде см. ниже.
Если у вас установлена Java:
Загрузите JAR файл для GlarusBI glarusBI.jar.
Создайте новый каталог и переместите в него файл glarusBI.jar.
Перейдите в новый каталог GlarusBI и запустите JAR.
java -jar glarusBI.jar
В окне терминала, в котором вы выполнили команду можно посмотреть лог запуска GlarusBI. Подождите, пока не появится сообщение «Инициализация GlarusBI завершена», и перейдите на http://localhost:3000/setup.
Локальная установка¶
Если вы просто хотите попробовать GlarusBI, или использовать GlarusBI на своем локальном компьютере, вы можете использовать базу данных H2 по умолчанию. Эта установка не предназначена для промышленной эксплуатации. Если вы намерены запустить GlarusBI в промышленной эксплуатации, см. Производственная установка.
Приведенные ниже инструкции содержат больше информации о каждом шаге установки.
1. Установка Java JRE¶
Возможно, у вас уже установлена Java. Чтобы проверить версию, откройте терминал и выполните:
java -version
Если Java не установлена, вам необходимо установить ее, прежде чем вы сможете запустить GlarusBI. Мы рекомендуем последнюю LTS-версию JRE от Eclipse Temurin с HotSpot JVM и архитектурой x64, но также поддерживаются и другие версии Java.
2. Создайте новый каталог и переместите в него JAR файл GlarusBI.¶
Когда вы запускаете GlarusBI, он создаст несколько новых файлов, поэтому важно поместить Jar-файл в новый каталог перед его запуском.
В posix-системах команды будут выглядеть примерно так:
Предполагая, что вы загрузили в /Users/person/Downloads:
mkdir ~/metabase
потом
mv /Users/person/Downloads/glarusBI.jar ~/metabase
3. Перейдите в новый каталог GlarusBI и запустите свой инстанс¶
Перейдите в каталог, который вы создали:
cd ~/metabase
Теперь, когда у вас установлена Java, вы можете запустить JAR из терминала с помощью:
java -jar glarusBI.jar
GlarusBI начнет использовать настройки по умолчанию. Вы увидите появление логов в окне терминала и прогресс по мере запуска GlarusBI. После полного запуска вы увидите подтверждение о завершении инициализации:
...
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 :: GlarusBI Initialization COMPLETE
Теперь все готово к работе! Вы можете получить доступ к своему новому серверу GlarusBI через порт 3000, скорее всего, через http://localhost:3000.
Вы можете использовать порт, отличный от 3000, установив переменную среды MB_JETTY_PORT перед запуском jar.
Обратите внимание, что в конфигурации по умолчанию GlarusBI будет использовать локальную базу данных H2 для хранения всех данных своего приложения. Как упоминалось выше это предназначено для быстрого запуска или личного использования GlarusBI. Если же вы хотите запустить GlarusBI в производственной среде, мы рекомендуем вам мигрировать с H2.
Производственный запуск¶
Шаги аналогичны шагам выше с двумя важными отличиями: если вы хотите запустить GlarusBI в промышленной эксплуатации, вам нужно:
Использовать базу данных продуктивной среды для хранения метаданных.
Запустить GlarusBI как сервис.
Если вы предпочитаете использовать Docker, ознакомьтесь с запуском GlarusBI в Docker.
База данных для хранения метаданных¶
Вот некоторые поддерживаемые базы данных.
Например, предположим, что вы хотите использовать PostgreSQL. Запустите сервис PostgreSQL и создайте пустую базу данных:
createdb metabaseappdb
Вы можете назвать свою базу данных как хотите. При этом нет необходимости создавать какие-либо таблицы в этой базе данных; GlarusBI сделает это за вас. Вам просто нужно установить переменные среды, которые GlarusBI будет использовать при запуске для подключения к этой базе данных.
Создайте каталог для своей GlarusBI, аналогично описанию в параграфе о Локальной установке, но перед запуском команды java -jar укажите следующие переменные среды, чтобы сообщить GlarusBI, как подключиться к созданной вами 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
Эти команды подключат GlarusBI к вашей базе данных Postgres, metabaseappdb через localhost:5432 с учетной записью пользователя username и паролем password. Если вы используете GlarusBI как службу, вы также можете поместить эти переменные среды в отдельный файл конфигурации.
Запуск GlarusBI как службы (сервиса)¶
Если вам нужно запустить JAR в среде промышленной эксплуатации, вы должны запустить GlarusBI как службу. Это:
Позволяет запускать GlarusBI автоматически
Позволяет запускать GlarusBI от непривилегированного пользователя (что хорошо для безопасности).
Точные инструкции по запуску GlarusBI как службы будут различаться в зависимости от вашей операционной системы. Пример того, как настроить GlarusBI как службу, см. в разделе Запуск GlarusBI в Debian.
Миграция на производственную среду¶
Если вы использовали GlarusBI с базой данных приложения H2 по умолчанию, и ваши пользователи уже создали вопросы, информационные панели, коллекции и т. д., вы захотите перенести эти данные в производственную базу данных приложения. И чем раньше вы это сделаете, тем лучше. См. Миграция из базы данных H2.
Поиск неисправностей¶
Если у вас возникнут проблемы во время установки, обратитесь к странице устранения неполадок.
Обновление GlarusBI¶
См. Обновление GlarusBI.
Продолжение конфигурации¶
Теперь, когда GlarusBI установлен, вы можете перейти к настройке и коннекту к вашей базе данных.