WWW.DISS.SELUK.RU

БЕСПЛАТНАЯ ЭЛЕКТРОННАЯ БИБЛИОТЕКА
(Авторефераты, диссертации, методички, учебные программы, монографии)

 

Pages:     || 2 |

«Версия 6.0.2 Adapter for FTP - Руководство пользователя Примечание Перед тем, как приступить к изучению этой информации, ознакомьтесь с общей информацией, приведенной в разделе “Примечания” на стр. 143. 22 декабря 2006 ...»

-- [ Страница 1 ] --

WebSphere® Адаптеры

Версия 6.0.2

Adapter for FTP - Руководство пользователя

Примечание

Перед тем, как приступить к изучению этой информации, ознакомьтесь с общей информацией, приведенной в разделе

“Примечания” на стр. 143.

22 декабря 2006 года

Данное издание относится к версии 6, выпуску 0, модификации 2 продукта IBM WebSphere Adapter for FTP (код

продукта 5724-N42), а также ко всем последующим выпускам и модификациям этого продукта, если в новых изданиях не будет оговорено иное.

Комментарии об этом документе можно отправить по адресу doc-comments@us.ibm.com. Будем рады получить ваши отзывы.

IBM может использовать или распространять переданную вами информацию любым способом на свое усмотрение, без возникновения каких-либо обязательств перед вами.

© Copyright International Business Machines Corporation 2006. Все права защищены.

