С 1 октября 2025 года ИТС поддержка всех программных продуктов Artix на базе операционной системы Ubuntu 18.04 прекращена.

При установке ПО Artix рекомендуется использовать отдельно выделенные физические серверы либо виртуальные машины, работающие под управлением Ubuntu Server (официальная редакция Ubuntu).
Развёртывание ПО Artix в контейнерах Linux (LXC, Docker и аналогичных технологиях контейнеризации на уровне ядра Linux) не допускается.

Начиная с версии #31 при установке Artix Control Center устанавливается MySQL версии 8.0.

Начиная с версии #63 при установке Artix Control Center устанавливается MongoDB:

версии 5.0.32, если процессор поддерживает AVX (расширение набора инструкций),
версии 4.4.30, если процессор не поддерживает AVX.

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

В качестве операционной системы для установки Artix Control Center используется 64-х разрядный дистрибутив Ubuntu 22.04 LTS (ubuntu-22.04.*-server-amd64). Установка на 32-х разрядную версию не предусмотрена. Для установки необходимо интернет-соединение.

Системные требования для установки Artix Control Center:

Для случая один сервер на торговую сеть:

Количество магазинов	Размер справочника товаров	Количество карт	*Процессор вида Intel Xeon E3, количество ядер**	ОЗУ Gb, не менее	Дисковое пространство Gb, не менее**
1-5	50k	100k	2	8	100
5-20	50k	300k	4	8	200
20-50	100k	500k	8	10	500
50-70	100k	1m	8	12	500
70-100	100k	1m	8	16	500
100-500	200k	****	16	32	500***
>500			Индивидуально

Для случая с серверами магазинов:

Для ЦКС (центральный кассовый сервер) системные требования аналогичны системным требованиям для варианта "один сервер на торговую сеть", для случая, когда есть распространение справочников с ЦКС на МКС (магазинный кассовый сервер).

Для МКС:

Размер справочника товаров	*Процессор вида Intel Xeon E3, количество ядер**		ОЗУ Gb, не менее	Дисковое пространство Gb, не менее**
200k	2		8	100***

* В каждом конкретном случае тип процессора и его быстродействие должно уточняться.

** Количество свободного места на диске, имеющегося в наличии, до установки ОС и компонентов.

*** Зависит от срока хранения продаж на сервере.

**** Зависит от использования карт в сети.

Для корректного отображения информации необходимо воспользоваться браузером Google Chrome, разрешение экрана не менее 1366x768.

При установке КС для работы с большим количеством касс (>100) необходимо ознакомиться с рекомендуемыми параметрами MySQL и MongoDB.

По умолчанию размер кэша MongoDB:

не превышает (количество доступной ОЗУ - 1)/2 Gb,
минимальный размер кэша – 256 Mb.

Для настройки лимита необходимо добавить параметр cacheSizeGB в секции wiredTiger файле /etc/mongod.conf:

storage:
  wiredTiger:
    engineConfig:
      cacheSizeGB: 1

Подготовка окружения

Установка кассового сервера производится на предварительно установленную операционную систему. При установке Artix Control Center некоторые пакеты получаются из стандартных репозиториев, поэтому запрещено удалять файл sources.list.

Общие сведения по установке

При установке БД по умолчанию создается пользователь root с паролем root, из-под которого автоматически создаётся пользователь netroot с паролем netroot, необходимый для работы с сервером.

Если на момент начала установки пользователь root уже был создан с паролем, отличным от root, то пользователь netroot не создастся.
Если есть необходимость удалить пользователя root или поменять его пароль, то это делается вручную после установки КС.

Установка КС и БД на одном сервере

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

Данный набор сервисов решает транспортную задачу по обновлению справочников, получению продаж, интеграции с АСТУ и предоставления веб-интерфейса пользователя.

sudo su
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/full.sh -o /tmp/full.sh
chmod +x /tmp/full.sh
/tmp/full.sh

Будут скачаны установочные скрипты, добавлены необходимые репозитории, установлены требуемые зависимости и запущены нужные сервисы.

Установка КС и БД на разных серверах

Раздельная установка предназначена для повышения отказоустойчивости системы в целом:

на одном сервере отказоустойчивость компонентов КС можно реализовать средствами резервного копирования платформы виртуализации,
на другом сервере отказоустойчивость БД можно реализовать штатными средствами репликации и резервного копирования.

