СОРМ Январь, версия 2020 (архивная)

Новая версия интеграции с СОРМ МФИ Софт согласно докумнетации 2020 года.

{toc}

h2. Про новую версию

h3. Отличия от старой интеграции

# Полностью переписан скрипт выгрузки и принцип интеграции в cron
# Добавлены файлы заголовков

h3. Что не готово

Всё готово, ожидаем проверку этой версии с ФСБ. К сожалению, процесс не быстрый, вероятно ближе к концу 2020.

h2. Как развернуть

# Скачайте архив с файлами интеграции и распакуйте в нужной директории:
{code}
yum install -y wget
wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/186286305/sorm3-mfi_20210611.tar.gz
tar xzf sorm3-mfi_20210611.tar.gz -C /app/asr_billing/cfg/
{code}
# Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала
{code}/app/asr_billing/cfg/sorm3-mfi/configure.sh{code}
# Исправьте файл */app/asr_billing/cfg/sorm3-mfi/config* - укажите там параметры Вашего FTP. Должно быть что-то вроде этого:
{code}
scrits_dir="/app/asr_billing/cfg/sorm3-mfi/"
sql_dir="/app/asr_billing/cfg/sorm3-mfi/sql_csv"
data_dir="/app/asr_billing/var/sorm3_data"
ftp_ip=10.90.1.185
ftp_login=carbon
ftp_pass=carbon
{code}

h2. Что нужно знать о выгрузках, скриптах и тд

h3. Примечания по архитектуре интеграции

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

h3. Какие выгрузки формируются

- Данные об абонентах
-* ABONENT
-* ABONENT_IDENT
-* ABONENT_SERVICE
-* ABONENT_ADDRESS
- Справочные данные
-* COMMUTATORS
-* GATEWAYS
-* IP_GATEWAY
-* IP_PLAN
-* SUPPLEMENTARY_SERVICE
-* DOC_TYPE
-* PAY_TYPE
-* UNDEFINED_PAYMENT


h3. Как сделать выгрузку вручную

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

Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:

upload.sh abonents abonent_ident abonent_address abonent_service

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

abonent_address
abonent_ident
abonents
abonent_service
commutators
gateways
ip_gateway
ip_plan
regions
supplementary_service
undefined_payment

{code}

h2. Как запустить настройку

Запустите скрипт configure.sh:
{code}/app/asr_billing/cfg/sorm3-mfi/configure.sh{code}

Если нужно выполнить только какую-то часть, например добавить массово атрибут новым абонентам, укажите это первым агрументом функции, например:
{code}

./configure.sh prepare_payment_report
{code}

* prepare_payment_report - сделает выгрузку актуального списка платёжных системы *pay_types.csv* и настроит SQL ежечасной выгрузки платежей *undefined_payment.sql*

h2. Отладка

Если выгрузка не прошла, или произошла с какой-либо ошибкой (пустые файлы, или оборванные "на середине"), посмотреть, как проходила выгрузка можно в файле журнала на сервере:
{code:title=Путь к файлу журнала}/app/asr_billing/var/log/sorm3_upload.log{code}
Есть три наиболее распространённые причины.

h3. 1. Проблема с CRON
Если выгрузка совсем не проходила и данных в журнале нет, возможно есть проблема с планировщиком задач - он может быть выключен, может неправильно сконфигурирован, или самим скриптом /etc/cron.d/sorm3-mfi-upload.sh - возможно на нём не установлены права на выполнение.

* Возможно cron просто выключен, включить можно командой:
{code}/etc/init.d/crond start{code}
* Убедитесть что файл /etc/init.d/cron исполняемый:
{code}chmode a+x /etc/init.d/crond{code}
* Проверьте, чтобы скрипт имел следующие права
{code} [root@carbontesst]# ll /app/asr_billing/cfg/sorm3-mfi/etc-host/cron.d/sorm3-mfi-upload
-rw-r--r-- 1 root root /app/asr_billing/cfg/sorm3-mfi/etc-host/cron.d/sorm3-mfi-upload{code} Выставить данные права можно с помощью команды
{code}chmod 644 /app/asr_billing/cfg/sorm3-mfi/etc-host/cron.d/sorm3-mfi-upload{code}
* Если есть какие-то ошибки в работе, Вы можете найти информацию о них в файле */var/log/cron*. К сожалению, отладка крона уже выходит за рамки документации продукта Carbon Billing. Пожалуйста, обратитесь к документации CRON если это Ваш случай.

h3. 2. Проблема в формировании выгрузки (в отчётах)

Мы написали краткую статью по отладке отчётов: [CarbonBilling:Отладка отчетов]. По ней Вы можете решить такую проблему.

h3. 3. Проблема с выгрузкой на FTP

Наша система резервного копирования так же использует FTP-сервера для хранения резервных копий удалённо.

В документаци по отладке выгрузки резервных копий мы описали распространённые причины, почему данные могут не выгружаться: [ALARM Ошибка автоматической резервной копии!|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=51019784#Системамониторинга-ALARMОшибкаавтоматическойрезервнойкопии\!]