Настройка WebSphere Application Server для Rational Engineering Lifecycle Manager

Развертывание и запуск сервера Jazz Team Server начинается с выбора сервера приложений, на котором будет располагаться Jazz Team Server и его приложения. Перед развертыванием файлов WAR приложения Rational Engineering Lifecycle Manager необходимо настроить сервер WebSphere Application Server.

Прежде чем начать

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

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

Прим.:
  • Rational Engineering Lifecycle Manager v1.x должен использовать тот же сервер приложений, что и Lifecycle Query Engine.
  • Rational Engineering Lifecycle Manager v4.x может использовать тот же сервер приложений, что и Lifecycle Query Engine, либо другой сервер приложений. Тем не менее, оба приложения должны быть зарегистрированы на одном сервере Jazz Team Server.

Об этой задаче

Данный документ не включает в себя исчерпывающую информацию по такому сложному вопросу, как настройка идентификации и SSL в WebSphere. Подробные сведения о различных вариантах идентификации и шифрования приведены в документации по WebSphere Application Server. Для получения дополнительной информации откройте веб-страницу документации по WebSphere и выполните поиск по следующим ключевым словам: Защита приложений и их среды.

Процедура

  1. Настройте виртуальную машину Java, в которой работает Rational Engineering Lifecycle Manager.

    Выберите Серверы > Типы серверов > Серверы приложений WebSphere > Server1. В разделе Инфраструктура сервера выберите Управление процессом и Java > Определение процесса. В разделе Дополнительные свойства выберите Виртуальная машина Java. Укажите следующие параметры. Нажмите кнопку Применить и выберите Сохранить напрямую в главной конфигурации.

    Табл. 1. Конфигурация виртуальной машины Java
    Поле Значение Комментарии
    Начальная куча 4096  
    Максимальный размер кучи 24576
    • Приведенные здесь значения являются рекомендуемыми; вы можете указать те значения, которые подходят для вашей среды. Для стандартного коллектива среднего размера можно указать значение 4096 МБ, чтобы выделить 4 ГБ памяти кучи для процесса Rational Engineering Lifecycle Manager в 64-разрядной системе. Если настроен недостаточный Максимальный размер кучи, то источник данных Rational Engineering Lifecycle Manager для приложения Lifecycle Query Engine может прекратить обработку имеющейся очереди и новых изменений, связанных с созданием, изменением или удалением продуктов.
    • Для того чтобы предотвратить подкачку, размер физической памяти должен превышать суммарный объем памяти, необходимый для всех процессов в системе. Подкачка снижает производительность системы и негативно сказывается на производительности системы управления памятью Java.
    • При увеличении размера кучи Java убедитесь, что в системе достаточно неиспользуемой физической памяти. Если физической памяти недостаточно, установите дополнительную память или взвесьте все возможные негативные последствия на общую производительность.
    Общие аргументы JVM Linux
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Windows
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux
    Для увеличения размера кучи используйте следующий параметр, заменив {N} на необходимый объем памяти, а {N/8} - на 1/8 от общего объема памяти. Например, если в -Xmx задано значение 8g, то в -Xmn должно быть задано значение 1g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  2. Настройте пользовательские свойства.

    В разделе Дополнительные свойства выберите Пользовательские свойства > Создать. Укажите следующие пользовательские свойства и нажмите кнопку OK для сохранения информации. Затем выберите Сохранить напрямую в главной конфигурации.

    Табл. 2. Информация о пользовательских свойствах
    Имя пользовательского свойства Значение пользовательского свойства Комментарии
    JAZZ_HOME file:///установочный-каталог-Jazz/server/conf

    Вместо каталога-установки-Jazz укажите каталог установки Jazz Team Server.

    Напоминание:
    • После префикса file: необходимо указать тройную косую черту (///)
    • Во избежание неполадок пути к файлам не должны содержать пробелы. Вместо каталога Program Files можно указать PROGRA~1, а вместо каталога Program Files (x86) можно указать PROGRA~2.
    Примеры:

    Linux file:///opt/IBM/JazzTeamServer/server/conf

    Windows file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf

    Это системное свойство задает расположение для поиска файлов конфигурации. В этом свойстве указывается URL, а не обычный путь. Укажите значение в формате URL файла: file:///путь-к-файлу.
    Важное замечание: Если применяется распределенная среда, в которой каждое веб-приложение использует отдельный сервер приложений, добавьте эти пользовательские свойства в каждый экземпляр WebSphere Application Server.
    java.awt.headless true  
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin true  
    Oracle

    ORACLE_JDBC_DRIVER_FILE

    Полный путь к файлу драйвер-JDBC/ojdbc6.jar Путь к драйверу JDBC необходимо указать полностью. Не используйте путь в формате URL (file:///). Дополнительная информация о соединениях Oracle Java Database Connectivity (JDBC) приведена в документе Настройка базы данных Oracle для Rational Engineering Lifecycle Manager и Lifecycle Query Engine

    SQL_JDBC_DRIVER_FILE

    Полный путь к файлу драйвер-JDBC/sqljdbc4.jar Путь к драйверу JDBC необходимо указать полностью. Не используйте путь в формате URL (file:///). Дополнительная информация о подключении к базе данных SQL Server приведена в документации по Rational solution for Collaborative Lifecycle Management.
    log4j.configuration file:///установочный-каталог-Jazz/server/conf/startup_log4j.properties  
  3. Увеличьте пул нитей по умолчанию для поддержки многопользовательского режима.

    Выберите Серверы > Типы серверов > Серверы приложений WebSphere > Server1. В разделе Дополнительные свойства выберите Пулы нитей > WebContainerПулы нитей. Увеличьте максимальный размер с 50 (значение по умолчанию) до 200 нитей и нажмите кнопку Сохранить непосредственно в главной конфигурации.

  4. Настройте пользовательское свойство InvalidateOnUnauthorizedSessionRequestException.
    Выберите Серверы > Типы серверов > Серверы приложений > Server1 > Управление сеансами > Пользовательские свойства > Создать. Введите пару имя и значение для пользовательского свойства. Нажмите кнопку OK или Применить, затем нажмите кнопку Сохранить на панели задач консоли для сохранения изменений в конфигурации.
    Табл. 3. Информация о пользовательском свойстве
    Имя пользовательского свойства Значение пользовательского свойства Комментарии
    InvalidateOnUnauthorizedSessionRequestException true По умолчанию это пользовательское свойство управления сеансами содержит значение false.
  5. Укажите общую библиотеку Jazz Reporting Service.
    1. В административной консоли выберите Среда > Общие библиотеки. Выберите область сервер и нажмите кнопку Создать.
    2. Введите имя общей библиотеки Общая библиотека JRS, добавьте описание и укажите путь к классам установочный-каталог-5.0.1/server/conf/rs/SharedLibrary. В разделе Загрузка классоввключите переключатель использования загрузчика изолированных классов для общей библиотеки и нажмите кнопку Применить.
    3. Выберите Сохранить в главной конфигурации.
  6. Для того чтобы изменения вступили в силу, перезапустите сервер приложений.
    • Linux Выполните команды stopServer.sh и startServer.sh.
    • Windows Выполните команды stopServer.bat и startServer.bat.

Дальнейшие действия

  1. Разверните файлы приложения.
    1. В административной консоли WebSphere Application Server выберите Приложения > Создать приложение > Создать приложение J2EE.
    2. В мастере Подготовка к установке прикладной программы в разделе Путь к новому приложению выберите Локальная файловая система и укажите полный путь к файлу приложения. В мастере Установить новое приложение укажите корневой контекст и выполните инструкции по установке. На сводной странице Установить новое приложение проверьте правильность выбранных параметров установки и нажмите кнопку Готово.
      Табл. 4. Файлы приложений и значения
      Приложение Полный путь Корневой контекст
      Rational Engineering Lifecycle Manager установочный-каталог-RELM/server/webapps/relm.war /relm
      Документация по Rational Engineering Lifecycle Manager установочный-каталог-RELM/server/webapps/relmhelp.war /relmhelp
      Приложение Управление конфигурациями установочный-каталог-RELM/server/webapps/vvc.war /vvc
      Jazz Reporting Service установочный-каталог-RELM/server/webapps/rs.war /rs
    3. Выберите Сохранить напрямую в главной конфигурации.

  2. Добавьте ссылку на библиотеку Jazz Reporting Service.
    1. Выберите Приложения > Типы приложений > Приложения J2EE для WebSphere, затем выберите rs_war в списке приложений.
    2. В разделе Ссылка выберите Ссылки на общие библиотеки.
    3. Включите переключатель rs_war и выберите Ссылка на общие библиотеки.
    4. Выберите Общая библиотека JRSи щелкните на стрелке вправо.
    5. Нажмите кнопку OK. Затем снова нажмите кнопку OK для сохранения параметров в главной конфигурации.

  3. Убедитесь, что порядок загрузки классов Jazz Reporting Service настроен правильным образом.
    1. Выберите Приложения > Типы приложений > Приложения J2EE для WebSphere, затем выберите rs_war в списке приложений.
    2. В разделе Подробные свойства выберите Загрузка классов и обнаружение обновления.
    3. В разделе Порядок загрузчиков классов выберите значение Вначале классы, загруженные локальным загрузчиком классов (а родительским - потом).
    4. Нажмите кнопку OK и выберите Сохранить в главной конфигурации.

  4. На странице Приложения Java EE выберите приложения, которые только что были развернуты на сервере WebSphere Application Server, и нажмите Запустить.
Прим.: Данный документ не включает в себя исчерпывающую информацию по такому сложному вопросу, как настройка идентификации и SSL в WebSphere. Подробные сведения о различных вариантах идентификации и шифрования приведены в документации по WebSphere Application Server. Для получения дополнительной информации откройте веб-страницу документации по WebSphere и выполните поиск по следующим ключевым словам: Защита приложений и их среды.

Комментарии