IBM Content Integrator (ICI) обеспечивает интеграцию контента (документов и изображений), хранящегося в разнородных репозиториях. Благодаря использованию ICI разнородные репозитории контента, работающие на различных платформах, в том числе на z/OS®, Windows® и Linux®, могут выступать в роли единой инфраструктурной среды предприятия. Таким образом, ICI позволяет компаниям оптимально использовать имеющиеся активы и избежать дополнительных затрат на поддержку консолидации данных. ICI может быть установлен на различных операционных платформах, однако данная статья рассматривает вопросы конфигурирования ICI для управления несколькими репозиториями в одном конкретном случае, а именно для ICI, работающего на платформе z/OS.
Статья описывает инструменты ICI и готовые примеры программного кода, позволяющие выполнять определенные операции по работе с контентом без использования API конкретных репозиториев. Инструменты управления ICI Administration Tool позволяют настроить подключения к нескольким репозиториям контента, работающим на различных операционных платформах. Браузер ICI позволяет искать и просматривать контент из нескольких разнородных источников.
Ознакомившись с материалом данной статьи, вы узнаете, как настроить ICI на z/OS для доступа к контенту, хранящемуся в репозитории на хосте Windows или z/OS. Вы сможете проверить правильность своих настроек и просмотреть или выполнить поисковые запросы для контента, хранящегося в различных источниках, с помощью инструментов и готовых примеров ICI.
Необходимое программное обеспечение
Поскольку данная статья рассматривает функциональность ICI на z/OS, для лучшего понимания изложенного здесь материала вам потребуются базовые представления об ICI и z/OS. Кроме того, для выполнения всех шагов, описанных в статье, вам понадобятся следующие программные продукты:
- IBM Content Integrator
- IBM FileNet® P8 Content Manager
- IBM DB2® Content Manager
Настройка доступа к репозиториям с помощью инструментов администрирования ICI Administration Tool
Инструменты администрирования ICI Administration Tool позволяют настроить доступ к различным репозиториям из рабочей среды ICI. Так как мы рассматриваем случай ICI, работающего локально на z/OS, вам потребуется X-сервер для отображения графического интерфейса ICI на удаленном компьютере. Например, если вы используете Windows-хост для удаленной работы с графическим интерфейсом ICI, работающего на z/OS, вы можете воспользоваться какой-либо реализацией X-сервера, например, Exceed.
Чтобы открыть окно администрирования ICI Administration Tool на удаленном Windows-хосте, необходимо выполнить следующие шаги:
- На системе z/OS укажите настройки удаленного дисплея. Для этого введите
export DISPLAY=your-system-ip:0.0Здесьyour-system-ipсоответствует IP-адресу вашего Windows-хоста. - На хосте Windows запустите Exceed или любой другой эквивалентный X-сервер.
- Активизируйте окно администрирования ICI Administration Tool, выполнив соответствующий скрипт, который находится в корневой директории установки Content Integrator.
Настройка доступа к репозиторию, работающему в среде z/OS
Воспользуемся IBM DB2 Content Manager в качестве примера репозитория, который может быть установлен и запущен на платформе z/OS. ICI поддерживает интеграцию контента, хранящегося в DB2 Content Manager.
Для настройки подключения к репозиторию DB2 Content Manager, работающему в среде z/OS, необходимо выполнить следующие шаги:
- В окне администрирования ICI Administration Tool выберите Connectors > New IBM DB2 Content Manager Connector.
- В редакторе свойств Properties Editor коннектора укажите в поле ICM Servers File полный путь к файлу cmbicmsrvs.ini, соответствующему вашему репозиторию. Аналогично, укажите в поле ICM Environment File полный путь к файлу cmbicmsrvs.ini, соответствующему вашему репозиторию.
- Установите все остальные свойства коннектора, как показано на рисунке 1.
- Сохраните новую конфигурацию.
Рисунок 1. Окно администрирования ICI, работающего на удаленной системе z/OS, с настройками коннектора для подключения к IBM DB2 Content Manager
Примечание: В рассматриваемом примере репозиторий DB2 Content Manager и ICI, вообще говоря, не обязаны работать на одной и той же платформе z/OS. ICI поддерживает подключение к удаленному репозиторию DB2 Content Manager через прокси-коннектор RMI или без него (прямое соединение).
Настройка подключения к репозиторию, работающему в среде Windows
Рассмотрим случай, когда необходимый контент хранится в репозитории IBM FileNet P8 Content Manager, работающем в среде Windows. Для интеграции контента по-прежнему будем использовать ICI, установленный на платформе z/OS.
Для настройки подключения к IBM FileNet P8 Content Manager в окне администрирования ICI необходимо выполнить следующие действия:
- В окне администрирования ICI Administration Tool выберите Connectors > New FileNet P8 Content Manager Connector.
- В окне редактора свойств Properties Editor установите соответствующее значение параметра Object Store Name.
- Для полей Remote Server URL, Remote Server Upload URL и Remote Server Download URL установите значение
cemp:iiop://hostname:port/FileNet/Engine.
Здесь в качестве параметра hostname необходимо указать IP-адрес сервера IBM FileNet P8, а в качестве параметра port нужно указать номер порта, соответствующего вашей конфигурации FileNet P8 Content Manager, как показано на рисунке 2. По умолчанию FileNet P8 Content Manager использует порт 2809.
Рисунок 2. Окно администрирования ICI, работающего на удаленной системе z/OS, с настройками коннектора для подключения к IBM FileNet P8 Content Manager
Подключение к репозиториям из ICI на z/OS
Подключимся к репозиториям с использованием только что настроенных соединений
Подключение к IBM DB2 Content Manager, работающему на платформе z/OS
IBM Content Integrator поддерживает подключение к репозиторию IBM DB2 Content Manager, работающему на удаленной платформе z/OS, через RMI-прокси.
Для настройки прокси-коннектора RMI для подключения к IBM DB2 Content Manager необходимо выполнить следующие действия:
- Найдите файл cmbicmsrvs.ini. Как правило, этот файл находится в директории II4C_ROOT\cmgmt\connectors, где II4C_ROOT – это корневая директория установки DB2 Information Integrator for Content.
- Установите соответствующие значения хоста, коммуникационного порта и удаленной базы данных.
- Для запуска прокси-коннектора RMI измените скрипт RMIBridge.sh, как показано в листинге 1. Необходимо внести следующие изменения:
- Убедитесь, что прокси-коннектор RMI использует IBM JRE версии 1.5. Версия 1.5 необходима для работы с DB2 Content Manager.
- Добавьте файлы cmbsdk81.jar, cmb81.jar, cmbview81.jar,
db2jcc.jar, db2jcc_license_cu.jar,
db2jcc_license_cisuz.jar в начало строки определения путей поиска классов для прокси-коннектора RMI. Обычно эти файлы находятся в директории II4C_ROOT/lib, где II4C_ROOT – это корневая директория установки DB2 Information Integrator for Content.
Примечание: Файл db2java.zip не используется и должен быть удален из путей к классам для всех скриптов.
- Добавьте папку cmgmt к строке определения путей поиска классов для сервера прокси-коннектора RMI. Обычно эта директория находится в директории II4C_ROOT/lib, где II4C_ROOT – это корневая директория установки DB2 Information Integrator for Content.
Листинг 1. Модифицированный скрипт RMIBridge.sh
IBMCMROOT=/opt/IBM/db2cmv8 export IBMCMROOT JAVA_HOME=$IBMCMROOT/java/jre export JAVA_HOME PATH=$JAVA_HOME/bin:$PATH export PATH VBR_ALLJARS=$IBMCMROOT/lib/cmbsdk81.jar:$VBR_ALLJARS export VBR_ALLJARS VBR_ALLJARS=$IBMCMROOT/lib/cmbview81.jar:$VBR_ALLJARS export VBR_ALLJARS VBR_ALLJARS=$IBMCMROOT/lib/cmb81.jar:$VBR_ALLJARS export VBR_ALLJARS VBR_ALLJARS=$IBMCMROOT/lib/db2jcc.jar:$VBR_ALLJARS export VBR_ALLJARS VBR_ALLJARS=$IBMCMROOT/lib/db2jcc_license_cu.jar:$VBR_ALLJARS export VBR_ALLJARS VBR_ALLJARS=$IBMCMROOT/lib/db2jcc_license_cisuz.jar:$VBR_ALLJARS export VBR_ALLJARS VBR_ALLJARS=$IBMCMROOT/cmgmt:$VBR_ALLJARS export VBR_ALLJARS |
- Сохраните изменения в файле RMIBridge.sh.
- В окне администрирования ICI Administration Tool в поле RMI Proxy Connector URL укажите IP адрес и порт, соответствующие прокси-коннектору RMI для DB2 Content Manager, как показано на рисунке 3.
Рисунок 3. Окно администрирования ICI, работающего на удаленной системе z/OS, с настройками URL для прокси-коннектора RMI
Примечание:
На рисунке 1 и рисунке 2 свойство Use RMI Proxy Connector имеет значение false. Если для подключения к репозиторию используется RMI-прокси, то свойство Use RMI Proxy Connector должно иметь значение true, в противном случае настройки RMI Proxy Connector URLs использоваться не будут.
- Сохраните обновленную конфигурацию подключения и закройте окно администрирования ICI.
Проверка правильности настроек для подключения к IBM DB2 Content Manager, работающего на z/OS
Выполните скрипт RMIBridge.sh для установления соединения с IBM DB2 Content Manager и воспользуйтесь одним из следующих способов для проверки правильности настроек:
- Для проверки правильности настроек средствами ICI Administration Tool: щелкните правой кнопкой мышки на значке IBM DB2 Content Manager. В контекстном меню выберите опцию Test Connection. В результате откроется окно редактора свойств с предложением зарегистрироваться в репозитории, как показано на рисунке 4.
Рисунок 4. Окно администрирования ICI, работающего на удаленной системе z/OS, демонстрирующее сценарий проверки подключения к IBM DB2 Content Manager
- Для проверки правильности настроек с помощью готовых примеров ICI: в корневой директории установки ICI на z/OS выполните из командной строки тестовый скрипт
run_sample.sh commandline.RepoTestкак показано в листинге 2.
Листинг 2. Проверка подключения ICI, работающего на z/OS, к IBM DB2 Content Manager, с помощью тестового скрипта, запущенного из командной строки на z/OS
# run_sample.sh commandline.RepoTest DB2CM1 ICMADM password Setting IBM Content Integrator environment variables Connecting to the Venice Bridge Server... Configuring IBM Content Integrator logging Retrieving the specified repository DB2CM1... Logging into DB2CM1 as ICMADM/password... Logged in! Logon ID is 4fb4c4e7c47f3286dd5fe43ffca7366201 Logging off DB2CM1 Logged off # _ |
Подключение к репозиторию IBM FileNet P8 Content Manager на Windows
В качестве репозитория, установленного и работающего на Windows-хосте, рассмотрим IBM FileNet P8 Content Manager. IBM Content Integrator поддерживает подключение к репозиторию на Windows-хосте с помощью прокси-коннектора RMI.
Для настройки прокси-коннектора RMI для подключения к IBM FileNet P8 Content Manager on WebSphere Application Server выполните следующие шаги:
- Скопируйте файл
WcmApiConfig.propertiesиз рабочей директории сервера FileNet P8 Content Manager в директориюIICE_HOME\lib. По умолчанию файлы сервера FileNet P8 Content Manager находятся в папкеP8AppEng\FileNet\Workplace\WEB-INF. - Убедитесь, что файл
WcmApiConfig.propertiesсодержит правильные ссылки на сервер FileNet P8 Content Manager. - В репозитории разрешите доступ к следующим JAR-файлам FileNet P8 Content Manager:
- javaapi.jar
- jace.jar
- В скрипте RMIBridge.sh определите переменную WAS_HOME..
- В скрипт RMIBridge.sh, расположенный в папке IICE_HOME\bin, включите дополнительные свойства, как показано в листинге 3:
Листинг 3. Свойства, которые необходимо добавить в скрипт RMIBridge.sh
-Djava.naming.factory.initial=iiop://<P8 server IP>:<port> -Djava.naming.provider.url=%JNDI_CLIENT_PROVIDER% -Djava.ext.dirs=%WAS_HOME%\java\jre\lib\ext;%WAS_HOME%\java\jre\lib; %WAS_HOME%\class es;%WAS_HOME%\lib;%WAS_HOME%\lib\ext -Xbootclasspath/p:%WAS_HOME%\lib\ibmorb.jar;%WAS_HOME%\profiles\default\properties -Dcom.ibm.CORBA.ConfigURL=file:/%WAS_HOME%\profiles\default\properties\sas.client.pro ps |
- Сохраните изменения в RMIBridge.sh.
- В окне администрирования ICI определите URL для RMI-коннектора, укажите IP-адрес и порт, соответствующие прокси-коннектору RMI для FileNet P8 Content Manager, точно так же, как описано выше для IBM DB2 Content Manager.
В окне администрирования ICI Administration Tool в поле RMI Proxy Connector URL укажите IP адрес и порт, соответствующие прокси-коннектору RMI для FileNet P8 Content Manager, как показано на рисунке 3.
Примечание: На рисунке 1 и рисунке 2 свойство Use RMI Proxy Connector имеет значение
false. Если для подключения к репозиторию используется URL RMI-прокси, то свойство Use RMI Proxy Connector должно иметь значениеtrue, в противном случае настройки RMI Proxy Connector URLs использоваться не будут. - Сохраните настройки коннектора и закройте окно администрирования ICI.
Проверка правильности настроек для подключения к IBM FileNet P8 Content Manager на Windows
Для проверки правильности ваших настроек выполните скрипт RMIBridge.sh для репозитория IBM FileNet P8 Content Manager и проверьте конфигурацию коннектора одним из следующих методов:
- Для проверки правильности настроек средствами ICI Administration Tool: щелкните правой кнопкой мышки на репозитории FileNet P8 Content Manager. В открывшемся контекстном меню выберите опцию Test Connection.
- Для проверки правильности настроек с помощью готовых примеров ICI: из корневой директории инсталляции ICI на z/OS выполните тестовый скрипт
run_sample.sh commandline.RepoTest.
Выше мы рассмотрели конфигурацию, которая включает в себя IBM Content Integrator, установленный на z/OS, репозиторий FileNet P8 Content Manager, установленный на Windows-хосте, и репозиторий DB2 Content Manager, работающий на платформе z/OS. Такая конфигурация является лишь одним из примеров возможной интеграционной среды предприятия, которая, вообще говоря, может включать в себя несколько разнородных репозиториев, установленных на разных платформах, таких, например, как Windows и z/OS. Тем не менее независимо от сложности конфигурации ICI обеспечивает единый интерфейс доступа к различным источникам контента.
Средства администрирования ICI Administration Tool обеспечивают возможность просмотра контента, хранящегося в произвольном репозитории. Все, что для этого требуется, - это настроить доступ к репозиторию в окне администрирования ICI Administration Tool и выполнить следующие шаги:
- Из корневой директории инсталляции ICI выполните скрипт, разрешающий просмотр содержимого репозитория:
run_sample.sh swing.RepoBrowser. Этот скрипт открывает окно браузера и позволяет просматривать содержимое репозитория, а также открывать папки и документы, хранящиеся в репозитории, непосредственно в окне браузера ICI. - В открывшемся окне браузера ICI RepoBrowser щелкните правой кнопкой мыши на нужном репозитории и укажите логин и пароль для доступа к контенту, как показано на рисунке 5.
Рисунок 5. Окно браузера ICI, работающего на платформе z/OS, с предложением пройти авторизацию для доступа к выбранному репозиторию
- После авторизации в выбранном репозитории в окне браузера будут показаны все папки и документы, хранящиеся в данном репозитории. Документы и их свойства можно просмотреть, щелкнув правой кнопкой мышки на нужном элементе, как показано на рисунке 6.
Рисунок 6. Окно браузера ICI, работающего на платформе z/OS, с контекстным меню для просмотра документов, хранящихся в репозитории
- Если вам необходимо выполнить поисковый запрос для содержимого репозитория, пройдите авторизацию, выберите нужный репозиторий и щелкните на нем правой кнопкой мыши. В открывшемся контекстном меню выберите опцию Query.
- Определите критерии поиска и нажмите кнопку Search, как показано на рисунке 7. Список документов, удовлетворяющих критериям поиска, будет выведен в основной панели окна.
Рисунок 7. Окно браузера ICI, работающего на платформе z/OS, с меню для определения критериев поиска контента в репозитории
Данная статья посвящена рассмотрению возможностей IBM Content Integrator (ICI) по объединению разнородных репозиториев, работающих на различных платформах, в единую инфраструктурную среду предприятия. Таким образом, ICI позволяет компаниям оптимально использовать имеющиеся активы и избежать дополнительных затрат на поддержку консолидации данных. IBM Content Integrator, работающий на платформе z/OS, обеспечивает единую точку доступа к контенту (документам и изображениям), хранящемуся в разнородных репозиториях на различных платформах, максимально используя при этом все преимущества среды z/OS.
Научиться
- Оригинал статьи Integrate content repositories from multiple platforms with IBM Content Integrator for z/OS (EN).
- Посетите страницу IBM Content Integrator Exchange (EN) для обмена кодом и идеями с другими разработчиками.
- Получите дополнительную информацию об установке, управлении и разработке решений для IBM Content Integrator в IBM Content Integrator Information Center (EN).
- Подробную информацию о продукте и доступных обновлениях и исправлениях дефектов можно получить на страничке поддержки Content Integrator Support Site (EN).
- Чтобы быть в курсе последних новостей, посещайте сайт технических мероприятий и Web-трансляций (EN) developerWorks.
Получить продукты и технологии
- Используйте в вашем следующем проекте разработки ПО ознакомительные версии ПО IBM, которые можно скачать непосредственно в разделе developerWorks.
Обсудить
- Примите участие в обсуждении материала на форуме.
- Участвуйте в блогах developerWorks и станьте членом сообщества developerWorks.

Джорджиана Аврам работает в IBM c 2005 года. Джорджиана начала работу в IBM в качестве технического стажера программы IBM Extreme Blue, а затем заняла должность технического консультанта подразделения IBM Global Business Services. Она имеет опыт работы по управлению контентом и анализу данных, работы с различными средствами отчетности, интеграционными и поисковыми системами предприятий, SOA, разработки бизнес-процессов и документооборота. В настоящее время Джорджиана работает в качестве инженера-программиста подразделения IBM Software Group. Ее специализация – управление корпоративным контентом и IBM Content Integrator. Джорджиана имеет степень бакалавра по вычислительной технике и по математике.
