В этом разделе описывается порядок настройки Jazz Team Server для работы с WebSphere Application Server. Предполагается, что Jazz Team Server устанавливается в систему, где установлен Websphere Application Server. Инструкции
относятся к
WebSphere
Application Server версии 6.1.0.23. Процедура для версии 7.0.0.7 и более поздних версий незначительно
отличается. Различия описаны в тексте.
Прежде чем начать
Перед выполнением этих действий необходимо
выполнить следующее:
- Установить WebSphere Application.
- Создать базу данных и добавить ее параметры в файл teamserver.properties.
- Включить вход в систему без учета регистра (необязательно): если
способ идентификации сервера приложений допускает вход в систему без
учета регистра, то в приложении
Jazz можно настроить
аналогичную функцию. Учетом регистра символов в имени пользователя
управляет свойство Использовать сравнение ИД пользователя без учета
регистра символов на странице Дополнительные свойства в
административном веб-интерфейсе. По умолчанию используется значение
"не менять"; для того чтобы выключить учет регистра символов в имени
пользователя, администратор должен явно переопределить это свойство.
- Опция защиты Java™ 2
должна быть выключена. Если эта опция включена в
WebSphere Application
Server, то запустить файл .war
Jazz Team Server
не удастся.
- Параметр защиты WAS "Использовать доступные данные идентификации при доступе к незащищенному URI" должен быть выбран. Если используется WAS Integrated Solutions Console, это можно сделать следующим образом:
- Перейдите в Защита -> Защита администрирования, приложений и инфраструктуры -> Защита Веб - Общие параметры. (В
WAS 7.0.0.7 выберите Защита -> Глобальная защита -> Защита Веб и
SIP ->
Общие параметры.)
- Включите переключатель для "Использовать доступные данные идентификации при доступе к незащищенному URI".
- В состав Jazz Team Server входят файлы, необходимые для работы полного сервера на основе Apache Tomcat. Для установки WebSphere необходима только часть файлов Jazz Team Server, их следует скопировать в каталог системы сервера WebSphere. В дальнейших инструкциях этот каталог называется каталог установки Jazz Team Server или JazzInstallDir (для краткости). В этом каталоге используются:
- Файл JazzInstallDir/server/tomcat/webapps/jazz.war.
- Каталог JazzInstallDir/server/update-site.
- Каталог JazzInstallDir/server/conf.
- База данных хранилища по умолчанию в каталоге JazzInstallDir/repositoryDB.
- Инструменты хранилища в каталоге JazzInstallDir/repotools.
- Каталог JazzInstallDirserver/license-update-site.
- Каталог JazzInstallDir/server/nl1-update-site.
- Каталог JazzInstallDir/server/nl2-update-site.
Совет: Если
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 требуется настройка идентификации для предоставления прав доступа и персонализации приложения.
Процедура
- Проверьте и обновите расположение базы данных в файле 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).
- Проверьте или обновите уровень 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/.
- Обновите параметры 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.
- Выберите .
- Нажмите Виртуальная машина Java.
- Добавьте 100 к значению Начальный размер кучи.
- Добавьте 1000 к значению Максимальный размер кучи.
- Нажмите Применить.
- Выберите Ведение протоколов и
трассировка. Нажмите Изменить параметры
протокола.
Jazz Team Server
использует модуль создания отчетов BIRT. Во избежание занесения
информационных записей BIRT в файл
WebSphere задайте уровень
ведения протокола severe для пакетов
org.eclipse.birt.*. Нажмите Применить.
- Выберите Серверы приложений > {имя_сервера} >
Определение процесса > Java
Виртуальный компьютер > Настраиваемые свойства. В число добавляемых свойств входит свойство JAZZ_HOME (системное
свойство, в котором указано расположение для поиска отдельных файлов
конфигурации). В этом свойстве используется URL, а не простой путь, поэтому значение следует указывать в виде file://.
- Добавьте следующие свойства: Нажмите Создать, введите
Имя и Значение, затем нажмите OK.
- Имя: java.awt.headless
Значение: true
- Имя:
org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin
Значение: true
- Имя: JAZZ_HOME Значение: file:///JazzInstallDir/server/conf
- Нажмите Сохранить, чтобы сохранить главную конфигурацию.
- Перезапустите Websphere для установки приложения Jazz.
В следующем примере командной строки
WASInstallDir обозначает расположение WebSphere Application Server на сервере.
- Откройте административную консоль WebSphere Application
Server.
- Выберите . (В
случае применения
WebSphere
Application Server 7.0.0.7 или более поздней версии выберите
).
- В поле Путь к новому приложению выберите Локальная файловая система.
- В поле Полный путь введите:
JazzInstallDir/server/tomcat/webapps/jazz.war
- В поле Корневой контекст укажите значение /jazz и
нажмите кнопку Далее.
Прим.: Этот шаг выполняется в конце установки в
случае
применения WebSphere
Application
Server 7.0.0.7 или более поздней версии.
- Нажмите Далее и выполните оставшиеся шаги мастера Установить новое приложение.
- Нажмите кнопку Готово.
- Убедитесь, что приложение jazz_war установлено, и нажмите кнопку
Сохранить для сохранения изменений в файле главной
конфигурации.
- Выберите .
- Включите переключатель рядом с jazz_war и нажмите Запустить.
При успешном запуске приложения появится зеленая стрелка.
Прим.: Оставшиеся шаги относятся только к Rational Quality Manager.
- Вернитесь на страницу Установить новое
приложение.
- Перейдите в расположение файла help.war в локальной файловой системе и выберите файл. Введите для корневого контекста значение
/help и нажмите Далее.
Прим.: Файл help.war находится в каталоге
установочный-каталог-Jazz\server\tomcat\webapps\help.war.
- Несколько раз нажмите Далее, пока не будет
показан экран Сводка, а затем нажмите Готово
для установки нового приложения.
- Убедитесь в том, что приложение help_war установлено, и нажмите
Сохранить для сохранения изменений в файле
главной конфигурации.
- Выберите .
- Выберите help_war и нажмите
Запустить.
Дальнейшие действия
После запуска сервера перейдите к разделу
Запуск мастера настройки.
Дополнительную информацию можно просмотреть по следующим
ссылкам:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