Содержание Глава 1. Относительно данной информации................... Глава 2. Информация о выпуске......................... Глава 3. Введение в WebSphere Adapters..................... Глава 4. Введение в WebSphere Adapter for FTP.................. Требования к аппаратному и программному обеспечению..................... Соответствие стандартам............................... Специальные возможности.............................. Протокол IP версии 6.0............................... Технический обзор адаптера FTP............................. Обработка исходящих запросов............................ Обработка входящих событий............................ Бизнес-объекты................................. Мастер поиска служб предприятия........................... Глобализация и преобразование двунаправленного текста................... Глава 5. Планирование реализации адаптера.................. Планирование обработки входящих событий и исходящих запросов................. Защита..................................... WebSphere Adapters в кластерной среде.......................... Путеводитель установки, настройки и развертывания адаптера.................. Глава 6. Установка адаптера.......................... Предварительные требования к установке......................... Выполнение установки................................ Удаление адаптера из системы............................. Глава 7. Настройка адаптера для развертывания................ Создание псевдонима идентификации........................... Создание проекта адаптера с помощью WebSphere Integration Developer................ Создание пользовательских связываний данных....................... Настройка адаптера для обработки исходящих запросов..................... Создание бизнес-объектов с помощью мастера поиска служб предприятия.............. Создание привязки к ссылке............................. Настройка адаптера для обработки входящих событий..................... Создание бизнес-объектов с помощью мастера поиска служб предприятия.............. Создание привязки к ссылке............................. Глава 8. Развертывание модуля........................ Экспорт проекта в качестве файла EAR.......................... Установка модуля................................. Настройка свойств конфигурации с помощью административной консоли............... Настройка свойств адаптера ресурсов.......................... Настройка свойств фабрики управляемых (J2C) соединений................... Настройка свойств спецификации активации........................ Глава 9. Настройка средств устранения неполадок............... Включение трассировки с поддержкой инфраструктуры обработки событий общего формата (CEI)....... Настройка свойств протокола............................. Изменение имен файлов протоколов и трассировки...................... Установка и обновление IBM Support Assistant........................ iii © Copyright IBM Corp. Глава 10. Администрирование адаптера..................... Запуск адаптера.................................. Остановка адаптера................................. Устранение неполадок и поддержка........................... Исключительная ситуация: XAResourceNotAvailableException.................. Устранение неполадок, связанных с обработкой событий................... Справочные ресурсы............................... Обращение в службу поддержки программного обеспечения IBM................. Глава 11. Краткие учебники по началу работы.................. Введение.................................... Работа с файлами учебника.............................. Бизнес-объекты и артефакты, используемые в учебниках..................... Учебник: Отправка исходящих данных на сервер FTP...................... Создание проекта адаптера с помощью WebSphere Integration Developer............... Настройка адаптера для обработки исходящих запросов.................... Развертывание модуля для тестирования......................... iv IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 1. Относительно данной информации Данная документация предназначена для инженеров по интеграции, отвечающих за реализацию, настройку и развертывание WebSphere Adapter for FTP. Для выполнения этих задач необходимо понимать концепции интеграции бизнес-процессов и обладать бизнес-интеграции осуществляется инженерами по интеграции. Эта информация v Механизмы бизнес-интеграции, включая программную модель Service Component v Функции и требования WebSphere Process Server или WebSphere Enterprise Service v Инструменты и функции, предоставляемые WebSphere Integration Developer. Вы © Copyright IBM Corp. 2 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 2. Информация о выпуске © Copyright IBM Corp. 4 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 3. Введение в WebSphere Adapters Продукт IBM WebSphere Adapters обеспечивает взаимодействие компонентов Java Platform, Enterprise Edition (J2EE), таких как новые приложения электронного бизнеса, с ресурсами информационной системы предприятия (EIS). EIS - это информационная инфраструктура предприятия (например, система планирования ресурсов [ERP] или Адаптер WebSphere выполняет роль посредника между компонентом J2EE и сервером v Адаптеры приложений подключаются к существующим приложениям (например, SAP Software, Siebel, PeopleSoft Enterprise и JD Edwards EnterpriseOne), обеспечивая Как часть семейства продуктов WebSphere, продукт WebSphere Adapters поддерживает WebSphere Integration Developer, WebSphere Process Server и WebSphere Enterprise v WebSphere Integration Developer представляет собой среду инструментов для развертываемого в WebSphere Process Server или WebSphere Enterprise Service Bus.



наконец, WebSphere Integration Developer создает модуль, в состав которого входит © Copyright IBM Corp. 6 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 4. Введение в WebSphere Adapter for FTP Java 2 Platform, Enterprise Edition (J2EE), выполняющимися в WebSphere Process Server Адаптер позволяет компонентам J2EE взаимодействовать с удаленной файловой системой. Например, компонент J2EE, настроенный для работы с адаптером, может Требования к аппаратному и программному обеспечению соответствует предъявляемым требованиям. Эти требования можно разделить на две категории: поддерживаемые платформы для выполнения программы установки Список платформ, поддерживаемых программой установки адаптера, приведен в развертывания и выполнения адаптера перечислены на следующей Web-странице:

IBM WebSphere Adapters и IBM WebSphere Business Integration Adapters: требования к программному обеспечению. Выберите в списке IBM WebSphere Adapters ссылку для Соответствие стандартам лицами, независимо от их возраста и физических возможностей. Продукт WebSphere Adapters полностью обеспечивает все специальные возможности согласно разделу подвижности работать с программными продуктами. Эти возможности встроены в WebSphere Adapters можно установить с помощью графического пользовательского интерфейса или сценария в неинтерактивном режиме. Неинтерактивная установка рекомендуется для пользователей, использующих специальные возможности.

© Copyright IBM Corp. Административная консоль WebSphere Process Server или WebSphere Enterprise Service приложений. Эта консоль работает в Web-браузере. Если Web-браузер поддерживает специальные возможности, как, например, Microsoft Internet Explorer или Netscape, то v Использовать программу чтения с экрана и цифровой синтезатор речи для чтения v Использовать программу распознавания речи, например, IBM ViaVoice, для ввода Настроить функции продукта можно в обычных текстовых редакторах, а выполнять В документации по продуктам приведены дополнительные сведения о специальных Мастер поиска служб предприятия - это основной компонент, применяемый для создания приложений с адаптерами. Этот мастер реализован как встраиваемый модуль Eclipse, который полностью доступен через WebSphere Integration Developer.

В этом продукте для навигации применяются стандартные комбинации клавиш Дополнительная информация об обязательствах IBM относительно специальных За совместимость IBM WebSphere Process Server с протоколом IP версии 6.0 отвечает IBM WebSphere Application Server версии 6.0 и его компонент JavaMail поддерживает Дополнительная информация о поддержке этого протокола в WebSphere Application Server приведена в разделе IPv6 WebSphere Application Server Information Center.

Дополнительная информация по IPv6 приведена на сайте www.ipv6.org.

Технический обзор адаптера FTP Адаптер FTP обеспечивает обмен бизнес-данными между удаленными файловыми 8 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя На следующем рисунке показана архитектура адаптера; стрелки указывают поток обработки входящих и исходящих операций.

Архитектура адаптера Обработка исходящих запросов WebSphere Adapter for FTP поддерживает синхронную обработку исходящих запросов.

Во время выполнения исходящих операций приложение J2EE обращается к адаптеру путем отправки запроса в виде бизнес-объекта. Адаптер обрабатывает запрос и возвращает приложению J2EE бизнес-объект, представляющий результат операции.

В качестве ответа адаптер может возвратить приложению J2EE бизнес-объект с полученными данными или значение null.

WebSphere Adapter for FTP поддерживает операции обработки исходящих запросов, Create В заданном каталоге сервера FTP создается файл с указанным именем. Содержимое файла может передаваться как часть запроса от клиента, либо оно может извлекаться из локальной файловой системы, в которой работает адаптер. Извлечение содержимого можно настроить.

Если создаваемый файл не существует, он создается и приложению J2EE возвращается значение null. Файл создается в промежуточном каталоге (если он существует), из которого перемещается в указанный каталог. Если промежуточный каталог не существует, файл Если файл, который требуется создать, уже существует, выдается исключительная ситуация FTPFileCreateException, файл не создается, а существующий файл не заменяется.

Append К файлу с указанным именем в заданном каталоге сервера FTP добавляется содержимое, переданное в запросе. Если файл существует, в него добавляется содержимое и приложению J2EE возвращается значение null. Файл, в который требуется добавить содержимое, копируется из указанного каталога в промежуточный (если он существует), и содержимое исходный указанный каталог. Если промежуточного каталога не существует, содержимое необходимо добавить содержимое, не существует, вызывающему компоненту возвращается Delete Файл удаляется из указанного каталога сервера FTP. После удаления файла приложению J2EE возвращается значение null. Если файл не существует, вызывающему компоненту возвращается исключительная ситуация FTPFileDeleteException.

Retrieve Возвращает содержимое одного или нескольких файлов, указанных в запросе. Если файлы, указанные в запросе существуют, их содержимое отправляется в качестве ответа.

Содержимое файла может возвращаться приложению J2EE в качестве бизнес-объекта или сохраняться в локальной файловой системе адаптера. Это настраиваемый параметр. Имена вызывающему компоненту отправляется исключительная ситуация FTPFileRetrieveException.

Overwrite Заменяет файл в каталоге содержимым, указанным в запросе. Если целевой файл существует, его содержимое заменяется и приложению J2EE возвращается значение null.

Файл, который необходимо заменить, копируется из указанного каталога в промежуточный (если он существует), и содержимое заменяется в промежуточном каталоге. Затем файл перемещается обратно в исходный указанный каталог. Если промежуточного каталога не существует, содержимое файла заменяется непосредственно в указанном каталоге. Если файл, который необходимо заменить, не существует, вызывающему компоненту возвращается исключительная ситуация FTPFileOverwriteException.

Exists Если файл, имя которого указано в запросе, существует в заданном каталоге, адаптер возвращает бизнес-объект ExistsResponse, в атрибуте DoesFileExists которого указано значение true. Если файл или каталог не существует, адаптер возвращает бизнес-объект ExistsResponse, в атрибуте DoesFileExists которого указано значение false.

List Возвращает список имен всех файлов и подкаталогов из каталога, указанного в запросе.

Имена файлов и подкаталогов возвращаются в бизнес-объекте ListResponse. Если целевой каталог не существует, вызывающему компоненту возвращается исключительная ситуация ServerToServer Передает указанный файл из одного каталога сервера FTP в другой каталог сервера FTP.

FileTransfer Если запрос содержит неполную информацию о серверах, адаптер возвращает 10 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя ExecuteFTPScript Выполняет команды из файла сценария FTP на сервере WebSphere Process Server.

Выполняются только команды поддерживаемые сервером FTP; остальные команды игнорируются. В случае сбоя операции возвращается исключительная ситуация FTPFileExecuteFTPScriptException. Файл сценария не должен содержать команды, относящиеся к соединениям (например, open и connect), поскольку для выполнения команд применяется уже открытое соединение. Если команды из файла сценария необходимо выполнить в конкретном каталоге сервера FTP, то в качестве первой команды следует WebSphere Adapter for FTP поддерживает следующие опции конфигурации обработки v Операции обработки исходящих запросов поддерживают как активные, так и пассивные информационные соединения. По умолчанию применяется активный v Файлы можно передавать в двоичном режиме или режиме ASCII. По умолчанию v При необходимости для команд, выполняемых в ходе операции обработки исходящих запросов, можно включить функцию контроля. Полученная информация записывается в файл трассировки, если указан уровень трассировки v Если запросы передаются через Proxy FTP, расположенный между адаптером и сервером FTP, для настройки доступны параметры Proxy Socks. Параметры Proxy настраиваются на уровне приложения и применяются для всех фабрик управляемых соединений и спецификаций активации, принимающих участие в v Если в ходе исходящей операции create приложение J2EE передает содержимое файла, то перед выполнением операции файл можно сохранить в рабочей станции.

v Если исходящие операции извлекают несколько файлов, их имена должны быть v До и после операций обработки исходящих запросов можно вызывать ExecuteFTPScript. Файл сценария не должен содержать команды, относящиеся к соединениям (например, open), поскольку для выполнения команд применяется уже v Номер порта сервера FTP можно настроить в URL FTP. Например, v С помощью пассивных информационных соединений адаптер можно подключить к v Пароли по умолчанию хранятся в незашифрованном виде в файлах импорта и экспорта. Если настроен псевдоним идентификации, то фактический пароль для входящих и исходящих конфигураций извлекается из псевдонима идентификации v В случае применения сервера FTP, если вывод команды ls -l отличается от стандартных списков, поддерживаемых Apache commons net 1.4.1 для других операционных систем, вы можете реализовать собственный анализатор для v Адаптер поддерживает защиту FTP с помощью протокола SSL. Для защищенных v В случае тайм-аута соединения FTP адаптер восстанавливает потерянное соединение. Если установить соединение невозможно, выполняется указанное v В ходе исходящих операций create файлы создаются в промежуточном каталоге (если он существует). Затем они перемещаются в целевой каталог. Такой подход позволяет третьему приложению считать данные из файла до его окончательной записи. Кроме того, промежуточный каталог применяется операциями Append и Overwrite; указанный файл сначала копируется в промежуточный каталог (если он существует), затем обрабатывается и возвращается в целевой каталог. Если промежуточный каталог не существует, операция выполняется в целевом каталоге.

В этом разделе приведено подробное описание бизнес-объектов, возвращаемых приложению J2EE после завершения операции обработки исходящих запросов.

После завершения обработки исходящих запросов адаптер возвращает полученный вывод исходному клиенту J2EE. Следующие операции возвращают значение null:

Операция Exists возвращает бизнес-объект, содержащий информацию о состоянии Состояние выполнения операции Exists представлено в бизнес-объекте ExistsResponse Операция List возвращает бизнес-объект, содержащий информацию о состоянии ListResponse содержит только элемент ListOfFileNames типа String[] со списком имен Операция Retrieve возвращает бизнес-объект, содержащий информацию о состоянии RetrieveResponseWrapperBG->RetrieveResponseWrapper->FileContent 12 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Бизнес-объект RetrieveResponseWrapper содержит элемент Content типа anyType[], Бизнес-объект FileContent содержит элемент Filename типа String, а также элемент Если для свойства SavedFileToLocalDirectory указано значение true, все файлы сохраняются в локальном каталоге и в элементе Content бизнес-объекта задается Примечание: Преобразование данных не выполняется пока вывод операции Retrieve В ходе обработки исходящих запросов адаптер с помощью среды преобразования данных преобразует данные из бизнес-объектов WebSphere Adapter в двоичные форматы данных, такие как XML. Данное преобразование необходимо, поскольку внешние приложения и технологии часто понимают только свои внутренние или стандартные промышленные форматы данных. Применение среды преобразования данных позволяет пользователям исправить данный пробел в обмене информацией.

В следующей процедуре описано преобразование данных в ходе обработки 1. Оболочка бизнес-объекта (CustomerWrapper или FTPFile), входящая в состав оболочки бизнес-графика (CustomerWrapperBG или FTPFileBG) заполняется информацией о протоколе из компонента J2EE. Фактический бизнес-объект (например, Customer) также в оболочке бизнес-объекта. Оболочка бизнес-объекта 2. В соответствии со связыванием данных, настроенным в ходе выполнения мастера поиска служб предприятия, вызывается подходящее связывание данных, которое 3. Адаптер проверяет аннотацию оболочки бизнес-объекта и бизнес-объекта бизнес-объекта Customer, вызывается подходящее связывание данных для связыванием данных для содержимого извлекается из аннотации к оболочке бизнес-объекта. Если значение типа содержимого или имени связывания данных com.ibm.j2ca.extension.emd.runtime.WBIXMLDataBinding 4. Запрос отправляется адаптеру и выполняется исходящая операция. Адаптер возвращает компоненту приложения J2EE бизнес-объект, представляющий Сквозная обработка выполняется в том случае, если преобразование данных не требуется. В ходе сквозной обработки нестандартное связывание данных, расширяющее UnstructuredContentDataBinding, не вызывает другие связывания В следующей процедуре описана сквозная обработка данных для исходящих 1. Оболочка бизнес-объекта FTPFile, входящая в состав оболочки бизнес-графика FTPFileBG заполняется информацией о протоколе из компонента J2EE. В атрибут Content бизнес-объекта FTPFile добавляется бизнес-объект без структуры.

Оболочка бизнес-объекта и имя исходящей операции отправляются в качестве 2. В соответствии со связыванием данных (FTPFileDataBinding), настроенным в ходе связывание данных, которое получает оболочку бизнес-объекта FTPFileBG.

14 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя 3. FTPFileDataBinding реорганизует содержимое в формат без структуры и выполняет сквозную обработку. Оно создает FTPFileUnstructuredRecord, задает фактическое содержимое и информацию о протоколе.

4. Бизнес-объект отправляется адаптеру и выполняется исходящая операция. Вывод исходящей операции представляет собой бизнес-объект, который возвращается связыванию данных WBIDataBindingImpl и отправляется обратно клиенту J2EE.

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

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

v Укажите информацию о соединении в ManagedConnectionFactory с помощью мастера поиска служб предприятия или административной консоли WebSphere Process Server.

v Информация уровня протокола (например, имена каталогов и файлов, а также другие свойства), необходимая для выполнения некоторых исходящих операций, задается в оболочке бизнес-объекта. Эти значения задаются в пользовательском связывании данных бизнес-объекта и передаются адаптеру для дальнейшей Адаптер выполняет поиск идентификационных данных сначала в псевдониме идентификации, затем в спецификации активации. Если идентификационные данные не заданы, применяются значения из окна свойств фабрики управляемых соединений.

Для подключения к серверу FTP применяется обязательное свойство Ftp Url, предусмотренное в окне Свойства фабрики управляемых соединений.

Обработка входящих событий выполняется асинхронно. Адаптер опрашивает сервер FTP, извлекает события с сервера FTP, выполняет преобразование информации в бизнес-объекты и отправляет бизнес-объекты настроенной конечной точке.

Адаптер опрашивает файлы из каталога событий сервера FTP с частотой, указанной в свойстве FTPPollFrequency. При поступлении файла в каталог событий адаптер считывает его содержимое файла и загружает файл в локальный каталог событий сервера адаптера. После загрузки файла адаптер в зависимости от конфигурации добавляет файл в архив на сервере FTP, либо удаляет его. В число настраиваемых параметров входят каталог событий, каталог архива, интервал опроса и число После отправки бизнес-объектов в конечную точку события в зависимости от конфигурации добавляются в архивный каталог локальной файловой системы или удаляются. Во избежание повторного опроса событий адаптер должен добавить их в Адаптер отправляет бизнес-объект в конечную точку с помощью селектора функций, public interface SplittingFunctionalityInterface extends Iterator{ public void setBODetails(String filename, int currentPosition, int totalBOs, 16 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя public void setEncoding(String encoding);

public void setLogUtils(LogUtils logUtils);

public boolean isSplitBySize() a. public int getTotalBOs(String filename) throws SplittingException Этот метод возвращает общее число бизнес-объектов, входящих в состав файла событий с именем filename.

b. public void setSplitCriteria(String splitCriteria) Этот метод задает splitCriteria на основе числа бизнес-объектов в файле событий. В ходе вызовов next() последовательно возвращаются все бизнес-объекты.

c. public void setLogUtils(LogUtils logUtils) С помощью этого метода задается объект LogUtils, который представляет собой класс, позволяющий записывать данные трассировки и сообщения протоколов в файлы.

d. public void setEncoding(String encoding) Этот метод позволяет задать кодировку, применяемую при чтении содержимого файла событий. Кроме того, кодировка применяется для SplitCriteria.

e. public void setBODetails(String filename, int currentPosition, int totalBOs, boolean includeEndBODelimiter) throws SplittingException С помощью этого метода задается номер текущего бизнес-объекта; каждый раз при вызове next() возвращается номер бизнес-объекта, указанный в параметре currentPosition. Кроме того, он принимает параметр includeEndBODelimiter; если этот параметр задан, то в конец содержимого бизнес-объекта добавляется SplitCriteria. Данный метод следует вызывать каждый раз перед вызовом метода next(), чтобы метод next() возвращал содержимое указанного в нем бизнес-объекта.

f. Итератор состоит из следующих требующих реализации методов: hasNext(), next и remove(). Метод next() возвращает содержимое бизнес-объекта, положение которого указано в методе setBODetails(). Если положение бизнес-объекта не задано, он не выполняется. Метод hasNext() проверяет существование положения бизнес-объекта, указанного в методе setBODetails(). Перед вызовом метода hasNext() следует вызвать setBODetails(). Метод remove() вызывается для всех записей бизнес-объектов, удаляемых из таблицы EventPersistence. В этом методе не следует удалять файл событий; выполняется только очистка ресурсов.

g. public boolean isSplitBySize() Этот метод указывает, следует ли выполнять анализ файла событий в соответствии с размером или ограничителем.

5. Адаптер отправляет бизнес-объект в конечную точку с помощью селектора функций, который отвечает за вызов настроенного связывания данных и преобразование текста записи в бизнес-объект. Бизнес-объект отправляется в конечную точку.

Среда преобразования данных В ходе обработки входящих событий среда преобразования данных преобразует информацию из событий в бизнес-объекты WebSphere Adapter. Такое преобразование необходимо, поскольку компоненты сервера WebSphere Process Server поддерживают только бизнес-объекты WebSphere Adapter.

В следующей процедуре показано, каким образом выполняется преобразование данных в ходе обработки входящих событий.

1. Из файла событий последовательно выбираются все бизнес-объекты в соответствии со свойством SplitCriteria, которое содержит ограничитель, 2. В свойствах DefaultObjectName и EventContentType из ActivationSpec указываются бизнес-графика (например, FTPFileBG) или именем оболочки бизнес-графика содержимого (например, SalesOrderWrapperBG). Для свойства EventContentType 3. Информация о протоколе, такая как имя файла событий и имя каталога, задается 4. Бизнес-объект отправляется селектору функций, который вызывает указанное 5. Бизнес-объект содержимого задается в оболочке бизнес-объекта. Информация о пример аннотации для бизнес-объектов SalesorderWrapper и SalesOrder.

com.ibm.j2ca.extension.emd.runtime.WBIXMLDataBinding 18 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя http://www.ibm.com/xmlns/prod/websphere/j2ca/ftp/ salesorderwrapperbg/SalesOrderWrapperBG Диаграмма преобразования данных для входящих событий Сквозная обработка Сквозная обработка выполняется в том случае, если преобразование данных не требуется.

В следующей процедуре показано, каким образом выполняется сквозная обработка 1. Из файла событий последовательно выбираются все бизнес-объекты в соответствии с указанным свойством разбиения. В свойствах DefaultObjectName и EventContentType из ActivationSpec указываются имя записи и тип содержимого из быть указано имя шаблона оболочки бизнес-графика, например, FTPFileBG.

2. Информация о протоколе, такая как имя файла событий и имя каталога, задается v В случае обработки FilePassByReference в качестве имени каталога указывается 3. Если свойство EventContentType недопустимо, содержит значение null или не содержит соответствующую запись в аннотации к преобразованию связывания данных оболочки, то для входящего сценария применяется сквозная обработка.

4. Бизнес-объект FTPFileUnstructuredRecord отправляется селектору функций, который создает экземпляр оболочки и проверяет аннотацию к преобразованию связывания данных для комбинаций свойств contentType и DataBinding. Такой подход позволяет селектору функций выполнить предварительный анализ в FTPFileUnstructuredRecord. Если подходящее связывание данных отсутствует (например, свойство contentType недопустимо, содержит значение null, не связыванию данных не удалось найти бизнес-объект), создается экземпляр бизнес-объекта без структуры содержимого без вызова связывания данных для 5. Оболочка бизнес-объекта FTPFile задается в соответствии с информацией о протоколе, а бизнес-объект UnstructuredContent задается в бизнес-объекте FTPFile.

6. Оболочка бизнес-объекта FTPFile задается в бизнес-объекте и отправляется в 20 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Диаграмма сквозной обработки входящих событий Передача файлов с помощью ссылок Адаптер поддерживает также функцию PassThrough, при которой только имя файла события отправляется в конечную точку. Файл событий, к имени которого добавляется системное время, доступен в локальном архивном каталоге. Данная функция используется в том случае, если приложения в конечной точке могут загружать файлы событий.

Разбиение файлов В режиме обработки входящих событий файл событий может разбиваться на несколько фрагментов, каждый из которых отправляется в конечную точку отдельно.

Такой подход позволяет уменьшить нагрузку на память в ходе обработки событий.

Разбиение файлов выполняется в соответствии с ограничителем или размером файла, который указывается в свойстве SplitCriteria. Значение ограничителя указывается в свойстве SplitCriteria, класс, применяемый для разбиения файла событий, указывается в свойстве SplittingFunctionClassName спецификации активации. По умолчанию адаптер предоставляет классы SplitBySize и SplitByDelimiter для свойства SplittingFunctionClassName.

Если фрагментация включена, каждый фрагмент передается конченой точке по отдельности. Число бизнес-объектов, передаваемых конечной точке, указывается в свойстве PollQuantity. Например, если в свойстве PollQuantity указано значение 3:

Адаптер не отвечает за сборку фрагментов данных. Он предоставляет внешнему приложению информацию о фрагментации данных, необходимую для объединения фрагментов. Информация о фрагментации данных указывается в свойстве chunkInfo оболочки бизнес-объекта. Она включает данные о размере фрагмента в байтах, а AbsolutePathOfTheEventFileNameInLocalEventDirectory_/_гггг_ММ_дд_ЧЧ_мм_сс_ССС.

Для разделения файлов событий применяются ограничители. Ограничитель указывается в свойстве SplitCriteria спецификации активации.

v Все новые строки в ограничители указываются с помощью символов \n. Адаптер v При наличии нескольких ограничителей они должны быть разделены точкой с следует добавить обратную косую черту \;. Например, ограничитель ##\;## обрабатывается как ##;##, т.е. точка с запятой (;) входит в состав ограничителя.

v Символы (;;), указанные перед фрагментом ограничителя, позволяют пропустить Адаптер рассматривает ##$$ в качестве ограничителя и пропускает строку v В качестве ограничителя можно указать произвольное значение без каких-либо v Если ограничитель расположен в конце файла, то свойство SplitCriteria использует Для применения функции восстановления событий, предусмотренной в WebSphere Process Server, в спецификации активации для свойства AssuredOnceDelivery 22 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя необходимо указать значение true. Если указано значение false, недоставленные события восстановить нельзя. Доставка совпадающих событий разрешена, если для свойства AssuredOnceDelivery указано значение false. Для повышения производительности рекомендуется запретить восстановление событий и разрешить доставку совпадающих событий, указав для свойства AssuredOnceDelivery значение false.

Хранение событий Файлы событий - это файлы, созданные сервером FTP и другими приложениями в каталоге событий сервера FTP. Каждая запись бизнес-объекта, входящая в состав файла событий, называется событием. В целях отслеживания записей бизнес-объектов до передачи события конечной точке адаптер создает запись в таблице базы данных.

Если в ходе входящей операции работа сервера базы данных завершается, адаптер выдает исключительную ситуацию. Для обработки событий потребуется перезапуск сервера базы данных и адаптера.

Структура таблицы событий EVNTID Varchar(255) Для отслеживания каждому событию должен EVNTSTAT integer Состояние события. С помощью состояния XID Varchar(255) Применяется адаптером для гарантированной Архив событий Архивные события хранятся в каталоге архива. Расширение файла указывается в свойстве спецификации активации FTPRenameExt.

Ниже перечислены конфигурации, применимые к этому варианту:

v Свойства FTPArchiveDirectory и FTPRenameExt заданы, для свойства FTPRenameExt указано значение processed, архивный файл расположен в указанном каталоге архива и его имя файла соответствует следующему формату:

имя-файла_системное-время.processed v Задано только свойство FTPArchiveDirectory, архивный файл расположен в v Свойства FTPArchiveDirectory и FTPRenameExt не заданы, файл событий удален из v Для свойства FTPRenameExt указано значение processed, архивный файл следующему формату: имя-файла_системное-время.processed Подсистема виртуальной мультипамяти (MVS) не поддерживает специальные символы, такие как _, в именах наборов данных и наборов записей. На платформах системное время. Такой подход позволяет избежать добавления в папку архива файлов с совпадающими именами и соответственно замены существующих файлов.

На платформах MVS в качестве разделителя наборов данных и наборов записей применяется символ. (точка). Максимальное допустимое число символов. (точек) в наборе данных или записей составляет 6. Имя набора данных не должно превышать Архивный файл: TEST.TS200304.TS290535.TS42234.ARCHIVE WebSphere Adapter for FTP поддерживает следующие опции конфигурации обработки FTPArchiveDirectory указан допустимый каталог сервера FTP, то файл добавляется 24 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя в архив на сервере FTP. В противном случае файл удаляется после завершения загрузки. В пределах рабочей станции адаптера процесс архивации файла событий управляется следующими свойствами: LocalArchiveDirectory, OriginalArchiveExt, SuccessArchiveExt и FailedArchiveExt.

v Адаптер может извлекать файлы из каталога событий в соответствии со значением свойства EventFileMask. Если для свойства EventFileMask указано значение *.*, адаптер извлекает из каталога событий все файлы.

v Файлы событий, полученные из каталога событий, могут обрабатываться в соответствии с порядком, указанным в свойстве SortEventFiles, для которого допустимы значения Timestamp и Filename. Если значение не указано, адаптер не сортирует события и обрабатывает их в порядке получения. Сортировка событий поддерживается только в том случае, если для свойства DeliveryType спецификации активации указано значение ORDERED.

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

v Адаптер поддерживает защиту FTP с помощью протокола SSL. Для защищенных операций применяются пассивные соединения.

v С помощью пассивных информационных соединений адаптер можно подключить к серверу FTP через брандмауэр.

v Файлы можно передавать в двоичном режиме или режиме ASCII. По умолчанию применяется двоичный режим.

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

v Если запросы передаются через Proxy FTP, расположенный между адаптером и сервером FTP, для настройки доступны параметры Proxy Socks. Параметры Proxy настраиваются на уровне приложения и применяются для всех фабрик управляемых соединений и спецификаций активации, принимающих участие в настройке адаптера.

v В случае применения сервера FTP, если вывод команды ls -l отличается от стандартных списков, поддерживаемых Apache commons net 1.4.1 для другой операционной системы, вы можете реализовать собственный анализатор для анализа вывода ls -l.

v До и после операций обработки исходящих запросов можно вызывать ExecuteFTPScript. Файл сценария не должен содержать команды, относящиеся к соединениям (например, open), поскольку для выполнения команд применяется уже открытое соединение.

v Для сквозной обработки предусмотрена опция разбиения больших файлов событий в соответствии со значениями свойств конфигурации. Файл загружается в локальную рабочую станцию с сервера FTP и разбивается на фрагменты, которые затем передаются в конечную точку.

v Номер порта сервера FTP можно настроить с помощью свойства EventDirectory, например: ftp://localhost:portNumber/eventDirectory.

v Пароли по умолчанию хранятся в незашифрованном виде в файлах импорта и экспорта. Если настроен псевдоним идентификации, то фактический пароль для входящих и исходящих конфигураций извлекается из псевдонима идентификации сервера WebSphere Process Server.

v В ходе операций сквозной обработки с помощью опции FilePassByReference в конечную точку можно отправить только имя файла. Файл событий (к имени которого добавляется системное время) доступен в локальном архивном каталоге.

v Пользователь может настроить несколько спецификаций активации, разрешив тем самым адаптеру одновременно опрашивать несколько каталогов событий на разных серверах FTP и доставлять события в целевые конечные точки. Например, если для двух спецификаций активации указаны одинаковые свойства, адаптер v В случае тайм-аута соединения FTP адаптер восстанавливает потерянное соединение. Если установить соединение невозможно, выполняется указанное Бизнес-объекты содержат информацию, необходимую для обработки запросов и создания ответов, например, функциональные свойства, информацию о преобразовании данных и содержимое файлов. Адаптер FTP использует одну и ту же структуру бизнес-объектов для обработки входящих событий и исходящих запросов.

В зависимости от потребностей организации можно использовать бизнес-объекты по умолчанию, создаваемые мастером поиска служб предприятия, а также импортировать существующие определения пользовательских бизнес-объектов Имена бизнес-объектов должны отражать представляемую ими структуру, например, Заказчик или Адрес. В большинстве случаев имена извлекаются в процессе импорта метаданных EMD в соответствии с именами, присвоенными сервером FTP.

Определения бизнес-объектов (XSD) адаптера FTP создаются заранее и размещаются Для поиска служб предприятия должны быть указаны допустимые файлы XSD; в именах элемента или complexType недопустимы специальные символы. Применение недопустимых файлов XSD приведет к ошибкам. Кроме того, в файлах XSD должны отсутствовать аннотации, поскольку все требуемые аннотации добавляются Имя графика родительского бизнес-объекта составляется из имени вложенного бизнес-объекта и символов BG, например, CustomerBG для бизнес-объекта Customer.

Адаптер и база данных не учитывают семантическое значение имен бизнес-объектов.

Структура бизнес-объектов адаптера FTP основана на общей структуре бизнес-объектов WebSphere Business Integration, которая моделируется как базовая схема XML. В ходе поиска служб предприятия адаптер FTP определяет и создает следующие бизнес-объекты: FTPFile, FTPFileBG, Customer, CustomerWrapperBG и Шаблоны определений бизнес-объектов FTPFileBG, FTPFile и UnstructuredContent создаются автоматически. Кроме того, в зависимости от конкретного набора нестандартных сложных типов, выбранных в ходе поиска служб предприятия, создаются определения соответствующих бизнес-объектов. Например, если выбрать тип Customer, то будут созданы бизнес-объекты CustomerWrapperBG, CustomerWrapper 26 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя FTPFileBG Бизнес-объект FTPFileBG представляет собой оболочку бизнес-объекта, в состав которой входит дочерний бизнес-объект FTPFile. Соответствующее отношение показано на следующем рисунке:

FTPFile В состав бизнес-объекта FTPFile входит дочерний бизнес-объект UnstructuredContent.

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

CustomerWrapperBG представляет собой оболочку бизнес-объекта, в состав которой входит дочерний бизнес-объект CustomerWrapper. Соответствующее отношение Бизнес-объект CustomerWrapper представляет собой оболочку бизнес-объекта, в состав которой входит дочерний бизнес-объект Customer. Соответствующее 28 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Архитектура бизнес-объектов определяет различные свойства, применимые к атрибутам. В этом разделе описано, каким образом адаптер обрабатывает эти В следующей таблице перечислены свойства вместе с описаниями.

Для простых атрибутов применяется значение 1. Для атрибутов контейнера применяется Число значений Внешний ключ В адаптере не предусмотрены элементы, представляющие внешние ключи.

Ключ В адаптере не предусмотрены элементы, представляющие ключи.

Имя Это свойство представляет уникальное имя простого атрибута или имя дочернего Обязательный Это свойство указывает, что атрибут должен содержать значение. Единственным обязательным атрибутом является DirectoryPath; он задается для всех исходящих Тип Атрибут может быть простым или сложным. Простые типы: Boolean, String, LongText, С помощью операций адаптер FTP указывает действия, выполняемые на сервере FTP в ходе обработки исходящих запросов. В следующей таблице приведен список Поддерживаемые операции для обработки исходящих запросов Overwrite Заменяет файл в каталоге содержимым, переданным в запросе.

Exists Возвращает true, если в заданном каталоге существует файл, указанный в запросе.

Передача файлов от сервера Передает файл из одного сервера FTP на другой сервер FTP.

серверу ExecuteFTPScript Запускает файл сценария FTP в указанном каталоге.

Информация о приложении бизнес-объекта расположена в аннотациях бизнес-объекта оболочки, а также в бизнес-объекте контекста. За создание описаний служб и добавление аннотаций для выбранных бизнес-объектов отвечает служба поиска метаданных предприятия (EMD) адаптера FTP. Например, если в ходе работы EMD выбран сложный тип Customer, информация о приложении бизнес-объекта добавляется в аннотации определений бизнес-объектов CustomerWrapper и Customer.

В случае применения нестандартных бизнес-объектов перед запуском мастера поиска служб предприятия следует создать предопределенные бизнес-объекты с помощью мастера бизнес-объектов WebSphere. Мастер сохраняет создаваемые определения бизнес-объектов в локальных файлах xsd. В процессе создания бизнес-объектов мастер поиска служб предприятия выполняет поиск предопределенных бизнес-объектов, созданных с помощью мастера бизнес-объектов, и заполняет их Дополнительные инструкции по созданию предопределенных бизнес-объектов Мастер поиска служб предприятия Мастер поиска служб предприятия применяется для создания бизнес-объектов для сервера FTP, захвата свойств входящих и исходящих соединений, а также для создания требуемых артефактов (импорт, экспорт и файлы wsdl). Мастер поиска служб предприятия создает эскиз проекта для бизнес-объектов. Он позволяет просматривать метаданные на сервере FTP, выбирать артефакты, а также создавать развертываемые объекты служб и описания. Бизнес-объекты для сервера FTP можно создавать путем выбора узлов метаобъектов в структуре метаданных.

бизнес-графиков и бизнес-объектов. С помощью мастера поиска служб предприятия v Задавать для бизнес-объектов информацию, относящуюся к конкретным v Задавать для свойств информацию, относящуюся к конкретным приложениям Глобализация и преобразование двунаправленного текста Данный адаптер был разработан с учетом требований глобализации и поддерживает одно- и многобайтовые наборы символов и позволяет отправлять сообщения с текстом на различных языках. Кроме того, он выполняет преобразование двунаправленного текста, т.е. позволяет обрабатывать файлы, в которых одновременно может содержаться текст, направленный слева направо (например, Среда выполнения Java™ виртуальной машины Java (JVM) представляет данные в кодировке Unicode. Формат Unicode содержит кодировки для символов из наиболее распространенных кодовых наборов (как одно-, так и многобайтовых). Поскольку компоненты WebSphere® Business Integration разработаны на языке Java, в большинстве случаев при передаче данных между компонентами WebSphere Business Integration дополнительное преобразование символов не требуется.

Для занесения в протокол сообщений на языке конкретной страны или региона 30 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Преобразование двунаправленного текста В арабском языке и иврите запись ведется справа налево, однако текст может содержать встроенные сегменты, записанные слева направо; в таких случаях говорят о двунаправленном сценарии. Обработка двунаправленных сценариев выполняется в соответствии с определенными стандартами. WebSphere Process Server и Enterprise Service Bus применяют стандартный формат Windows, однако для обмена данными с WebSphere Process Server и Enterprise Service Bus информационная система предприятия может использовать другой формат. Продукт WebSphere Adapters выполняет преобразование данных двунаправленных сценариев, которые передаются между системами, обеспечивая правильную обработку и отображение этих данных в обоих конечных точках транзакции.

Формат двунаправленного текста WebSphere Process Server WebSphere Process Server и WebSphere Enterprise Service Bus используют формат двунаправленного текста ILYNN (implicit, left-to-right, on, off, nominal). Этот формат также применяется операционной системой Windows. Если информационная система предприятия использует другой формат, то перед передачей данных серверу WebSphere Process Server адаптер выполняет преобразование формата.

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

Атрибуты формата двунаправленного текста Перед отправкой данных серверу WebSphere Process Server адаптер преобразует их в логический формат слева направо.

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

Свойства, управляющие преобразованием двунаправленного текста, можно задать в v Свойства адаптера ресурсов: Применяются для хранения параметров конфигурации запрещает преобразование двунаправленного текста для конкретного экземпляра адаптера. Настроить эти свойства можно с помощью административной консоли v Свойства ManagedConnectionFactory (MCF): Применяются для динамического создания экземпляра исходящего соединения с информационной системой v Свойства спецификации активации: Содержат информацию о конфигурации Некоторые адаптеры позволяют добавлять в бизнес-объекты аннотации свойств двунаправленного текста. Такой подход позволяет добавить информацию, управляющую преобразованием бизнес-объекта или его отдельного элемента.

Редактор бизнес-объектов, входящий в состав WebSphere Integration Developer, 32 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Адаптер выполняет преобразование двунаправленного текста после задания свойств двунаправленного текста и добавления требуемых аннотации к бизнес-объектам.

Применяемая при этом логика реализована на основе иерархического наследования значений свойств и механизма поиска.

Свойства, заданные для адаптера ресурсов, принадлежат верхнему уровню иерархической структуры; свойства, заданные в других областях и добавленные в бизнес-объект в качестве аннотаций, принадлежат более низким уровням. Например, если указать значения свойств двунаправленного текста EIS только для адаптера ресурсов, то эти значения будут наследоваться и использоваться преобразованиями, которым требуется заданное свойство двунаправленного текста EIS, как во входящих (спецификация активации), так и в исходящих (фабрика управляемых соединений) транзакциях.

Однако, если указать значения свойств двунаправленного текста EIS как для адаптера ресурсов, так и для спецификации активации, то во входящей транзакции для преобразования будут использоваться значения из спецификации активации.

Логика обработки выполняет поиск значений свойств двунаправленного текста, необходимых для преобразования, с помощью механизма поиска. Механизм поиска начинает поиск заданных свойств с уровня, на котором вызывается преобразование, и продолжает его, перемещаясь вверх по иерархической структуре. Применяется первое допустимое найденное значение. Иерархическая структура просматривается в направлении от дочерних уровней к родительским; сестринские уровни не учитываются.

34 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 5. Планирование реализации адаптера Процесс реализации IBM WebSphere Adapter for FTP предусматривает планирование Планирование обработки входящих событий и исходящих запросов версии 1.4.1, обеспечивающий доступ к удаленной файловой системе. API Commons Net предоставляет интерфейс, применяемый для анализа нестандартного вывода Commons Net версии 1.4.1 приведена на Web-сайте http://jakarta.apache.org/commons/ Защита режима может потребоваться дополнительная настройка параметры брандмауэра.

Где server.cert - это сертификат сервера, а хранилище-доверенных-сертификатов это хранилище доверенных сертификатов клиента.

v Хранилище доверенных сертификатов задается путем обновления свойства JVM.

Например, javax.net.ssl.trustStore=C:\MyKeyStore\хранилище-сертификатов-клиента WebSphere Adapters в кластерной среде Производительность и готовность адаптера можно повысить путем развертывания © Copyright IBM Corp. управляемых вместе для эффективного распределения рабочей нагрузки, повышения готовности и масштабируемости. В ходе установки кластера серверов создается профайл диспетчера развертывания. HAManager (подкомпонент диспетчера развертывания) уведомляет контейнер JCA о необходимости активировать экземпляр адаптера. Контейнер JCA предоставляет среду выполнения для экземпляров адаптера. Дополнительная информация о кластерных средах приведена на Web-сайте http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/ com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm_cluster_v61.html.

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

В кластерной среде одно и то же событие могут обнаружить несколько экземпляров адаптера. Такой сценарий увеличивает вероятность повторной обработки события или возникновения ошибки данных. Например, если два экземпляра адаптера одновременно опрашивают одну таблицу событий с одинаковым фильтром типа событий, то один экземпляр может удалить данные, от которых зависит другой экземпляр. В кластерных средах существует риск параллельной обработки в Для того чтобы избежать этого, HAManager для входящих экземпляров адаптера принудительно обеспечивает изолированное поведение. Даже если все экземпляры адаптера запущены, только один из них обнаруживает и публикует событие в В ходе развертывания модуля адаптера в кластере контейнер JCA проверяет свойство enableHASupport объекта EJB ResourceAdapter. Если для свойства enableHASupport указано значение true, то контейнер JCA регистрирует все экземпляры адаптера в HAManager со стратегией 1 из N. Эта стратегия означает, что только один из серверов кластера запускает опрос событий (или прослушивание) для этого экземпляра экземпляры адаптера, они находятся в режиме ожидания по отношению к активному событию, до тех пор пока активный экземпляр адаптера не завершит обработку события. Если по каким-либо причинам сервер, на котором запущена нить опроса, завершит свою работу, то активизируется экземпляр адаптера, выполняющийся на В кластерной среде несколько экземпляров адаптера могут выполнять исходящие запросы. Соответственно, если в среде выполняется несколько приложений, которые взаимодействуют с одним и тем же адаптером WebSphere для исходящих запросов, то можно повысить производительность, развернув модуль адаптера в кластерной WebSphere Application Server Network Deployment содержит функцию управления рабочей нагрузкой, которая распределяет обработку исходящей информации среди экземпляров адаптера. В результате этого, исходящие операции в кластерной среде становятся подобны тем же операциям в среде одного сервера: один экземпляр 36 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя адаптера обрабатывает только один исходящий запрос в один момент времени.

Более подробная информация об управлении рабочей нагрузкой находится на Web-сайте http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/ com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.html.

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

После успешной установки WebSphere Adapter настраивается с помощью WebSphere Integration Developer. Затем он развертывается на сервере WebSphere Process Server или WebSphere Enterprise Service Bus в качестве файла EAR. На следующем рисунке показан соответствующий поток задач; ниже приведено описание каждой задачи.

Подробные инструкции по установке приведены в разделе Установка IBM WebSphere Adapters. Дополнительная информация о процедурах настройки и развертывания приведена в документации по адаптеру.

Рисунок 1. Путеводитель установки, настройки и развертывания адаптера a. (Необязательно) Настройте взаимодействие адаптера с информационной c. Создайте проект адаптера WebSphere Integration Developer (проекция J2EE) 38 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя d. (Необязательно) С помощью WebSphere Integration Developer добавьте в проекта адаптера требуемые внешние зависимости. Кроме того, эти зависимости должны входить в состав файла EAR, который экспортируется в ходе развертывания адаптера.

e. Для настройки адаптера запустите мастера поиска служб предприятия из проекции Интеграция бизнес-процессов WebSphere Integration Developer.

Мастер поиска служб предприятия создает компоненты интеграции бизнес-процессов и позволяет указать информацию, необходимую для начальной настройки адаптера. Вывод мастера поиска служб предприятия сохраняется в проекте модуля интеграции бизнес-процессов, содержащем бизнес-объект, файл импорта и файл экспорта.

f. (Необязательно) С помощью WebSphere Integration Developer создайте точки привязки для компонента, созданного мастером поиска служб предприятия.

3. Развертывание модуля a. В проекции J2EE WebSphere Integration Developer экспортируйте проект модуля интеграции бизнес-процессов в качестве файла EAR.

b. Установите модуль на сервере WebSphere Process Server или WebSphere Enterprise Service Bus.

c. (Необязательно) С помощью административной консоли задайте (или измените) следующие свойства:

v Свойства адаптера ресурсов v Свойства фабрики управляемых соединений (J2C) v Свойства спецификации активации для EIS 40 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 6. Установка адаптера Для установки адаптера следует проверить предварительные требования к системе и Предварительные требования к установке требованиям к программному и аппаратному обеспечению. Эти требования можно разделить на две категории: поддерживаемые платформы для запуска программы Список платформ, поддерживаемых программой установки адаптера, приведен в Описание требований к программному и аппаратному обеспечению для настройки, WebSphere Adapters and IBM WebSphere Business Integration Adapters: software В случае применения WebSphere Integration Developer версии 6.0.1.1 или более ранней в дополнительных файла Jar. Дополнительная информация приведена в разделе Выполнение установки Для всех адаптеров WebSphere Adapters предусмотрена общая процедура установки.

Адаптер можно установить с помощью графического пользовательского интерфейса © Copyright IBM Corp. Примечание: Для установки отдельных адаптеров WebSphere Adapters требуются установочный каталог по умолчанию, файл RAR сохраняется в следующем каталоге:

C:\Program Files\IBM\ResourceAdapters\ftp\adapter\ftp\deploy\CWYFT_FTPFile.rar.

Удаление адаптера из системы Процедура удаления из системы одинакова для всех адаптеров WebSphere Adapters.

Адаптер можно удалить из системы с помощью графического пользовательского Удаление адаптера из системы может потребоваться для устранения неполадок.

Инструкции по удалению адаптера из системы приведены в разделе Удаление из Примечание: Процедура удаления из системы развернутого адаптера описана в 42 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 7. Настройка адаптера для развертывания предусматривает создание проекта адаптера с помощью WebSphere Integration Developer, добавление в проект требуемых файлов, выбор бизнес-объектов, которые Создание псевдонима идентификации Псевдоним идентификации создается на сервере с помощью административной консоли WebSphere Process Server. Административная консоль позволяет настроить 1. На начальной странице административной консоли WebSphere выберите Защита Создание проекта адаптера с помощью WebSphere Integration Developer связанные артефакты. Он создается путем импорта в WebSphere Integration Developer © Copyright IBM Corp. Создайте проект адаптера (в контексте WebSphere Integration Developer - проект коннектора) для добавления адаптера, импортированного из установочного каталога адаптера, а также прочих связанных артефактов. Все проекты автономны - в них c. После открытия окна WebSphere Integration Developer закройте начальную 4. В окне Импортировать коннектор нажмите кнопку Обзор и выберите каталог, в 6. Необязательно: При необходимости измените имя проекта в поле Проект 7. Необязательно: В поле Целевой сервер выберите сервер для развертывания 44 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Переключатель Добавить модуль в проект EAR Обратите внимание, что после отмены выбора переключателя поле Проект EAR Создан новый проект коннектора J2EE. Для просмотра его содержимого разверните проект в Меню проектов. Например, если для проекта коннектора указано имя CWYFT_FTPFile, разверните запись CWYFT_FTPFile.

Создание пользовательских связываний данных Адаптер предусматривает возможность создания пользовательских связываний данных в соответствии с потребностями применяемой среды. Пользовательское связывание данных - это класс Java, предназначенный для преобразования потока данных в бизнес-объекты в ходе входящей обработки и бизнес-объектов в поток данных в ходе исходящей обработки. Операции экспорта и импорта информационной системы предприятия (EIS) и JMS можно настроить для вызова пользовательских Следующая процедура позволяет создать пользовательские связывания данных.

Инструкции по выполнению задачи Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера 1. Реализуйте пользовательское связывание данных с помощью интерфейса commonj.connector.runtime.RecordHolderDataBinding. Этот интерфейс расположен в файле commonj.connector.jar, который входит в состав динамических библиотек 2. Создайте пользовательское связывание данных с помощью входящей или DataObject getDataObject() пользовательского связывания данных. Сначала a. Метод setRecord принимает com.ibm.j2ca.base.UnstructuredRecord в качестве обработки адаптер вызывает методы public void setDataObject(DataObject dataObject) и public Record getRecord() пользовательского связывания данных.

бизнес-объекта, применяется файл CWYBS_AdapterFoundation.jar, содержащий класс com.ibm.j2ca.base.AdapterBOUtil. В состав этого класса входит метод, предназначенный для извлечения из бизнес-объекта информации о приложении.

46 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя 4. С помощью методов API бизнес-объектов извлеките из аннотации все значения.

Вывод представляет собой бизнес-объект, содержащий информацию о v В случае входящей обработки создайте экземпляр бизнес-объекта на основе значения recordName, содержащегося в записи без структуры.

v В случае входящей обработки вызовите getMetadataForObject() путем передачи бизнес-объекта в качестве параметра.

Настройте пользовательское связывание данных в соответствии с инструкциями, приведенными в файле катало-WPS\samples\doc\CustomEISDataBinding\index.html.

Настройка адаптера для обработки исходящих запросов Для настройки WebSphere Adapter for имя адаптера для обработки исходящих событий с помощью мастера поиска служб предприятия WebSphere Integration Developer задайте свойства соединения, выберите бизнес-объекты или службы в информационной системе предприятия, затем создайте определения бизнес-объектов и связанные артефакты для обработки исходящих событий.

Создание бизнес-объектов с помощью мастера поиска служб предприятия Мастер поиска служб предприятия позволяет найти бизнес-объекты и службы для применения в исходящем соединении с сервером FTP.

Настройка свойств соединения для поиска служб Мастер поиска служб предприятия (ESD) позволяет просмотреть все службы, доступные для адаптера, а также настроить параметры соединения с сервером FTP.

1. В окне WebSphere Integration Developer выберите проекцию Интеграция a. Выберите Окно Открыть проекцию Прочие в строке меню. Будут b. Выберите проекцию Интеграция бизнес-процессов.

2. Щелкните правой кнопкой мыши внутри окна Интеграция бизнес-процессов и выберите Создать Поиск служб предприятия. Если опция Поиск служб предприятия не показана, в списке опций меню выберите Прочие. В окне Выбрать мастер разверните папку Интеграция бизнес-процессов, выберите Поиск служб 3. Выберите IBM WebSphere Adapter for FTP в меню Импортировать конфигурации Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера бизнес-данных и выбора связывания данных, применяемого в динамическом бизнес-объектов. Например: C:\Program Files\IBM\ResourceAdapters\FTP\ символов, если бизнес-данные указаны в другой кодировке. Бизнес-данные это содержимое файлов, над которыми выполняются операции.

48 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Окно Настроить параметры агента поиска Результат С помощью этих свойств служба поиска подготавливает дерево метаданных, применяемое для выбора объектов и навигации в последующих задачах.

Выбор бизнес-объектов и служб Мастер поиска служб предприятия позволяет выбрать бизнес-объекты и службы, применяемые вместе с адаптером, для настройки работы адаптера после развертывания на сервере.

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

Инструкции по выполнению задачи 1. В окне Поиск служб предприятия нажмите кнопку Выполнить запрос для выбора бизнес-объектов.

2. Выберите бизнес-объекты в дереве объектов метаданных.

a. Выберите бизнес-объекты, которые требуется добавить в проект коннектора.

b. Нажмите кнопку Добавить в список импорта для добавления выбранных бизнес-объектов в проект. Эта кнопка доступна только для тех объектов, которые можно импортировать. Для остальных объектов она недоступна.

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера 3. Необязательно: Если в окне Настроить параметры агента поиска была выбрана опция настройки дополнительных бизнес-объектов, то при нажатии кнопки Добавить в список импорта откроется окно Конфигурация параметров заказчика, 4. После добавления в проект всех необходимых бизнес-объектов нажмите кнопку После добавления в модуль бизнес-объекты следует настроить для поддержки бизнес-объекта по умолчанию. При необходимости это значение можно изменить.

2. Введите расположение бизнес-объекта в поле Расположение бизнес-объекта. В 3. Нажмите кнопку Далее. По умолчанию выбираются все показанные операции.

50 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Окно Настроить объекты Результат Объекты настроены для исходящего обмена данными.

Создание артефактов С помощью мастера поиска служб предприятия можно создать описания бизнес-объектов и связанные артефакты для добавления бизнес-объекта контейнера в бизнес-функцию и создания нового собранного приложения адаптера (модуля SCA).

Созданные описания бизнес-объектов и связанные артефакты добавляются в новое приложение адаптера (модуль SCA).

1. В окне Создать артефакты нажмите кнопку Создать рядом с полем Модуль для создания нового модуля.

2. Выберите Создать проект модуля и нажмите кнопку Далее.

3. В окне Создать модуль в поле Имя модуля введите имя модуля и нажмите кнопку Готово. После создания бизнес-объекта указанное имя присваивается собранному приложению адаптера (модулю SCA).

4. В окне Создать артефакты выберите переключатель Использовать свойства найденного соединения.

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера 5. Введите свойства фабрики управляемых соединений адаптера FTP.

Дополнительная информация о свойствах приведена в разделе “Свойства фабрики 52 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Нижняя часть окна Создать артефакты 7. Нажмите кнопку Готово.

Результат Создаются следующие бизнес-объекты: WSDL, import, FTPFileBG, FTPFile, UnstructuredContent, CustomerWrapperBG, CustomerWrapper и Customer. Указанные пользователем бизнес-объекты приложения обновляются в соответствии с информацией о приложении для преобразования данных и сохраняются в расположении бизнес-объектов.

Создание привязки к ссылке С помощью редактора сборки свяжите проект адаптера и автономную ссылку.

Автономная ссылка указывает на базовый компонент J2EE. Путем создания ссылки между проектом адаптера и автономной ссылкой адаптер связывается с другими процессами сервера.

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

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера 1. В окне WebSphere Integration Developer выберите проекцию Интеграция 2. В проекции Интеграция бизнес-процессов WebSphere Integration Developer правой 54 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Значок Автономная ссылка c. Создайте проводник между автономной ссылкой и проектом адаптера. Для этого щелкните сбоку графического представления автономных ссылок и перенесите проводник на графическое представление проекта адаптера.

Окно связывания компонентов d. Выберите Файл Сохранить.

4. Выберите Файл Сохранить.

Результат Созданы привязки к ссылкам.

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера Настройка адаптера для обработки входящих событий Для настройки WebSphere Adapter for имя адаптера для обработки входящих событий с помощью мастера поиска служб предприятия WebSphere Integration Developer задайте свойства соединения, выберите бизнес-объекты или службы в информационной системе предприятия, затем создайте определения бизнес-объектов Создание бизнес-объектов с помощью мастера поиска Мастер поиска служб предприятия позволяет найти бизнес-объекты и службы для Мастер поиска служб предприятия (ESD) позволяет просмотреть все службы, доступные для адаптера, а также настроить параметры соединения с сервером FTP.

1. В окне WebSphere Integration Developer выберите проекцию Интеграция 2. Щелкните правой кнопкой мыши внутри окна Интеграция бизнес-процессов и мастер разверните папку Интеграция бизнес-процессов, выберите Поиск служб 3. Выберите IBM WebSphere Adapter for FTP в меню Импортировать конфигурации 56 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Окно Адаптер ресурсов служб предприятия 4. В окне Настроить параметры агента поиска укажите свойства поиска бизнес-данных и выбора связывания данных, применяемого в динамическом режиме.

a. В поле Имя папки укажите имя папки, в которой расположены схемы XSD бизнес-объектов. Например: C:\Program Files\IBM\ResourceAdapters\FTP\ adapter\FTP\Samples. Бизнес-объекты для применения в сценариях интеграции выбираются в определениях схем из указанной папки.

b. Необязательно: Укажите значение в поле Набор символов. Выберите набор символов, если бизнес-данные указаны в другой кодировке. Бизнес-данные это содержимое файлов, над которыми выполняются операции.

Примечание: В случае применения сценариев, созданных с помощью WebSphere Integration Developer, набор символов выбирать не c. Введите значение в поле Тип содержимого. Этот одноразовый параметр применяется для объединения типа содержимого с соответствующим связыванием данных. Отображаются все типы содержимого, поддерживаемые адаптером.

d. Необязательно: Если требуется настроить дополнительные свойства бизнес-объектов, выберите переключатель Настроить свойства бизнес-объектов. Если этот переключатель выбран, последовательно откроются окна, позволяющие задать свойства отдельных бизнес-объектов.

5. Определив все свойства, нажмите кнопку Далее.

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера С помощью этих свойств служба поиска подготавливает дерево метаданных, Мастер поиска служб предприятия позволяет выбрать бизнес-объекты и службы для Перед выбором в информационной системе предприятия бизнес-объектов и служб для настройки адаптера необходимо указать свойства соединения с адаптером для 1. В окне Поиск служб предприятия нажмите кнопку Выполнить запрос для выбора a. Выберите бизнес-объекты, которые требуется добавить в проект коннектора.

58 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Окно поиска служб предприятия В окне Импортируемые объекты отображаются выбранные объекты. При необходимости их можно удалить с помощью кнопки Удалить выбранное.

3. Необязательно: Если в окне Настроить параметры агента поиска была выбрана опция настройки дополнительных бизнес-объектов, то при нажатии кнопки Добавить в список импорта откроется окно Конфигурация параметров заказчика, позволяющее указать свойства отдельных бизнес-объектов.

4. После добавления в проект всех необходимых бизнес-объектов нажмите кнопку Далее.

Настройка выбранных объектов После добавления в модуль бизнес-объекты следует настроить для входящих операций.

1. В окне Настроить объекты мастера поиска служб предприятия выберите Inbound в списке Тип службы. Будет показано базовое пространство имен схемы бизнес-объекта по умолчанию. При необходимости это значение можно изменить.

2. Введите расположение бизнес-объекта в поле Расположение бизнес-объекта. В проекте коннектора будет создан каталог с указанным именем.

3. Нажмите кнопку Далее. По умолчанию выбираются все показанные операции.

При необходимости список можно изменить с помощью кнопок Добавить и Удалить.

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера бизнес-объектов и связанные артефакты для добавления бизнес-объекта контейнера в бизнес-функцию и создания нового собранного приложения адаптера (модуля SCA).

Созданные описания бизнес-объектов и связанные артефакты добавляются в новое Готово. После создания бизнес-объекта указанное имя присваивается собранному 3. В окне Создать артефакты выберите переключатель Использовать свойства 60 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Окно Создать артефакты 4. Укажите обязательные свойства спецификации активации, указанные звездочкой (*). Дополнительная информация о свойствах приведена в разделе “Свойства спецификации активации” на стр. 124. Обязательные свойства приведены в следующем списке:

v Имя JNDI DataSource Имя JNDI, применяемое для создания соединения JDBC с источником данных, с помощью которого адаптер сохраняет события в таблице базы данных хранилища событий. Источник данных следует предварительно настроить с помощью административной консоли WebSphere Process Server.

v Имя таблицы событий Имя таблицы, предназначенной для хранения событий.

v Каталог событий ftp://[имя-пользователя:пароль@]имя-хоста[:порт]/каталог-событий Если идентификационные данные не указаны в URL, их следует указать в полях Имя пользователя и Пароль.

v Маска файла событий Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера Создаются следующие бизнес-объекты: WSDL, import, FTPFileBG, FTPFile, UnstructuredContent, CustomerWrapperBG, CustomerWrapper и Customer. Указанные пользователем бизнес-объекты приложения обновляются в соответствии с Создайте привязку к ссылке между адаптером и модулем проекта, для того чтобы Перед созданием привязки к ссылке следует сохранить и настроить проект адаптера.

1. В окне WebSphere Integration Developer выберите проекцию Интеграция 2. В проекции Интеграция бизнес-процессов WebSphere Integration Developer правой 62 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Значок Компонент в окне диаграммы сборки b. Щелкните на значке Компонент (без типа реализации) и перенесите компонент в рабочую область редактора.

Значок Компонент c. Щелкните на значке Проводник и перенесите его из FTPInboundInterface в Component1 для создания связывания.

Глава 7. Настройка адаптера для развертывания, WebSphere Adapter for имя адаптера 64 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 8. Развертывание модуля экспортировать проект в архив EAR, установить проект адаптера, добавить свойства предприятия, и при необходимости создать кластер приложений проекта адаптера.

Экспорт проекта в качестве файла EAR Мастер поиска служб предприятия позволяет экспортировать созданный проект в Установка модуля Установка проекта адаптера - это последний этап процесса развертывания. Когда вы устанавливаете проект адаптера и запускаете его, адаптер, встроенный в модуль Перед установкой проекта адаптера убедитесь, что в проект адаптера экспортирован Следующая процедура позволяет установить модуль адаптера. Дополнительная информация о добавлении приложений проекта в кластер приведена на Web-странице http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp.

© Copyright IBM Corp. 1. Откройте административную консоль WebSphere Process Server. Для этого 2. В окне административной консоли выберите Приложения Установить новые 4. Необязательно: В случае развертывания в кластерной среде, нажимайте кнопку Применить. Примечание: Если для свойства enableHASupport указано значение 66 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя 6. Выберите Псевдоним идентификации SCA в списке выбора записи 7. Выберите переключатель рядом с модулем и нажмите кнопку Применить.

8. Нажмите кнопку Далее. Будет показан обзор всех опций установки.

9. Проверьте правильность всех опций, затем нажмите Готово.

10. Убедитесь, что приложение установлено успешно.

11. Щелкните на ссылке Сохранить в главной конфигурации, показанной в конце 12. Нажмите кнопку Сохранить.

Теперь проект развернут и для развернутого приложения показано окно Приложения Если вы хотите задать или сбросить адаптер ресурсов, фабрику управляемых соединений, свойства спецификации активации, свойства преобразования данных или вы хотите объединить в кластер приложения проекта адаптера, то сделайте это в административной консоли WebSphere Process Server до того, как приступите к настройке инструментов устранения неполадок.

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

Настройка свойств адаптера ресурсов Свойства адаптера ресурсов можно задать с помощью административной консоли.

3. В списке Приложения J2EE выберите имя приложения адаптера, свойства 4. Прокрутите страницу до конца вниз. В разделе Связанные элементы выберите 8. Для каждого изменяемого свойства выполните следующие действия:

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

4. Прокрутите страницу до конца вниз. В разделе Связанные элементы выберите 7. В разделе Дополнительные свойства выберите Фабрики соединений J2C.

8. Щелкните на имени фабрики соединений J2C, которую требуется изменить.

9. Выберите Другие свойства. Другие свойства - это свойства фабрики соединений 10. Для каждого изменяемого свойства выполните следующие действия:

68 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя 11. Выберите Сохранить в поле Сообщения в верхней части окна.

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

2. В разделе Приложения выберите Приложения J2EE 3. В списке Приложения J2EE выберите имя приложения адаптера, свойства которого требуется изменить.

4. Прокрутите страницу до конца вниз. В разделе Связанные элементы выберите Модули коннекторов.

5. Щелкните на файле CWYFT_FTPFile.rar.

6. Выберите Адаптер ресурсов.

7. В разделе Дополнительные свойства выберите Спецификации активации J2C.

8. Щелкните на имени приложения параметра, которое требуется изменить.

9. Выберите Пользовательские свойства спецификации активации J2C.

10. Для каждого изменяемого свойства выполните следующие действия:

a. Щелкните на имени свойства.

b. Измените содержимое поля Значение или введите значение, если оно не Дополнительная информация о свойствах приведена в разделе “Свойства спецификации активации” на стр. 124.

11. Выберите Сохранить в поле Сообщения в верхней части окна.

70 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 9. Настройка средств устранения неполадок Настройте средства устранения неполадок в соответствии с вашими требованиями.

Для управления состоянием обработки событий разрешите ведение протокола адаптера. Для сбора диагностической информации об адаптере включите поддержку определения степени подробности информации, заносимой в файлы протоколов и трассировки. Установите IBM Support Assistant для получения быстрого доступа к Включение трассировки с поддержкой инфраструктуры обработки событий общего формата (CEI) Включение трассировки и управление степенью подробности данных трассировки v WebSphere Process Server: http://www.ibm.com/software/integration/wps v WebSphere Enterprise Service Bus: http://www.ibm.com/software/integration/wsesb © Copyright IBM Corp. 5. Выберите компонент для вашего адаптера. Каждый компонент адаптера содержит Например, com.ibm.j2ca.siebel.cei.adapter_ID1. Каждому экземпляру развернутого 7. В списке выберите уровень подробности информации о бизнес-объектах для WebSphere Integration Developer соответствует уровню подробности контроля v finer. Включить CEI с публикацией только описания нагрузки бизнес-объектов.

В WebSphere Integration Developer соответствует уровню подробности контроля WebSphere Integration Developer соответствует уровню подробности контроля инфраструктурой обработки событий общего формата приведена в документации Настройка свойств протокола Административная консоль позволяет разрешить ведение протокола, а также задать его свойства, такие как расположение, уровень подробности и формат вывода.

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

v Указать расположение для сохранения файлов протокола и число сохраняемых можно открыть с помощью анализатора протоколов, который представляет собой приложение, поставляемое вместе с сервером процессов. Анализатор протоколов 72 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Дополнительная информация об отслеживании работы сервера процессов, в том числе описание компонентов служб и точек событий, приведена в документации по серверу процессов.

Конфигурацию протокола можно изменить в статическом или динамическом режиме. Статические изменения конфигурации применяются в ходе запуска или перезапуска сервера приложений. Динамические изменения применяются немедленно.

При создании протокола уровень подробности для него устанавливается на основе данных конфигурации. Если для конкретного протокола данные конфигурации недоступны, уровень подробности определятся в соответствии с конфигурацией родительского протокола. Поиск данных конфигурации в родительских протоколах выполняется до тех пор, пока не будут найдены допустимые данные. Изменение уровня протокола рекурсивно применяется ко всем его дочерним протоколам.

Следующая процедура позволяет разрешить ведение протокола и задать свойства его вывода.

Инструкции по выполнению задачи 1. В панели навигации административной консоли выберите Серверы Серверы приложений.

2. Щелкните на имени нужного сервера.

3. В разделе Устранение неполадок выберите Протоколы и трассировка.

4. Нажмите кнопку Изменить уровни подробности протоколов.

5. Укажите, каким образом следует применять изменения:

v Для статического изменения конфигурации перейдите на вкладку Конфигурация.

v Для динамического изменения конфигурации перейдите на вкладку Среда выполнения.

6. Выберите пакеты, уровни которых требуется изменить. Имена пакетов WebSphere Adapters начинаются со строки com.ibm.j2ca:

v Для базового компонента адаптера выберите com.ibm.j2ca.base.

v Для базового компонента адаптера и всех развернутых адаптеров выберите com.ibm.j2ca.base.*.

v Для конкретного адаптера выберите связанный пакет.

WebSphere Adapter for JD Edwards EnterpriseOne com.ibm.j2ca.jde WebSphere Adapter for Siebel Business Applications com.ibm.j2ca.siebel 7. Щелкните на имени пакета и выберите уровень ведения протокола.

Уровень ведения Fatal Невозможно продолжить работу задачи или компонента.

10. Для применения статических изменений конфигурации остановите и Изменение имен файлов протоколов и трассировки По умолчанию данные протоколов и трассировки для всех процессов и приложений Process Server сохраняются в файлах SystemOut.log и trace.log соответственно. Для разделения данных протокола и трассировки разных процессов измените имена При необходимости после развертывания адаптера на сервере приложений имена Конфигурацию ведения протокола можно изменить как в статическом, так и в динамическом режиме. Статические изменения применяются в ходе запуска или перезапуска сервера приложений. Динамические изменения применяются немедленно.

Файлы протоколов и трассировки расположены в каталоге установочный-каталог/ Следующая процедура позволяет задать или изменить имена файлов протоколов и расширения.ear. Например, для файла EAR с именем Accounting_OutboundApp.ear 74 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя WebSphere Adapter for Siebel Business Applications CWYEM_Siebel.rar 5. Щелкните на имени адаптера ресурсов.

6. В области Другие свойства укажите имена файлов:

v Для изменения имени файла протокола введите имя в поле Значение для свойства logFilename. Значение по умолчанию - SystemOut.log.

v Для изменения имени файла трассировки введите имя в поле Значение для свойства traceFilename. Значение по умолчанию - trace.log.

7. Для применения статических изменений остановите и перезапустите сервер Установка и обновление IBM Support Assistant IBM Support Assistant (ISA) - это свободно распространяемая, локальная рабочая среда обслуживания программного обеспечения, помогающая решать вопросы и проблемы, связанные с программными продуктами IBM. Установите модули для установленных продуктов. Она позволяет быстро получить доступ к информации поддержки, а также к инструментам обслуживания, предназначенным для поиска и устранения неполадок. Процедура установки и обновления выполняется быстро и IBM Support Assistant предоставляет следующие возможности:

v Доступ к данным службы поддержки IBM, конференциям IBM и другим ресурсам через объединенный интерфейс поиска (одновременный поиск по нескольким v Упрощенный доступ к обучающим материалам IBM.

v Упрощенный доступ к домашним страницам продуктов IBM, страницам поддержки продуктов, форумам и конференциям по продуктам через удобные v Среда инструментов и администратор обновления, позволяющие легко обновлять и устанавливать модули и инструменты ISA.

v Быстрый анализ записей о неполадках за счет передачи важных данных о системе В отдельной системе можно одновременно установить IBM Support Assistant версий и 3. Такой подход позволяет получить поддержку для широкого диапазона решений Следующая процедура позволяет установить и обновить IBM Support Assistant.

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

6. На вкладке Новые продукты и инструментарий установите модули для адаптера.

76 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя Глава 10. Администрирование адаптера С помощью административной консоли сервера можно запускать и останавливать Запуск адаптера Для запуска остановленного адаптера применяется административная консоль. По Для выполнения этой задачи необходимо запустить административную консоль.

Адаптеру присваивается состояние Запущен; в верхней части страницы отображается Остановка адаптера Для выполнения этой задачи необходимо запустить административную консоль.

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

С помощью административной консоли сервера устраните неполадки адаптера.

© Copyright IBM Corp. Устранение неполадок и поддержка Общие методики устранения неполадок и подробная справочная информация позволяют быстро обнаруживать и устранять неполадки. При необходимости XAResourceNotAvailableException Если протокол сервера процессов содержит повторяющиеся записи об исключительной ситуации com.ibm.ws.Transaction.XAResourceNotAvailableException, В ходе запуска адаптера в протокол сервера процессов повторно заносится сообщение com.ibm.ws.Transaction.XAResourceNotAvailableException Ресурс был удален во время фиксации или отката транзакции, связанной с этим ресурсом. В ходе запуска адаптер пытается восстановить транзакцию, однако это 2. Удалите файл протокола транзакций, содержащий транзакцию. Найдите транзакцию с помощью информации, приведенной в трассировке исключительной каталог-сервера\profiles\имя-профайла\tranlog\имя-узла\wps\имясервера\transaction\tranlog Устранение неполадок, связанных с обработкой событий В случае завершения работы сервера базы данных в ходе выполнения входящей операции адаптер выдает исключительную ситуацию. Для обработки событий 78 IBM WebSphere Адаптеры: Adapter for FTP - Руководство пользователя После перезапуска базы данных и адаптера обработка событий возобновляется автоматически.

Справочные ресурсы Справочные ресурсы службы поддержки программного обеспечения IBM позволяют получить последнюю информацию о поддержке и техническую документацию, загрузить инструменты и исправления, а также предотвратить неполадки WebSphere Adapter for имя адаптера. Кроме того, в справочных ресурсах приведены инструкции по диагностике неполадок адаптера и обращению в службу поддержки программного обеспечения IBM.

На Web-сайте WebSphere Adapters (http://www.ibm.com/software/integration/wbiadapters/ supp) приведены ссылки на следующие ресурсы:

v Информационные сообщения (предупреждения из службы технической поддержки) v Технические комментарии Список комментариев для WebSphere Adapters можно найти по следующему адресу: http://www.ibm.com/support/search.wss?rs=695&tc=SSMKUK v Отчеты об анализе лицензионных программ (APAR) v Техническая информация, в том числе справочная система Information Center продукта, руководства, IBM Redbook и официальные документы.

v Программы обучения v IBM Software Support Handbook Зарегистрируйтесь на сайте для создания собственной страницы поддержки.

Обращение в службу поддержки программного обеспечения IBM Служба поддержки программного обеспечения IBM позволяет получить поддержку для WebSphere Adapters по телефону или по сети Internet. Перед обращением в службу поддержки программного обеспечения IBM рекомендуется собрать подробную информацию о неполадке, поскольку это позволит значительно ускорить получение Перед тем, как начать Если вы считаете, что неполадка связана с дефектом, служба поддержки программного обеспечения IBM окажет вам помощь. Перед обращением в службу поддержки программного обеспечения IBM убедитесь, что ваша организация заключила с IBM контракт на обслуживание программного обеспечения и имеет право отправлять отчеты о неполадках в IBM. Тип необходимого контракта на обслуживание программного обеспечения зависит от установленного продукта:

v Для распределенных программных продуктов IBM (включая следующие продукты, но не ограничиваясь ими: Tivoli, Lotus и Rational, а также DB2 и WebSphere для операционных систем Windows, Linux и UNIX) требуется регистрация в программе Passport Advantage. Зарегистрироваться можно одним из следующих способов:

Откройте Web-страницу Passport Advantage (http://www-306.ibm.com/ software/support/pa.html) и щелкните на ссылке How to Enroll.

Для того чтобы найти номер телефона, по которому можно обратиться в своей стране, перейдите на страницу контактной информации IBM Software Support Handbook (http://techsupport.services.ibm.com/guides/contacts.html) и v Для продуктов IBM eServer (включая следующие продукты, но не ограничиваясь ими: DB2 и WebSphere для zSeries, pSeries и iSeries) можно заключить соглашение представителем или деловым партнером IBM. Дополнительная информация о поддержке программных продуктов eServer приведена на Web-сайте IBM Technical Support Advantage (http://www-03.ibm.com/servers/eserver/techsupport.html).



Pages:     || 2 |


Похожие работы:

«Семинар Сложные вопросы налогообложения. Практика методологии исчисления отдельных видов налогов Семинар Сложные вопросы налогообложения. Практика методологии исчисления отдельных видов налогов Организатор: ЦНТИ ПРОГРЕСС Время проведения: с 17 по 21 июня 2013 года. Место проведения: Учебный комплекс ЦНТИ Прогресс г. Санкт-Петербург, Васильевский остров, Средний пр-т, д. 36/40 ст. метро Василеостровская Начало занятий: понедельник 17 июня 09:00 На кого ориентирован и кому будет полезен этот...»

«Оглавление ПРЕЗИДЕНТ Водителям-иностранцам для работы по найму придется получать российские права Реформа РАН не скажется негативно на работе сотрудников академических институтов - президент РФ. 5 Программа Материнский капитал после 2016 года должна стать более адресной - Владимир Путин. 5 Путин считает успех россиян в Казани результатом отличной подготовки Путин: итоги проверки боеготовности ВВО более чем удовлетворительны Путин: целью РФ в G20 стало стимулирование роста числа рабочих мест...»

«МИНОБРНАУКИ РОССИИ Государственное образовательное учреждение высшего профессионального образования Поморский государственный университет имени М.В. Ломоносова (ПГУ имени М.В. Ломоносова) Основная образовательная программа высшего профессионального образования Направление подготовки: 060602.65 Медицинская биофизика Квалификация (степень): специалист Форма обучения: очная Архангельск 2011 г. Общие положения. 1. 1.1. Основная образовательная программа (ООП) подготовки специалиста, реализуемая ПГУ...»

«Сведения о разработке и утверждении рабочей программы дисциплины Рабочая программа дисциплины Введение в специальность регионального компонента цикла ОПД составлена в соответствии с Государственным образовательным стандартом высшего профессионального образования второго поколения для специальности 080502.65 Экономика и управление на предприятии (по отраслям) Автор (ы) Большакова Н.Н. Рецензент (ы) Горюнов В.Н., профессор кафедры финансов и бухучета Сибирского филиала Международного института...»

«РАЗДЕЛ I ОБЩИЕ ПОЛОЖЕНИЯ 1.1. Муниципальное бюджетное образовательное учреждение дополнительного образования детей Вурнарская детская школа искусств Вурнарского района Чувашской Республики (далее – Учреждение) создано путем изменения типа муниципального образовательного учреждения дополнительного образования детей Вурнарская детская школа искусств в соответствии с постановлением Главы Вурнарского района от 03 августа 2011 г. №434. Школа является некоммерческим образовательным учреждением...»

«Государственное образовательное учреждение Высшего профессионального образования Липецкий государственный технический университет Металлургический институт УТВЕРЖДАЮ Директор металлургического института В.Б. Чупров _2011 г. РАБОЧАЯ ПРОГРАММА ДИСЦИПЛИНЫ (МОДУЛЯ) УСТАЛОСТНАЯ ПРОЧНОСТЬ ДЕТАЛЕЙ МАШИН Направление подготовки Технологические машины и оборудование Профиль подготовки Металлургические машины и оборудование Квалификация (степень) выпускника бакалавр Форма обучения очная г. Липецк – 2011...»

«МИНИСТЕРСТВО СЕЛЬСКОГО ХОЗЯЙСТВА РОССИЙСКОЙ ФЕДЕРАЦИИ Федеральное государственное образовательное учреждение высшего профессионального образования Саратовский государственный аграрный университет имени Н.И. Вавилова 1. Цель освоения дисциплины СОГЛАСОВАНО УТВЕРЖДАЮ Целью освоения дисциплины Почвоведение и инженерная геология Заведующий кафедрой Декан факультета является формирование у студентов навыков проведения почвенноэкологического обследования и использования его /Морозов А.А./ результатов...»

«УТВЕРЖДАЮ Директор НОУ Свято-Владимирская Православная школа Кондюрина М.Л. 27августа2013 г. Основная образовательная программа основного общего и среднего общего образования Негосударственного общеобразовательного учреждения Свято-Владимирская Православная школа Принято на заседании Педагогического совета протокол №1 от 27 августа 2013г. 1 СОДЕРЖАНИЕ: I. Целевой раздел 4 1.1. Пояснительная записка. 1.2. Планируемые результаты освоения обучающимися основной образовательной программы основного...»

«СОДЕРЖАНИЕ 1 стр. 3 1. ПАСПОРТ ПРИМЕРНОЙ ПРОГРАММЫ УЧЕБНОЙ ДИСЦИПЛИНЫ 5 2. СТРУКТУРА И ПРИМЕРНОЕ СОДЕРЖАНИЕ УЧЕБНОЙ ДИСЦИПЛИНЫ 14 3. УСЛОВИЯ РЕАЛИЗАЦИИ ПРИМЕРНОЙ ПРОГРАММЫ УЧЕБНОЙ ДИСЦИПЛИНЫ 15 4. КОНТРОЛЬ И ОЦЕНКА РЕЗУЛЬТАТОВ ОСВОЕНИЯ УЧЕБНОЙ ДИСЦИПЛИНЫ 2 1. ПАСПОРТ РАБОЧЕЙ ПРОГРАММЫ УЧЕБНОЙ ДИСЦИПЛИНЫ Налоги и налогообложение 1.1. Область применения программы Рабочая программа учебной дисциплины является частью основной профессиональной образовательной программы в соответствии с ФГОС по...»

«ОФИЦИАЛЬНО Индекс № 241 (23885) Суббота, 21 декабря 2013 года № 96 (180) 2109 НИЖНЕТАГИЛЬСКАЯ ГОРОДСКАЯ ДУМА ШЕСТОЙ СОЗЫВ Двадцать пятое заседание РЕШЕНИЕ от 20.12.2013 № 52 О бюджете города Нижний Тагил на 2014 год и плановый период 2015 и 2016 годов Рассмотрев представленный Главой города проект бюджета города Нижний Тагил на 8. Утвердить свод расходов бюджета города Нижний Тагил по разделам, подразгод и плановый период 2015 и 2016 годов, итоги публичных слушаний по вопросу делам, целевым...»

«СОГЛАСОВАНО УТВЕРЖДАЮ Заместитель Министра образования Заместитель Министра образования и и науки Российской Федерации науки Российской Федерации / А.Б. Повалко / / Л.М. Огородова / 23 декабря 2013 г. 24 декабря 2013 г. КОНКУРСНАЯ ДОКУМЕНТАЦИЯ по проведению конкурсного отбора на предоставление субсидий в рамках реализации федеральной целевой программы Исследования и разработки по приоритетным направлениям развития научно-технологического комплекса России на 2014 - 2020 годы Мероприятие 1.2, 2...»

«Министерство образования Республики Беларусь Учреждение образования Белорусский государственный университет информатики и радиоэлектроники Утверждаю Проректор по учебной работе и социальным вопросам _ А.А. Хмыль _05_052014 г. ПРОГРАММА вступительного экзамена в магистратуру по специальности 1-45 80 02 Телекоммуникационные системы и компьютерные сети факультета Телекоммуникаций Профилирующая кафедра: Сети и устройства телекоммуникаций 2014 Программа составлена на основе типовых учебных программ...»

«Международная деятельность МЕЖДУНАРОДНАЯ ДЕЯТЕЛЬНОСТЬ В 2013 году сотрудники Института активно сотрудничали с зарубежными научными организациями и компаниями, учеными, участвовали в международных научных совещаниях, конгрессах, конференциях, симпозиумах и семинарах. Международная научно-техническая деятельность Института осуществляется по следующим основным направлениям. Участие сотрудников в международных форумах, конгрессах, совещаниях, конференциях, симпозиумах, выставках, круглых столах,...»

«Пояснительная записка Программа вступительного испытания в аспирантуру по направлению подготовки: 47. 06. 01 Философия, этика и религиоведение (Исследователь. Преподаватель-исследователь). Профиль 09.00.01 – Онтология и теория познания составлена в соответствии с требованиями Федерального государственного образовательного стандарта. Вступительные испытания проводятся в форме экзамена, цель которого выявить способности и готовность абитуриента к обучению по образовательным программам...»

«ФЕДЕРАЛЬНОЕ АГЕНТСТВО ПО РЫБОЛОВСТВУ Федеральное государственное унитарное предприятие Всероссийский институт рыбного хозяйства и океанографии (ФГУП ВНИРО) ДОКЛАД об основных результатах научных исследований ФГУП ВНИРО в 2010 году МОСКВА, 2011 УДК 639.2.001.5 Ответственные за выпуск: Сытова М.В. канд. техн. наук; Мовсесова Н.В. Составители: Абрамова Л.С., д-р техн. наук; Бизиков В.А., д-р биол. наук; Булатов О.А., д-р биол. наук; Глубоков А.И., д-р биол. наук; Глубоковский М.К., д-р биол. наук;...»

«МУНИЦИПАЛЬНОЕ БЮДЖЕТНОЕ ОБРАЗОВАТЕЛЬНОЕ УЧРЕЖДЕНИЕ СРЕДНЯЯ ОБЩЕОБРАЗОВАТЕЛЬНАЯ ШКОЛА № 7 ПРОГРАММА поисково-исследовательской деятельности музея Боевой и Трудовой Славы Возрождение г. Нижневартовск 2012 год Пояснительная записка Музей - специфический институт науки, культуры и образования. Он призван выполнять свои, присущие только ему функции. К исторически сложившимся социальным функциям музея относят функцию документирования и образовательно-воспитательную. Другими функциями музея являются...»

«МИНИСТЕРСТВО ОБРАЗОВАНИЯ И НАУКИ РОССИЙСКОЙ ФЕДЕРАЦИИ Г ОУ ВПО Р О С С ИЙ С К О-А Р МЯ Н С К ИЙ (С Л А ВЯ НС КИ Й) УН ИВ Е РСИ Т Е Т авлена в соответствии с федеральными государственными ованиями к структуре основной профессиональной зовательной программы послевузовского УТВЕРЖДАЮ: фессионального образования (аспирантура) Проректор по научной работе _ П.С. Аветисян 2011г. Факультет Прикладной математики и информатики Кафедра Математической кибернетики Учебная программа подготовки аспиранта...»

«СОДЕРЖАНИЕ 1 Общие положения 1.1. ФГОС по направлению подготовки ВПО и другие нормативные документы, необходимые для разработки ООП 1.2 Нормативные документы для разработки ООП бакалавриата по направлению подготовки 230100 Информатика и вычислительная техника 1.3.Общая характеристика вузовской основной образовательной программы высшего профессионального образования (бакалавриат) 1.3.1. Цель (миссия) ООП бакалавриата по направлению Информатика и вычислительная техника, образовательная программа...»

«МИНИСТЕРСТВО ОБРАЗОВАНИЯ И НАУКИ РОССИЙСКОЙ ФЕДЕРАЦИИ ФЕДЕРАЛЬНОЕ ГОСУДАРСТВЕННОЕ БЮДЖЕТНОЕ ОБРАЗОВАТЕЛЬНОЕ УЧРЕЖДЕНИЕ ВЫСШЕГО ПРОФЕССИОНАЛЬНОГО ОБРАЗОВАНИЯ МОСКОВСКИЙ ГОСУДАРСТВЕННЫЙ ЮРИДИЧЕСКИЙ УНИВЕРСИТЕТ имени О.Е. КУТАФИНА (МГЮА) Кафедра гражданского и семейного права ГРАЖДАНСКОЕ ПРАВО Рабочая программа Направление подготовки: юриспруденция Квалификация (степень) выпускника: бакалавр Форма обучения: очная, очно-заочная, заочная Москва Издательский центр Университета имени О.Е. Кутафина...»

«Справочник 500 некоммерческих организаций Ярославской области 2014 Уважаемые читатели! Вы держите в руках Справочник некоммерческих организаций Ярославской области. Он явился результатом деятельности, поддержанной в рамках региональной программы Государственная поддержка социально ориентированных некоммерческих организаций при поддержке Губернатора Ярославской области. Стратегическая цель проекта — укрепить и развить социально ориентированные некоммерческие организации Ярославской области...»






 
2014 www.av.disus.ru - «Бесплатная электронная библиотека - Авторефераты, Диссертации, Монографии, Программы»

Материалы этого сайта размещены для ознакомления, все права принадлежат их авторам.
Если Вы не согласны с тем, что Ваш материал размещён на этом сайте, пожалуйста, напишите нам, мы в течении 1-2 рабочих дней удалим его.