Установка WebSphere MQ на платформе Windows NT

Рассмотрим порядок установки WebSphere MQ на платформе WindowsNT. Процесс установки построен таким образом, что инсталляцию может выполнить пользователь, никогда ранее не работавший с данным продуктом. WebSphere MQ не является требовательным программным обеспечением (ПО) по отношению к аппаратной части компьютера. Несмотря на это, вряд ли стоит планировать серьезную работу на низко производительных системах. К примеру, для платформы Windows NT вполне достаточно компьютера на базе процессора Pentium IV c тактовой частотой не менее 1000 MHz и ОЗУ 512 Мб. Минимальные и рекомендуемые параметры приведены в Таблице 2.1.

Приведенные цифры касаются требований самого WebSphere MQ и не учитывают потребностей операционной системы. Количество используемой оперативной памяти будет возрастать незначительно с появлением таких новых объектов как очереди, каналы, процессы, но на каждый Trigger Monitor потребуется дополнительно по 3Мбт.

На компьютере для инсталляции WebSphere MQ необходимо установить следующие программные продукты или их более поздние версии:

• Microsoft Internet Explorer 4.01+SP1;
• Microsoft HTML Help 1.3;
• Microsoft MMC 1.1;
• Microsoft Active Directory Client Extensions;
• Microsoft Installer MSI 2.0;
• 128-bit Strength Encryption;
• Supported JAVA Runtime Environment 1.3.

Для начала инсталляции необходимо, в зависимости от комплекта поставки, запустить файл запуска программы установки и следовать инструкциям, появляющимся на экране. После сообщений о подготовке и начале установки должно появиться меню (рис.2.1), в котором нужно последовательно выполнить пункты:

1. Software Prerequisites – проверка установки необходимого ПО на компьютере;
2. Network Prerequisites – варианты работы с использованием домена или без (рекомендуется не использовать работу в домене, т.е. на вопрос об использовании специального домена ответить «No»);
3. WebSphere MQ Installation – собственно, начало инсталляции – необходимо нажать кнопку «Launch WebSphere MQ Installer».

Рис. 2.1.  Меню установки WebSphere MQ

После очередного приглашения к началу инсталляции и принятия соглашения о Лицензиях появится меню с выбором вариантов установки Typical, Compact или Custom. Выбираем Typical – наиболее простой и надежный способ установки. При этом установка будет произведена на C:\Program Files\IBM\WebSphere MQ. Возможность изменения каталога и диска установки реализована в способе Custom.

После появления информации о готовности к началу установки появится вопрос о наличии лицензии, на который необходимо ответить «Yes». После этого начнется процесс копирования файлов с инсталляционного диска на ваш компьютер, который закончится сообщением об успешной установке (рис.2.2).

Рис. 2.2.  Окончание процесса установки WebSphere MQ

После нажатия на кнопку «Finish» будет предложено сконфигурировать WebSphere MQ для работы в вашей сети или перенести существующие менеджеры очередей, оставшиеся от предыдущей версии. На вопрос об использовании домена следует ответить «No». Экранную форму с предложением об установке параметров по умолчанию рекомендуется пропустить, так как и без этого программа установки успешно завершит работу, а на создании и конфигурации объектов WebSphere MQ мы остановимся подробнее в последующих разделах. После появления последней экранной формы (рис.2.3) и нажатия кнопки «Готово» процесс установки завершается.

Рис. 2.3.  Окончание процесса установки и конфигурации WebSphere MQ

В результате установки мы получаем несколько инструментов для работы с WebSphere MQ (рис.2.4):

• First Steps – позволяет запускать различные приложения WebSphere MQ, такие как конфигурация менеджера очередей по умолчанию (Default Configuration); обзор возможностей (Quick Tour); обмен Postcard сообщениями; запуск WebSphere MQ Explorer; запуск утилиты API-Exerciser, позволяющей детально рассмотреть этапы подключения к менеджеру очередей и создания различных вариантов сообщений и запуска программы-справочника (Help Center);
• Help Center – справка WebSphere MQ;
• Prepare WebSphere MQ Wizard – утилита, позволяющая произвести инсталляцию/деинсталляцию WebSphere MQ;
• WebSphere MQ Explorer – утилита создания и управления объектами WebSphere MQ как на локальных, так и на удаленных менеджерах очередей;
• WebSphere MQ Services - утилита создания и управления сервисами WebSphere MQ.

