Техническое описание Компонента
Содержание
- 1. Общие сведения
- 1.1. Наименование и обозначение Компонента
- 1.2. Назначение Компонента
- 1.3. Возможности Компонента
- 1.4. Показатели назначения Компонента
- 1.5. Требования к каналам связи
- 1.6. Требования к операционным системам
- 1.7. Требования к техническим и программным средствам
- 1.8. Режим работы Компонента
- 1.9. Используемые языки программирования
- 1.10. Требования к персоналу
- 2. Структура Компонента «Витрина данных»
- 2.1. Модули Компонента «Витрина данных»
- 2.2. Состав модулей в дистрибутиве
- 2.3. Описание модулей Витрины данных
- 2.3.1. Агент проверок
- 2.3.2. Сервис генерации уникального номера (Counter-Provider)
- 2.3.3. Сервис формирования документов
- 2.3.4. СМЭВ3-адаптер
- 2.3.5. СМЭВ QL Сервер
- 2.3.5.1. Назначение СМЭВ QL сервера
- 2.3.5.2. Основные понятия СМЭВ QL
- 2.3.5.3. Функции СМЭВ QL Сервера
- 2.3.5.3.1. Администрирование и конфигурирование
- 2.3.5.3.2. Работа с моделями
- 2.3.5.3.3. Работа с источниками данных
- 2.3.5.3.4. Работа с картами машин состояний
- 2.3.5.3.5. Обработка запроса к витрине
- 2.3.5.3.5.1. Запрос получения данных из витрины (POST/data)
- 2.3.5.3.5.2. Запрос изменения данных витрины через события машины состояний (POST/states/{model}/{event})
- 2.3.5.3.5.3. Обработка запроса получения данных витрины
- 2.3.5.3.5.4. Асинхронное получение данных клиентом
- 2.3.5.3.5.5. Обработка запроса изменения данных витрины через машину состояний
- 2.3.5.3.5.6. Обработка регламентированного СМЭВ QL запроса
- 2.3.5.3.6. Уведомления при изменении данных витрины (push-сервис)
- 2.3.5.3.6.1. Регистрация получателя уведомлений
- 2.3.5.3.6.2. Удаление получателя уведомлений
- 2.3.5.3.6.3. Запрос списка получателей уведомлений
- 2.3.5.3.6.4. Запрос данных об отслеживаемых ресурсах
- 2.3.5.3.6.5. Передача уведомления при вызове события машины-состояний
- 2.3.5.3.6.6. Регистрация метода для получения уведомлений на стороне клиента
- 2.3.5.3.6.7. Передача уведомления на основе сообщения топика Prostore
- 2.3.5.3.7. Работа с Регламентированными СМЭВ QL запросами
- 2.3.5.4. Компонентная модель СМЭВ QL сервера
- 2.3.6. Стандартный загрузчик
- 2.3.7. BLOB-адаптер
- 2.3.7.1. Общее описание
- 2.3.7.2. Общая схема взаимодействия через BLOB-адаптер
- 2.3.7.3. Взаимодействие через СМЭВ-адаптер
- 2.3.7.4. Взаимодействие через СМЭВ3-адаптер
- 2.3.7.5. Требования к серверу BLOB-адаптера
- 2.3.7.6. Требования к Хранилищу BLOB-объектов
- 2.3.7.7. Требования к предоставляемому интерфейсу Хранилища BLOB-объектов (API-интерфейс)
- 2.3.8. CSV-Uploader
- 2.3.9. DATA-Uploader - Модуль исполнения асинхронных заданий
- 2.3.10. ETL - Модуль загрузки/ удаления данных
- 2.3.11. REST-Uploader - Модуль асинхронной загрузки данных из сторонних источников
- 2.4. Cвязи между модулями
- 2.5. Связи с другими программами
- 2.6. Карта портов
- 3. Архитектура Компонента «Витрина данных»
- 4. Выходные данные
- 5. Вызов и загрузка
- 6. Приложение 1. Пример XML-файла со структурой витрины
- 7. Термины и определения
Руководство по установке
Содержание
- 1. Общие сведения о Компоненте
- 2. Подготовка к установке
- 2.1. Предварительные действия
- 2.1.1. Установка операционной системы
- 2.1.2. Создание пользователя datamart
- 2.1.3. Настройка межсетевого экрана
- 2.1.4. Отключение SELinux (только для РЕД ОС)
- 2.1.5. Выбор часового пояса
- 2.1.6. Установка сервиса синхронизации времени
- 2.1.7. Настройка имен хостов (FQDN) на серверах
- 2.1.8. Установка Java SE Development Kit 17.0.7
- 2.1.9. Подключение к серверу через SSH-клиент PuTTY
- 2.1.10. Создание SSH-ключей
- 2.1.11. Копирование SSH-ключей на сервер
- 2.1.12. Копирование архива программы
- 2.1.13. Распаковка архива
- 2.1.14. Установка Docker
- 2.1.15. Установка библиотеки python-docker-py
- 2.1.16. Настройка логирования в Docker
- 2.1.17. Перезапуск Docker
- 2.1.18. Добавление пользователя в группу Docker
- 2.1.19. Настройка Ansible
- 2.1. Предварительные действия
- 3. Установка Компонента
- 3.1. Установка Компонента «Витрина данных» конфигурации Стандарт
- 3.1.1. Порядок установки
- 3.1.2. Установка Prostore (dtm-query-execution-core)
- 3.1.3. Установка СМЭВ QL Сервера
- 3.1.4. Установка СМЭВ3-адаптера
- 3.1.5. Установка BLOB-адаптера
- 3.1.6. Установка сервиса формирования документов
- 3.1.7. Установка стандартного загрузчика
- 3.1.8. Установка CSV-Uploader
- 3.1.9. Установка DATA-uploder – Модуля исполнения асинхронных заданий
- 3.1.10. Установка REST-uploader – Модуля асинхронной загрузки данных из сторонних источников
- 3.1.11. Установка сервиса генерации уникального номера (Counter-Provider)
- 3.1.12. Установка Агента проверок
- 3.1.13. Установка коннектора Kafka-Postgres
- 3.1.14. Установка и настройка сервиса сбора данных запросов и ответов Витрины данных
- 3.2. Установка Компонента «Витрина данных» конфигурации лайт
- 3.3. Установка системы мониторинга
- 3.4. Подключение к Агенту СМЭВ4
- 3.1. Установка Компонента «Витрина данных» конфигурации Стандарт
- 4. Проверка Компонента
- 4.1. Проверка Компонента «Витрина данных» конфигурации Стандарт
- 4.1.1. Проверка ПО Prostore
- 4.1.2. Проверка СМЭВ QL Сервера
- 4.1.3. Проверка СМЭВ3-адаптера
- 4.1.4. Проверка DATA-Uploder – Модуля исполнения асинхронных заданий
- 4.1.5. Проверка REST-Uploader – Модуля асинхронной загрузки данных из сторонних источников
- 4.1.6. Проверка BLOB-адаптера
- 4.1.7. Проверка сервиса формирования документов
- 4.1.8. Проверка стандартного загрузчика
- 4.1.9. Проверка Сервиса генерации уникального номера (Counter-provider)
- 4.1.10. Проверка Агента проверок
- 4.2. Проверка Компонента «Витрина данных» конфигурации Лайт
- 4.1. Проверка Компонента «Витрина данных» конфигурации Стандарт
- 5. Обновление Компонента
- 5.1. Обновление Компонента конфигурации «Стандарт» с версии 1.х на 2.х
- 5.1.1. Обновление Компонента с переиспользованием прикладной БД
- 5.1.1.1. Проверка резервной копии
- 5.1.1.2. Подготовка служебной БД нового Prostore
- 5.1.1.3. Остановка Компонента версии 1.х
- 5.1.1.4. Миграция метаданных Prostore
- 5.1.1.5. Включение Компонента версии 2.х
- 5.1.1.6. Включение взаимодействий Компонента
- 5.1.1.7. Заключительные действия
- 5.1.1.8. Восстановление прежней версии Компонента
- 5.1.2. Обновление Компонента с поднятием второй копии витрины
- 5.1.3. Ограничения
- 5.1.1. Обновление Компонента с переиспользованием прикладной БД
- 5.2. Обновление Компонента конфигурации Лайт
- 5.1. Обновление Компонента конфигурации «Стандарт» с версии 1.х на 2.х
- 6. Приложение 1. Настройка firewall (Iptables)
- 7. Приложение 2. Просмотр выполнения загрузки данных в программу
- 8. Приложение 3. Рекомендации по конфигурированию инфраструктуры Компонента «Витрина данных»
- 7. Термины и определения
Руководство администратора
Содержание
- 1. Общие сведения о Компоненте
- 2. Настройка Компонента
- 2.1. Настройка технических средств
- 2.2. Настройка программных средств
- 2.2.1. Настройка Prostore (dtm-query-execution-core)
- 2.2.2. Настройка Агента проверок
- 2.2.2.1. Конфигурация Агента проверок (application.yml)
- 2.2.2.2. Параметры конфигурации
- 2.2.2.3. Конфигурационный файл с описанием проверяемой схемы
- 2.2.2.4. Описание спецификации для взаимодействия с Агентом проверок
- 2.2.2.5. Описание служебной схемы, создаваемой Агентом проверок
- 2.2.2.5.1. Описание таблицы dqf_{table_name}_errors
- 2.2.2.5.2. Описание таблицы dqf_checks
- 2.2.2.5.3. Описание таблицы aggregation
- 2.2.2.5.4. Описание таблицы aggregation_arm_ds
- 2.2.2.5.5. Описание таблицы child_checks
- 2.2.2.5.6. Описание таблицы parent_checks
- 2.2.2.5.7. Описание таблицы inc_settings
- 2.2.2.5.8. Описание таблицы last_processed_operation
- 2.2.2.5.9. Описание таблицы schedule_checks
- 2.2.2.5.10. Описание таблицы smev3_adapter_pebble
- 2.2.2.5.11. Описание таблицы smev3_adapter_receiver_scheduler
- 2.2.2.5.12. Описание таблицы inc_rate_limiter
- 2.2.3. Настройка Сервиса генерации уникального номера (Counter-provider)
- 2.2.4. Настройка Сервиса формирования документов
- 2.2.5. Настройка СМЭВ3-адаптера
- 2.2.5.1. Конфигурация СМЭВ3-адаптер (application.yml)
- 2.2.5.2. Параметры конфигурации
- 2.2.5.2.1. Секция vertx
- 2.2.5.2.2. Секция spring
- 2.2.5.2.3. Секция iua
- 2.2.5.2.4. Секция smev
- 2.2.5.2.5. Секция receiver
- 2.2.5.2.6. Секция persistence-mode
- 2.2.5.2.7. Секция prostore-rest-client
- 2.2.5.2.8. Секция prostore-persistence
- 2.2.5.2.9. Секция environment
- 2.2.5.2.10. Секция zookeeper
- 2.2.5.2.11. Секция migration
- 2.2.5.2.12. Секция paramstorage
- 2.2.5.2.13. Секция sign
- 2.2.5.2.14. Секция blob
- 2.2.5.2.15. Секция rest
- 2.2.5.2.16. Секция scheduler
- 2.2.5.2.17. Секция pool
- 2.2.5.2.18. Секция logging
- 2.2.5.2.19. Секция http-server
- 2.2.5.2.20. Секция spf
- 2.2.5.2.21. Секция dynamic-config
- 2.2.5.2.22. Секция component-info
- 2.2.6. Настройка СМЭВ QL Сервера
- 2.2.6.1. Конфигурирование сервера
- 2.2.6.1.1. Конфигурация файла application.yml
- 2.2.6.1.1.1. Секция ktor
- 2.2.6.1.1.2. Секция sources
- 2.2.6.1.1.3. Секция swagger
- 2.2.6.1.1.4. Секция storage
- 2.2.6.1.1.5. Секция access
- 2.2.6.1.1.6. Секция request
- 2.2.6.1.1.7. Секция delta
- 2.2.6.1.1.8. Секция state
- 2.2.6.1.1.9. Секция index_recommendations
- 2.2.6.1.1.10. Секция standalone-tables
- 2.2.6.1.1.11. Секция proxy-tables
- 2.2.6.1.1.12. Секция push
- 2.2.6.1.1.13. Секция agent
- 2.2.6.1.1.14. Секция signature
- 2.2.6.1.1.15. Секция cls
- 2.2.6.1.1.16. Секция component-info
- 2.2.6.1.2. Конфигурация файла credentials.yml
- 2.2.6.1.3. Общий сценарий выполнения
- 2.2.6.1.1. Конфигурация файла application.yml
- 2.2.6.2. Стейт-машина СМЭВ QL
- 2.2.6.2.1. Конфигурирование Стейт-машины
- 2.2.6.2.2. Удаление записи через Стейт-машину
- 2.2.6.2.3. Передача данных без изменения статуса (статичный ивент)
- 2.2.6.2.4. Обновление объектов через Стейт-машину
- 2.2.6.2.5. Обогащение payload запроса дополнительными атрибутами
- 2.2.6.2.6. Методы API Стейт-машины
- 2.2.6.2.7. Спецификация интерфейса Стейт-машины
- 2.2.6.3. Запросы
- 2.2.6.4. Ответы
- 2.2.6.5. Описание эндпоинтов
- 2.2.6.5.1. GET /ping
- 2.2.6.5.2. GET /states
- 2.2.6.5.3. GET /states/{model}
- 2.2.6.5.4. POST /states/{model}/{event}
- 2.2.6.5.5. GET /model
- 2.2.6.5.6. GET /model/{model}
- 2.2.6.5.7. GET /model/{model}/{version}
- 2.2.6.5.8. GET /sources
- 2.2.6.5.9. POST /data
- 2.2.6.5.10. GET /server/indexes/required
- 2.2.6.5.11. GET /regulated-query
- 2.2.6.6. Ошибки
- 2.2.6.1. Конфигурирование сервера
- 2.2.7. Настройка стандартного загрузчика
- 2.2.7.1. Конфигурация стандартного загрузчика
- 2.2.7.2. Параметры конфигурации
- 2.2.7.2.1. Секция http-server
- 2.2.7.2.2. Секция metrics
- 2.2.7.2.3. Секция prostore-rest-client
- 2.2.7.2.4. Секция spring
- 2.2.7.2.5. Секция auth
- 2.2.7.2.6. Секция manager
- 2.2.7.2.7. Секция buffer
- 2.2.7.2.8. Секция flk
- 2.2.7.2.9. Секция uploader
- 2.2.7.2.10. Секция comparator
- 2.2.7.2.11. Секция deployer
- 2.2.7.2.12. Секция dtm-facade
- 2.2.7.2.13. Секция manager-client
- 2.2.7.2.14. Секция buffer-client
- 2.2.7.2.15. Секция component-info
- 2.2.7.2.16. Секция retry
- 2.2.7.2.17. Секция grpc
- 2.2.8. Настройка BLOB-адаптера
- 2.2.9. Настройка CSV-Uploader
- 2.2.9.1. Конфигурация CSV-uploader (application.yml)
- 2.2.9.2. Параметры конфигурации
- 2.2.9.2.1. Секция auth
- 2.2.9.2.2. Секция http-server
- 2.2.9.2.3. Секция file-size
- 2.2.9.2.4. Секция environment
- 2.2.9.2.5. Секция prostore-rest-client
- 2.2.9.2.6. Секция spring
- 2.2.9.2.7. Секция metadata
- 2.2.9.2.8. Секция persistence-mode
- 2.2.9.2.9. Секция validation
- 2.2.9.2.10. Секция upload
- 2.2.9.2.11. Секция uploader
- 2.2.9.2.12. Секция csv-parser
- 2.2.9.2.13. Секция metrics
- 2.2.10. Настройка DATA-Uploader – Модуль исполнения асинхронных заданий
- 2.2.10.1. Конфигурация модуля DATA-Uploader (application.yml)
- 2.2.10.2. Параметры конфигурации
- 2.2.10.2.1. Секция http-server
- 2.2.10.2.2. Секция persistence-mode
- 2.2.10.2.3. Секция prostore-rest-client
- 2.2.10.2.4. Секция redis
- 2.2.10.2.5. Секция upload
- 2.2.10.2.6. Секция data-storage
- 2.2.10.2.7. Секция environment
- 2.2.10.2.8. Секция zookeeper
- 2.2.10.2.9. Секция csv-parser
- 2.2.10.2.10. Секция active
- 2.2.10.2.11. Секция delta
- 2.2.10.2.12. Секция stream
- 2.2.10.2.13. Секция response
- 2.2.10.2.14. Секция component-info
- 2.2.10.2.15. Секция metrics
- 2.2.11. Настройка DTM-Uploader
- 2.2.12. Настройка REST-Uploader – Модуль асинхронной загрузки данных из сторонних источников
- 2.2.12.1. Конфигурация модуля REST-Uploader (application.yml)
- 2.2.12.2. Параметры конфигурации
- 2.2.12.2.1. Секция http-server
- 2.2.12.2.2. Секция executor
- 2.2.12.2.3. Секция file-size
- 2.2.12.2.4. Секция environment
- 2.2.12.2.5. Секция data-storage
- 2.2.12.2.6. Секция conditions
- 2.2.12.2.7. Секция Zookeeper
- 2.2.12.2.8. Секция persistence-mode
- 2.2.12.2.9. Секция prostore-rest-client
- 2.2.12.2.10. Секция migration
- 2.2.12.2.11. Секция response
- 2.2.12.2.12. Секция control
- 2.2.12.2.13. Секция redis
- 2.2.12.2.14. Секция auth
- 2.2.12.2.15. Секция metrics
- 2.2.12.2.16. Секция csv-parser
- 2.2.12.2.17. Секция component-info
- 2.2.12.2.18. Секция retries
- 2.2.12.3. Проверка форматно-логического контроля
- 2.2.12.4. Статусная модель
- 2.2.12.5. Спецификация модуля асинхронной загрузки данных из сторонних источников
- 2.2.13. Настройка сервиса журналирования
- 2.3. Настройка сервиса мониторинга
- 3. Запуск и остановка Компонента
- 3.1. Prostore
- 3.2. Агент проверок
- 3.3. Сервис генерации уникального номера (Counter-provider)
- 3.4. Сервис формирования документов
- 3.5. СМЭВ3-адаптер
- 3.6. СМЭВ QL Сервер
- 3.7. Стандартный загрузчик
- 3.8. BLOB-адаптер
- 3.9. CSV-Uploader
- 3.10. DATA-uploader – Модуль исполнения асинхронных заданий
- 3.11. REST-Uploader – Модуль асинхронной загрузки данных из сторонних источников
- 4. Бекапирование Компонента «Витрина данных»
- 5. Дополнительные возможности
- 6. Сообщения администратору
- 7. Метрики в модулях Компонента «Витрина данных»
- 8. Приложение 1. Эксплуатация CSV-Uploader
- 8.1. Инструкция по эксплуатации CSV-Uploader
- 8.1.1. Общие правила формата загружаемых CSV-файлов
- 8.1.2. Загрузка структуры Витрины
- 8.1.3. Выгрузка шаблона CSV
- 8.1.4. Загрузка CSV-файла
- 8.1.5. Обязательная загрузка данных с предварительным форматно-логическим контролем
- 8.1.6. Загрузка данных без подключения к Prostore
- 8.1.7. Аутентификация
- 8.1.8. Настройки CSV-uploader
- 8.1.9. Просмотр журнала загрузок по расписанию
- 8.1.10. Интерфейс Форматно-логического контроля
- 8.1. Инструкция по эксплуатации CSV-Uploader
- 9. Приложение 2. Пример XML-файла со структурой витрины
- 7. Термины и определения