Настройка WebSphere Application Server

В этом разделе описывается порядок настройки Jazz Team Server для работы с WebSphere Application Server. Предполагается, что Jazz Team Server устанавливается в систему, где установлен Websphere Application Server. Инструкции относятся к WebSphere Application Server версии 6.1.0.23. Процедура для версии 7.0.0.7 и более поздних версий незначительно отличается. Различия описаны в тексте.

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

Перед выполнением этих действий необходимо выполнить следующее:
Совет: Если Jazz Team Server устанавливается для Rational Team Concert с помощью IBM® Installation Manager, то файлы Jazz Team Server можно установить в каталоге веб-приложения. Во время установки идущий в комплекте сервер приложений Apache Tomcat устанавливать не следует, так как в этом случае Installation Manager спросит путь к каталогу веб-приложения и установит только файлы, которые необходимы для WebSphere. По умолчанию используются каталоги C:\Program Files\IBM\JazzTeamServer (в Windows®) и /opt/IBM/JazzTeamServer (в Linux®). В данной процедуре каталог установки называется JazzInstallDir. Если вы применяете IBM Installation Manager для установки файлов в каталоге веб-приложений WebSphere Application Server, то перемещать вручную файлы, как описано выше, не нужно.

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

Прим.: В данном документе не описана настройка идентификации WebSphere или SSL (это более сложная задача). Подробные сведения о различных способах идентификации и шифрования для WebSphere приведены в WebSphere Information Center. Для получения дополнительной информации перейдите в WebSphere Information Center и найдите раздел Защита приложений и их среды. Для веб-интерфейса Jazz требуется настройка идентификации для предоставления прав доступа и персонализации приложения.

Процедура

  1. Проверьте и обновите расположение базы данных в файле teamserver.properties.
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Прим.: Это пример конфигурации DB2. В файл teamserver.properties следует внести изменения в соответствии с производителем базы данных (Oracle/MS-SQL).
  2. Проверьте или обновите уровень WebSphere Application Server.

    Для Jazz Team Server должен быть установлен WebSphere Application Server Version 6.1 с IBM Java SDK 1.5 SR5 или более поздним кумулятивным пакетом исправлений или WebSphere Application Server 7.0 не ниже 7.0.0.7. Обновление SDK IBM Java SDK 1.5 SR6 доступно по адресу http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. При запуске Jazz с WebSphere 6.1 и GA IBM Java SDK будут выданы "ошибки прокси" после выполнения нескольких операций.

    Приобретите соответствующие i-fixes WebSphere Application Server для исправлений IBM Java SDK 1.5 SR9 или IBM Java SDK 1.6 SR4 (они требуются для правильной работы IBM Rational Team Concert 2.0). В противном случае некоторые службы на сервере могут быть запущены неверно. I-fixes доступны по соответствующим APAR WebSphere Application Server. APAR для IBM Java SDK 1.5/WebSphere Application Server 6.1 - PK85942; эти файлы можно загрузить из ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/. Установите по крайней мере пакет исправлений 19 WebSphere Application Server 6.1 перед установкой i-fix JRE. APAR для IBM Java SDK 1.6/WebSphere Application Server 7.0 - PK 86771; эти файлы можно загрузить из ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Обновите параметры JVM.

    У виртуальной машины Java, в которой выполняется Jazz Team Server, требуется настроить ряд специфических параметров.

    Первый параметр из Общих параметров JVM, который требуется задать,- это максимальное выделение памяти по умолчанию (-Xmx). Значение этого параметра зависит от размера рабочей группы, поддерживаемой сервером, и объема памяти сервера, на котором выполняется Jazz Team Server. Для рабочих групп среднего размера можно указать значение -Xmx1536M, то есть для процесса Jazz Team Server будет выделено 1536 Мб памяти кучи.

    Второй параметр из Общих параметров JVM, который требуется задать специально для Rational Quality Manager,- это размер стека. Обычно для Rational Quality Manager указывают -Xss786K.

    При подключении к базе данных Oracle или SQL Server необходимо добавить свойство "ORACLE_JDBC" или "SQLSERVER_JDBC" соответственно. Укажите в этом свойстве абсолютный путь (не URL) к драйверу JDBC.

    В следующем примере показаны Общие параметры JVM для подключения к базам данных Oracle и SQL Server и параметры размера стека и максимального выделения памяти по умолчанию. Поменяйте JazzInstallDir на свой каталог установки Jazz Team Server.

    -DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k

    Есть и другие системные параметры, которые необходимо настроить для управления определенными режимами работы сервера. Они указаны ниже. Здесь описана настройка значений параметров JVM в административной консоли WebSphere WebSphere. Поменяйте JazzInstallDir на свой каталог установки Jazz Team Server:

    1. Выберите Серверы > Серверы приложений.
    2. Нажмите сервер-1.
    3. Выберите Java и управление процессами > Определение процесса.
    4. Нажмите Виртуальная машина Java.
    5. Добавьте 100 к значению Начальный размер кучи.
    6. Добавьте 1000 к значению Максимальный размер кучи.
    7. Нажмите Применить.
    8. Выберите Ведение протоколов и трассировка. Нажмите Изменить параметры протокола. Jazz Team Server использует модуль создания отчетов BIRT. Во избежание занесения информационных записей BIRT в файл WebSphere задайте уровень ведения протокола severe для пакетов org.eclipse.birt.*. Нажмите Применить.
    9. Выберите Серверы приложений > {имя_сервера} > Определение процесса > Java Виртуальный компьютер > Настраиваемые свойства. В число добавляемых свойств входит свойство JAZZ_HOME (системное свойство, в котором указано расположение для поиска отдельных файлов конфигурации). В этом свойстве используется URL, а не простой путь, поэтому значение следует указывать в виде file://.
    10. Добавьте следующие свойства: Нажмите Создать, введите Имя и Значение, затем нажмите OK.
      • Имя: java.awt.headless Значение: true
      • Имя: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Значение: true
      • Имя: JAZZ_HOME Значение: file:///JazzInstallDir/server/conf
    11. Нажмите Сохранить, чтобы сохранить главную конфигурацию.
    Важное замечание: При работе с Solaris необходимо также добавить следующий аргумент командной строки Java:
    -XX:MaxPermSize=256m
    Дополнительная информация приведена в Главе 2, "Настройка среды Solaris для WebSphere Application Server" руководства по выполнению задач IBM WebSphere Application Server версии 6.1 в операционной системе Solaris 10.
  4. Перезапустите Websphere для установки приложения Jazz.
    В следующем примере командной строки WASInstallDir обозначает расположение WebSphere Application Server на сервере.
    • В Windows для WebSphere по умолчанию используется следующий каталог установки:
      C:\Program Files\IBM\WebSphere\AppServer
      В Windows сервер можно перезапустить следующими командами:
      cd WASInstallDir\bin 
      stopServer.bat сервер-1 [если на сервере включена защита, добавьте: -username {имя-пользователя-LDAP} -password {пароль-LDAP}] 
      startServer.bat сервер-1
    • В Linux значение по умолчанию для установочного каталога WebSphere следующее:
      /opt/IBM/WebSphere/AppServer
      В Linux сервер можно перезапустить следующими командами:
      cd WASInstallDir/bin 
      ./stopServer.sh сервер-1 [если на сервере включена защита, добавьте: -username {имя-пользователя-LDAP} -password {пароль-LDAP}] 
      ./startServer.sh сервер-1
    1. Откройте административную консоль WebSphere Application Server.
    2. Выберите Приложения > Установить новое приложение. (В случае применения WebSphere Application Server 7.0.0.7 или более поздней версии выберите Приложения > Создать приложение > Создать приложение предприятия).
    3. В поле Путь к новому приложению выберите Локальная файловая система.
    4. В поле Полный путь введите:
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. В поле Корневой контекст укажите значение /jazz и нажмите кнопку Далее.
      Прим.: Этот шаг выполняется в конце установки в случае применения WebSphere Application Server 7.0.0.7 или более поздней версии.
    6. Нажмите Далее и выполните оставшиеся шаги мастера Установить новое приложение.
    7. Нажмите кнопку Готово.
    8. Убедитесь, что приложение jazz_war установлено, и нажмите кнопку Сохранить для сохранения изменений в файле главной конфигурации.
    9. Выберите Приложения > Приложения J2EE.
    10. Включите переключатель рядом с jazz_war и нажмите Запустить.

      При успешном запуске приложения появится зеленая стрелка.

      Прим.: Оставшиеся шаги относятся только к Rational Quality Manager.
    11. Вернитесь на страницу Установить новое приложение.
    12. Перейдите в расположение файла help.war в локальной файловой системе и выберите файл. Введите для корневого контекста значение /help и нажмите Далее.
      Прим.: Файл help.war находится в каталоге установочный-каталог-Jazz\server\tomcat\webapps\help.war.
    13. Несколько раз нажмите Далее, пока не будет показан экран Сводка, а затем нажмите Готово для установки нового приложения.
    14. Убедитесь в том, что приложение help_war установлено, и нажмите Сохранить для сохранения изменений в файле главной конфигурации.
    15. Выберите Приложения > Приложения J2EE.
    16. Выберите help_war и нажмите Запустить.

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

После запуска сервера перейдите к разделу Запуск мастера настройки.

Дополнительную информацию можно просмотреть по следующим ссылкам:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


Комментарии