Рис. 2.4.  Основные инструменты работы с WebSphere MQ

Прежде чем перейти к описанию работы с вышеуказанными утилитами рассмотрим процесс деинсталляции WebSphere MQ. Можно отметить, что в ходе многолетней эксплуатации авторам не приходилось производить переустановку WebSphere MQ в системах промышленной эксплуатации, что говорит о высокой надежности работы. Тем не менее предлагается следующий алгоритм переустановки WebSphere MQ:

• Остановить все программы, помещающие сообщения в очереди;
• Остановить все Receiver и Requester каналы, чтобы остановить потоки входящих сообщений;
• Убедиться в отсутствии в очередях сообщений, подлежащих обработке;
• Перевести тип запуска сервиса IBM MQSeries (предыдущая версия данного ПО называлась именно так, и не смотря на то, что устанавливается WebSphere MQ, сервис называется именно IBM MQSeries) из автоматического (Auto) в ручной (Manual);
• Перезагрузить компьютер;
• Произвести удаление программы IBM WebSphere MQ из Панели управления\Установка и удаление программ;
• Удалить папку C:\Program Files\IBM\WebSphere MQ.
• Удалить из переменных окружения ссылки на WebSphere MQ.
• Удалить группу mqm.

Основные утилиты

Рассмотрим подробнее работу основных утилит WebSphere MQ.

First Steps. Главное меню утилиты First Steps представлено на рис.2.5.

Default Configuration. Пункт меню посвящен настройкам по умолчанию. Рассматривать его не будем, так как в дальнейшем дадим подробное описание объектов WebSphere MQ и скажем о параметрах по умолчанию для каждого объекта, а также будет рассмотрен вопрос о том, как задать один раз значение по умолчанию, чтобы все объекты в дальнейшем создавались именно с этим параметром.

Рис. 2.5.  Главное меню утилиты First Steps

Quick Tour. Справочная информация о WebSphere MQ, введение, инсталляция/деинсталляция, совместимость, основные утилиты, работа с компонентами WebSphere MQ: менеджеры очередей, кластеры, очереди, каналы и пр.

Postcard. Утилита, позволяющая передавать сообщения между компьютерами, на которых установлено WebSphere MQ. Нужно сразу оговориться, что применима она только для менеджеров очередей, объединенных в кластер, и существует не для промышленной эксплуатации, а скорее для проверки установки соединения. Для передачи сообщения нужно ввести своё имя, далее имя адресата и имя менеджера очередей, куда необходимо передать сообщение. Адресат может прочитать сообщение, также запустив Postcard на своем компьютере. После выхода из Postcard сообщения не сохраняются.

WebSphere MQ Explorer. Основной продукт, позволяющий создавать и модифицировать объекты WebSphere MQ. Внешний вид представлен на рис. 2.6 и являет собой оснастку (snap-in) консоли управления Microsoft.

В левой части можно видеть список менеджеров очередей, доступных для управления и их объекты. В зависимости от позиционирования курсора в левой части на различных объектах, в правой части оснастки будут отображаться списки объектов и их свойства. Кроме этого, в верхней части имеются панели управления и панели инструментов такие как: «Стандартные меню (Действие и Вид)», стандартная панель инструментов и панель инструментов WebSphere MQ. Работа со «Стандартным меню (Действие и Вид) описана во многих справочных руководствах по работе с Microsoft Windows и не представляет особого интереса. Кратко можно сказать, что используя эти меню можно добавлять или удалять различные оснастки для консоли управления и изменять ее вид. В стандартной панели инструментов имеются две кнопки представляющие интерес в части работы с объектами WebSphere MQ. Это кнопка обновления информации и кнопка экспорта списка. Информация, отображающаяся как в левой, так и в правой части WebSphere MQ Explorer статична, т.е. отображает состояние объектов в конкретный момент времени. Для получения текущего состояния объекта необходимо нажать кнопку обновления информации (Refresh). Информация будет обновляться об объекте, на котором позиционирован курсор, то есть если он установлен в левой части на «Queues», то в правой части произойдет обновление информации о состоянии всех очередей, а если курсор будет установлен на одну очередь в правой части WebSphere MQ Explorer, то информация обновится только об этой очереди. С помощью кнопки экспорта списка можно вывести всю информацию об объектах в текстовый файл. Этим удобно пользоваться для анализа состояния объектов менеджера очередей WebSphere MQ, например, легко выяснить, какие каналы используют одну и ту же трансмиссионную очередь и устранить эту "опасную настройку". Используя кнопки панели инструментов WebSphere MQ Explorer можно скрывать или отображать различные типы объектов менеджеров очередей. Например, информация о состоянии временных очередей и системных объектах не так важна и актуальна, и ее можно убрать с экрана или добавить с помощью кнопок

