Развертывание приложений сервера Rational Asset Manager server на Tomcat 5.5

IBM® Rational Asset Manager можно установить в установку Apache Tomcat вручную.

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

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

Необходимо знать расположение следующих файлов JDBC .jar для сервера базы данных:
  • Для IBM DB2:db2jcc_license_cu.jar и db2jcc.jar
  • Для Oracle:ojdbc5.jar. При работе с Oracle 10 можно использовать файл ojdbc5.jar для Oracle 11. Файлы можно загрузить из Oracle.
  • Для Microsoft SQL Server:sqljdbc.jar. Файлы можно загрузить из Microsoft.

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

Производительность и стабильность Rational Asset Manager можно повысить установкой его веб-приложений и файлов приложений для включенного IBM Rational Team Concert на отдельных серверах Tomcat. Во всем этом документе установочным каталогом для сервера Tomcat для Rational Asset Manager является установочный-каталог-tomcat. Установочным каталогом для сервера Tomcat для Rational Team Concert является установочный-каталог-tomcat-для-rtc. При установке всех веб-приложений на одном сервере Tomcat эти каталоги будут одинаковы.

Прим.: Для успешного развертывания Rational Asset Manager и включенного Rational Team Concert в разных приложениях сервера Tomcat на одном компьютере эти разные серверы Tomcat должны быть настроены для использования разных защищенных и незащищенных во избежание конфликтов. Дополнительная информация о портах Tomcat 5.5 приведена в документации по Apache Tomcat.

Процедура

  1. Убедитесь, что на всех серверах хранилищ заданы одинаковые значения текущей даты, времени и часового пояса.
  2. Извлеките файлы приложений в соответствующий архив для 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. Для Windows: Linux:AIX: Извлеките библиотечные файлы для Rational Licensing Key Server 8.1.2 в папку установочный-каталог-tomcat\shared\lib:
    Важное замечание: При установке в Linux for zSeries не выполняйте этот шаг
    1. Найдите и извлеките файл расположение-извлечения-архива\sharedLibs\rlsclients_rlsibmratl_812.zip.
    2. В распакованном файле .zip найдите файл rlsibmratl812.zip для операционной системы и архитектуры. Например, файл для 32-разрядной Windows находится в каталоге win32.
    3. Извлеките содержимое соответствующего файла rlsibmratl812.zip.
    4. Скопируйте все содержимое извлеченного файла rlsibmratl812.zip в каталог установочный-каталог-tomcat\shared\lib.
  5. Для Windows: Linux:AIX: Измените сценарий запуска для сервера Tomcat для Rational Asset Manager:
    Важное замечание: При установке в Linux for zSeries не выполняйте этот шаг
    1. Найдите файл запуска Tomcat и откройте его в текстовом редакторе. В случае Windows этим файлом является установочный-каталог-tomcat\bin\startup.bat. Путь в Linux, AIX и Linux for zSeries: установочный-каталог-tomcat/bin/startup.sh.
    2. В файл запуска введите следующий текст:
      • Для Windows:
        set JAVA_OPTS=-Djava.library.path="установочный-каталог-tomcat\shared\lib"
      • Linux:AIX:
        export JAVA_OPTS="-Djava.library.path=установочный-каталог-tomcat/shared/lib"
  6. Из каталога расположение-извлечения-архива/apps/tomcat/ скопируйте следующие файлы в каталог установочный-каталог-tomcat/webapps/:
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • ramhelp.war
    • rmcabdgovernprocess.war
  7. Для изменения корневого пути приложений переименуйте соответствующие файлы 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
    ramhelp.war ram.help.war ram.help Приложение справки и поддержки Rational Asset Manager
    rmcabdgovernprocess.war ram.process.war ram.process Приложение с документацией по процессам разработки на основе ресурсов.
  8. Настройте сервер Tomcat для доступа Rational Asset Manager к вашей базе данных:
    1. Откройте файл установочный-каталог-tomcat\conf\server.xml в текстовом редакторе.
    2. В файле server.xml найдите строки, начинающиеся со слова <Connector и содержащие значения port="8080" или port="8009". Измените начало этих строк на <Connector URIEncoding="UTF-8".
    3. Между открывающим и закрывающим тегами для ресурсов Global JNDI <GlobalNamingResources> и </GlobalNamingResources> введите следующий текст для вашей версии Tomcat.
      Прим.: Вместо значений имя_пользователя и пароль_пользователя укажите ИД и пароль пользователя, имеющего права доступа администратора к базе данных. Например, атрибут "url" может выглядеть следующим образом: jdbc:db2://localhost:50000/RAMDB
    Введите этот текст для вашего сервера базы данных, заменив следующие переменные:
    • В атрибутах имя пользователя и пароль замените свое-имя-пользователя и свой-пароль на ИД пользователя и пароль с административными правами доступа к серверу базы данных.
    • В атрибуте url замените полное-имя-сервера-базы-данных и номер-порта-базы-данных адресом и номером порта сервера для вашей базы данных и замените имя-базы-данных-Rational-Asset-Manager именем базы данных для ресурсов. Например, для DB2 атрибут url может выглядеть следующим образом: jdbc:db2://localhost:50000/RAMDB.
    • Значения атрибутов maxWait, maxActive и maxIdle приведены только для примера и могут быть изменены соответственно требованиям к производительности.
    • Для IBM DB2:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="свое-имя-пользователя"
      password="свой-пароль"
      url="jdbc:db2://полное-имя-сервера-базы-данных:номер-порта-базы-данных/имя-базы-данных-Rational-Asset-Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Для Oracle:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="свое-имя-пользователя"
      password="свой-пароль"
      url="jdbc:oracle:thin:@полное-имя-сервера-базы-данных:номер-порта-базы-данных:имя-базы-данных-Rational-Asset-Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Для Microsoft SQL Server:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="свое-имя-пользователя"
      password="свой-пароль"
      url="jdbc:microsoft:sqlserver://полное-имя-сервера-базы-данных:номер-порта-базы-данных:имя-базы-данных-Rational-Asset-Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. Надстройте сервер Tomcat на единый вход для всех приложений:
    1. Откройте файл установочный-каталог-tomcat\conf\server.xml в текстовом редакторе.
    2. Найдите следующий текст:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. Удалите символы комментария с элемента <Valve>:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  10. Скопируйте следующие файлы JAR в папку установочный-каталог-tomcat\common\lib:
    • Для IBM DB2:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • Для Oracle:
      • ojdbc5.jar (Этот файл можно загрузить из Oracle. При работе с Oracle 10 загрузите пакет для Oracle 11 и найдите файл ojdbc5.jar.)
    • Для Microsoft SQL Server:
      • sqljdbc.jar (Этот файл можно загрузить из Microsoft.)
    Эти файлы предоставляются провайдером баз данных, вероятнее всего, в папке /java/ установочного каталога базы данных.
  11. Настройте сервер Tomcat на защиту пользователей. Если планируется использовать защиту LDAP, сначала используйте защиту на основе файлов, и после настройки приложений переключитесь на идентификацию LDAP. Дополнительная информация приведена в разделе Настройка идентификации LDAP для Tomcat.
    1. В текстовом редакторе откройте файл установочный-каталог-tomcat\conf\tomcat-users.xml.
    2. Введите имя пользователя admin и присвойте ему роли admin и manager. Для добавления этого пользователя можно скопировать и вставить между тегами <tomcat-users> следующий текст:
      <user username="admin" password="" roles="admin,manager" />

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

  12. В зависимости от настройки разверните или настройте Rational Team Concert.

Комментарии