Установка кассового сервера

Кассовый сервер УКМ 5 представляет собой средство управления настройками касс и функционально описан здесь.

Перед установкой кассового сервера, необходимо развернуть сервер на ESXI 6.5 , соответствующий рекомендуемым системным требованиям тестового сервера:
- 6 ядер CPU;
- 22gb ОЗУ (доступную через команду htop);
- 100gb жесткий диск;
- 2 сетевых интерфейса:
- eth0 – интерфейс выхода в локальную сеть,
- eth1 – должен быть присвоен адрес 172.17.*.* (виртуальная сеть, без выхода в локальную сеть), если сеть настроена правильно - адрес присвоится автоматически;
- доступ в Интернет на момент установки.

Скорость дисков при проверке командой hdparm -tT должна быть не ниже Timing buffered disk reads 380 MB/sec (без нагрузки).

Сервер должен находиться в одной локальной сети с кассами.

Серверная часть кассовой программы, а также программное обеспечение кассовых терминалов полноценно функционируют на ОС Linux, включая x64/x86 debian-based.

Необходимо предоставить дуплексный доступ кассового сервера УКМ 5 к серверу лицензирования через интернет по протоколу HTTPS с пропускной способностью не менее 24 кбайт/сек (приблизительно) на порт 15002.

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

Логин и пароль нужно запросить у представителя технической поддержки.

Далее, с помощью проводника (mc) или командной строки создаем следующие каталоги:

Создаем требуемые папки:

mkdir /opt/ukm5-server
mkdir /home/support/1.37

Закачиваем архив docker-1.37.2.zip в /home/support/1.37/ и архив kubernetes-1.37.2.tgz в /home/support/1.37/ с нашего ftp

Проверка сетевых адаптеров и настройка DNS

Настройка второго диска

Пропускаем этот пункт, если диск один.

Проверка запуска MariaDB и установка HAproxy

sudo systemctl restart mariadb
sudo systemctl enable mariadb
sudo systemctl status mariadb

1. Устанавливаем HAproxy (чтобы видеть IP-адреса касс):

cd /opt/compose
sudo yum install haproxy

2. Копируем конфиг текущего HAproxy в свежеустановленный (перезаписать файл, при необходимости):

sudo cp /opt/compose/cfg/haproxy/haproxy.cfg /etc/haproxy/haproxy.cfg

3. Останавливаем Docker-Compose:

sudo docker-compose down

4. В текущем файле /etc/haproxy/haproxy.cfg комментируем кусок про frontend stats (c 216 строки до конца):

sudo mcedit /etc/haproxy/haproxy.cfg

5. Проверяем текущий конфиг HAproxy на валидность:

haproxy -c -f /etc/haproxy/haproxy.cfg

Ответ – Configuration file is valid.
Если есть ошибки – смотрим, чем вызваны, правим, проверяем снова.

6. Запускаем HAproxy:

sudo systemctl start haproxy
sudo systemctl status haproxy

7. Удаляем Docker-Compose из автозагрузки:

sudo mcedit /opt/compose/docker-compose.yaml

Меняем параметр restart на no:

Сохраняем файл. При следующей загрузке Docker-Compose не стартует контейнер с HAproxy.

8. Добавляем HAproxy в загрузку:

sudo systemctl enable haproxy

Разворачивание экосистемы

cd /opt/ecosystem
sh _create-ecosystem.sh

Ожидаем установки и смотрим вывод статуса служб:

Prometheus не нужен, его можно удалить.

Настройка внешнего доступа к kafka

Редактируем файл kube-configmap.yaml:

sudo mcedit /opt/ecosystem/kafka/kube-configmap.yaml

Нужно вписать актуальный IP/FQDN клиентского сервера УКМ 5 eth0 в соответствующих строчках:

cd /opt/ecosystem/kafka/
sh _restart-kafka-zookeeper.sh

Загружаем докеры:

Распаковываем архив docker-1.37.2.zip в каталог /home/support/1.37 (пароль на архив: 12345):

cd /home/support/1.37 ENTER unzip docker-1.37.2.zip

sudo docker load < admin-impl-1.37.2
sudo docker load < converters_service-1.37.2
sudo docker load < db-migration-srvdata-1.37.2
sudo docker load < db-migration-srvsales-1.37.2
sudo docker load < flush-queue-1.37.2
sudo docker load < frontend-1.37.2
sudo docker load < import-export-api-1.37.2
sudo docker load < jsreport-1.37.2
sudo docker load < licensing-impl-1.37.2
sudo docker load < login-impl-1.37.2
sudo docker load < logs_cleaner-1.37.2
sudo docker load < monitoring-impl-1.37.2
sudo docker load < ntp_timezones-1.37.2
sudo docker load < pos_agent-1.37.2
sudo docker load < public-api-1.37.2
sudo docker load < receipts_cutter-1.37.2
sudo docker load < tradedata_processing-1.37.2
sudo docker load < transport_service-1.37.2
sudo docker load < transport_service_nginx-1.37.2

Проверить загруженные контейнеры можно с помощью команды:

sudo docker images

Далее распаковываем архив kubernetes-1.37.2.tgz в /opt/ukm5-server/:

Вносим в конфигурационные файлы следующие изменения:

Необходимо отредактировать параметр DOWNLOAD_URL_PREFIX, заменить ukm5-qa-server на ukm5-server (или ваше FQDN имя сервера):

sudo mcedit /opt/ukm5-server/configmap-common/configmap-common.yaml

Изменяем параметр: PRODUCE_ITEMS_DOCUMENT  значение с false на true:

sudo mcedit /opt/ukm5-server/tradedata-processing-import/configmap.yaml

Далее запускаем установку базовых служб сервера скриптом _start-base.sh:

sudo su

cd /opt/ukm5-server/
./_start-base.sh

Запускаем и ждем ~10-50 минут.

Следить за установкой сервера можно из параллельного окна putty следующей командой:

kubectl get pods -A

Службы должны запускаться и быть в состоянии Running 1/1:

После успешного завершения работы скрипта _start-base.sh станет доступен интерфейс администратора сервера по адресу: http://<ip_адрес_вашего_сервера>/:

Также будет доступна Kibana для просмотра логов сервера по адресу http://<ip_адрес_вашего_сервера>:5601: