entaxy-public/documentation/installation/local-installation/local-installation.ru.adoc

246 lines
13 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

= Локальная установка Entaxy на рабочую станцию или сервер.
__Alternative languages:__
* xref:windows-local-installation.adoc[English]
== Введение.
В этой инструкции мы рассмотрим установку Entaxy. Установка на все ОС проходит аналогичным образом и отличается выбором соответствующих инсталляторов или использованием пакетных менеджеров.
== Установка Java.
. Скачиваем и устанавливаем JAVA. Для работы Entaxy рекомендуется Java 11. Работа платформы протестирована на OpenJDK и LibericaJDK от BellSoft (https://libericajdk.ru/pages/downloads/)
. Создаем переменную окружения JAVA_HOME.
. Добавляем абсолютный путь к директории bin в системную переменную окружения PATH.
== Дистрибутивы Entaxy
Сущетсвет несколько вариантов сборок Entaxy, которые доступны по адресу https://entaxy.ru/download
. `entaxy-assembly-compact*` - все-в-одном, брокер, бд и графический веб-интерфейс в одной сборке. См. xref:#_установка_all_in_one [Установка all-in-one]
. `entaxy-assembly*` - сборка без предустановленного графического веб-интерфейса. См. xref:#_установка_без_ui [Установка без UI]
. `entaxy-assembly-with-ui*` - сборка без предустановленного брокера сообщений. См. xref:#_установка_с_внешним_брокером [Установка с внешним брокером]
. Все компоненты устанавливаются отдельно. См. xref:#_покомпонентная_установка [Покомпонентная установка]
== Установка all-in-one
. Распаковываем архив `entaxy-assembly-compact*`
. Распакованный архив лучше перенести в другое место, чтобы абсолютный путь до каталога приложения не был слишком длинным, также необходимо чтобы путь содержал только латинские символы и был без пробелов.
. Переходим в каталог `/bin` приложения и запускаем:
- entaxy - для Linux
- entaxy.bat - для Windows
. Немного ждем и проверяем, что система корректно запустилась см. xref:#_проверка_готовности_системы [Проверка готовности системы]
== Установка без UI
. Распаковываем архив `entaxy-assembly*`
. Распакованный архив лучше перенести в другое место, чтобы абсолютный путь до каталога приложения не был слишком длинным, также необходимо чтобы путь содержал только латинские символы и был без пробелов.
. Переходим в каталог `/bin` приложения и запускаем:
- entaxy - для Linux
- entaxy.bat - для Windows
. Немного ждем и проверяем, что система корректно запустилась см. xref:#_проверка_готовности_системы [Проверка готовности системы]
. Веб-интерфейс можно установить, после запуска системы, командой (в консоли Карафа): `source scripts/entaxy-ui.install`
== Установка с внешним брокером
. Для установки брокера смотрите инструкцию: xref:#_установка_и_настройка_брокера[Установка и настройка брокера]
. Распаковываем архив `entaxy-assembly-with-ui*`
. Распакованный архив лучше перенести в другое место, чтобы абсолютный путь до каталога приложения не был слишком длинным, также необходимо чтобы путь содержал только латинские символы и был без пробелов.
. Переходим в каталог `/bin` приложения и запускаем:
- entaxy - для Linux
- entaxy.bat - для Windows
. Немного ждем и проверяем, что система корректно запустилась см. xref:#_проверка_готовности_системы [Проверка готовности системы]
== Покомпонентная установка
=== Установка и настройка БД.
Entaxy не привязана к какой-либо конкретной СУБД, но по умолчанию используется встроенная H2, в данной инструкции будет показано как установить и настроить систему на работу с БД Postgres.
. Скачиваем инсталятор с официального сайта (https://www.enterprisedb.com/downloads/postgres-postgresql-downloads).
. Запускаем установку. image:image/postgresql-installation-1.jpg[postgresql-installation]
. Оставляем все настройки по умолчанию и устанавливаем пароль `postgres`.
. Запускаем pgAdmin 4 и устанавливаем мастер пароль для приложения `postgres`. image:image/pgadmin-start.jpg[pgadmin-start]
. Добавляем подключение к локальному серверу БД.
. Выбираем доступную базу данных из списка и переходим в Query Tool, в котором выполняем sql запрос:
[source,sql]
----
CREATE USER "entaxy" WITH PASSWORD 'entaxy';
----
image:image/pgadmin-create-user.jpg[pgadmin-create-user]
[start=7]
. Теперь в том же окне по очереди (по одной строчке) выполняем запросы для создания необходимых для Entaxy баз данных.
[source,sql]
----
CREATE DATABASE esb_entaxy;
----
[source,sql]
----
GRANT ALL PRIVILEGES ON DATABASE esb_entaxy TO entaxy;
----
[source,sql]
----
CREATE DATABASE cache;
----
[source,sql]
----
GRANT ALL PRIVILEGES ON DATABASE cache TO entaxy;
----
На этом настройка СУБД завершена.
=== Установка и настройка брокера
В этой инструкции мы рассмотрим использование брокера сообщений Artemis.
. Скачиваем архив с официального сайта (https://activemq.apache.org/components/artemis/download/).
. Распаковываем архив и переходим в директорию bin.
. Запускаем в командной строке создание брокера `artemis create --user entaxy --password entaxy --allow-anonymous $ARTEMIS_HOME/brokers/entaxy-broker`.
. После создания брокера надо открыть файл `$ARTEMIS_HOME/brokers/entaxy-broker/etc/broker.xml` и проверить, что автоматическое удаление очередей и адресов отключено:
[source,xml]
----
<!--default for catch all-->
<address-setting match="#">
<auto-delete-queues>false</auto-delete-queues>
<auto-delete-addresses>false</auto-delete-addresses>
</address-setting>
----
. Запускаем брокер сообщений `$ARTEMIS_HOME/brokers/entaxy-broker/bin/artemis run`
Установка брокера завершена.
=== Установка Entaxy
. xref:#_установка_с_внешним_брокером [Выполняем установку Entaxy без брокера]
. xref:#_настройка_entaxy_на_внешнюю_базы_данных [Перенастраиваем Entaxy на внешнюю БД], установленную на предыдущем шаге.
== Проверка готовности системы
Чтобы проверить, что все сервисы Entaxy готовы к работае, открываем следующий адрес в браузере http://localhost:8181/system/health
При полной готовности система выдаст следующую информацию:
image:image/health-check.png[]
Если при первом запуске Entaxy Connections находится в статусе TEMPORARILY_UNAVAILABLE, необходимо перезапустить Entaxy.
== Настройка Entaxy на внешнюю базу данных
По умолчанию все сборки Entaxy используют встроенную БД H2.
Для того чтобы перенестроить Entaxy на использование внешней БД, нужно выполнить следующие шаги:
В каталоге `/etc` приложения:
. Найти файлы `org.ops4j.datasource-entaxy.esb.cache.cfg` и `org.ops4j.datasource-entaxy.esb.storage.cfg`
. Удалить их или переименовать путем добавления постфикса, например, `*.defaultdb`.
. Найти файлы `org.ops4j.datasource-entaxy.esb.cache.cfg.pg` и `org.ops4j.datasource-entaxy.esb.storage.cfg.pg` и удалить постфикс `.pg` из имени.
. Если при выполнении установки БД были указаны другие данные или была выполненна установка на другом хосте, то вводим соответствующие значения в файлах.
== Тестирование.
Для проверки работоспособности платформы переходим к xref:../../connectors/uniform-exchange-service/tests/postman.adoc[инструкции по тестированию].
== Кластерный запуск Entaxy
По умолчанию Entaxy использует мультикаст для поиска компонентов кластера по сети, необходимо убедиться что настройки вашего оборудования и файервол настроены для широковещания.
Чтобы два и более экземпляра соединились в кластер достаточно их запустить на разных хостах из одной подсети.
=== Настройка статичных адресов узлов кластера
Если требуется указать статичные адреса узлов кластера поиска узлов, то это можно сделать в файле `/etc/hazelcast.xml`
- Выключаем мультикаст `<multicast enabled="false">`
- Включаем ip `<tcp-ip enabled="true">`
например:
[source,xml]
----
<multicast enabled="false">
<multicast-group>224.2.2.3</multicast-group>
<multicast-port>54327</multicast-port>
</multicast>
<tcp-ip enabled="true">
<interface>127.0.0.1</interface>
</tcp-ip>
----
Также можно задавать маски адресов:
[source,xml]
----
<tcp-ip enabled="true">
<interface>192.168.1.*</interface>
</tcp-ip>
----
=== Проверка кластера
Чтобы понимать, что экземпляры соединились в кластер, выполняем следующую команду в одной из консолей карафа: `cluster:node-list`
image:image/cluster-note-list.png[]
=== Запуск нескольких экземпляров на одном хосте
Для того чтобы запустить несколько экземпляров системы на одном хосте, необходимо в файле `etc/entaxy.properties` изменить значения свойств:
- entaxy.rmiRegistryPort
- entaxy.rmiServerPort
- entaxy.jmxmpPort
- entaxy.sshPort
- entaxy.org.osgi.service.http.port
- entaxy.service.port.management
- entaxy.service.port.subscription