В WebSphere MQ Explorer имеется возможность сортировки списка отображаемых объектов в алфавитном порядке. Для сортировки очередей по названию необходимо нажать на поле «Name». Для сортировки по типу - на поле «Queue Type», по количеству сообщений – на «Current Depth» и так далее. Повторное нажатие на данные поля приведет к рекурсивному (обратному) отображению, то есть, если повторно нажать на поле «Name», то список очередей будет построен в порядке обратном алфавитному.

С помощью WebSphere MQ Explorer можно создавать, модифицировать, удалять и управлять объектами менеджеров очередей. Вызвав контекстное меню для каждой группы или для одного объекта с помощью правой кнопки мыши, мы получим набор команд, характерных для каждого конкретного объекта. Для очередей это могут быть команды создания, изменения свойств, добавление очереди в кластер, помещения тестовых сообщений, просмотр статуса очереди или первых двухсот сообщений очереди, удаления всех сообщений из очереди и удаления самой очереди. Для каналов соответственно команды создания, удаления, модификации и остановки, инициализации и старта. Для процессов – создания, модификации и удаления. Команд на старт или остановку процессов не существует, так как процессы стартуют по определенным правилам, о которых будет сказано ниже.

Для подключения к удаленному менеджеру очередей необходимо вызвать контекстное меню из группы «Queue Managers» и выполнить пункт «Show Queue Manager...». В появившейся форме выставить флажок «Show a remote queue manager» и заполнить поля «Queue Manager Name» (имя удаленного менеджера) и «Connection Name» - IP адрес или имя компьютера с указанием в скобках номера порта для службы Listener (по умолчанию 1414). Подключение к менеджеру возможно в том случае, если пользователь обладает соответствующими правами на удаленном компьютере.

Рис. 2.6.  WebSphere MQ Explorer

Подробные действия для создания и управления объектами WebSphere MQ как с помощью WebSphere MQ Explorer, так и с помощью команд MQSC (MQSeries commands) будет рассмотрено ниже.

API Exerciser. Утилита, позволяющая пошагово выполнять действия, связанные с обработкой сообщений в существующих очередях. Выполняя каждый шаг (подключение к менеджеру, открытие очереди, помещение или считывание сообщения из очереди, закрытие очереди и отключение от менеджера) вы имеете возможность видеть результаты работы той или иной команды в окне статуса, что позволяет избежать ошибок. Кроме этого имеется расширенный режим работы для формирования сообщений сложных форматов.

Help Center. Данный пункт меню вызывает справочную систему WebSphere MQ, в которой имеется глоссарий и возможность поиска информации по ключевым словам.

Менеджер очередей

Менеджер очередей – совокупность объектов WebSphere MQ (различных видов очередей, каналов, процессов, сервисов или служб). Он осуществляет контроль и управление всеми его объектами и обрабатывает поступающие запросы от прикладных программ.

Для создания любого объекта WebSphere MQ, и менеджера очередей в частности, существует два основных способа: на основе команд и графический, работающий в среде Windows. Создание объектов и работа с ними на основе команд является универсальным способом, работающим на различных платформах с одним и тем же синтаксисом этих команд. Поэтому создание менеджера очередей рассмотрим прежде всего с помощью команды crtmqm.

Итак, для платформы NT необходимо ввести в командной строке:

