Установка и настройка SetMark на Windows и Linux

- 1.1 Важная информация
- 1.2 Обязательные требования к номеру магазина
2 Установка (Windows).
3 Установка (Linux).
- 3.1 Параметры установки:
  - 3.1.1 Пример запуска:
  - 3.1.2 Пример:
4 Настройка сервиса.

Важная информация

Перед установкой нужно убедиться, что:

В сети есть настроенный сервер лицензирования и доставки обновлений SetAgent
Сервер соответствует рекомендуемым требованиям.

Функциональность предоставляется только при покупке лицензии.

Виды лицензий:

ПО SET Retail 10 модуль "SET Mark" плагин "Alco" Лицензия
ПО SET Retail 10 модуль "SET Mark" плагин "Продовольственные товары" Лицензия
ПО SET Retail 10 модуль "SET Mark" плагин "Непродовольственные товары" Лицензия
ПО SET Retail 10 модуль "SET Mark" плагин "Централизованная проверка марок в офлайн режиме. Интеграционный модуль Честного Знака" Лицензия

https://crystals.atlassian.net/browse/SRTB-9639

https://crystals.atlassian.net/browse/CR-13940

Обязательные требования к номеру магазина

Номер магазина является критически важным параметром в системе и должен быть обязательно указан (значение NULL недопустимо). Данный параметр необходим:

Для валидации акцизного алкоголя
При получении лицензии во время установки

При установке SetMarkCentrum (Модули Продовольственные и Непродовольственные товары) номер магазина можно указать "1" и продолжить установку. При использовании варианта поставки с централизованным хранением марок SetMark не имеет привязки к магазинам.

Важно: номер магазина обязателен при валидации акцизного алкоголя вне зависимости от архитектуры.

https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4939055427

Установка (Windows).

Начиная с версии SetMark 2.26.0 параметры Номер магазина и Адрес сервера лицензирования являются обязательными.

Инсталлятор для Windows уже содержит в себе все необходимые компоненты. Поддерживаются 64-х разрядные версии системы.

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

Список параметров:

для всех версий:
- /SILENT, /VERYSILENT - указывает программе установки запускаться в тихом режиме, при /SILENT не будет показано окно мастера установки, но будет отображаться прогресс, при /VERYSILENT не будет показано никаких окон. Остальные окна, например сообщения об ошибках отображаться будут.
- /COMPONENTS="разделенный запятыми список компонентов" - переопределяет настройки компонентов по умолчанию. Будут выбраны только указанные компоненты, остальные будут отменены. Если имя компонента имеет префикс "*", будут выбраны также любые дочерние компоненты. Если имя компонента имеет префикс "!", компонент будет отменен. Поддерживаемые компоненты: "postgres", "postgres\setup", "postgres\config".
- /DIR="x:\dirname" - переопределяет каталог установки по умолчанию.
для версий от 1.3.0 и старше:
- добавлена поддержка указания настроек SetMark в формате "/param="value"". Список параметров:
  - shop - номер магазина. обязательный параметр. (значение по умолчанию: отсутствует)
  - license - адрес агента лицензирования. Начиная с версии SetMark 2.26.0 параметр Адрес сервера лицензирования является обязательным.
  - dbhost - адрес базы данных. (значение по умолчанию: localhost)
  - dbport - порт для подключения к БД. (значение по умолчанию: 5432)
  - dbuser - имя пользователя БД. (значение по умолчанию: setmark)
  - dbpass - пароль пользователя БД. (значение по умолчанию: setmark)
  - dbname - название базы данных. (значение по умолчанию: set_mark)
  - pguser - имя пользователя(Администратор) БД. (значение по умолчанию: postgres)
  - pgpass - пароль пользователя(Администратор) БД. (значение по умолчанию: postgres)

Пример запуска:

Better Code Block

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

Введите базовые настройки для приложения. Позже их можно изменить в файле application.properties (по умолчанию C:\Program Files\setmark\config\application.properties) и в базе данных в таблице configuration.

Начиная с версии SetMark 2.26.0 параметры Номер магазина и Адрес сервера лицензирования являются обязательными.

Далее настраиваются параметры подключения к базе данных.

