СОРМ3 Сигналтек Визирь

Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (22)

просмотр истории страницы
Выгрузка подготовлена только для операторов ШПД.
{toc}

h1. Что выгружается
{info}Выгрузка подготовлена только для операторов ШПД.{info}

* Данные по абонентам
* Платежи
* Пулы IP-адресов
* Коммутаторы
* Типы удостоверений личности
* Точки соединения с операторами связи
* Маршрутизаторы
* Методы платежей
* Список операторов связи филлиалов
h2. Как развернуть

h1. Описание и настройка
# Скачайте архив с файлами интеграции и распакуйте в нужной директории:
{code}
yum install -y wget
wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/157614082/sorm3-signaltec_20211005.tar.gz
mkdir /app/asr_billing/cfg/sorm3-signaltec
tar xzf sorm3-signaltec_20211005.tar.gz -C /app/asr_billing/cfg/sorm3-signaltec/
{code}
# Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала
{code}/app/asr_billing/cfg/sorm3-signaltec/configure.sh{code}
# Исправьте файл */app/asr_billing/cfg/sorm3-signaltec/config.ini* - укажите там параметры Вашего FTP. Секция FTP в конфигурационном файле должна выглядеть приблизительно так:
{code}
[ftp]
# Данные подключения к FTP
ftp_ip=10.90.1.185
ftp_login=carbon
ftp_pass=carbon
{code}

h2. Описание
Для интеграции с СОРМ Сигналтек нужно:
* Развернуть в сети FTP
* Передать реквизиты доступа поставщику
* Настроить выгрузку на биллинге,
* Заполнить статичные справочники - некоторые данные заполняются вручную по мере необходимости , так как не хранятся в базе.
Что нужно знать о выгрузках, скриптах и тд

Выгрузка происходит одним скриптом по крону, по-умолчанию раз в сутки, но можно настроить с любой периодичностью, задав нужным отчетам необходимые префиксы.
Скрипт учитывает что после выгрузки из БД возможно данные необходимо как-то еще обработать, например в периодической выгрузке абонентов нужно отражать устаревшие записи.
h2. Что нужно знать о выгрузках, скриптах и тд

h3. Пример как изменить период выгрузки
Предположим, по согласованию с куратором из органов Вам нужно сделать выгрузку раз в час:
* Сделайте sql-файл *hourly_abonents.sql*
* Сделайте csv-файл с заголовками выгрузки *hedings_abonents.csv* (он может быть общим для всех типов выгрузки)
* При необходимости как-то отредактировать SQL-выгрузку, создайте shell-скрипт *hourly_abonents.sh*
* Добавьте в CRON +host-системы+ запись:
{code}1 1 * * * root /app/asr_billing/cfg/sorm3/signaltec_upload.sh hourly &>>/app/asr_billing/var/log/sorm3_upload.log{code}
{note}Обратите внимание, что префикс имени файла *hourly* передаётся скрипту выгрузки параметром{note}
h3. Примечания по архитектуре интеграции

h2. Настройка
* По-умолчанию автоматический делаются выгрузки:
** раз в сутки: abonents abonent_ident abonent_address abonent_service
** раз в час: undefined_payment
* Если хотите изменить частоту или набор выгрузок - поправьте */app/asr_billing/cfg/sorm3-signaltec/etc-host/cron.d/sorm3-signaltec-upload.sh* и перезапустите cron
* Справочники нужно выгружать только при необходимости вручную, передав имена нужных выгрузок. Примерно так:
{code}/app/asr_billing/cfg/sorm3-signaltec/upload.sh gates_short ip_numbering_plan_short switches_short
{code}

h3. Подготовьте FTP-сервер
# Разверните в своей сети FTP-сервер
# Создайте на FTP пользователя с правами на чтение, запись, изменение и удаление файлов и папок
# Создайте в корневой директории папки:
#* abonents
#* payments
#* general
# Убедитесь что выше указанные права есть на папках ОС
h3. Какие выгрузки формируются

h3. Настройте выгрузку из биллинга
# Скачайте архив [СОРМ3 Сигналтек Визирь^Signaltech-2020-02-13-3.tar.gz]
# Распакуйте в корень системы
# Отредактируйте файл */app/asr_billing/cfg/sorm3/signaltec_upload.sh*, укажите данные FTP-сервера:
{code}declare FTP_IP='127.0.0.1'
declare FTP_LOGIN='ftp_user'
declare FTP_PWD='ftp_password'{code}
#* FTP_IP - IP FTP-сервера
#* FTP_LOGIN - имя пользователя FTP-сервера
#* FTP_PWD - логи пользователя FTP-сервера
# Перезапустите CRON:
{code}/etc/init.d/crond restart{code}
# Заполните статичные данные по документации поставщика:
#* *static_telcos_short.csv* - список операторов связи. Указанный ID будет использоваться в дальнейшем в отчетах.
#* *static_gates_short.csv* - BRAS-сервера
#* *static_ip_data_points_long.csv* - точки соединения с другими операторами
#* *static_doc_types_short.csv* - список используемых документов для удостоверения личности
#* *static_pay_types.csv* - список платежных систем
# Отредактируйте динамический выгружаемые отчеты:
#* *periodic_payments_short.sql* - актуализируйте список платежных систем
# Выгрузите сделайте первоначальную выгрузку данных:
{code}/app/asr_billing/cfg/sorm3/signaltec_upload.sh static
/app/asr_billing/cfg/sorm3/signaltec_upload.sh periodic{code}
- Данные об абонентах
-* abonents
- Справочные данные
-* ip_numbering_plan
-* payments_complete
-* payments_daily
-* supplement_services
-* switches
-* telcos
-* doc_types
-* gates
-* ip_data_points_long
-* pay_types

h1. Отладка
Скрипты выгрузки запускаются в режиме отладки и весь ход выполнения можно проанализировать по файлу */app/asr_billing/var/log/sorm3_upload.log*
h3. Как сделать выгрузку вручную

Скриптом upload.sh, в качестве параметров через пробел перечислите нужные отчёты для выгрузки, например:
{code}/app/asr_billing/cfg/sorm3-signaltec/upload.sh gateways{code}

Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:
{code:title=Команда}/app/asr_billing/cfg/sorm3-signaltec/upload.sh{code}
{code:title=Вывод}
2021-10-06 12:46:06 скрипт запущен

Укажите какие отчёты надо выгружать. Например:

upload.sh abonent abonent_ident abonent_address abonent_service

Справочники и данные об абонентах, которые можно выгрузить этим скриптом:

abonents
ip_numbering_plan
payments_complete
payments_daily
supplement_services
switches
telcos
doc_types
gates
ip_data_points_long
pay_types


Ещё скрипт можно запустить с дебагом, тогда файлы будут созданы, но без выгрузки на FTP. Например:

upload.sh abonent --debug
{code}