CR-4122 - Получение подробных данных проблемы… СТАТУС

SRTE-3039 - Получение подробных данных проблемы… СТАТУС

SRTE-3054 - Получение подробных данных проблемы… СТАТУС

SRTE-3055 - Получение подробных данных проблемы… СТАТУС

SRTE-3061 - Получение подробных данных проблемы… СТАТУС

10.2.92.0

Описание

В SetRetail10 есть функциональность по отображению изображений в плитках продаж или показ медиаконтента в LCD-мониторах. Начиная с версии 10.2.92.0 появилась возможность по обеспечению синхронизации медиаконтента с кассами (Клавиатурные, SetTouch).

• По сути SetSync может обеспечивать централизованную передачу файлов с сервера на кассы торговой сети.
• Поддерживается любой тип файлов и размера.
• Внимание! Размер передаваемого файла не ограничен, но учитывайте нагрузку вашей локальной сети, а также объем жесткого диска.
• Таким образом можно осуществлять как синхронизацию файлов медиаконтента (изображения, видеоролики), так и передавать любые типы файлов на кассу.
• Передача файлов от кассы к серверу не предусмотрена.
• Управление видеороликами и изображениями для касс осуществляется по стандартной логике, согласно техническому процессу. Изображения и файлы для использования на кассе можно синхронизировать для следующих функциональностей. В какие папки выкладывать изображения описано также в главе в этой статье.
  • SetTouch ◾️ Дисплей покупателя. Воспроизведение изображений и видео.
  • SetTouch ◾️ Настройка экрана продажи.
  • SetRetail10 ▪️ Клавиатурная касса ◾️ Добавление немаркированного товара на кассе с помощью его изображений из меню.
  • 🔒 Стандартный монитор LCD (дисплей покупателя). По вопросам подключения и настройки обратитесь к вашему менеджеру. 

Компоненты

• MinIO — это сервер хранения объектов с открытым исходным кодом. Служба может хранить неструктурированные данные, такие как фото, видео, файлы любых типов, и предоставляет один сервер хранения объектов, объединяющий в пул множество дисков, размещенных на разных серверах. 

• minio-forward-proxy - компонент отвечает за отображение контента (изображений) в визуализации сервера - плитках пик-листов и карточках товаров.
• Rclone — это многопоточная компьютерная программа с открытым исходным кодом, предназначенная для управления файлами в облаке и других хранилищах с высокой задержкой.

Системные требования

В таблице указаны рекомендуемые системные требования для установки сервиса MinIO и микросервиса minio-forward-proxy.

Список необходимых портов

Проверка доступности портов от кассы к серверу

Настройка

Подготовка 

Настройка часового пояса

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

timedatectl

2. Чтобы вывести список зон для Европы выполните команду:

timedatectl list-timezones | grep Europe

3. Чтобы вывести список зон для Азии выполните команду:

timedatectl list-timezones | grep Asia

4. Найдите в списке регион с нужным часовым поясом. Например, для Москвы необходимо установить Europe/Moscow. 

5. Выполните команду для установки часового пояса:

sudo timedatectl set-timezone Europe/Moscow

timedatectl set-timezone Europe/Moscow

6. Командой timedatectl проверьте правильность настройки часового пояса.

7. Для синхронизации времени на серверах воспользуйтесь рекомендациями из статьи.

MinIO

1. Создайте каталог:

 sudo mkdir /home/minio

2. Перейдите в созданную папку:

cd /home/minio/

3. Выполните команду для загрузки актуального программного пакета minio:

 sudo wget https://dl.min.io/server/minio/release/linux-amd64/minio

4. Дождитесь окончания загрузки.

5. Выполните команду для установки необходимых разрешений:

sudo chmod +x minio

6. Выполните команду для проверки запуска сервиса minio, указав необходимый порт, через который будет происходить обмен.

sudo nohup ./minio server --address :9001 /home/minio/data &

7. Откройте любой веб-браузер в сети и наберите IP-адрес в формате http://XXX.XXX.XXX.XXX:ПОРТ → убедитесь, что запускается страница авторизации сервиса minio.

Автозапуск

Добавьте на автозапуск сервис minio:

1. Скачайте и поместите скрипт автозапуска

Ubuntu - cкачайте d.sh в папку на сервере /home/hd.

sudo wget https://crystals.atlassian.net/wiki/download/attachments/2097676803/d.sh

CentOS - cкачайте d.sh в папку на сервере /home/minio.

Для скачивания выполните команду:

sudo wget https://crystals.atlassian.net/wiki/download/attachments/2097676803/d.sh

2. После скачивания в Ubuntu выполните команды:

sudo cp /home/hd/d.sh /home/minio/
sudo chown root:root /home/minio/d.sh
sudo chmod +x /home/minio/d.sh

