Можно вручную установить
IBM® Rational Asset Manager
в существующей установке Apache Tomcat. Выполните эти инструкции,
чтобы развернуть
Rational Asset Manager
в Tomcat V5.5.
Подготовка
У вас есть права доступа администратора и доступ к файлам на сервере Tomcat, который установлен и запущен.
Потребуется файл
ojdbc14.jar (Oracle 10) или
ojdbc5.jar (Oracle 11), обеспечивающий
взаимодействие Tomcat с сервером Oracle. Эти файлы предоставляются поставщиком сервера базы данных.
Об этой задаче
Для повышения производительности и стабильности
Rational Asset
Manager веб-приложения Rational Asset
Manager и файлы приложений
Rational Team
Concert
можно установить на отдельных серверах Tomcat. В пределах этого
документа установочный каталог сервера Tomcat для
Rational Asset
Manager
называется
<каталог-tomcat>, а
установочный каталог сервера Tomcat для
Rational Team
Concert
- <каталог-tomcat-для-rtc>.
В случае установки всех веб-приложений на одном сервере эти каталоги будут
совпадать.
Прим.: Для успешного развертывания
Rational Asset
Manager и встроенного продукта
Rational Team
Concert на нескольких серверах Tomcat, установленных на одном компьютере, необходимо указать отдельный порт для каждого сервера Tomcat во избежание возникновения коллизий. Дополнительная информация о портах в Tomcat 5.5 приведена в документации Apache Tomcat.
- Убедитесь, что на всех серверах хранилищ заданы одинаковые значения текущей даты, времени и часового пояса.
- Извлеките файлы сервера
Rational Asset Manager из
архива
для Tomcat и операционной системы. Эти файлы расположены в папке
<расположение-распаковки-архива>/apps/tomcat/.
- Извлеките файлы общей библиотеки в папку <каталог-tomcat>\shared\lib:
- Найдите и извлеките файл
<расположение-распаковки-архива>\apps\tomcat\sharedLib.zip.
- Скопируйте все содержимое архива sharedLib.zip в
каталог <каталог-tomcat>\shared\lib.
- В случае установки
Rational Team
Concert
на другом сервере Tomcat скопируйте содержимое файла
sharedLib.zip в каталог
<каталог-tomcat-для-rtc>\shared\lib
этого сервера Tomcat.
- Из каталога <расположение-распаковки-архива>/apps/tomcat/
скопируйте следующие файлы в каталог
<каталог-tomcat>/webapps/:
- com.ibm.ram.repository.web.tomcat_runtime.war
- com.ibm.ram.repository.web.ws.tomcat_runtime.war
- iehs.war
- rmcabdgovernprocess.war
- Для изменения корневого пути приложений переименуйте
соответствующие файлы WAR. Рекомендуется использовать следующие имена:
Табл. 1. Рекомендуемые корневые пути для файлов веб-приложений Rational Asset
Manager| Исходное имя файла |
Рекомендуемое имя файла |
Корневой путь |
Описание |
| com.ibm.ram.repository.web.tomcat_runtime.war |
ram.war |
ram |
Основное
веб-приложение
Rational Asset
Manager
для Tomcat |
| com.ibm.ram.repository.web.ws.tomcat_runtime.war |
ram.ws.war |
ram.ws |
Приложение
веб-служб
Rational Asset
Manager для Tomcat |
| iehs.war |
ram.help.war |
ram.help |
Приложение справки и
поддержки
Rational Asset
Manager |
| rmcabdgovernprocess.war |
ram.process.war |
ram.process |
Приложение с документацией по процессам разработки на основе ресурсов. |
- Настройте доступ к Oracle на сервере Tomcat для
Rational Asset
Manager.
- Откройте файл <каталог-tomcat>\conf\server.xml в текстовом редакторе.
- В файле server.xml найдите строки, начинающиеся со слова <Connector и содержащие значения port="8080" или port="8009".
Измените начало этих строк на <Connector URIEncoding="UTF-8".
- Между открывающим и закрывающим тегами для Глобальных ресурсов
JNDI <GlobalNamingResources> и
</GlobalNamingResources> в файле
server.xml введите следующий текст для своей
версии Tomcat.
Прим.: Вместо значений <имя_пользователя> и
<пароль_пользователя> укажите ИД и пароль
пользователя, имеющего права доступа администратора к базе данных. Значения, показанные для "maxWait",
“maxActive" и "maxIdle" являются примерами значений и могут быть
подогнаны в соответствии с потребностями производительности.
Введите следующий текст:
<Resource name="jdbc/RAM_Con"
type="javax.sql.DataSource"
driverClassName="oracle.jdbc.driver.OracleDriver"
username="<имя_пользователя>"
password="<пароль>"
url="jdbc:oracle:thin:@<полное-имя-системы>:<порт-oracle>:<имя-базы-данных-Rational-Asset-Manager>"
poolPreparedStatements="true"
maxWait="5000"
maxActive="4"
maxIdle="2"/>
- Добавьте следующий файл .jar в папку
<каталог_установки_tomcat>\common\lib:
- ojdbc14.jar (Oracle 10); или
- ojdbc5.jar (Oracle 11)
Этот файл можно получить у поставщика приложения базы данных.
- Найдите файл
<расположение-распаковки-архива>/apps/tomcat/RTC-server.zip
на установочном носителе.
- Извлеките архив RTC-server.zip в папку <установочный_каталог_rtc>.
- Найдите файл <установочный_каталог_rtc>/jazz/server/jazz_war.ear и извлеките его содержимое. Файлы
.ear можно извлечь с помощью бесплатной
утилиты 7-Zip.
Из извлеченного пакета jazz_war.ear скопируйте
файл jazz.war в каталог
<каталог-tomcat-для-rtc>/webapps/.
- Настройте защищенный порт на сервере Tomcat для Rational Team
Concert:
- Создайте сертификат защиты для идентификации сервера Tomcat
при установлении соединений
SSL. Можно создать собственный сертификат с помощью команды
keytool можно запросить сертификат, подписанный
сертификатной компанией.
Дополнительная информация о создании собственных
сертификатов с помощью команды keytool приведена в
документации
по Java Sun. Пример команды keytool, позволяющей
создать собственный сертификат: keytool -genkey -alias tomcat -keystore <каталог-tomcat-для-rtc>/.keystore
Многие версии JRE IBM содержат
инструмент ikeyman (в каталоге
<каталог-IBM-Java-JRE>/jre/bin/).
С помощью этого инструмента можно создавать сертификаты защиты на
сервере и управлять ими. Дополнительная информация об
инструменте iKeyman приведена в
книге
Руководство
пользователя iKeyman.
- В файле
<каталог-tomcat-для-rtc>\conf\server.xml
найдите тег <Connector> с атрибутом scheme="https".
В файле по умолчанию тег <Connector>
для порта 8443 выделен символами комментария.
- Скопируйте и вставьте следующий текст:
<Connector port="8443"
maxHttpHeaderSize="8192"
maxThreads="150"
minSpareThreads="25"
maxSpareThreads="75"
enableLookups="false"
disableUploadTimeout="true"
acceptCount="100"
scheme="https"
secure="true"
clientAuth="false"
keystoreFile="<файл-хранилища-ключей>"
keystorePass="<пароль-хранилища-ключей>"
sslProtocol="<протокол-хранилища-ключей>"
algorithm="<алгоритм-хранилища-ключей>"
URIEncoding="UTF-8" />
Где:
- <файл-хранилища-ключей> - это имя
файла хранилища ключей. Можно указать полный путь или
значение относительно корневого каталога сервера Tomcat (<каталог-tomcat-для-rtc>);
- <пароль-хранилища-ключей> - это
пароль файла хранилища ключей.
- <протокол-хранилища-ключей> - это
протокол хранилища ключей. Как правило, применяются значения
TLS и SSL_TLS.
- <алгоритм-хранилища-ключей> - это
алгоритм
X509 для хранилища ключей. Как правило, применяются значения
SunX509 и IbmX509.
- Если для параметра port указано значение, отличное от
8443 для коннектора без поддержки SSL (по умолчанию
применяется порт 8080), то измените значение
атрибута redirectPort с учетом номера порта
коннектора SSL.
Дополнительная информация о настройке SSL для Tomcat приведена на
следующих веб-страницах:
Apache
Tomcat 5.5 SSL Configuration HOW-TO и
Apache Tomcat Configuration reference.
- Настройте параметры
запуска Tomcat:
- Скопируйте подходящий файл .jar из
провайдера базы данных в папку
<каталог_установки_rtc>/jazz/server/oracle
(при необходимости создайте папку oracle вручную):
- ojdbc14.jar (Oracle 10); или
- ojdbc5.jar (Oracle 11)
- Только для Oracle 11: измените
имя файла ojdbc5.jar на ojdbc14.jar.
- Найдите файл запуска Tomcat и откройте его в текстовом редакторе. Путь в Windows®: <каталог-tomcat-для-rtc>\bin\startup.bat.
Путь в Linux®, AIX и Linux for zSeries: <каталог-tomcat-для-rtc>/bin/startup.sh.
- В файле запуска введите следующий текст, где
<каталог_установки_rtc> - это
извлеченный каталог на шаге 9, а
<каталог_jar_oracle> - это
расположение файла .jar Oracle из шага
12.a
(замените пробелы в <каталог_установки_rtc> и
<каталог_jar_oracle> символами
%20): set ORACLE_JDBC=<каталог_jar_oracle>
set JAZZ_INSTALL_DIR=<установочный_каталог_rtc>
set JAVA_OPTS=-Djava.awt.headless=true -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M


