Руководство по установке#

Адресный план — это дополнительный модуль Системы для работы с данными ФИАС. В интерфейсе Системы сервис представлен кнопкой «Загрузка данных ФИАС» в меню «Импорт/экспорт» на панели навигации основного приложения.

Установка NET.Core 3.1, RabbitMQ, Erlang#

Работа сервиса требует версию NET.Core не ниже 3.1 RabbitMQ необходим для обрабокти сообщений между IAS и самим сервисом.

Если на вашем проекте уже установлены выше перечисленные службы, то этот шаг нужно пропустить. Никакая дополнительная настройка RabbitMQ не требуется.

В случае, если у вас не установлен RabbitMQ, необходимо предварительно произвести его установку и настройку. Установка сервиса производится с помощью Ansible. Предварительно необходимо установить средства поддержки Docker и Docker-compose.

Обновление метаданных#

Подключать подсистему необходимо в паре с подсистемой «Адресный план». Сначала подключается подсистема «Адресный план», а затем «Адресный план ФИАС».

Важно

  • Для работы сервиса необходимо наличие на всех схемах проекта метаданных подсистемы «Адресный план ФИАС»

  • Обновление метаданных хотя бы на одной схеме проекта во время работы сервиса приведет к отмене запущенного процесса загрузки и сопоставления данных ФИАС

Создание каталогов#

С помощью утилиты FullWfScript создать каталоги в панели навигации, используя скрипт «4_catalogs.sql» в папке «Для установки» подсистемы «Адресный план ФИАС».

Обновление GeoMeta с модулем#

В интерфейсе системы сервис «Сопоставление адресного плана с данными ФИАС» представлен кнопкой «Загрузка данных ФИАС» в меню «Импорт/экспорт» на панели навигации основного приложения IAS.

Для установки дополнительного модуля системы по работе с данными ФИАС:

  1. скачайте модуль Gems.Module.FiasIntegration из папки артефактов сборки /Modules/Gems.Module.FiasIntegration,

  2. скопируйте папку модуля в директорию приложения на сервере (например, /opt/IAS/AppServer/Modules),

  3. перезапустите приложение GeoMeta.

Или:

  1. скачайте модуль Gems.Module.FiasIntegration из папки артефактов сборки /Modules/Gems.Module.FiasIntegration,

  2. скопируйте папку модуля в директорию основного приложения Products/IAS/release.zip/ExtraModules,

3. установите сборку IAS, добавив к установочной команде настройку: -extraModule=Gems.Module.FiasIntegration.

Пример установочной команды сборки GeoMeta:

sudo bash /…/IASUnixDeploy -installDir=/opt/IAS
-connectionString='Server=localhost;Port=5432;Database=database;User Id=postgres;Password=admin;'

Установка DB-компонента#

DB-компонент Project.FIAS необходим для создания на схемах проекта:

  • справочных значений ФИАС, используемых в работе сервиса,

  • ролей на загрузку данных ФИАС и на просмотр созданных в результате импорта объектов подсистемы «Адресный план ФИАС»,

  • субъекта, юридического лица «Импорт ФИАС», который используется для заполнений полей [Кто создал] и [Кто обновил] в системных свойствах объекта.

Пример установочной команды компонента:

dotnet  /…/IAS/Cli/gems.cli.dll db-migrate-standalone -c "Server=localhost;Port=5432;Database=database;User Id=postgres;Password=admin;Connection Idle Lifetime=5;Connection Pruning Interval=3;Maximum Pool Size=500; CommandTimeout=60;" -s scheme  -o Project.FIAS

Установка модуля#

Пример установочной команды сервиса:

sudo bash /…/FiasDeploy -installDir=/…/Fias
-connectionString='Server=localhost;Port=5432;Database=database;User Id=postgres;Password=admin;'

Важно

  • В файле appsettings.json каталога ../AppServer укажите логин и пароль в блоке RabbitMq.

  • Проверьте статус службы systemctl status Gems.Fias

  • Проверьте, что настройки RabbitMQ в файле /opt/Fias/appsettings.json совпадают с теми, что в файле /opt/GeoMeta/AppServer/appsettings.json

Конфигурация имени служебного субъекта#

Системные свойства (поля [Кто создал], [Кто обновил]) автоматически созданных объектов ФИАС могут быть заполнены наименованием специально выделенного для работы сервиса субъектом.

По умолчанию, после установки DB-компонента, на всех схемах проекта будет создан субъект – юридическое лицо с наименование «Импорт ФИАС».

Наименование может быть изменено в конфигурационном файле сервиса Fias appsettings.json, параметр «UserFiasInsertName».

Изменив наименование, нужно удостовериться, что на всех схемах проекта создан субъект, юридическое лицо, с таким же наименование. В противном случае, системные свойства кто создал и обновил объект ФИАС не будут заполнены.

Настройка репликации#

Данные ФИАС создаются в каталогах муниципальных образований. Если требуется настроить репликацию со всех этих схем на региональную, то необходимо для нее указать следующие псевдонимы объектов:

Псевдонимы объектов#

Наименование типа

Псевдоним типа

ОА-1 - Регион

FiasRegion

ОА-2 - Административный район

FiasAdmArea

ОА-3 - Муниципальный район

FiasMunArea

ОА-4 - Городское или сельское поселение

FiasSettlement

ОА-5 - Город

FiasCity

ОА-6 - Населенный пункт

FiasPlace

ОА-7 - Элемент планировочной структуры

FiasPlanStructure

ОА-8 - Элемент улично-дорожной сети

FiasStreet

ОА-10 - Здание (сооружение)

FiasHouses

ОА-13 - Автономный округ (устаревшее)

FiasAutoRegion

ОА-14 - Внутригородская территория (устаревшее)

FiasCtar

ОА-15 - Дополнительная территория (устаревшее)

FiasAddCtar

ОА-16 - Объекты на дополнительной территории (устаревшее)

FiasAddCtarObj

Возможные проблемы при открытие окна «Импорт ФИАС»#

  1. Ошибка «The AMQP operation was interrupted: AMQP close-reason, initiated by Peer, code=404, text=“NOT_FOUND - no exchange „rpc_exchange“ in vhost „/““, classId=60, methodId=40»

Решение: перезагрузите сервис Gems.Ias.ApplicationServer.Service

  1. Ошибка «Не удалось установить связь с удаленным сервером за отведенное время»

Решение: перезагрузите сервис rabbitmq-server.service

  1. Первая и вторая ошибки зациклились и появляются поочередно

Решение: перезагрузите сервисы в следующем порядке:

  1. rabbitmq-server.service

  2. Gems.Ias.ApplicationServer.service

  3. Gems.Fias.service