Установка и базовая настройка IBM Integration Bus V9

В этой статье мы подробно рассмотрим процесс установки и базовой настройки IBM Integration Bus V9.0.0.2 на ОС Red Hat Enterprise Linux.

Базовая настройка будет включать:

  1. Создание узла интеграции
  2. Создание сервера интеграции
  3. Тюнинг  некоторых параметров сервера интеграции
  4. Настройка вывода системного лога IIB в отдельный журнал
  5. Настройка соединения с БД Oracle
  6. Настройка доступа в IIB Web User Interface: role-based security

Итак, начнем.

Установка IIB V9

Для установки IIB V9.0.0.2 нам потребуются дистрибутив IIB V9.0.0.0 и fix pack 9.0.0.2. Fix pack для IIB – это, по сути, самостоятельный дистрибутив IIB, включающий все необходимое и не требующий предварительной установки базовой версии 9.0.0.0. Однако, из дистрибутива базовой версии нам будут нужны файлы лицензии, но об этом позже.

Все действия производим из-под пользователя root. Сначала создаем группу mqbrkrs и пользователя mqm из-под которого будет работать IIB:

Создаем директорию для размещения дистрибутивов, например:

Копируем в эту директорию дистрибутив IIB V9.0.0.0 и распаковываем его:

Создаем директорию для размещения дистрибутива fix pack 9.0.0.2, копируем его и распаковываем:

Копируем лицензию из дистрибутива базовой версии 9.0.0.0 в дистрибутив FP02:

Запускаем инсталлятор IIB V9.0.0.2 в консольном режиме и следуем его шагам:

После успешной установки IIB, запускаем инсталлятор IBM Integration Bus ODBC Database Extender в консольном режиме и следуем его шагам:

===================================================================
Хозяйке на заметку:

Если при установке появилась ошибка:

То необходимо установить недостающий пакет:

yum install glibc.i686

Если при запуске инсталлятора появилась ошибка:

То необходимо установить:

yum install libgcc.x86_64
yum install libgcc.i686

===================================================================

Опционально устанавливаем IBExplorer:

При запуске IBExplorer может возникнуть ошибка с libgcc_s.so.1, тогда выполняем команду:

После установки всех компонент изменяем владельца и группу на установленных файлах:

chown -R mqm:mqbrkrs /opt/ibm
chown -R mqm:mqbrkrs /var/mqsi

Из под пользователя mqm, “закрепляем” профайл IIB:

Профайл, т.е. запуск mqsiprofile, определяет настройки среды исполнения IIB.

P.S.: Для удаления IIB и его компонентов запустите uninstaller:

/install_dir/Uninstaller/Uninstaller -i console

На этом установка IIB V.9.0.0.2 завершена. Мы установили среду исполнения IIB, инструмент управления, имеющий графический интерфейс –  IBExplorer и ODBC Database Extender для подключения к БД. Теперь перейдем к настройке IIB.

Базовая настройка IBM Integration Bus

1. Создание узла интеграции

Необходимым условием для создания узла интеграции версии 9.0.0.2 является наличие менеджера очередей WebSphere MQ. Создадим узел интеграции MYIIB9:

В нашем примере будет создан узел интеграции MYIIB9 с параметрами:

-q queueManagerName

Имя менеджера очередей. Обязательный параметр. Необходим для связывания создаваемого узла интеграции с существующем менеджером очередей.

-g configurationChangeTimeout

Максимальное время (в секундах, от 10 до 3600), отведенное на выполнение запроса пользователя для изменения конфигурации узла интеграции. Опциональный параметр. Значение по умолчанию: 300 секунд.

-k internalConfigurationTimeout

Максимальное время (в секундах, от 10 до 3600), отведенное на выполнение внутреннего запроса по изменению конфигурации сервера интеграции. Например, это время за которое узел интеграции должен успеть запустить сервер интеграции после получения соответствующей команды. Опциональный параметр. Значение по умолчанию: 60 секунд. Относится ко всем серверам интеграции узла.

-s

