Установка и запуск

Печать Установка и запуск
Download Установка и запуск as PDF
Download Установка и запуск as ODT
Download Установка и запуск as TXT

 

Состав и содержание дистрибутива

Дистрибутив содержит:

  • «modusbi» — исполняемый файл, являющийся сервером для Аналитического портала. Расширение файла зависит от платформы (операционной системы):
    • Windows — исполняемый файл «modusbi.exe»;
    • Linux — исполняемый файл «modusbi».
  • «modusbi.json» — файл настройки, который можно использовать для быстрой первичной настройки. Позволяет не изменяя метаданные запустить портал с любыми предварительными настройками.
  • «modusbi-init.mbm» — файл инициализации базы данных Аналитического портала.
  • «modusbi.mbv» — триальный ключ, позволяющий работать с Аналитическим порталом 30 дней.
  • «update/modusbi.mbu» — файл обновления базы данных Аналитического портала до последней версии.

Дополнительно, в дистрибутиве для «Windows» содержатся:

  • «modusbi.bat» — файл для запуска Аналитического портала как приложения;
  • «service-create.bat» — файл создания сервиса Аналитического портала;
  • «service-delete.bat» — файл удаления сервиса Аналитического портала.

Если в дистрибутиве присутствуют файлы, не описанные в данной инструкции, их не следует принимать во внимание. Также не рекомендуется выполнять системные команды, которые могут быть указаны в этих файлах, чтобы избежать возможных рисков для системы.

Подготовка перед установкой Аналитического Портала

Перед установкой аналитического портала необходимо развернуть базу данных под управлением СУБД PostgrеSQL для хранения настроек АП.

За дистрибутивами СУБД PostgreSQL и инструкциями по установке и настройке перейдите на официальный сайт разработчика:

Инструкция по установке PostgreSQL и DBeaver.

После установки СУБД, создайте новую базу данных, например «modusbi»:

CREATE DATABASE "modusbi"

Установка Аналитического Портала

Необходимо запустить файл дистрибутива «ModusBI-xx.xx.xx.exe», где «хх.хх.хх» - номер устанавливаемого релиза. В появившемся окне нажать кнопку «Далее» и указать путь к каталогу, куда будет установлен аналитический портал, затем подождать пока файлы распакуются и завершить установку.

 

Запуск портала в режиме службы

Для запуска портала в режиме службы необходимо запустить файл «service-create.bat», для удаления — «service-delete.bat». Оба файла находятся в каталоге, куда была выполнена установка.

Установка АП из .deb пакета

Необходимо скопировать на диск файл установки с расширением «.deb» и выполнить команду:

sudo apt install modusbi-3.7.17.deb

По умолчанию программа будет установлена в каталог «/opt/modusbi».

Запуск и остановка службы выполняется командами:

systemctl start/stop modusbi
Важно! У пользователя, под которым работает служба аналитического портала, должен быть создан домашний каталог.

Установка АП из .rpm пакета

Необходимо скопировать на диск файл установки с расширением «.rpm» и выполнить команду:

sudo rpm -i ИмяФайла.rpm

По умолчанию программа будет установлена в каталог «/opt/modusbi».

Запуск и остановка службы выполняется командами:

systemctl start/stop modusbi
Важно! У пользователя, под которым работает служба аналитического портала, должен быть создан домашний каталог.

Первоначальная настройка Аналитического Портала

Настройка modusbi.json