В этих случаях система продолжит работу, а вышедший из строя сервер можно будет достаточно быстро восстановить. Особенно при использовании механизма репликации.

Универсального решения по быстрому восстановлению и балансировке нагрузки нет. Подходящая реализация может быть выполнена заказчиком самостоятельно – на основе общедоступных решений и исходя из особенностей его инфраструктуры.

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

Многое зависит от конкретного проекта, поэтому системные требования часто формируются при обсуждении индивидуальных целей и задач. Например, для сервера БД (MySQL или PostgreSQL), помимо стандартных минимальных требований, находящихся в открытом доступе, нужно оценить размер дискового пространства для хранения своих данных. Общие рекомендации можно прочитать выше, в разделе Системные требования.

При росте затрат на дополнительное аппаратное обеспечение, программное обеспечение, необходимое для работы кассового ПО Artix, остается бесплатным.

Установка КС

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

sudo su
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/full_split.sh -o /tmp/full_split.sh
chmod +x /tmp/full_split.sh
/tmp/full_split.sh

Будут скачаны установочные скрипты, добавлены необходимые репозитории, установлены требуемые зависимости и запущены нужные сервисы.

Установка БД

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

sudo su
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/install_db.sh -o /tmp/install_db.sh
chmod +x /tmp/install_db.sh
/tmp/install_db.sh <список_баз_данных_через_пробел>

, где в <список_баз_данных_через_пробел> могут быть указаны mongodb, mysql, pgsql.

Установка и обновление Puppet

Данный набор сервисов, включающий в своем составе Puppet обеспечивает обновление конфигураций касс.

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

Минимальные системные требования для работы с одной кассой:

Количество ядер: 2 CPU
Оперативная память: 512 МБ
Дисковое пространство: 20 ГБ HDD

Многое зависит от конкретного проекта, поэтому системные требования часто формируются при обсуждении индивидуальных целей и задач. Помимо количества касс и минимальных системных требований, нужно учесть производимую ими нагрузку и объем данных, передаваемых на сервер. Для точной настройки конфигурации обратитесь в службу технической поддержки.

Runinterval агенты: 7200
CPU: 14
ОЗУ: 24GB
Дисковое пространство: 120GB SSD
PUPPETSERVER_JAVA_ARGS=-Xms7168m -Xmx7168m
PUPPETSERVER_MAX_ACTIVE_INSTANCES=11

Установка Puppet

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

sudo su
curl https://update.artix.su/static/cs/install_scripts/stable/puppet_env/install.sh -o /tmp/install.sh
chmod +x /tmp/install.sh
/tmp/install.sh

Будет скачан и запущен установочный скрипт.

При установке на один сервер ничего менять не нужно, в значении по умолчанию будет указан один из внутренних адресов.

При установке Puppet-сервера на отдельную машину необходимо указать ip-адрес по которому будет доступен КС.

Если Puppet-сервер установлен на отдельную машину, то необходимо указать его ip-адрес в конфигурационном файле /opt/artixcs-rest/application.properties для следующих настроек:

cashserver.puppet.certificateProxy=<ip-адрес>:8072
cashserver.puppet.validationProxy=<ip-адрес>:8073

После изменения настроек необходимо перезапустить КС командой:

systemctl restart artixcs-rest

В результате будет установлен docker и развернуты образы puppet.

После установки Puppet на КС необходимо установить lsyncd с помощью команд:

Для корректной работы необходимо установить lsyncd на машину вместе с КС.

sudo su
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/install_lsyncd.sh -o /tmp/install_lsyncd.sh
chmod +x /tmp/install_lsyncd.sh
/tmp/install_lsyncd.sh

В процессе установки lsyncd будет предложено указать ip-адрес Puppet-сервера. При установке на один сервер вместе с Puppet ничего менять не нужно, в значении по умолчанию будет указан внутренний адрес.

Для обновления Puppet выполните те же команды, что и при установке.

Обновление КС

Если все компоненты системы установлены на одном сервере, то для обновления кассового сервера выполните команды:
sudo su curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/update.sh -o /tmp/update.sh chmod +x /tmp/update.sh /tmp/update.sh
Если компоненты системы установлены на разных серверах, то для обновления кассового сервера выполните команды:
sudo su curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/update_split.sh -o /tmp/update.sh chmod +x /tmp/update.sh /tmp/update.sh

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