3. Откройте файл d.sh для редактирования → если требуется, установите необходимый порт для работы сервиса → сохраните изменения.

sudo mcedit /home/hd/d.sh

mcedit /home/minio/d.sh

4. Для Ubuntu cкачайте файл rc.local в папку на сервере /home/hd 

Для скачивания выполните команду 

sudo wget https://crystals.atlassian.net/wiki/download/attachments/2097676803/rc.local

Далее выполните команды:

sudo cp /home/hd/rc.local /etc/
sudo chown root:root /etc/rc.local
sudo chmod +x /etc/rc.local
sudo systemctl enable rc-local

5. Для CentOS добавьте команду для выполнения при запуске ОС → сделайте пустую строку → сохраните файл.

sh /home/minio/d.sh

6. Для CentOS в командной строке выполните команды:

chmod +x /home/minio/d.sh
chmod +x /etc/rc.d/rc.local
systemctl enable rc-local

6. Для Ubuntu и CentOS перезагрузите сервер полностью. Проверьте работу сервиса через веб-браузер.

sudo reboot

Микросервис minio-forward-proxy

Установка Docker и docker-compose

Ubuntu

1. Обязательно выполните команды для удаления старых версий Docker:

sudo apt remove docker \
                  docker-common \
                  docker-selinux \
                  docker-engine

sudo apt-get purge -y docker-engine docker docker.io docker-ce 
sudo apt-get autoremove -y --purge docker-engine docker docker.io docker-ce 
sudo umount /var/lib/docker/
sudo rm -rf /var/lib/docker /etc/docker
sudo rm /etc/apparmor.d/docker
sudo groupdel docker
sudo rm -rf /var/run/docker.sock
sudo rm -rf /usr/bin/docker-compose

2. Установите необходимые пакеты, выполнив команду:

sudo apt update

3. Установите Docker:

curl -fsSL https://get.docker.com/ | sh

Дождитесь окончания процесса.

4. Выполните следующие команды:

sudo curl -L "https://github.com/docker/compose/releases/download/1.26.0/docker-compose-$(uname -s)-$(uname -m)"  -o /usr/local/bin/docker-compose
sudo mv /usr/local/bin/docker-compose /usr/bin/docker-compose
sudo chmod +x /usr/bin/docker-compose
docker-compose --version

5. Запустите Docker:

sudo systemctl start docker

6. Проверьте, что служба Docker запускается, набрав команду:

sudo systemctl status docker

7. Установите службу Docker на автозапуск:

sudo systemctl enable docker

8. Произведите авторизацию для учетной записи, которая позволяет выполнить установку микросервиса minio-forward-proxy.

Выполните команду:

docker login artifactory.setmachine.ru:5000

• Username: setsync-customers
• Password: JQ9v&H39q70R

Убедитесь, что появилось сообщение Login Succeeded.

---

1. Обязательно выполните команду для удаления старых версий Docker:

sudo apt remove docker \
                  docker-common \
                  docker-selinux \
                  docker-engine

sudo apt-get purge -y docker-engine docker docker.io docker-ce 
sudo apt-get autoremove -y --purge docker-engine docker docker.io docker-ce 
sudo umount /var/lib/docker/
sudo rm -rf /var/lib/docker /etc/docker
sudo rm /etc/apparmor.d/docker
sudo groupdel docker
sudo rm -rf /var/run/docker.sock
sudo rm -rf /usr/bin/docker-compose

sudo yum remove docker \
                  docker-common \
                  docker-selinux \
                  docker-engine

2. Установите необходимые пакеты, выполнив команду:

sudo apt update

sudo yum check-update

3. Установите Docker:

curl -fsSL https://get.docker.com/ | sh

Дождитесь окончания процесса.

4. Выполните следующие команды:

sudo curl -L "https://github.com/docker/compose/releases/download/1.26.0/docker-compose-$(uname -s)-$(uname -m)"  -o /usr/local/bin/docker-compose
sudo mv /usr/local/bin/docker-compose /usr/bin/docker-compose
sudo chmod +x /usr/bin/docker-compose
docker-compose --version

5. Запустите Docker:

sudo systemctl start docker

6. Проверьте, что служба Docker запускается, набрав команду:

sudo systemctl status docker

7. Установите службу Docker на автозапуск:

sudo systemctl enable docker

8. Произведите авторизацию для учетной записи, которая позволяет выполнить установку микросервиса minio-forward-proxy.

Выполните команду:

sudo docker login artifactory.setmachine.ru:5000

• Username: setsync-customers
• Password: JQ9v&H39q70R

Убедитесь, что появилось сообщение Login Succeeded.

Установка микросервиса

1. Создайте в домашней директории папку minio_forward_proxy

sudo mkdir /home/minio_forward_proxy
sudo chmod -R 777 /home/minio_forward_proxy/