Статус административной защиты узла интеграции. Возможные значения: active/inactive. Опциональный параметр.

Подробную информацию о создании узла интеграции с помощью команды можно получить в соответствующем разделе IBM Integration Bus Knowledge Center.

Изменяем функциональный уровень IIB

Активация новых возможностей fix pack 9.0.0.2:

2. Создание сервера интеграции

Для создания сервера интеграции следует воспользоваться командой mqsicreateexecutiongroup:

Хорошая практика в названии сервера интеграции использовать номер внутреннего http порта, который будет присвоен этому серверу. Для того, что бы вывести список всех серверов интеграции узла и их соответствующие состояния, необходимо воспользоваться командой mqsilist:

3. Настройка параметров сервера интеграции

Переключение HTTPInput и HTTPReply nodes с листнера узла интеграции на встроенные листнеры серверов интеграции  (Switching from a broker-wide listener to embedded listeners):

Устанавливаем http-порт для сервера интеграции:

Изменяем размер хипа JVM сервера интеграции (min 256 Mb/max 512 Mb):

После выполненных настроек требуется перезапустить сервер интеграции.

4. Вывод системного лога узла интеграции в отдельный файл 

Системный лог узла интеграции, Administration Log, по умолчанию формируется в /var/log/messages.
Для того, что бы вывести системный лог узла интеграции в отдельный файл необходимо отредактировать /etc/rsyslog.conf.

В секции #### RULES #### добавить user.none:

ниже добавить:

Таким образом мы настроим вывод всех записей содержащих слово “IBM” в журнал /var/log/mqsi/.system/broker.myiib9.log.

Теперь настроим ротацию лога по размеру 20 Мб. Для этого в /etc/logrotate.d создаем файл iib со следующим содержанием:

Создаем пустой лог файл IIB и изменяем его владельца:

После всех настроек необходимо перезапустить rsyslog командой:

service rsyslog restart

Теперь в директории /var/log/mqsi/.system/ будет формироваться системный лог узла интеграции broker.myiib9.log, с ротацией и архивацией журнала по достижении 20 Мб, а так же глубиной хранения 10 архивных файлов.

5. Настройка ODBC подключения к БД Oracle

IBM Integration Bus ODBC Database Extender по умолчанию устанавливается в директорию /opt/ibm/IE02/2.0.1

После его установки необходимо перезапустить Integration Bus:

mqsistop MYIIB9
mqsistart MYIIB9

Затем перейти в каталог:

И скопировать файлы odbc.ini и odbcinst.ini в каталог /var/mqsi/odbc.

Установить права на файлы:

Затем отредактировать bash_profile пользователя mqm, который расположен в директории /var/mqm. В конец файла .bash_profile (или .bashrc) добавляем строки (перед строкой “. /opt/ibm/mqsi/9.0.0.2/bin/mqsiprofile“):

После чего перезапускаем систему, выполнив команду reboot.

После перезагрузки системы редактируем файл /var/mqsi/odbc/odbc.ini. Находим описание подключения к БД Oracle, раздел ORACLEDB:

Копируем или редактируем этот раздел для создания нового источника данных, например:

В самом низу файла, в секции “Mandatory information stanza” прописываем путь к драйверам в параметре InstallDir:

Сохраняем и закрываем файл.

Для многопоточного доступа к БД в файле odbcinst.ini следует добавить параметр Threading=2.

Командой mqsisetdbparms устанавливаем имя пользователя и пароль для подключения к базе:

После этого необходимо перезапустить сервер интеграции, иначе в логах могут быть ошибки:

Проверить соединение c БД можно с помощью команды mqsicvp. Для проверки всех DataSources узла интеграции:

mqsicvp MYIIB9

Для конкретного источника данных, например TEST.DS:

mqsicvp -n TEST.DS -u mqm -p password123

Для удобства, что бы знать где находится файл odbc.ini, в конец файла mqsiprofile добавляем строку “echo $ODBCINI“. Ниже приведен конец файла mqsiprofile :

Настройка подключения к базе данных завершена.

6. Настройка доступа в IIB Web User Interface: role-based security

