Универсальный транспортный модуль (официальный пакет u-trans)
/linuxcash/
).
Установка УТМ версии 3
Если ранее был установлен УТМ более поздней версии, то перед установкой новой версии пакета u-trans
необходимо:
Удалить пакет
u-trans
более ранней версии командой:aptitude purge u-trans
- Удалить каталог
/opt/utm/
со всем содержимым.
Для установки УТМ необходимо:
Выполнить синхронизацию индексных файлов командой:
aptitude update
Установить пакет
supervisor
(устанавливается из репозиторияArtix
):aptitude install supervisor
Установить пакеты из репозитория
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
.
- Пакеты для Ubuntu 18.04:
- Подключить физически ключ.
Установить пакет
u-trans
одной из команд:Установка deb-пакетаdpkg -i u-trans-3_0_8.deb
или
Установка из репозитория для Ubuntu 18.04aptitude install u-trans:i386
Установка из репозитория для Ubuntu 14.04aptitude install u-trans
После установки пакета в течение нескольких минут запускаются следующие сервисные службы monitoring
, updater
, utm
, отвечающие за работу, обновление и мониторинг транспортного модуля.
Сервисные службы
Служба обновления updater
Служба updater
используется только в УТМ версии 3.
Служба updater
отвечает за обновление транспортного модуля. Настройка службы производится в конфигурационном файле /opt/utm/updater/conf/transport.properties
.
Наименование | Тип данных | Описание |
---|---|---|
transport.app.home | строковый | Директория размещения транспортного модуля |
transport.connector | строковый | Адрес транспортного модуля |
#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.port | целочисленный | Целое положительное число | Порт транспортного модуля | По умолчанию |
Значение настройки gost.pkcs11.model
необходимо оставить пустым, оно будет заполнено автоматически при выборе ключа.
#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
используется только в УТМ версии 3.
Служба мониторинга monitoring
предназначена для хранения запросов и контроля работы транспортной службы. Настройка службы выполняется в конфигурационном файле /opt/utm/monitoring/conf/transport.properties
.
Наименование | Тип данных | Описание |
---|---|---|
monitoring.address | строковый | Адреса отправки данных мониторинга и транспортного модуля, мониторинг которого осуществляется |
#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.app.home | строковый | Директория размещения транспортного модуля |
transport.connector | строковый | Адрес транспортного модуля |
#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.port | целочисленный | Целое положительное число | Порт транспортного модуля | По умолчанию 8082 |
#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
.
Наименование | Тип данных | Описание |
---|---|---|
monitoring.address | строковый | Адреса отправки данных мониторинга и транспортного модуля, мониторинг которого осуществляется |
#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 включен в пакет artix45-egais
5.3-5 и выше.
Перед обновлением транспортного модуля необходимо произвести регистрацию всех ТТН, имеющихся на кассе, и завершить продажи/возвраты алкогольной продукции. При обновлении УТМ до версии 3.0.8 миграция данных не выполняется, осуществляется полная замена базы данных.
Для обновления транспортного модуля необходимо выполнить следующие действия:
В файле
/etc/apt/sources.list.d/artix.list
указать репозиторий для скачивания обновлений пакета (egais-5.3-5 является версией пакета, номер версии может изменяться):Для Ubuntu 14.04deb http://update.artix.su/trusty egais-5.3-5 artix contrib
Выполнить синхронизацию индексных файлов командой:
aptitude update
Установить новую версию пакета командой:
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
необходимо:
Выполнить реконфигурирование модуля:
dpkg-reconfigure artix45-egais
- При реконфигурировании модуля на экран будет выведен диалог, в котором необходимо выбрать тип ключа:
- Установить пароли для хранилища ключей
Rutoken
в файлах:/opt/egais/monitoring/conf/transport.properties
/opt/egais/transporter/conf/transport.properties
/opt/egais/updater/conf/transport.properties
- Перезапустить сервисы:
egais-monitoring
egais-transporter
egais-updater
Дополнительные настройки
artix45-egais
, так и для пакета u-trans
.Для возможности отправки данных на сервер ЕГАИС на кассе должны быть выполнены следующие настройки:
- указаны актуальные адреса процессинга документов и службы обновлений,
- время отклика от процессинга документов не должно превышать 300 мс,
- открыт исходящий порт TCP 443.
Перед отправкой данных на сервер устанавливается ssl
-соединение с использованием ключа, сформированного по алгоритму RSA
, длиной 2048 бит. В рамках каждого сеанса связи осуществляются:
- проверка валидности ключа (зарегистрирован, кем выдан, срок действия и т. п.);
- отправка новых подписанных чеков;
- получение квитанций по чекам, отправленным в предыдущие сеансы связи.
При включении кассового ПО и переустановке пакета сервисные службы запускаются в течение нескольких минут.