Установка/обновление КС с указанием версий пакетов

Функционал предназначен для воссоздания состава пакетов специально подготовленного тестового КС на другой машине. В результате выполняется установка/обновление КС с версиями пакетов из тестового КС:

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

Установка с указанием версий будет выполнена для пакетов, устанавливаемых скриптом full.sh. Полный перечень пакетов, устанавливаемых скриптом, приведен в статье "Список пакетов и образов".

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

Подготовка конфигурационного файла

Для возможности установки/обновления с указанием версий пакетов необходимо:

Скачать конфигурационный файл packages_version.conf.

sudo su  
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/packages_version.conf -o /tmp/packages_version.conf

Получить список всех установленных пакетов Artix на тестовом КС.
dpkg -l | grep artix

В файле /tmp/packages_version.conf указать версии для установленных пакетов из полученного списка. При необходимости нужно добавить недостающие пакеты вручную с указанием их версий.

# mono
artixcs-rest=4.0.53
artix-cs-nes=3.0.131
artix-cs-exchangers=3.0.131
artixcs-config=4.0.46
# split
#artixcs-rest-split=
# Прочие пакеты
artixcs-apt-config=1.0.2
...
artixcs-processed=4.0.18
artixcs-sales-loader=0.1.45
...

Сделать снапшот / бэкап тестового КС.
Выполнить обновление тестового КС с указанными версиями пакетов из файла /tmp/packages_version.conf.
sudo su curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/update.sh -o /tmp/update.sh chmod +x /tmp/update.sh

После обновления могут быть автоматически установлены или удалены пакеты/зависимости, отсутствующие в списке всех установленных пакетов Artix на тестовом КС.

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

Если требуется зафиксировать версии или избежать удаления пакетов, отсутствующих в списке, то необходимо:

добавить в файл /tmp/packages_version.conf недостающие пакеты вручную с указанием их версий.
откатиться к предыдущему состоянию кассового сервера.
выполнить обновление с дополненным файлом /tmp/packages_version.conf.

Проверить результат обновления.
dpkg -l | grep artix
Состав пакетов Artix и номера их версий должны соответствовать актуальному файлу /tmp/packages_version.conf.
Скопировать актуальный файл /tmp/packages_version.conf на машину, где планируется установка/обновление КС с указанием версий пакетов.

Установка КС с указанием версий пакетов

Перед установкой рекомендуется сделать снапшот / бэкап.

Если для пакета в /tmp/packages_version.conf не указана версия или закомментировано название пакета, то будет установлена последняя версия пакета.

Для пакетов, которые устанавливаются вручную, отдельно от скрипта full.sh, установка с указанием версий не поддержана.

artixcs-accounting-bonuses
artixcs-accounting-bonuses-certificates
artixcs-accounting-certificates
artixcs-accounting-coupons
artixcs-accounting-scheduled-impacts
artixcs-counter
artixcs-datatransfer
artixcs-consultant-app
artixcs-accounting-event-notifier
artixcs-online-card
artixcs-online-shop
artixcs-issuance-card
artixcs-private-office
artix-cs-db-trimmer
artix-cs-zabbix
artixcs-config
artixcs-puppet-objects
artixcs-middle
artixcs-central

Для установки необходимо:

В файле /tmp/packages_version.conf, скопированном с подготовленного тестового КС, проверить версии пакетов, которые должны быть установлены. При необходимости нужно добавить недостающие пакеты вручную с указанием их версий.

Скачать и запустить скрипт установки:

sudo su  
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/full.sh -o /tmp/full.sh
chmod +x /tmp/full.sh
/tmp/full.sh

Обновление КС с указанием версий пакетов

Перед обновлением рекомендуется сделать снапшот / бэкап.

Для обновления необходимо:

В файле /tmp/packages_version.conf, скопированном с подготовленного тестового КС, проверить версии пакетов, которые должны быть обновлены. При необходимости нужно добавить недостающие пакеты вручную с указанием их версий.

Если для обновляемого пакета не указана версия (или он вообще не указан в файле), то при обновлении будут удалены все зависящие от него пакеты.

Скачать и запустить скрипт обновления:

sudo su  
curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/update.sh -o /tmp/update.sh
chmod +x /tmp/update.sh
/tmp/update.sh