mkdir /home/minio_forward_proxy

2. Скачайте архив minio_forward_proxy.zip → загрузите файлы из распакованного архива 

Первый вариант::

cd /home/minio_forward_proxy/
sudo wget https://crystals.atlassian.net/wiki/download/attachments/2097676803/minio_forward_proxy.zip
unzip minio_forward_proxy.zip 
rm -rf minio_forward_proxy.zip

Второй вариант:

С помощью WinSCP или другим способом в папку /home/minio_forward_proxy

3. Для отображения скрытых файлов в WinSCP перейдите в меню Options → выберите Preferences → перейдите в раздел Panels → установите флажок Show hidden files (Ctrl + Alt + H) → кликните OK.

4. Файл .env отобразится в списке.

5. Настройте конфигурационные файлы:

5.1. Файл /home/minio_forward_proxy/consul/minio-forward-proxy.yml

• application.port: 5678 - порт микросервиса, который будет слушать обращение на запрос изображения из сервера MinIO с нужными параметрами (в данном случае, это обращение от Retail или Centrum). Но это именно порт, с которым будет запущен микросервис в контейнере.
• minio.max.connections: 10000 - это одновременно возможные коннекты к микросервису. В данном примере к микросервису могут одновременно обращаться 10000 серверов SetRetail.

5.2. Файл /home/minio_forward_proxy/.env

• CONSUL_HOST=http://172.29.16.179/ - IP-адрес (который будет доступен всем участникам сети) хоста, на котором разворачивается микросервис. Указывается строго в формате http://XXX.XXX.XXX.XXX.
• CONSUL_PORT=9889 - любой доступный порт для микросервиса consul.
• HEALTH_CHECK_PORT=5489 - любой доступный порт. По этому порту можно узнать состояние микросервиса minio_forward_proxy. Например, http://172.29.16.179:5489/health, в ответ получим OK, если микросервис запущен.
• IMAGE_TAG=minio-forward-proxy:1.0.0 - версия образа микросервиса. Меняться будет только цифровая часть - 1.0.0

5.3. Файл /home/minio_forward_proxy/docker-compose.yaml

Настраивается проброс портов наружу, то есть чтобы с локального хоста были доступны внутренние порты в контейнере.

• ports:

            - 5678:5678 - порт на локальном хосте : порт внутри контейнера

Порт внутри контейнера должен совпадать с портом, указанным в параметре application.port в файле /home/minio_forward_proxy/consul/minio-forward-proxy.yml

6. Перейдите в папку /home/minio_forward_proxy

cd /home/minio_forward_proxy

7. Выполните команду для выдачи необходимых разрешений:

sudo chmod +x *

chmod +x *

8. Выполните команду:

sudo ./start_minio_forward_proxy.sh

./start_minio_forward_proxy.sh

Дождитесь окончания установки.

9. Проверьте работу MinIO и микросервиса → в адресную строку браузера введите выражение:

http://{service_ip}:{service_port}/{bucket_name}?minio-url={minio_ip}%3A{minio_port}&minio-auth=Basic%20{auth_base64}%3D

• service_ip - IP-адрес хоста, где развернут микросервис.
• service_port - порт, который слушает микросервис на хосте.
• bucket_name - название корзины на сервере MinIO.
• minio_ip - IP-адрес сервера MinIO.
• minio_port - порт, на котором запущен сервер MinIO.
• auth_base64 - аутентификация на сервере MinIO в кодировке base64. bWluaW9hZG1pbjptaW5pb2FkbWlu это minioadmin:minioadmin

Пример адреса:

http://192.168.56.143:5678/images?minio-url=192.168.56.143%3A9001&minio-auth=Basic%20bWluaW9hZG1pbjptaW5pb2FkbWlu%3D

В итоге будет выдан список всех файлов, которые есть в корзине {bucket_name}.

Автозапуск микросервиса

1. Скопируйте файл df.sh в папку /home/minio_forward_proxy

Скачать файл можно напрямую из командной строки:

cd /home/minio_forward_proxy/
wget https://crystals.atlassian.net/wiki/download/attachments/2097676803/df.sh

Для Ubuntu перед копиррованием выполните команду:

sudo chmod -R 777 /home/minio_forward_proxy/

2. Откройте на редактирование файл автозагрузки

sudo chown root:root /home/minio_forward_proxy/df.sh
sudo chmod +x /home/minio_forward_proxy/df.sh
sudo mcedit /etc/rc.local

mcedit /etc/rc.d/rc.local

3. Добавьте команду sh /home/minio_forward_proxy/df.sh для выполнения скрипта, а также сделайте пустую строку после неё клавишей ENTER.

Ubuntu:

CentOS:

4. В командной строке выполните команды:

sudo chmod +x /home/minio_forward_proxy/df.sh
sudo chmod +x /etc/rc.local
sudo systemctl enable rc-local

