Быстрый старт

Введение.

В этой инструкции описаны шаги для быстрой установки и старта использования Entaxy.

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

Установка Entaxy.

Установку компактной версии можно выполнить по следующей инструкции: Установка компактной версии.

Настройка Entaxy после установки.

После установки Entaxy сразу готова к работе, имеет универсальный коннектор, преднастроенный маршрут по умолчанию, с подтверждением доставки сообщения. Для того чтобы отправить\получить сообщения, необходимо создать профили, роли систем, а также входящие/исходящие сообщения.

  1. Заходим в консоль управления. В браузере открываем: http://localhost:8181/hawtio/ вводим логин/пароль, по умолчанию: extaxy/entaxy

hawtio logo

  1. Создаем профили систем.

    • Переходим в раздел Entaxy → platform → runtime → profiles → Operations → createProfile.

    • В поля id, name, description вводим значения, например, s1 (сокращение от System 1).

    • Нажимаем кнопку Execute.

    • Повторяем те же действия для создания второй системы, называем ее, например, s2.

create profiles

  1. Создаем логины профилей системы.

    • В разделе profiles открываем папку с именем системы s1.

    • Далее на вкладке Operations находим операцию createAccount, т.к. создаем логин для системы s1, то вводим login/password - s1/s1.

    • Нажимаем кнопку Execute.

    • Аналогичные действия выполняем для второй системы введя login/password - s2/s2.

create account

  1. Создаем коннекторы систем. См. также Подробное описание коннектора.

    • В разделе profiles открываем папку с именем системы s1. Далее на вкладке Operations находим операцию addConnector.

    • Для создания входного коннектора в поле factoryId вводим uniform-service-in-connector, в поле parameters вводим пустое значение {}.

    • Нажимаем кнопку Execute.

    • Для создания исходящего коннектора в поле factoryId вводим uniform-service-out-connector, в поле parameters вводим пустое значение {}.

    • Нажимаем кнопку Execute.

    • Аналогичные действия выполняем и для второй системы.

create connector

Отправка и получение сообщений

Для того чтобы запустить обмен сообщениями между системами, которые были созданы на предыдущем этапе, можно использовать SOAP-запросы в шину.

Инструменты выполнения запросов

У нас уже есть готовые тесты для Postman, с помощью которых можно быстро проверить обмен сообщениями.

  1. Устанавливаем и запускаем Postman.

  2. Скачиваем и импортируем коллекцию тестов (Окружение, Коллекция запросов)

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

Отправка тестовых сообщений

Для отправки тестовых сообщений необходимо выполнить запросы из группы uniform-exchange-connector

  1. SEND - отправка тестового сообщения из системы 1 в систему 2 (если необходимо, то можно посмотреть как сообщение появилось в artemis)

  2. GET - получение тестового сообщения из системы 1 системой 2 (если необходимо, то можно посмотреть как сообщение было получено из artemis)

  3. ACK - отправка подтверждения получения сообщения системы 2 (иначе сообщение будет восстановлено)

postman uniform exchange connector