После установки необходимо перейти в каталог, куда были распакованы файлы и в первую очередь необходимо отредактировать файл «modusbi.json». Далее требуется несколько действий, описанных ниже.

  1. Настроить параметры подключения к СУБД PostgreSQL в блоке «metadata».

    {
    "metadata": {
        "driver": "postgres",
        "datasource": "postgres://<ПОЛЬЗОВАТЕЛЬ_БД>:<ПАРОЛЬ_БД>@<IP-АДРЕС_PG>:<ПОРТ_PG>/<ИМЯ_БД>?application_name=modusbi&sslmode=disable",
        "maxopenconns": <максимальное количество одновременно открытых соединений, не больше значения max_connections в PostgreSQL>,
        "maxidleconns": <максимальное количество открытых (ожидающих) соединений в пуле>,
        "maxlifetime": <максимальное время жизни соединения в пуле, секунды>
    }
}

    Например, СУБД установлена на том же сервере, что и аналитический портал, и подключение к ней выполняется через стандартный порт 5432. Была создана база данных «modusbi», и был создан пользователь «postgres» с паролем «my_pass». Тогда строка подключения будет выглядеть следующим образом:

    {
    "metadata": {
        "driver": "postgres",
        "datasource": "postgres://postgres:my_pass@127.0.0.1:5432/modus?application_name=modusbi&sslmode=disable",
        "maxopenconns": 100,
        "maxidleconns": 20,
        "maxlifetime": 3600
    }
}

  2. Настроить хост сервера в блоке «server». По умолчанию сервер прослушивает порт 3000 только на локальном хосте 127.0.0.1. Если предполагается доступ к аналитическому порталу с других устройств, необходимо установить значение "host": "0.0.0.0".

    Например, предполагается вход на аналитический портал с других устройств на порт 3000. Тогда блок «server» будет иметь следующие настройки:

    {
    ...
    "server": {
        "host": "0.0.0.0",
        "port": 3000
    }
    ...
}

  3. Настроить параметры подключения к серверу Бэкэнда. К этому адресу будут обращаться клиентские соединения из браузера при работе с аналитическим порталом. В общем случае обращение должно выполняться к устройству, на котором запущен аналитический портал. По умолчанию сервер обращается к локальному хосту 127.0.0.1 на порт 3000. Для работы с других устройств необходимо указать значения и параметры подключения к внутреннему или внешнему адресу сервера, с указанием протокола, по которому будет проходить соединение.


    Например, предполагается вход на аналитический портал для пользователей с других устройств, находящихся в локальной сети. Аналитический портал развернут по адресу 192.168.0.3, сервер слушает порт 3000. Тогда блок «backend» будет иметь следующие настройки:

    {
    ...
    "backend": {
        "protocol": "http",
        "host": "192.168.0.3",
        "port": 3000,
        "base_url": "/v1/api/"
    }
    ...
}

Подробнее о настройке конфигурации вы можете прочитать в инструкции Настройки конфигурации Аналитического портала.

Запуск инициализации Базы данных

Подробнее о настройке вы можете прочитать в статье База данных Аналитического портала.

После настройки портала необходимо выполнить его первичную инициализацию. Для этого необходимо в командной строке в режиме администратор или в среде bash перейти в каталог портала и запустить исполняемый файл «modusbi.exe» (в Linux системах «modusbi») с параметром -init.

Пользователь операционной системы, под чьей учетной записи производится запуск приложения портала, должен иметь право на создание, изменение, удаление файлов в каталоге размещения исполняемого файла портала и на запуск исполняемого файла портала.

Например, Аналитический портал установлен в каталог «C:\Program Files\ModusBI». Тогда команда инициализации будет иметь вид:

Для Windows:

C:\portal>modusbi.exe -init

Для Linux

cd "/opt/modusbi". "modusbi" -init

После выполнения команды начнется создание структуры метаданных в указанной в настройках информационной базе. Результатом выполнения команды должно стать информационное сообщение «созданы метаданные в ‘<БД PostgreSQL>’, необходимо перезапустить сервер».

Далее нужно выполнить команды для создания службы:

sc create modusbi binPath="%cd%\modusbi.exe --service=true" type=own start=auto DisplayName=modusbi

После необходимо заново запустить службу аналитического портала.

net start modusbi

Также нужно создать разрешающее правило в Брандмауэре для входящего порта 3000 или отключить Брандмауэр.

Важно! Инициализация базы данных портала выполняется только один раз при первом запуске.

Получение временной лицензии. Если аналитический портал устанавливается на устройство впервые, автоматически будет получена временная лицензия на срок 30 дней, информация об этом будет отражена в информационном сообщении и в командной строке. Подробнее в инструкции «Лицензирование портала».

После инициализации необходимо заново запустить исполняемый файл аналитического портала. Портал готов к работе.

Проверьте работоспособность Портала

Детальная информация о процессе инициализации будет записана в файл журнала «modusbi.log».

Чтобы проверить работу портала, нужно перейти по установленному адресу, например 127.0.0.1:3000, в этом случае откроется окно авторизации, что означает что портал готов к работе.

По умолчанию доступна учетная запись

  • имя: «admin»;
  • пароль: «admin».

Поле первого входа, рекомендуется поменять стандартные параметры подключения.

Портал готов к работе.

Удаление Modus BI

  • Остановить службу Аналитического портала на сервере WEB-приложений:
sudo systemctl stop modusbi
  • Удалить базу метаданных Аналитического портала на сервере баз данных. Команды в оболочке СУБД:
DROP DATABASE <НаименованиеБД>;
  • Удалить Аналитически портал с сервера WEB-приложений:
apt-get remove modusbi