Универсальный транспортный модуль (официальный пакет u-trans)

Установка УТМ версии 3

Для установки УТМ необходимо:

1. Выполнить синхронизацию индексных файлов командой:

   aptitude update

2. Установить пакет supervisor (устанавливается из репозитория Artix):

   aptitude install supervisor

3. Установить пакеты из репозитория Artix:

   Совместимость пакетов проверена для пакета u-trans версии 3.0.8-1243.

   aptitude install <наименование_пакета>

   • Пакеты для Ubuntu 18.04: libc6:i386, libncurses5:i386, libstdc++6:i386, libssl1.0.0:i386, pcscd.
   • Пакеты для Ubuntu 14.04: pcscd.
4. Подключить физически ключ.

5. Установить пакет u-trans одной из команд:

   Установка deb-пакета

   dpkg -i u-trans-3_0_8.deb
   

   или

   Установка из репозитория для Ubuntu 18.04

   aptitude install u-trans:i386

   Установка из репозитория для Ubuntu 14.04

   aptitude install u-trans

После установки пакета в течение нескольких минут запускаются следующие сервисные службы monitoring, updater, utm, отвечающие за работу, обновление и мониторинг транспортного модуля.

Сервисные службы

Служба обновления updater

Служба updater отвечает за обновление транспортного модуля. Настройка службы производится в конфигурационном файле /opt/utm/updater/conf/transport.properties.

#Transport config
transport.app.home=/opt/utm/transport
...
transport.connector=127.0.0.1:8192

Логирование работы сервиса updater ведется в /opt/egais/updater/l/update.log.

Транспортная служба utm

Транспортная служба utm осуществляет отправку и принятие запросов. Настройка службы осуществляется в конфигурационном файле /opt/utm/transport/conf/transport.properties.

#Web server
web.server.port=8082

Логирование работы сервиса utm ведется в /opt/utm/transport/l/access.log.<Дата> , /opt/utm/transport/l/transport_info.log и /opt/utm/transport/l/transport_transaction.log.

Служба мониторинга monitoring

Служба мониторинга monitoring предназначена для хранения запросов и контроля работы транспортной службы. Настройка службы выполняется в конфигурационном файле /opt/utm/monitoring/conf/transport.properties.  

#Transport Monitoring
monitoring.address=

Логирование работы сервиса monitoring ведется в /opt/utm/monitoring/l/monitor.log.

Использование ключей Jacarta/Rutoken

Выбор ключа происходит автоматически при установке пакета u-trans, в зависимости от того, какой ключ сейчас физически подключен.

Выбрать другой ключ можно посредством его подключения к кассе и выполнения команды:

dpkg-reconfigure u-trans

Управление службами

Управление сервисными службами utm, monitoring и updater осуществляется посредством утилиты supervisorctl:

supervisorctl [команда] [служба]

[команда] может принимать значение:

• status
• stop
• start
• restart

[служба] может принимать значение:

• utm
• monitoring
• updater
• all

supervisorctl restart all

Универсальный транспортный модуль (artix45-egais)

Для установки УТМ в файле /etc/apt/sources.list.d/artix.list необходимо указать адрес репозитория для получения пакетов (egais-5.3-5 является версией пакета, номер версии может изменяться):

deb http://update.artix.su/trusty egais-5.3-5 artix contrib

Установка транспортного модуля осуществляется при установке пакета artix45-egais командой:

aptitude install artix45-egais

После установки пакета в течение нескольких минут запускаются 3 сервисные службы, отвечающие за работу, обновление и мониторинг транспортного модуля.

Служба обновления egais-updater 

Служба egais-updater отвечает за обновление транспортного модуля. Настройка службы производится в конфигурационном файле /opt/egais/updater/conf/transport.properties.

#Transport config
transport.app.home=/opt/transporter
...
transport.connector=127.0.0.1:8082

Логирование работы сервиса egais-updater ведется в /opt/egais/updater/l/update.log.

Транспортная служба egais-transporter

Транспортная служба egais-transporter осуществляет отправку и принятие запросов. Настройка службы осуществляется в конфигурационном файле /opt/egais/transporter/conf/transport.properties. 

#Web server
web.server.port=8082

Логирование работы сервиса egais-transporter ведется в /opt/egais/transporter/l/transport_user_friendly.log и /opt/egais/transporter/l/transport_info.log.

Служба мониторинга egais-monitoring

Служба мониторинга egais-monitoring предназначена для хранения запросов и контроля работы транспортной службы. Настройка службы выполняется в конфигурационном файле /opt/egais/monitoring/conf/transport.properties.  

#Transport Monitoring
monitoring.address=https://update.balancer.fsrar.ru/monitor/file http://localhost:8082/monitoring/in

Логирование работы сервиса egais-monitoring ведется в /opt/egais/monitoring/l/monitor.log.

Обновление транспортного модуля

Перед обновлением транспортного модуля необходимо произвести регистрацию всех ТТН, имеющихся на кассе, и завершить продажи/возвраты алкогольной продукции. При обновлении УТМ до версии 3.0.8 миграция данных не выполняется, осуществляется полная замена базы данных.

Для обновления транспортного модуля необходимо выполнить следующие действия:

1. В файле /etc/apt/sources.list.d/artix.list указать репозиторий для скачивания обновлений пакета (egais-5.3-5 является версией пакета, номер версии может изменяться):

   Для Ubuntu 14.04

   deb http://update.artix.su/trusty egais-5.3-5 artix contrib

2. Выполнить синхронизацию индексных файлов командой:

   aptitude update

3. Установить новую версию пакета командой:

   aptitude full-upgrade

Миграция настроек

При обновлении транспортного модуля из текущих конфигурационных файлов во вновь создаваемые мигрируют следующие настройки:

• в службе обновления значение transport.connector;
• в транспортной службе значение web.server.port;
• в службе мониторинга monitoring.address.

Если пакет устанавливается впервые, то используются настройки по умолчанию.

Резервное копирование данных

Для возможности восстановления данных при обновлении, переустановке и удалении пакета транспортного модуля создаются резервные копии:

• базы данных в /linuxcash/logs/backup/egais-db/
• чеков в /linuxcash/logs/backup/egais-check/
• логов в /linuxcash/logs/backup/egais-logs/

Использование Rutoken

При установке УТМ на кассе по умолчанию устанавливается ключ Jacarta. Для изменения используемого ключа на Rutoken необходимо:

1. Выполнить реконфигурирование модуля:

   dpkg-reconfigure artix45-egais

2. При реконфигурировании модуля на экран будет выведен диалог, в котором необходимо выбрать тип ключа:
   
3. Установить пароли для хранилища ключей Rutoken в файлах:
   • /opt/egais/monitoring/conf/transport.properties
   • /opt/egais/transporter/conf/transport.properties
   • /opt/egais/updater/conf/transport.properties
4. Перезапустить сервисы:
   • egais-monitoring
   • egais-transporter
   • egais-updater

Дополнительные настройки

Для возможности отправки данных на сервер ЕГАИС на кассе должны быть выполнены следующие настройки:

• указаны актуальные адреса процессинга документов и службы обновлений,
• время отклика от процессинга документов не должно превышать 300 мс,
• открыт исходящий порт TCP 443.

Перед отправкой данных на сервер устанавливается ssl-соединение с использованием ключа, сформированного по алгоритму RSA, длиной 2048 бит. В рамках каждого сеанса связи осуществляются:

• проверка валидности ключа (зарегистрирован, кем выдан, срок действия и т. п.);
• отправка новых подписанных чеков;
• получение квитанций по чекам, отправленным в предыдущие сеансы связи.