Ранее мы создали узел интеграции MYIIB9 с выключенной административной защитой. Это означает, что любой пользователь используя веб-браузер может зайти в административный интерфейс узла интеграции (Web User Interface) и выполнять любые действия по изменению конфигурации.

Допустим, нам необходимо ограничить доступ к веб-интерфейсу администрирования IIB для всех пользователей, кроме администраторов.

Для этого в системе создадим специального пользователя-администратора для WebUI, назовем его, например, webadmin:

Затем создадим этого пользователя в IIB (-r – роль/пользователь в системе, -a – пароль):

Останавливаем узел интеграции:

Активируем защиту:

Запускаем узел интеграции:

Теперь доступ в WebUI защищен, а при попытке входа будет отображаться форма для ввода логина/пароля:WebUI

Подробнее о настройке доступа в WebUI можно ознакомиться в статье на DeveloperWorks:

http://www.ibm.com/developerworks/websphere/library/techarticles/1312_fan/1312_fan.html

На этом мы закончим рассматривать вопросы установки и базовой настройки продукта IBM Integration Bus V9.

VN:F [1.9.22_1171]
Rating: 0.0/5 (0 votes cast)
Метки: , , , , ,
Опубликовано в WebSphere Message Broker, Основы, Тюнинг
3 комментария на “Установка и базовая настройка IBM Integration Bus V9
  1. LordHydra:

    Хороший мануал! респект!
    Пара вопросов есть.
    Зачем меняете heap size’ы там по умолчанию -1 везде ну тобишь infinity, если в EG память не течёт, то это излишне точно, я думаю много у кого eg по гигабайту есть.

    На AIXe если сделать вот так “chown -R mqm:mqbrkrs /var/mqm” то mq не запуститься. MQ проверяет владельцев и группу файлов qm.ini, qmstatus.ini, и если там не mqm падает. Ну это так, к слову.

    После прописывания пароля для датасорса, надо рестартать только ту/те eg которые его используют, весь брокер можно не грузить.

    Так же не понял зачем всю железку грузить :)

    VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)
    • Sergey Kirsanov Sergey Kirsanov:

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

      Значение ‘-1′ параметров jvmMinHeapSize и jvmMaxHeapSize, означает, что будет использоваться heap size по умолчанию, который равен 32 MB и 256 MB соответственно.
      При активной работе у EG часто растет потребление памяти, но это не обязательно связано с утечками памяти и размером JVM, а вызвано конструктивными особенностями продукта.
      Подробности тут:
      http://www-01.ibm.com/support/docview.wss?uid=swg21106136

      Причин для увеличения размера хипа может быть несколько. Например, рекомендуется увеличить хип при увеличении во флоу числа Node, написанных на java. При увеличении числа http тредов так же рекомендуется увеличить хип.

      Про “chown -R mqm:mqbrkrs /var/mqm” – спасибо за замечание, исправил.
      Конечно, вместо этой команды должна быть такая:
      chown -R mqm:mqbrkrs /var/mqsi
      И это касается всех Linux/Unix систем.

      По поводу “После прописывания пароля для датасорса, надо рестартать только ту/те eg которые его используют, весь брокер можно не грузить.” – в статье не написано, что нужно перезапускать весь брокер.
      Указано, что нужно перезапустить именно сервер интеграции (EG), а не узел инетграции (broker), цитата:
      “После этого необходимо перезапустить сервер интеграции, иначе…”.

      VN:F [1.9.22_1171]
      Rating: 0 (from 0 votes)
  2. LordHydra:

    По поводу “-1″ это “Акелла промахнулся” 😀 Согласен.
    Парни продолжайте в том же духе.

    VA:F [1.9.22_1171]
    Rating: +3 (from 3 votes)

Добавить комментарий для LordHydra Отменить ответ

Ваш e-mail не будет опубликован. Обязательные поля помечены *

*

Можно использовать следующие HTML-теги и атрибуты: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code class="" title="" data-url=""> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> <pre class="" title="" data-url=""> <span class="" title="" data-url="">

Выбор языка: