Настройка 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 Information Center. Для получения дополнительной информации перейдите на веб-сайт WebSphere Information Center и выполните поиск по следующим ключевым словам: Защита приложений и их среды.

Процедура

  1. Для использования продукта Rational Engineering Lifecycle Manager необходимо настроить ряд параметров в применяемой им виртуальной машине Java. Для настройки этих свойств с помощью WebSphere Integrated Solutions Console, выберите Серверы > Типы серверов > Серверы приложений WebSphere > Server1.
  2. В разделе Инфраструктура сервера выберите Управление процессом и Java > Определение процесса.
  3. В разделе Дополнительные свойства выберите Виртуальная машина Java.
  4. Добавьте значение 4096 в поле Первоначальная куча.
  5. Добавьте значение 24576 в поле Максимальный размер кучи.
    Совет: Приведенные здесь значения являются рекомендуемыми; вы можете указать те значения, которые подходят для вашей среды. Для стандартного коллектива среднего размера можно указать значение 4096 МБ, чтобы выделить 4 ГБ памяти кучи для процесса Rational Engineering Lifecycle Manager в 64-разрядной системе. Если настроен недостаточный Максимальный размер кучи, то источник данных Rational Engineering Lifecycle Manager для приложения Lifecycle Query Engine может прекратить обработку имеющейся очереди и новых изменений, связанных с созданием, изменением или удалением продуктов.

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

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

  6. В поле Стандартные аргументы JVM введите следующую строку:
    Windows:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Совет: Для увеличения размера кучи используйте следующий параметр, заменив {N} на необходимый объем памяти, а {N/8} - на 1/8 от общего объема памяти. Например, если в -Xmx задано значение 8g, то в -Xmn должно быть задано значение 1g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  7. Нажмите кнопку Применить и выберите Сохранить напрямую в главной конфигурации.
  8. Среди других пользовательских свойств необходимо добавить системное свойство JAZZ_HOME, задающее расположение файлов конфигурации. В этом свойстве указывается URL, а не обычный путь к каталогу, то есть значение должно иметь следующий формат: file:///путь к файлу. В разделе Виртуальная машина Java > Дополнительные свойства выберите Пользовательские свойства.
    Напоминание: После префикса file: необходимо указать тройную косую черту (///)
    Важное замечание: Если применяется распределенная среда, в которой каждое веб-приложение использует отдельный сервер приложений, добавьте эти пользовательские свойства в каждый экземпляр WebSphere Application Server.
  9. Нажмите Создать, введите JAZZ_HOME в поле Имя и введите file:///каталог-установки-Jazz/server/conf в поле Значение. Вместо каталога-установки-Jazz укажите расположение каталога установки Jazz Team Server. Например, введите file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf (в системе Windows) или file:///opt/IBM/JazzTeamServer/server/conf (в системе Linux).
    Прим.: Во избежание неполадок пути к файлам не должны содержать пробелы. Вместо каталога Program Files можно указать PROGRA~1, а вместо каталога Program Files (x86) можно указать PROGRA~2.
  10. Нажмите кнопку OK.
  11. Повторите шаг 10 для добавления следующих пользовательских свойств:
    • Имя: 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
    • Имя: log4j.configuration Значение: file:///каталог-установки-Jazz/server/conf/startup_log4j.properties
      Прим.: Параметры из файла startup_log4j.properties применяются на начальных этапах процесса запуска для передачи сообщений в файл SystemOut.log сервера WebSphere Application Server. После выполнения начальных этапов все приложения Jazz начинают использовать настроенные для них параметры из файла каталог-установки-Jazz/server/conf/контекст приложения/log4j.properties.
  12. Выберите Сохранить напрямую в главной конфигурации.
  13. Увеличьте пул нитей по умолчанию для поддержки многопользовательского режима. Выберите Серверы > Типы серверов > Серверы приложений WebSphere > Server1.
  14. В разделе Дополнительные свойства выберите Пулы нитей.
  15. Выберите WebContainer и увеличьте максимальный размер с 50 (значение по умолчанию) до 200 нитей.
  16. Выберите Сохранить напрямую в главной конфигурации.
  17. Откройте меню Серверы > Типы серверов > Серверы приложений > Server1 > Управление сеансами > Пользовательские свойства. На странице Пользовательские свойства нажмите кнопку Создать.
  18. На странице Конфигурация введите InvalidateOnUnauthorizedSessionRequestException в поле Имя и true в поле Значение. По умолчанию это пользовательское свойство управления сеансами содержит значение false. Нажмите кнопку OK или Применить.
  19. Нажмите кнопку Сохранить на панели задач консоли для сохранения изменений в конфигурации.
  20. Для того чтобы изменения вступили в силу, перезапустите сервер.

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

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

  1. На административной консоли WebSphere Application Server выберите Приложения > Установить новое приложение (или Приложения > Новое приложение > Новое приложение Java EE).
  2. В разделе Путь к новому приложению выберите Локальная файловая система.
  3. В разделе Полный путь введите [каталог-установки-relm]/server/webapps/relm.war
  4. Укажите /relm в качестве корневого контекста
  5. Нажмите кнопку Далее и выполните остальные шаги мастера Установить новое приложение согласно приведенным инструкциям. Нажмите кнопку Готово.
  6. Установите приложение Управление изменениями, vvc.war, используя описанную выше процедуру. Укажите путь [каталог-установки-relm]/server/webapps/vvc.war и корневой контекст /vvc.
  7. Установите приложение шлюза SPARQL, SPARQL_Gateway.war, используя описанную выше процедуру. Укажите путь [каталог-установки-relm]/server/webapps/SPARQL_Gateway.war и корневой контекст /SPARQL_Gateway.
  8. Для того чтобы просматривать документацию с сервера, а не из Интернета, разверните приложение relmhelp.war.
  9. Выберите Сохранить напрямую в главной конфигурации.
  10. Для работы шлюза SPARQL необходимо изменить порядок загрузки классов по умолчанию.
    1. Выберите Приложения > Типы приложений > Приложения Java EE WebSphere, а затем выберите SPARQL_Gateway_war в списке приложений.
    2. Выберите Загрузка классов и обнаружение обновлений.
    3. В разделе Порядок загрузчиков классов выберите значение Вначале классы, загруженные локальным загрузчиком классов (а родительским - потом)
    4. Нажмите кнопку OK и выберите Сохранить в главной конфигурации.
    5. Выберите Управление модулями. Выберите модуль SPARQL_Gateway.
    6. Найдите поле Порядок загрузчиков классов и выберите значение Вначале классы, загруженные локальным загрузчиком классов (а родительским - потом)
    7. Нажмите кнопку OK и выберите Сохранить в главной конфигурации.
  11. На странице Приложения Java EE выберите приложения, которые только что были развернуты на сервере WebSphere Application Server, и нажмите Запустить.
Прим.: Данный документ не включает в себя исчерпывающую информацию по такому сложному вопросу, как настройка идентификации и SSL в WebSphere. Подробные сведения о различных вариантах идентификации и шифрования приведены в справочной системе WebSphere Application Server Information Center. Для получения дополнительной информации перейдите на веб-сайт WebSphere Information Center и выполните поиск по следующим ключевым словам: Защита приложений и их среды.

Комментарии