crtmqm /u DEAD_LETTER QM_Win2000

где:

/u или -u – опция, говорящая о том, что далее будет создана очередь недоставленных сообщений (подробнее см. лекцию 7);

DEAD_LETTER – имя очереди недоставленных сообщений;

QM_Win2000 – имя менеджера очередей.

Подробное описание утилиты runmqsc и работы с основными командами MQSC будет рассмотрено ниже. Имя менеджера очередей не является уникальным в пределах сети, но на одном компьютере не может быть двух менеджеров с одинаковым именем.

Для платформы UNIX синтаксис команды выглядит следующим образом:

crtmqm -u DEAD_LETTER QM_HP_UNIX

Данная команда, как и опция –u должна быть введена в нижнем регистре и именно со знаком «-» (-U работать не будет).

Также для успешного создания/изменения любого объекта необходимо обладать соответствующими правами. Так, например, WindowsNT пользователь, от имени которого вводится команда, должен быть членом группы mqm. Подробнее о вопросах авторизации см. в лекции 5.

Полный синтаксис команды crtmqm имеет вид:

crtmqm –c Text –d DefaultTransmissionQueue 
–h MaximumHandleLimit –lc(или -ll) 
–ld LogPath –lf LogFileSize –lp LogPrimaryFiles 
–ls LogSecondaryFiles –q –g ApplicationGroup 
–t IntervalValue –u DeadLetterQueue 
–x  MaximumUncommittedMessages –z MQMName

Опции команды crtmqm означают следующее.

–c Text - Описание (description) или комментарий, можно ввести до 64 символов.

–d DefaultTransmissionQueue - Транспортная (transmission) очередь по умолчанию. В эту очередь будут попадать сообщения, для которых значение Transmission Queue явно не определено и это имеет свой смысл. При возникновении данной ситуации выгоднее получить сформировавшееся сообщение в DEAD_LETTER, так как имеется ряд способов извлечения или повторной отправки сообщений из DEAD_LETTER по назначению.

–h MaximumHandleLimit - Максимальное количество открытых объектов (командой MQOPEN). Значение может быть в пределах от 1 до 999 999 999, по умолчанию 256 (если не планируется работа одного приложения с более чем 256 объектами на одном менеджере, а авторы настоятельно не рекомендуют этого делать за исключением работы с distribution list, то следует оставить значение по умолчанию, т.е. 256);

–lc - Используется «круговое» логирование. При этом восстановление состояния менеджера очередей в определенный период невозможно, то есть если «упал» сервер, то сохраняются только те объекты и сообщения, которые существовали в момент «падения».

Данное значение (lc) используется по умолчанию.

–ll - Используется «линейное» логирование. При данном типе логирования возможно восстановление данных. Указав тип логирования при создании менеджера в дальнейшем нельзя его изменить.

–ld LogPath - Указывается путь, где будут создаваться файлы логирования. Для UNIX по умолчанию это var/mqm/log. Пользователь и группа mqm должны иметь соответствующие права в этом каталоге. Соответственно, при изменении пути необходимо также предоставить соответствующие права для вышеуказанных пользователей.

Для NT по умолчанию – C:\Program Files\IBM\WebSphere MQ\log

–lf LogFileSize - Размер файла логирования. Файл будет создан с размером в 4 раза большим указанного числа. Значение может быть в диапазоне между 32 и 4095 для NT, OS/2 Warp и между 64 и 16384 для UNIX. Значение по умолчанию для NT и OS/2 Warp равно 256 для UNIX – 1024.

–lp LogPrimaryFiles - Количество первичных файлов логирования. Может быть в пределах от 2 до 62. Значение по умолчанию – 3.

–ls LogSecondaryFiles - Количество вторичных файлов логирования. Может быть в пределах от 1 до 61. Значение по умолчанию – 2.

Следует соизмерять размеры файлов с возможностями операционных систем.

–q - Если указана опция –q, то созданный менеджер очередей будет создан как менеджер по умолчанию.

–g ApplicationGroup - Опция применима только для AIX, Sun-Solaris и HP-UX. Указывается имя группы, которой разрешается запускать MQI приложения, работать с файловой системой менеджера очередей.