:ORACLE_JDBC=<каталог_jar_oracle>
JAZZ_INSTALL_DIR=<установочный_каталог_rtc>
export JAVA_OPTS="-Djava.awt.headless=true -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
- Отредактируйте файл свойств сервера Jazz:
- В каталоге <установочный_каталог_rtc>/jazz/server/conf/jazz/ найдите файл teamserver.properties и переименуйте его на teamserver.derby.properties.
- В каталоге
<каталог_установки_rtc>/jazz/server/conf/jazz/
найдите файл
teamserver.oracle.properties
и переименуйте его в teamserver.properties.
- В файле teamserver.properties укажите базу
данных и параметры соединения:
- В текстовом редакторе откройте файл
teamserver.properties.
- Найдите следующие строки:
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
- Измените значение
com.ibm.team.repository.db.jdbc.location для
расположения сервера Oracle и имя базы данных для жизненных циклов:
- Замените jazzDBUser на имя пользователя базы данных
Oracle (например, RAMSCHEMA).
- Замените @localhost:1521 на расположение
и порт базы данных Oracle. Если расположение отличается от
localhost, то перед ним необходимо добавить
две прямые косые черты (//), например,
@//oracleserver.example.com:1521.
- Замените ORCL на имя базы данных жизненного цикла;
например, rtcdb.
- В свойстве
com.ibm.team.repository.db.jdbc.password
замените JazzDBpswd на пароль указанного выше
пользователя Oracle.
Прим.: Не изменяйте текст
{password} в свойстве
com.ibm.team.repository.db.jdbc.location.
- Добавьте следующие свойства в файл teamserver.properties, где <незащищенный_порт> - номер незащищенного порта для сервера Tomcat (по умолчанию 8080), <защищенный_порт> - номер защищенного порта для сервера Tomcat (по умолчанию 8443) и <временный_каталог> - абсолютный путь к каталогу для хранения временных файлов:
com.ibm.team.scm.tmpdir=<временный_каталог>
com.ibm.team.repository.server.repourl.port.http=<незащищенный_порт>
com.ibm.team.repository.user.registry.type=UNSUPPORTED
com.ibm.team.repository.ws.allow.admin.access=false
com.ibm.team.repository.server.repourl.port.https=<защищенный_порт>
- Создайте таблицы для Rational Team
Concert:
- Откройте окно командной строки и перейдите в каталог
<установочный_каталог_rtc>/jazz/server/.
- Выполните следующую команду:
:repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties com.ibm.team.repository.db.override.versioncheck=true


:./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties com.ibm.team.repository.db.override.versioncheck=true
- Настройте серверы Tomcat для защиты пользователей. Если планируется
использовать защиту LDAP, то перед включением идентификации LDAP
следует настроить приложения
с помощью защиты на основе файлов (дополнительная информация приведена в
разделе Настройка идентификации LDAP для Tomcat):
- Откройте файл
<каталог-tomcat>\conf\tomcat-users.xml
в текстовом редакторе. (сервер для
Rational Asset Manager).
- Добавьте пользователя с именем admin и
присвойте ему роли admin и manager.
Можно скопировать следующий текст и вставить его между тегами
<tomcat-users>:
<user username="admin" password="" roles="admin,manager" />
Необходимо использовать имя пользователя admin.
- Откройте файл
<каталог-tomcat-для-rtc>\conf\tomcat-users.xml
в текстовом редакторе. (сервер для
Rational Team
Concert). Если приложения устанавливаются на одном
сервере Tomcat, то этот файл будет совпадать с файлом, указанным на шаге 15a.
- Вставьте следующий текст между
тегами <tomcat-users>:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- Добавьте пользователя с именем admin и
присвойте ему роли admin,
manager и JazzAdmins. Можно
скопировать следующий текст и вставить его между тегами
<tomcat-users>:
<user username="admin" password=""
roles="admin,manager,JazzAdmins" />
Если приложения устанавливаются на одном сервере, то можно
добавить роль JazzAdmins пользователю, созданному на
шаге 13b.
- Перезапустите сервер Tomcat.
- Настройте учетную запись администратора для Rational Team
Concert:
- Запустите веб-интерфейс администрирования Rational Team
Concert в веб-браузере, указав следующий адрес: https://<имя_системы>:<защищенный_порт>/jazz/admin/. Обратите внимание на префикс https; требуется
защищенное соединение.
- Войдите в систему, указав ИД пользователя
и Пароль администратора сервера
приложений. Если будет выдано сообщение об ошибке, связанной с загрузкой информации о
состоянии сервера, то перезапустите сервер базы данных и сервер Tomcat и
снова войдите в систему.
- Нажмите Управление пользователями. Ошибки, связанные с конфигурацией внешнего реестра, можно
проигнорировать.
- Выберите Создать пользователя.
- Введите следующие сведения:
- Имя пользователя: ИД администратора сервера Tomcat
- ИД пользователя: ИД администратора сервера Tomcat
- Адрес электронной почты: Действительный адрес электронной почты администратора сервера Tomcat
- В разделе "Лицензия для доступа к клиенту" выберите Rational
Team Concert - Разработчик, чтобы предоставить этому пользователю лицензию разработчика.
- Выберите Сохранить.
- Выйдите из системы и снова войдите в пользовательский
веб-интерфейс администрирования от имени администратора сервера
приложений.
- Импортируйте шаблона процесса управления жизненными циклами в Rational Team
Concert:
- В веб-интерфейсе администрирования Rational Team
Concert нажмите Управление шаблонами процессов. Если ссылка Управление шаблонами
процессов не отображается, то выйдите из системы и снова
войдите в пользовательский веб-интерфейс администрирования.
- Нажмите Импортировать шаблон и выберите файл com.ibm.ram.lifecycle.zip, расположенный в папке <расположение-распаковки-архива>/DatabaseScripts/.
Нажмите кнопку ОК. Будет показан шаблон RAM
Lifecycle.
- Создайте новую область проекта в Rational Team
Concert:
- В В веб-интерфейсе администрирования Rational Team
Concert нажмите Управление областями проекта. Если ссылка Управление областью проекта не отображается, то выйдите из системы и снова
войдите в пользовательский веб-интерфейс администрирования.
- Нажмите Создать область проекта.
- Введите следующие данные:
- Имя проекта: Жизненный цикл RAM
- Сводка: Область проекта для управления жизненными циклами Rational Asset Manager
- Описание: Эта область применяется для управления жизненными циклами Rational Asset Manager
- Выберите Сохранить.
- Укажите необходимые роли и участников для области проекта:
- На странице "Управление областями проекта" выберите область проекта Жизненный цикл RAM.
- В разделе "Администраторы" нажмите Добавить; затем найдите и выберите созданную учетную запись администратора.
- В разделе "Участники" нажмите Добавить; затем найдите и выберите созданную учетную запись администратора.
- После добавления администратора щелкните на значке Роли процесса рядом с именем администратора.
- В окне "Изменить роли процесса" в списке Доступные роли выберите Администрирование и нажмите кнопку Добавить.
- Нажмите кнопку Готово.
- Выберите Сохранить.
- Остановите и перезапустите сервер Tomcat.
- В веб-браузере откройте Rational Asset Manager.
В случае применения рекомендуемых имен файлов приложений URL будет выглядеть
следующим образом: http://localhost:8080/ram/home.faces
или
http://<адрес-веб-сервера>:<порт>/ram/home.faces. Откроется веб-клиент Rational Asset Manager.
Дальнейшие действия
Затем настройте веб-приложение Rational Asset
Manager. Дополнительная информация приведена в разделе Настройка приложения сервера Rational Asset Manager.