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

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

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

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

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

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

Для МКС:

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

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

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

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

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

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), помимо стандартных минимальных требований, находящихся в открытом доступе, нужно оценить размер дискового пространства для хранения своих данных. Общие рекомендации можно прочитать выше, в разделе Системные требования.

Установка КС

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

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

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

Установка 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

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

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

systemctl restart artixcs-rest

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

После установки Puppet на КС необходимо установить 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

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

• Если все компоненты системы установлены на одном сервере, то для обновления кассового сервера выполните команды:

  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

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

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

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

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

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

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

1. Скачать конфигурационный файл 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

2. Получить список всех установленных пакетов Artix на тестовом КС.

   dpkg -l | grep artix

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

   Пример фрагмента файла 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
   ...

4. Сделать снапшот / бэкап тестового КС.

5. Выполнить обновление тестового КС с указанными версиями пакетов из файла /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

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

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

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

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

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

7. Проверить результат обновления.
   

   dpkg -l | grep artix

   Состав пакетов Artix и номера их версий должны соответствовать актуальному файлу /tmp/packages_version.conf.

8. Скопировать актуальный файл /tmp/packages_version.conf на машину, где планируется установка/обновление КС с указанием версий пакетов.

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

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

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

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

   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

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

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

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

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

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

   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