search string side menu

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

Установка ELMA365 Standard

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

С 30.05.2024 заблокирован доступ из РФ к Docker Hub. Ознакомьтесь с официальным заявлением компании.

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

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 компоненты:

  • Docker;
  • 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-docker.sh https://dl.elma365.com/onPremise/latest/elma365-docker-latest && \
sudo chmod +x elma365-docker.sh && \
sudo ./elma365-docker.sh

Адреса для загрузки других версий ELMA365 перечислены в статье «Ссылки для скачивания дистрибутивов ELMA365».

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

Для создания нового стартового (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-серверу

Чтобы использовать ваш proxy-сервер для установки и работы ELMA365 Standard, раскомментируйте и заполните переменные секции Настройка режима работы сервера ELMA365 через прокси-сервер в конфигурационном файле config-elma365.txt.
 

Пример для ELMA365_HOST=192.168.1.103:
 

# -------------------------------------------------------------
# Настройка режима работы сервера ELMA365 через прокси-сервер
# -------------------------------------------------------------
HTTPS_PROXY=http://proxy_user:proxy_pass@host:port/
HTTP_PROXY=http://proxy_user:proxy_pass@host:port/
NO_PROXY=localhost,192.168.1.103,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/12,
cluster.local,linkerd.svc
https_proxy=http://proxy_user:proxy_pass@host:port/
http_proxy=http://proxy_user:proxy_pass@host:port/
no_proxy=localhost,192.168.1.103,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/12,
cluster.local,linkerd.svc

 
Пример для ELMA365_HOST=example.com:
 

# -------------------------------------------------------------
# Настройка режима работы сервера ELMA365 через прокси-сервер
# -------------------------------------------------------------
HTTPS_PROXY=http://proxy_user:proxy_pass@host:port/
HTTP_PROXY=http://proxy_user:proxy_pass@host:port/
NO_PROXY=localhost,example.com,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/12,
cluster.local,linkerd.svc
https_proxy=http://proxy_user:proxy_pass@host:port/
http_proxy=http://proxy_user:proxy_pass@host:port/
no_proxy=localhost,example.com,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/

 

где:

  • proxy_user — имя пользователя для авторизации на proxy‑сервере;
  • proxy_pass — пароль для авторизации на proxy‑сервере;
  • host — хост используемого proxy‑сервера;
  • port — порт используемого proxy‑сервера.

Убедитесь, что в переменных no_proxy и NO_PROXY указаны сетевые адреса диапазоны сетевых адресов и домены, которые нужно исключить из использования proxy.

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

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

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

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

sudo ./elma365-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 для последующих обновлений.

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

elma365-standard-trial-version.html install-kind-offline.html