Развертывание Rational Asset Manager в Apache Tomcat V5.5, подключенном к SQL Server 2005

Можно вручную установить IBM® Rational Asset Manager в существующей установке Apache Tomcat.
Подготовка

У вас есть права доступа администратора и доступ к файлам на сервере Tomcat, который установлен и запущен.

Вам потребуется файл sqljdbc.jar, который позволяет Tomcat подключиться к серверу Microsoft® SQL Server. Эти файлы предоставляются поставщиком сервера базы данных.

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

Для повышения производительности и стабильности 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.
  1. Убедитесь, что на всех серверах хранилищ заданы одинаковые значения текущей даты, времени и часового пояса.
  2. Извлеките файлы сервера Rational Asset Manager из архива для Tomcat и операционной системы. Эти файлы расположены в папке <расположение-распаковки-архива>/apps/tomcat/.
  3. Извлеките файлы общей библиотеки в папку <каталог-tomcat>\shared\lib:
    1. Найдите и извлеките файл <расположение-распаковки-архива>\apps\tomcat\sharedLib.zip.
    2. Скопируйте все содержимое архива sharedLib.zip в каталог <каталог-tomcat>\shared\lib.
    3. В случае установки Rational Team Concert на другом сервере Tomcat скопируйте содержимое файла sharedLib.zip в каталог <каталог-tomcat-для-rtc>\shared\lib этого сервера Tomcat.
  4. Из каталога <расположение-распаковки-архива>/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
  5. Для изменения корневого пути приложений переименуйте соответствующие файлы 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 Приложение с документацией по процессам разработки на основе ресурсов.
  6. Настройте сервер Tomcat для Rational Asset Manager для подключения к серверу SQL Server.
    1. Откройте файл <каталог-tomcat>\conf\server.xml в текстовом редакторе.
    2. В файле server.xml найдите строки, начинающиеся со слова <Connector и содержащие значения port="8080" или port="8009". Измените начало этих строк на <Connector URIEncoding="UTF-8".
    3. Между открывающим и закрывающим тегами для Глобальных ресурсов JNDI <GlobalNamingResources> и </GlobalNamingResources> в файле server.xml введите следующий текст для своей версии Tomcat.
      Прим.: Вместо значений <имя_пользователя> и <пароль_пользователя> укажите ИД и пароль пользователя, имеющего права доступа администратора к базе данных. Значения, показанные для "maxWait", “maxActive" и "maxIdle" являются примерами значений и могут быть подогнаны в соответствии с потребностями производительности.
    Введите следующий текст:
    <Resource name="jdbc/RAM_Con"
    type="javax.sql.DataSource"
    driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
    username="<имя_пользователя>"
    password="<пароль>"
    url="jdbc:microsoft:sqlserver://<полное-имя-сервера>:<порт-SQLServer>:<имя-базы-данных-Rational-Asset-Manager>"
    poolPreparedStatements="true"
    maxWait="5000"
    maxActive="4"
    maxIdle="2"/>
  7. Добавьте следующий файл JAR в папку <каталог_установки_tomcat>\common\lib:
    • sqljdbc.jar
    Этот файл можно получить у поставщика приложения базы данных.
  8. Найдите файл <расположение-распаковки-архива>/apps/tomcat/RTC-server.zip на установочном носителе.
  9. Извлеките архив RTC-server.zip в папку <установочный_каталог_rtc>.
  10. Найдите файл <установочный_каталог_rtc>/jazz/server/jazz_war.ear и извлеките его содержимое. Файлы .ear можно извлечь с помощью бесплатной утилиты 7-Zip. Из извлеченного пакета jazz_war.ear скопируйте файл jazz.war в каталог <каталог-tomcat-для-rtc>/webapps/.
  11. Настройте защищенный порт на сервере Tomcat для Rational Team Concert:
    1. Создайте сертификат защиты для идентификации сервера 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.

    2. В файле <каталог-tomcat-для-rtc>\conf\server.xml найдите тег <Connector> с атрибутом scheme="https". В файле по умолчанию тег <Connector> для порта 8443 выделен символами комментария.
    3. Скопируйте и вставьте следующий текст:
      <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.
    4. Если для параметра port указано значение, отличное от 8443 для коннектора без поддержки SSL (по умолчанию применяется порт 8080), то измените значение атрибута redirectPort с учетом номера порта коннектора SSL.

    Дополнительная информация о настройке SSL для Tomcat приведена на следующих веб-страницах: Apache Tomcat 5.5 SSL Configuration HOW-TO и Apache Tomcat Configuration reference.

  12. Настройте параметры запуска Tomcat:
    1. Скопируйте следующий файл .jar из провайдера базы данных в папку <каталог-rtc>/jazz/server/sqlserver (при необходимости создайте папку sqlserver вручную):
      • sqljdbc.jar
    2. Найдите файл запуска Tomcat и откройте его в текстовом редакторе. Путь в Windows®: <каталог-tomcat-для-rtc>\bin\startup.bat. Путь в Linux®, AIX и Linux for zSeries: <каталог-tomcat-для-rtc>/bin/startup.sh.
    3. В файле запуска введите следующий текст, где <каталог-rtc> - это извлеченный каталог на шаге 9, а <каталог_jar_oracle> - это расположение файла .jar SQL Server из шага 12.a:
      • Windows: (замените пробелы в <каталог-rtc> и <каталог_jar_oracle> символами %20):
        set SQLSERVER_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
      • Linux:AIX:Linux для zSeries::
        SQLSERVER_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"
  13. Отредактируйте файл свойств сервера Jazz:
    1. В каталоге <установочный_каталог_rtc>/jazz/server/conf/jazz/ найдите файл teamserver.properties и переименуйте его на teamserver.derby.properties.
    2. В каталоге <каталог-rtc>/jazz/server/conf/jazz/ найдите файл teamserver.sqlserver.properties и переименуйте его в teamserver.properties.
    3. В файле teamserver.properties укажите базу данных и параметры соединения:
      1. В текстовом редакторе откройте файл teamserver.properties.
      2. Найдите следующие строки:
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      3. Измените значение com.ibm.team.repository.db.jdbc.location для расположения SQL Server и имя базы данных для жизненных циклов:
        1. Замените @localhost:1433 на расположение и порт базы данных SQL Server.
        2. Замените jazz на имя базы данных жизненного цикла, например, RTCDB.
        3. Замените jazzDBUser на имя пользователя базы данных SQL Server.
      4. В свойстве com.ibm.team.repository.db.jdbc.password замените JazzDBpswd на пароль указанного выше пользователя SQL Server.
        Прим.: Не изменяйте текст {password} в свойстве com.ibm.team.repository.db.jdbc.location.
      5. Добавьте следующие свойства в файл 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=<защищенный_порт>
  14. Создайте таблицы для Rational Team Concert:
    1. Откройте окно командной строки и перейдите в каталог <установочный_каталог_rtc>/jazz/server/.
    2. Выполните следующую команду:
      • Windows::
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Linux:AIX:Linux для zSeries::
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  15. Настройте серверы Tomcat для защиты пользователей. Если планируется использовать защиту LDAP, то перед включением идентификации LDAP следует настроить приложения с помощью защиты на основе файлов (дополнительная информация приведена в разделе Настройка идентификации LDAP для Tomcat):
    1. Откройте файл <каталог-tomcat>\conf\tomcat-users.xml в текстовом редакторе. (сервер для Rational Asset Manager).
    2. Добавьте пользователя с именем admin и присвойте ему роли admin и manager. Можно скопировать следующий текст и вставить его между тегами <tomcat-users>:
      <user username="admin" password="" roles="admin,manager" />

      Необходимо использовать имя пользователя admin.

    3. Откройте файл <каталог-tomcat-для-rtc>\conf\tomcat-users.xml в текстовом редакторе. (сервер для Rational Team Concert). Если приложения устанавливаются на одном сервере Tomcat, то этот файл будет совпадать с файлом, указанным на шаге 15a.
    4. Вставьте следующий текст между тегами <tomcat-users>:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    5. Добавьте пользователя с именем admin и присвойте ему роли admin, manager и JazzAdmins. Можно скопировать следующий текст и вставить его между тегами <tomcat-users>:
      <user username="admin" password=""
      roles="admin,manager,JazzAdmins" />

      Если приложения устанавливаются на одном сервере, то можно добавить роль JazzAdmins пользователю, созданному на шаге 13b.

  16. Перезапустите сервер Tomcat.
  17. Настройте учетную запись администратора для Rational Team Concert:
    1. Запустите веб-интерфейс администрирования Rational Team Concert в веб-браузере, указав следующий адрес: https://<имя_системы>:<защищенный_порт>/jazz/admin/. Обратите внимание на префикс https; требуется защищенное соединение.
    2. Войдите в систему, указав ИД пользователя и Пароль администратора сервера приложений. Если будет выдано сообщение об ошибке, связанной с загрузкой информации о состоянии сервера, то перезапустите сервер базы данных и сервер Tomcat и снова войдите в систему.
    3. Нажмите Управление пользователями. Ошибки, связанные с конфигурацией внешнего реестра, можно проигнорировать.
    4. Выберите Создать пользователя.
    5. Введите следующие сведения:
      1. Имя пользователя: ИД администратора сервера Tomcat
      2. ИД пользователя: ИД администратора сервера Tomcat
      3. Адрес электронной почты: Действительный адрес электронной почты администратора сервера Tomcat
    6. В разделе "Лицензия для доступа к клиенту" выберите Rational Team Concert - Разработчик, чтобы предоставить этому пользователю лицензию разработчика.
    7. Выберите Сохранить.
    8. Выйдите из системы и снова войдите в пользовательский веб-интерфейс администрирования от имени администратора сервера приложений.
  18. Импортируйте шаблона процесса управления жизненными циклами в Rational Team Concert:
    1. В веб-интерфейсе администрирования Rational Team Concert нажмите Управление шаблонами процессов. Если ссылка Управление шаблонами процессов не отображается, то выйдите из системы и снова войдите в пользовательский веб-интерфейс администрирования.
    2. Нажмите Импортировать шаблон и выберите файл com.ibm.ram.lifecycle.zip, расположенный в папке <расположение-распаковки-архива>/DatabaseScripts/. Нажмите кнопку ОК. Будет показан шаблон RAM Lifecycle.
  19. Создайте новую область проекта в Rational Team Concert:
    1. В В веб-интерфейсе администрирования Rational Team Concert нажмите Управление областями проекта. Если ссылка Управление областью проекта не отображается, то выйдите из системы и снова войдите в пользовательский веб-интерфейс администрирования.
    2. Нажмите Создать область проекта.
    3. Введите следующие данные:
      • Имя проекта: Жизненный цикл RAM
      • Сводка: Область проекта для управления жизненными циклами Rational Asset Manager
      • Описание: Эта область применяется для управления жизненными циклами Rational Asset Manager
    4. Выберите Сохранить.
  20. Укажите необходимые роли и участников для области проекта:
    1. На странице "Управление областями проекта" выберите область проекта Жизненный цикл RAM.
    2. В разделе "Администраторы" нажмите Добавить; затем найдите и выберите созданную учетную запись администратора.
    3. В разделе "Участники" нажмите Добавить; затем найдите и выберите созданную учетную запись администратора.
    4. После добавления администратора щелкните на значке Роли процесса рядом с именем администратора.
    5. В окне "Изменить роли процесса" в списке Доступные роли выберите Администрирование и нажмите кнопку Добавить.
    6. Нажмите кнопку Готово.
    7. Выберите Сохранить.
  21. Остановите и перезапустите сервер Tomcat.
  22. В веб-браузере откройте Rational Asset Manager. В случае применения рекомендуемых имен файлов приложений URL будет выглядеть следующим образом: http://localhost:8080/ram/home.faces или http://<адрес-веб-сервера>:<порт>/ram/home.faces. Откроется веб-клиент Rational Asset Manager.
Дальнейшие действия
Затем настройте веб-приложение Rational Asset Manager. Дополнительная информация приведена в разделе Настройка приложения сервера Rational Asset Manager.

Отправить комментарий