Как установить приложение#

Подготовка к установке#

  1. Приложение «Мониторинг качества данных» работает в контейнере Docker. Поэтому перед его установкой нужно установить на сервере Docker и Docker-Compose.

  1. Для получения данных приложению требуется производственный календарь. Производственный календарь нужен на каждый год, по которому будут запрашиваться показатели качества. То есть, для получения показателей в приложении за 2018, 2019, 2020 год на проекте должен быть производственный календарь на эти годы.

См.также

calendar

Установка приложения#

Для установки приложения:

  1. Подключитесь к серверу, на котором будет установлено приложение «Мониторинг качества данных»

  2. Скопируйте артефакты сборки приложения в директорию, откуда будет производиться установка, например, /opt/nephrite:

    • nginx/default.conf

    • nginx/nginx.conf

    • docker-compose.init.yml

    • docker-compose.yml

    • .env

    • nephrite-aggregation-service.tar

    • nephrite-api.tar

    • nephrite-init.tar

    • nephrite-nginx.tar

    • nephrite-web.tar

  3. Укажите настройки в файле .env

Все параметры, которые необходимы изменить, заключены в файле в блок:

#########################ТУТ РЕДАКТИРУЕМ#########################

Для каждого параметра подписана поясняющая информация:

# порт, по которому Nephrite открыт во внешнюю среду
NEPHRITE_EXTERNAL_PORT=9000

# строка подключения к базе данных Nephrite
ConnectionStrings__Nephrite=Server=172.16.55.113;Port=5432;Database=gisogd_ias;User Id=postgres;Password=qwerty123;ApplicationName=Nephrite;Connection Idle Lifetime=5;Connection Pruning Interval=3;Maximum Pool Size=500;

# строка подключения к базе данных Geometa
ConnectionStrings__Geometa=Server=172.16.55.113;Port=5432;Database=gisogd_ias;User Id=postgres;Password=qwerty123;ApplicationName=Nephrite;Connection Idle Lifetime=5;Connection Pruning Interval=3;Maximum Pool Size=500;

# строка подключения к базе данных приложению ГИСОГД (Diamond)
ConnectionStrings__Diamond=Server=172.16.55.113;Port=5432;Database=gisogd;User Id=postgres;Password=qwerty123;ApplicationName=Nephrite;Connection Idle Lifetime=5;Connection Pruning Interval=3;Maximum Pool Size=500;

# еще одна строка подключения к Nephrite в ином виде. Для инициализации
INIT_CONNECTION_STRING=host=172.16.55.113 port=5432 dbname=gisogd_ias user=postgres password=qwerty123 application_name=NephriteInit;

В строке подключения важно указывать IP, а не доменное имя

# расписание запуска (где по очереди указываются значения: минуты, часы, дни месяца, месяцы, дни недели; * указывает на всевозможные значения параметра)
CRON_PERIOD=0 0 * * 2-6

По умолчанию сервис будет запущен в 00:00 часов со вторника по субботу. Для ежедневного запуска приложения вместо 2-6 укажите *

# Стартовая дата первичного получения первых данных
AGGREGATION_START_DATE=2021-01-01

#UI ссылка на справку мониторинга
USER_MANUAL_URL=https://help.gemsdev.ru/user/usages/nephrite/user/index.html#

Вставьте url-ссылку на раздел «Мониторинг качества данных» из справки проекта

#NGINX
#сертификат для SSL
NGINX_SSL_CERT_FILE=/etc/ssl/certs/gemsdev.ru.crt
#ключ сертификата для SSL
NGINX_SSL_CERT_KEY_FILE=/etc/ssl/private/gemsdev.ru.key

Необходимо указать имя файла сертификата и файла ключа в соответствии с тем, что находятся в директории etc/ssl/certs/ и /etc/ssl/private/

#URL Геометы
GEOMETA_URL=https://command2.gemsdev.ru

Ссылка для указания URL Системы для перехода в каталог мониторинга качества данных Системы

  1. В конфигурационном файле nginx в /etc/nginx/sites-available/isogd добавьте:

    • в начало:

      upstream nephrite {
server localhost:9000;
}

    • в конец:

      server {
    server_name nephrite.gemsdev.ru;
    listen 443 ssl http2;
    include /etc/nginx/sites-available/isogd-common;
    include /etc/nginx/sites-available/isogd-ssl;
    location / {
        proxy_pass https://nephrite;
    }
}

    Сохраните изменения и перезапустите nginx:

    systemctl restart nginx

  2. Откройте терминал и перейдите в директорию, куда были скопированы установочные файлы, например, в /opt/ Nephrite

  3. Запустите скрипт deploy.sh из артефактов сборки приложения. Скрипт выполнит импорт docker-образов сервисов, необходимых для работы приложения Nephrite, из всех .tar файлов, которые были скопированы на сервер на шаге 2. После чего выполнит их установку.

Добавление каталога «Мониторинг качества данных» в Систему#

Чтобы в панели навигации Системы для проекта отображался каталог с документами, которые подлежат правке для улучшения показателей качества:

  1. добавьте в проект метаданные подсистемы Мониторинг качества данных (Нефрит)

  2. откройте метаданные проекта в редакторе метаданных

  3. проверьте, чтобы в метаданных не было ошибок (см. error_meta)

  4. обновите метаданные на проекте: Как скачать протокол

  5. перезапустите Систему командой:

    systemctl restart Gems.Ias.ApplicationServer.service

  6. укажите настройки в файле Script Мониторинг качества данных\run.bat

../../../_images/run_bat.png

  1. запустите файл run.bat для загрузки каталога