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

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

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

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

...

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

storage:
  wiredTiger:
    engineConfig:
      cacheSizeGB: 1

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

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

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

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

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

  Anchor
  cs_full cs_full

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

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

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

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 httphttps://downloadsupdate.artix.su/static/downloads/dockercs/install_scripts/stable/puppet_env/install_single.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

Установка КС

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

Anchor
cs_update cs_update

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

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

  Code Block
  language

...

• text

  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

  
  

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

  Code Block
  language text
  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

  
  

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

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

...

...

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

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

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

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

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

  
  

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

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

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

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

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

   
   

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

   Code Block
   language text
   dpkg -l | grep artix

   
   

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

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

   Code Block
   language text
   sudo su   curl https://update.artix.su/static/cs/

...

1. install_scripts/

...

1. stable/cs_env/update.sh -o /tmp/update.sh chmod +x /tmp/update.sh

   
   

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

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

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

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

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

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

   Code Block
   language text
   dpkg -l | grep artix

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

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

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

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

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

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

   Code Block
   language text
   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/

...

1. full.sh

...

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

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

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

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

   
   

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

   Code Block
   language text
   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