Важно: параметры Имя пользователя(администратор) и Пароль(администратор) не используются сервисом SetMark. Они нужны установщику для создания новой базы данных и пользователя для нее. Если новая база данных не создается - эти параметры не будут использованы. При необходимости Вы можете создать базу и пользователя позже. Остальные параметры будут прописаны в конфигурационный файл в раздел # database settings.

Далее необходимо выбрать необходимые компоненты. Если в системе уже установлен PostgreSQL или пользователь и база данных уже созданы - снимите галочки с соответствующих пунктов.

Проверьте правильность введенных данных и приступите к установке.

Всё готово. Сервис SetMark установлен в системе и будет запускаться при старте ПК. Логи в каталоге с программой.

Проверить работу или остановить/запустить сервис можно в диспетчере задач (ctrl+shift+esc → службы) или любым другим стандартным для Windows способом (ищем в google).

Удалить сервис можно из папки установки файлом unins000.exe При это будут удалены только файлы программы, база данных останется нетронутой, что позволит установить сервис заново без создания новой базы. При необходимости всё можно удалить вручную стандартными средствами PostgreSQL.

Установка (Linux).

Установка на Linux доступна для дистрибутивов поддерживающих системный менеджер systemd (большинство популярных дистрибутивов, включая Debian GNU/Linux версии 8+, CentOS версии 7+, Ubuntu версии 15.10+ и другие). Подробнее смотрите в документации к вашей версии Linux.

Для корректной установки и работы должна быть установлена PostgreSQL версии не ниже 9.4, а также создана база данных (можно создать пустую, без таблиц) и пользователь (не рекомендуется использовать администратора). Если PostgreSQL не будет найдена, то установка SetMark станет невозможна!

В случае возникновения проблем с Java, можно поменять версию Java для вашего дистрибутива в каталоге с установленной программой (по умолчанию opt/SetMark/jre).

Частично базовая конфигурация доступна во время установки с помощью ключей для файла инсталляции. Ключи могут использоваться как вместе, так и по отдельности. В дальнейшем эти параметры можно поменять в файле application.properties (по умолчанию opt/SetMark/config/application.properties) и в базе данных в таблице configuration. Чтобы посмотреть список допустимых параметров используйте --help:

Параметры установки:

-d - раздел для установки сервиса SetMark. Если не указывать, значение по умолчанию: /opt

-dbuser - логин пользователя БД Postgres. Если не указывать, значение по умолчанию: setmark

-dbpass - пароль пользователя БД Postgres. Если не указывать, значение по умолчанию: setmark

-dbhost - адрес сервера Postgres. Если не указывать, значение по умолчанию: localhost

-dbport - порт сервера Postgres. Если не указывать, значение по умолчанию: 5432

-dbname - имя базы данных SetMark на сервере Postgres. Если не указывать, значение по умолчанию: set_mark

-shopnum - номер магазина, на который установлен SetMark и за марки которого он будет отвечать (для локального SM). Обязательный параметр, начиная с версии SetMark 2.26.0.

-licenseurl - адрес сервера лицензирования. Обязательный параметр, начиная с версии SetMark 2.26.0

Если при установке не были введены параметры Номер магазина (shopnum) и Адрес сервера лицензирования (licenseurl), их необходимо указать в базе данных в таблице configuration (для версии продукта 1.3.0 и выше). Параметры Номер магазина и Адрес сервера лицензирования являются обязательными начиная с версии 2.26.0.

Пример запуска:

sh ./setmark.sh -d=/РАЗДЕЛ -dbuser=ЛОГИН -dbpass=ПАРОЛЬ -shopnum=НОМЕР_МАГАЗИНА -licenseurl=АДРЕС_SETAGENT

Управление запуском и остановкой сервиса осуществляется стандартными командами.

Пример:

service setmark stop
service setmark start

Для удаления SetMark воспользуйтесь файлом uninstall.sh из каталога с установленной программой.

Настройка сервиса.

Необходимые настройки вынесены в файл config/application.properties.

Пример содержимого:

^{# server settings}
^{server.port=9000}
^locale=ru

^{# set mark updater settings}
^{updater.port=9001}

^{# module Alco setting}
^{setmark.alco.check.alcocode=true}
^{setmark.alco.check.barcode=false}
^{setmark.alco.check.item=false}
^{setmark.alco.check.mrc=false}

^{# module Tobacco settings}
^{setmark.tobacco.check.balance=false}

^{# amrc sending settings}
^{setmark.alco.minprice.report.enable=false}
^{setmark.alco.minprice.report.login=}
^{setmark.alco.minprice.report.password=}
^{setmark.alco.minprice.report.cron=0 0 2 * * *}
^{setmark.alco.minprice.report.limit=5000}
^{setmark.alco.minprice.report.remote.uri=http://localhost:8080}
^{setmark.alco.minprice.report.timeout=5000}
^{setmark.alco.minprice.report.repeat.timer=600000}

^{# reporting settings}
^{setmark.report.processing.enable=false}
^{setmark.report.processing.login=}
^{setmark.report.processing.password=}
^{setmark.report.processing.timer=600000}
^{setmark.report.processing.limit=5000}
^{setmark.report.processing.remote.uri=http://localhost:8080}
^{setmark.report.processing.timeout=5000}

^{# date format}
^{spring.jackson.date-format=yyyy-MM-dd'T'HH:mm:ssZ}

^{# database settings}
^{spring.datasource.db.name=set_mark}
^{spring.datasourse.db.port=5432}
^{spring.datasourse.db.host=localhost}
^{spring.datasource.username.base=setmark}
^{spring.datasource.password.base=setmark}

^{# logger settings}
^{logging.level.root=info}

^{# 'application.properties' version. do not change!}
^{setmark.properties.version=@VERSION@}

^{# server settings}
^{# порт на котором будет запущен сервер}
^{# язык сообщений}

^{# set mark updater settings}
^{# порт на котором будет запущен сервис обновления}

^{# module Alco setting}
^{# включить контроль алкокодов}
^{# включить контроль штрихкодов}
^{# включить контроль артикула}
^{# включить контроль аМРЦ}

^{# module Tobacco settings}
^{# включить контроль табака на остатках}

^{# amrc sending settings}
^{# включение выгрузки списка загруженных алкогольных МРЦ в ERP для сверки. (true/false)}
^{# имя пользователя(если необходимо) для авторизации при отправке пакетов со списком аМРЦ. если отсутствует, то без авторизации}
^{# пароль(если необходим) для авторизации при отправке пакетов со списком аМРЦ}
^{# частота отправки сообщений со списком аМРЦ в формате linux-cron}
^{# максимальное число записей в одном запросе}
^{# адрес сервера куда отправлять список загруженных алкогольных МРЦ. Записывается целиком, с протоколом и портом}
^{# ограничение сколько ждем ответа сервера, в мс.}
^{# время до повторной отправки пакета в случае ошибки, в мс.}

^{# reporting settings}
^{# включение выгрузки отчета в ERP о проблемных АМ по таймеру. (true/false)}
^{# имя пользователя(если необходимо) для авторизации при отправке пакетов с сообщениями об ошибках. если отсутствует, то без авторизации}
^{# пароль(если необходим) для авторизации при отправке пакетов с сообщениями об ошибках}
^{# частота отправки сообщений об ошибках, в мс}
^{# максимальное число сообщений об ошибках в одном запросе}
^{# адрес сервера куда отправлять сообщения об ошибках. Записывается целиком, с протоколом и портом}
^{# ограничение сколько ждем ответа сервера, в мс.}

^{# date format}
^{# форматы даты в сообщениях json, если не указан, то timestamp}

^{# database settings}
^{# имя базы данных с которой будем работать}
^{# порт базы данных}
^{# ip базы данных}
^{# имя пользователя для подключения к БД}
^{# пароль для подключения к БД}

^{# logger settings}
^{# уровень логирования}

^{# 'application.properties' version. do not change!}
^{# версия файла настроек. НЕ ДЛЯ РУЧНОГО ИЗМЕНЕНИЯ!}

^Порты:
^{9000 - сервис SetMark (для ERP и касс)}
^{9001 - сервис обновления}
^{5432 - postgres}