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

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

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

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

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

Адрес сервера лицензирования для получения лицензии на продукт и доставки обновлений можно ввести позже в таблице configuration.

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

Важно: параметры Имя пользователя(администратор) и Пароль(администратор) не используются сервисом 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). Если не указывать, значения по умолчанию нет, не применяется

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

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

sh ./setmark.sh -d=/РАЗДЕЛ -dbuser=ЛОГИН -dbpass=ПАРОЛЬ

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

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