–t IntervalValue - Определяет время интервала триггеринга очередей в миллисекундах. Значение может быть в пределах от 0 до 999 999 999 (более 11 дней). Подробнее о триггеринге см. в лекции 4.

–u DeadLetterQueue - Имя очереди недоставленных сообщений.

–x MaximumUncommittedMessages - Максимальное количество сообщений, которые могут находиться в очередях и транзакции по их отправке еще не завершились. Значение может быть в пределах от 0 до 999 999 999. По умолчанию – 10000.

–z - Запрещает появление сообщений об ошибках. Настоятельно не рекомендуется использовать данную опцию, т.к. при возникновении проблем не будет достаточной информации об ошибках

MQMName - Имя менеджера.

Возможные ошибки при создании менеджера очередей отражены в документации [7]. Этой книгой " WebSphere MQ. Messages" рекомендуется пользоваться всегда, как только будет получен код ошибки AMQxxxx.

Существует еще один важный параметр CCSID – кодовая страница менеджера. При создании менеджеров на разных серверных платформах и в разных операционных системах кодовые страницы могут отличаться. Для того чтобы исключить процедуру конвертации при передаче сообщений между менеджерами с разными кодовыми страницами рекомендуется на всех менеджерах установить одну и ту же кодовую страницу, например 1251. У WebSphere MQ существует множество таблиц перекодировки, с помощью которых осуществляется конвертация сообщений. Данные таблицы находятся в каталоге C:\Program Files\IBM\WebSphere MQ\conv\table. Если нет соответствующей таблицы перекодировки, то существует вероятность, что соединение между менеджерами очередей будет невозможно.

Просмотреть и изменить текущую кодовую страницу можно с помощью утилиты runmqsc.exe и соответствующих команд в ней, например, alter qmgr force ccsid(1251). Итак, используя простейший синтаксис :

crtmqm /u DEAD_LETTER QM_Win2000

можно создать менеджер QM_Win2000. Затем следует его активизировать (стартовать).

Для этого существует утилита strmqm:

strmqm –c –z MQMName

где:

-c - При указании этой опции менеджер стартует, пересоздает все системные объекты с параметрами по умолчанию и затем останавливается.

-z - Запрещает появление сообщений об ошибках. Использовать ее не рекомендуется.

MQMName - Имя менеджера.

Для простого старта менеджера по умолчанию достаточно набрать в командной строке:

strmqm

Для остановки менеджера очередей существует утилита endmqm:

endmqm –c/-w/-i/-p –z MQMName

где:

-c - Менеджер остановится только после того, как все приложения, работающие с объектами WebSphere MQ «отсоединятся» от самих объектов, то есть ни один объект не будет «захвачен» приложениями. Причем менеджер будет ждать, пока не выполнятся все запросы (действия) приложений. При выполнении команды с этой опцией управление сразу же передается командной строке и не выдается никаких сообщений об остановке.

-w - Практически то же, что и с опцией –с, за исключением того, что пока менеджер останавливается, управление не передается командной строке, а выводится сообщение «Waiting for queue manager MQMName to end».

-i - Менеджер выполнит все текущие запросы приложений и остановится. Если в процессе остановки появятся новые запросы и необработанные транзакции, то при последующем старте менеджера произойдет откат незавершенных транзакций. Управление передается командной строке после остановки менеджера.

-p - Немедленная остановка. Менеджер остановится, не обрабатывая все текущие транзакции и запросы приложений. Остановка с данной опцией может привести к непредсказуемым результатам. Все процессы WebSphere MQ, которые не могут быть корректно остановлены в течение 30 секунд после начала работы endmqm будут отключены.

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

И последняя команда – удаление менеджера:

dltmqm –z MQMName

где:

-z - Запрещает появление сообщений об ошибках. Использовать ее не рекомендуется.

MQMName - Имя менеджера.

При выполнении этой команды удаляется не только менеджер, но и все его объекты. Перед удалением менеджера следует его остановить с помощью команды endmqm. Важно, чтобы в момент удаления менеджера, каталог с содержимым менеджера (для WindowsNT это - C:\Program Files\IBM\WebSphere MQ\Qmgrs\QM_Win2000) не был никем «захвачен», иначе удалить менеджер невозможно.