chmod +x /home/minio_forward_proxy/df.sh
chmod +x /etc/rc.d/rc.local
systemctl enable rc-local

5. Перезагрузите сервер полностью. Проверьте работу сервиса через веб-браузер.

sudo reboot

Настройка папки для загрузки контента в сервисе MinIO

1. Введите логин и пароль → нажмите Login.

• Access Key: minioadmin
• Secret Key: minioadmin

2. Кликните Buckets → кликните Create Bucket +.

3. Введите название корзины (bucket), например: images → кликните Create Bucket.

5. Кликните Object Browser → кликните созданный контейнер.

6. Кликните Upload → кликните Upload File (если папка с файлами Upload Fold...) → выберите файлы изображений → нажмите Открыть.

7. Файлы будут загружены на сервер.

Установка Rclone на кассе

1. С помощью SetConsole и WinSCP или другого средства распространения файлов на кассы скопируйте следующие файлы в папку /mnt/sda1/tce/optional.

• Rclone

В некоторых системных блоках, наименование диска может отличаться и быть: hda.

2. Откройте на редактирование файл в Midnight Commnder /mnt/sda1/tce/onboot.lst.

3. Добавьте следующие строки:

rclone.tcz
bash.tcz

4. В командной строке выполните команды:

tce-load -i bash
tce-load -i rclone
cash save

Настройка SetRetail/SetCentrum

1. Кликните Интеграция → Внешние процессинги → кликните кнопку добавления процессинга .

2. Наберите в строке поиска Set Sync → кликните Set Sync → установите флажок для включения процессинга Set Sync → кликните .

3. В списке внешних процессингов кликните  на строке с процессингом Set Sync.

5. Установите необходимые настройки → нажмите .

• Установите флажок  Включить.

Начиная с версии 10.3.10.0 настройки адресации разнесены по отдельным вкладкам для удобства настройки. 

SRTE-3974 - Получение подробных данных проблемы… СТАТУС

CR-7167 - Получение подробных данных проблемы… СТАТУС

10.3.10.0

Вкладка POS

Вкладка TOUCH

Вкладка CSI-K

SCOC-1448 - Получение подробных данных проблемы… СТАТУС

CR-10523 - Получение подробных данных проблемы… СТАТУС

10.4.1.0

Вкладка НАСТРОЙКИ

Настройка контента по магазинам

SRTS-2560 - Получение подробных данных проблемы… СТАТУС

CR-10522 - Получение подробных данных проблемы… СТАТУС

10.4.4.0

Начиная с версии 10.4.4.0 можно использовать SetSync для синхронизации рекламного контента, если контент специфичен по географии при топологии SetCentrum ↔ Кассы;

В настройках выделите те, магазины на которые будут прогружены пути к локальным сервисам SetSync.

Пример работы

Загруженный контент для отображения на втором LCD-мониторе покупателя:

Загруженный контент для отображения в плитках товарных групп:

Отображение контента в пик-листах и карточке товара

SRTE-3893 - Получение подробных данных проблемы… СТАТУС

CR-6997 - Получение подробных данных проблемы… СТАТУС

10.3.8.0

Начиная с версии 10.3.8.0. добавлена возможность отображения загруженных изображений товаров в шаблонах пик-листов на сервере SetRetail и SetCentrum, а также в карточке товара.

Настройка

1. Выполните скрипт по базе данных set сервера, установив в параметре property_value IP-адрес микросервиса в формате ХХХ.ХХХ.ХХХ.ХХХ:ПОРТ:

UPDATE
        sales_management_properties
SET     property_value = '192.168.56.143:5678',
		transport_level = 20,
		priority = 2,
		send_status = 0
WHERE  
        property_key   = 'minio.forward.proxy.url'
        AND module_name = 'SET_ESB';

2. Перезапустите службу сервера:

service JBOSS_SVC restart

Технические требования

• Название файла должно соответствовать артикулу товара.
• Доступные форматы изображений (регистр учитывается):
  • png
  • jpg
    • SRTE-3969 - Получение подробных данных проблемы… СТАТУС
    • 10.3.9.0
  • jpeg
    • SRTE-3969 - Получение подробных данных проблемы… СТАТУС
    • 10.3.9.0
• Максимальный размер загружаемого файла: 5 МБ.

Приоритетность показа изображений

При загрузке в MinIO изображений с одинаковым наименованием (артикулом), но с разным расширением, они будут показываться в следующем порядке:

1. png (если отсутствует, используется jpg).

2. jpg (если отсутствует, используется jpeg).

3. jpeg (последний приоритет).

Пример работы

В удаленном хранилище MinIO загружены файлы изображений для товаров:

Показ изображений в шаблоне пик-листа

Показ изображений в карточке товара