ELMA365 On-Premises > ELMA365 On-Premises Standard / Установка ELMA365 Standard

Установка ELMA365 Standard

ELMA365 редакции Standard можно установить в Kubernetes-in-Docker (KinD). Данный вариант установки наиболее прост и позволяет запускать локальный кластер Kubernetes с использованием узла Docker контейнера.

Установка состоит из трёх этапов:

  1. Подготовка инфраструктуры.
  2. Установка Docker на вашу операционную систему.
  3. Скачивание скрипта установки и заполнение конфигурационного файла.
  4. Запуск скрипта установки.

Перед началом установки ознакомьтесь с системными требованиями ELMA365 On-Premises Standard.

on-premises-standard-1

Шаг 1: Подготовка инфраструктуры

Под инфраструктурой понимаются необходимые для работы приложения ELMA365 On-Premises компоненты.

начало внимание

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

конец внимание

Компоненты необходимые для работы приложения ELMA365 On-Premises:

  • Kubernetes-кластер;
  • PostgreSQL;
  • MongoDB;
  • RabbitMQ;
  • Redis;
  • S3 (MinIO).

Встроенные компоненты хранения данных подходят для ознакомительных целей и в особых случаях для организации платформ тестирования и разработки. Если в дополнительных параметрах установки не заданы параметры подключения к внешним базам данных и S3-хранилищу, то автоматически будут использованы встроенные компоненты хранения данных (PostgreSQL, MongoDB, RabbitMQ, Redis, MinIO).

В рамках статьи база данных PostgreSQL и объектное хранилище S3 будут внешними. Подробнее о том, как развернуть базу данных и объектное хранилище читайте в статьях: «PostgreSQL» и «MinIO (S3)».

Для подключения к PostgreSQL и MinIO (S3) используются стандартные строки подключения и пароли.

Шаг 2: Установка Docker

Установите Docker для вашей операционной системы.

начало внимание

Обратите внимание, KinD не поддерживает создание Kubernetes-кластера с Cgroups v2. Подробнее о возможных ошибках читайте в документации.

конец внимание

Шаг 3: Скачивание скрипта установки и заполнение конфигурационного файла

При первом запуске скрипт установки создаст файл конфигурации с наименованием config-elma365.txt в каталоге, откуда он был запущен.

  1. Скачайте и запустите скрипт установки ELMA365 для создания конфигурационного файла, выполнив следующую команду:

sudo curl -fsSL -o elma365-installer-docker.sh https://dl.elma365.com/onPremise/master/latest/installer-docker && \
sudo chmod +x elma365-installer-docker.sh && \
sudo ./elma365-installer-docker.sh

начало внимание

Для создания нового стартового (default) файла конфигурации переименуйте существующий файл конфигурации config-elma365.txt и запустите скрипт установки с ключом --new-config.

конец внимание

  1. Внесите изменения в подготовленный скриптом установки конфигурационный файл config-elma365.txt.
  1. Для быстрого старта приложения ELMA365 Standard раскомментируйте и заполните необходимые переменные.

Заполнение основных параметров в конфигурационном файле config-elma365.txt может выглядеть следующим образом:

kubernetes-in-docker-2

Где:

  • ELMA365_HOST=192.168.1.103 IP-адрес хостовой машины, по которому будет доступно приложение ELMA365 Standard. Подробнее о создании домена (FQDN) читайте в «Изменение параметров ELMA365 Standard»;
  • ELMA365_EMAIL=admin@mail.com — адрес электронной почты администратора;
  • ELMA365_PASSWORD=test — пароль администратора;
  • ELMA365_LANGUAGE=ru-RU — язык установленной системы.

начало внимание

Если Docker установлен через Snap, в файле конфигурации необходимо раскомментировать и изменить пути до папок/каталогов для параметров: ELMA365_INSTALL_DIR, ELMA365_BACKUP_DIR, например, на:

  • ELMA365_INSTALL_DIR=/mnt/elma365/docker;
  • ELMA365_BACKUP_DIR=/mnt/elma365/backup.

конец внимание

  1. Настройте подключение к внешним базам данных и объектному хранилищу S3.

Важно: встроенные компоненты хранения данных подходят для ознакомительных целей и в особых случаях для организации платформ тестирования и разработки. Если в дополнительных параметрах установки не заданы параметры подключения к внешним базам данных и S3-хранилищу, то автоматически будут использованы встроенные компоненты хранения данных (PostgreSQL, MongoDB, RabbitMQ, Redis, MinIO).

Для подключения к внешней базе данных PostgreSQL расскоментируйте и заполните параметр ELMA365_DB_PSQL, указав строку подключения, полученную при выполнении установки PostgreSQL в шаге 6.

Пример настройки подключения:

kubernetes-in-docker-7

Расскоментируем и зададим для подключения к S3:

  • параметры ELMA365_DB_S3_ADDRESS, ELMA365_DB_S3_BUCKET, ELMA365_DB_S3_USER, ELMA365_DB_S3_PASSWORD, ELMA365_DB_S3_REGION, ELMA365_DB_S3_METHOD, ELMA365_DB_S3_SSL. Значения параметров подключения получим при выполнении установки MinIO (S3) в шаге 10;
  • параметр ELMA365_DB_S3_GATEWAY переведём в значение true для включения проксирования подключений к S3 через ELMA365.

Пример заполнения параметров:

kubernetes-in-docker-8

Заполнение переменных подключения к proxy-серверу

Подробнее о параметрах конфигурационного файла config-elma365.txt читайте в статье «Изменение параметров ELMA365 Standard».

Шаг 4: Запуск скрипта установки ELMA365 Standard

Объём загружаемых файлов во время установки ELMA365 Standard составляет 4-5 ГБ, время установки занимает 10-15 минут.

  1. Запустите загруженный ранее скрипт установки с помощью команды:

sudo ./elma365-installer-docker.sh

По окончании установки в скрипте отобразится сообщение об успешной установке приложения ELMA365 Standard.

kubernetes-in-docker-3

  1. Запустите браузер и откройте страницу входа в приложение ELMA365 Standard по адресу http://ELMA365_HOST. Параметр ELMA365_HOST был указан в файле конфигурации config-elma365.txt на шаге скачивания скрипта установки и заполнения конфигурационного файла.

В представленном примере используется следующий адрес страницы входа в приложение ELMA365 Standard: http://192.168.1.103

kubernetes-in-docker-4

  1. В качестве логина и пароля укажите адрес электронной почты администратора и пароль, который использовался в файле конфигурации config-elma365.txt в параметрах ELMA365_EMAIL и ELMA365_PASSWORD.

В приведённом примере используются:

  • Логинadmin@mail.com;
  • Парольtest.
  1. Нажмите кнопку Войти в систему.

Откроется окно активации системы ELMA365.

  1. Активируйте систему. Подробнее об этом читайте в статье «Активация On-Premises».

Установка приложения ELMA365 редакции Standard успешно закончена.

Начало внимание

Сохраните файл config-elma365.txt для последующих обновлений.

Конец внимание