Управлять работой менеджеров очередей можно с помощью WebSphere MQ Explorer.

Процесс создания менеджера:

1. Запустить WebSphere MQ Explorer.
2. Щелкнуть правой кнопкой мыши по "Queue Managers".
3. Выбрать из контекстного меню пункт "New" => "Queue Manager".
4. Выбрать из контекстного меню пункт "New" => "Queue Manager".

   
   
   Рис. 2.7.  Создание менеджера очередей (Шаг 1)

   В этой форме:

   Queue Manager – имя менеджера;

   Make this the default queue manager – флажок, определяющий будет ли этот менеджер менеджером по умолчанию;

   Def. Transmission Queue – имя трансмиссионной очереди по умолчанию рекомендуется оставить пустым во избежание ошибок передачи данных;

   Dead Letter Queue – очередь недоставленных сообщений;

   Max Handle Limit – количество открытых объектов WebSphere MQ одним приложением (одна программа не сможет работать одновременно более чем с 256 очередями);

   Trigger Interval – значение интервала времени, через который опрашивается состояние очереди триггерными процессами;

   Max Uncommitted Msgs – максимальное количество сообщений, которые могут находится в очередях и транзакции по их отправке еще не завершились;

5. Нажать кнопку «Next» и заполнить форму (рис.2.8) Create Queue Manager (Step2)

   
   
   Рис. 2.8.  Создание менеджера очередей (Шаг 2)

   В этой форме:

   Use circular/linear logging - с помощью данного флажка можно выбрать тип логирования на вновь создаваемом менеджере;

   Log Path – указывает путь, где будут созданы лог-файлы;

   Log File Size - размер файла логирования, размер созданного файла будет в 4 раза превышать указанное число;

   Log Primary Files – количество первичных файлов логирования;

   Log Secondary Files – число вторичных файлов логирования.

6. Нажать кнопку «Next» и заполнить форму (рис.2.9) Create Queue Manager (Step3)

   
   
   Рис. 2.9.  Создание менеджера очередей (Шаг 3)

   В этой форме:

   Start Queue Manager – при установленном флажке менеджер очередей будет активизирован непосредственно сразу после создания;

   Create Server Connection Channel – установка данного флажка позволит создать канал (SYSTEM.ADMIN.SVRCONN) для удаленного управления объектами менеджера через протокол TCP/IP.

7. Нажать кнопку «Next» и заполнить форму (рис.2.10) Create Queue Manager (Step4)

   
   
   Рис. 2.10.  Создание менеджера очередей (Шаг 4)

   В этой форме:

   Create listener configured for TCP/IP – создает listener для удаленного подключения к менеджеру;

   Listen on port number – номер порта для работы listener (по умолчанию - 1414).

После нажатия на кнопку «Finish» менеджер с именем QM_Win2000 будет создан и произведен его старт. На оснастке консоли WebSphere MQ Explorer с левой стороны должно появиться имя менеджера, как это показано на рис.2.6.

Для удаления менеджера очередей через WebSphere MQ Explorer нужно вызвать контекстное меню из имени менеджера и выполнить команду «Stop». Следует напомнить, что перед этим нужно остановить все receiver- каналы, а также все программы, помещающие или считывающие сообщения из очередей. Способ остановки можно выбрать «Immediate» (незамедлительно). После того как менеджер будет остановлен, опять же с помощью контекстного меню выполнить команду «Delete». После этого менеджер очередей будет удален вместе со всеми своими объектами, и его восстановление будет невозможно.

В заключении можно добавить, что все эти процессы не представляют особой сложности. Процесс установки WebSphere MQ на NT-платформу занимает около получаса и решающим обстоятельством является мощность или скорость дисковых ресурсов. На процесс создания менеджера после ввода всех параметров уйдет не более минуты. Время остановки менеджера зависит от количества объектов. Для примера можно сказать, что на компьютере Pentium III с тактовой частотой 700 MHz и оперативной памятью 512Mb, менеджер, содержащий 1000 очередей, останавливается меньше чем за 30 секунд.