Обновление предыдущей версии на сервере Tomcat

Приведены инструкции по обновлению предыдущей версии IBM® Rational Asset Manager на Apache Tomcat.

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

Важное замечание: В случае обновления Rational Asset Manager версии 7.1.1.1 необходимо установить IBM Rational Team Concert, требующий дополнительную базу данных и защищенный сертификат для сервера Tomcat.

Необходимо обновить сервер лицензий и создать запрос на обновленные ключи лицензий. Дополнительная информация о требуемой версии Rational License Server приведена в разделе Установка Rational License Key Server.

Кроме того, потребуется несколько раз остановить и перезапустить сервер приложений.

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

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

В этом кратком изложении перечислены необходимые действия для обновления Rational Asset Manager до последней версии:
  1. Выполните подготовительные действия для обновления и резервного копирования важных файлов и баз данных: шаги 1-4.
  2. Получите файлы приложений для последней версии Rational Asset Manager: шаг 5.
  3. В случае обновления версии V7.1.1.1 или более ранней создайте дополнительную базу данных: шаг 6.
  4. Завершите работу сервера Tomcat: шаг 7.
  5. Обновите сервер лицензий до Rational Common Licensing 8.1.2: шаг 8.
  6. Скопируйте новую общую библиотеку файлов для Rational Asset Manager и Rational Common Licensing 8.1.2 и соответствующим образом измените файлы запуска сервера Tomcat: шаги 9-11.
  7. Надстройте сервер Tomcat на единый вход: шаг 12.
  8. Получите файлы текущего приложения для включенного Rational Team Concert: шаги 13-14.
  9. Если при обновлении из версии V7.1.1.1 или более ранней требуется Rational Team Concert, установите Rational Team Concert на сервере приложений: шаги 17-24.
  10. В случае обновления версии V7.1.1.1 или более ранней настройте Rational Team Concert: шаги 25-31.
  11. В случае обновления версии V7.2 или более поздней обновите включенный Rational Team Concert: шаг 33.
  12. Удалите файлы существующего приложения для Rational Asset Manager и установите новые версии приложений: шаги 34-39.
  13. Войдите в Rational Asset Manager и перенесите хранилище: шаг 40.
  14. В случае обновления версии V7.1.1.1 или более ранней настройте Rational Asset Manager для подключения к Rational Team Concert: шаг 42.
  15. Измените параметры для подключения к новому общему серверу лицензий Rational: шаг 43.
  16. Обновите все клиенты Eclipse: шаг 44.

Процедура

  1. Перед тем как начать обновление, создайте полную резервную копию хранилища, баз данных, файлов ресурсов и параметров сервера приложений согласно инструкциям раздела Резервное копирование хранилища Rational Asset Manager.
  2. Если тема или сообщения электронной почты были изменены до обновления сервера Rational Asset Manager, загрузите текущую тему и файлы сообщений электронной почты (на странице Администрирование > Сервис) и затем повторно примените их после обновления сервера. См. раздел Миграция темы.
  3. Убедитесь, что на всех серверах хранилищ заданы одинаковые значения текущей даты, времени и часового пояса.
  4. Если применяется Rational Asset Manager версии 7.0.0.2 или ниже, убедитесь, что сервер заданий включен. Для того чтобы включить сервер заданий, выполните следующие действия:
    1. Войдите в веб-клиент Rational Asset Manager как администратор хранилища.
    2. Выберите Администрирование.
    3. В боковой панели "Управление хранилищем" нажмите Инструменты.
    4. В строке адреса браузера замените tools.faces на advancedConfiguration.faces и откройте указанную страницу. Пример: http://example.com:9080/com.ibm.ram.repository.web/admin/repository/advancedConfiguration.faces
    5. На странице "Дополнительные параметры" в разделе "Параметры заданий" выберите Включить сервер заданий.
    6. Нажмите кнопку Сохранить.
    7. Перезапустите сервер приложений.
  5. Извлеките файлы приложений в соответствующий архив для Tomcat и операционной системы. Файлы приложений находятся в папке расположение-извлечения-архива/apps/tomcat/.
  6. В случае обновления версии V7.1.1.1 или более ранней:Создайте базу данных для жизненных циклов ресурсов:
  7. Остановите сервер Tomcat или серверы. Хранилище и все другие приложения на вашем сервере теперь будут автономны.
  8. Для Windows:Linux:AIX: Обновите свой Rational Licensing Server до версии Rational Common Licensing 8.1.2 или выше. Дополнительная информация приведена в разделе Миграция из Rational Licensing Server v7.1.x или более ранних в Rational Common Licensing.

    Rational License Key Server поставляется на установочном носителе вместе с Rational Asset Manager. Последнюю версию Rational License Server можно также получить с помощью своей учетной записи Passport Advantage или в Rational Download Center.

    Эта процедура требует остановки всех приложений на Rational Licensing Server, удаления из системы существующего Rational Licensing Server, обновления лицензионных файлов и установки сервера Rational Common Licensing. Для Windows см. раздел Настройка сервера лицензий для Windows; для AIX или Linux см. раздел Настройка сервера лицензий для UNIX.

    Для Linux для zSeries продолжите использовать Rational License Server для UNIX и Linux 7.0.0.1.
  9. Извлеките файлы общей библиотеки в папку \shared\lib для серверов Tomcat:
    1. Найдите и извлеките файл расположение-извлечения-архива\apps\tomcat\sharedLib.zip.
    2. Скопируйте все содержимое архива sharedLib.zip в каталог установочный-каталог-tomcat\shared\lib.
  10. Для 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.
  11. Для Windows:Linux:AIX: Измените сценарий запуска для сервера Tomcat для Rational Asset Manager
    1. Найдите файл запуска Tomcat и откройте его в текстовом редакторе. В случае Windows этим файлом является установочный-каталог-tomcat\bin\startup.bat. Путь в Linux, AIX и Linux for zSeries: установочный-каталог-tomcat/bin/startup.sh.
    2. Найдите строку, включающую JAVA_OPTS=.
      • Если переменная среды JAVA_OPTS уже задана, то добавьте следующие опцию и значение:
        • Для Windows:
          -Djava.library.path="установочный-каталог-tomcat\shared\lib"
        • Linux:AIX:
          -Djava.library.path=установочный-каталог-tomcat/shared/lib
      • Если переменная среды JAVA_OPTS не задана, то введите следующий текст:
        • Для Windows:
          set JAVA_OPTS=-Djava.library.path="установочный-каталог-tomcat\shared\lib"
        • Linux:AIX:
          export JAVA_OPTS="-Djava.library.path=установочный-каталог-tomcat/shared/lib"
  12. Надстройте сервер Tomcat на единый вход для всех приложений:
    1. Откройте файл установочный-каталог-tomcat\conf\server.xml в текстовом редакторе.
    2. Найдите следующий текст:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. Удалите символы комментария с элемента <Valve>:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  13. На установочном носителе найдите файл расположение-извлечения-архива/apps/tomcat/RTC-server.zip.
  14. Извлеките архив RTC-server.zip в расположение на жестком диске, которым в этих инструкциях является rtc_install_dir.
  15. В зависимости от ситуации установите и настройте или обновитеRational Team Concert:
    • При обновлении из версии 7.1.1.1 или предыдущих: Установите и настройте включенный Rational Team Concert. Перейдите к шагу 16.
    • При обновлении из версии 7.2 или следующих: Обновите включенный Rational Team Concert. Перейдите к шагу 33.
  16. В зависимости от ситуации установите и настройте или только обновите Rational Team Concert:
    • При необходимости установки и настройки Rational Team Concert: Перейдите к этапу 17.
    • При наличии существующего приложения Rational Team Concert и необходимости настройки его на работу с Rational Asset Manager: Перейдите к этапу 25.
  17. Найдите файл rtc_install_dir/jazz/server/ramjazz_war.ear и извлеките его. Для извлечения файлов .ear можно воспользоваться бесплатной утилитой, например 7-Zip. Из извлеченного пакета ramjazz_war.ear скопируйте файл ramjazz.war в каталог установочный-каталог-tomcat-для-rtc/webapps/.
  18. Настройте защищенный порт на сервере Tomcat для Rational Team Concert:
    1. Создайте сертификат защиты, который идентифицирует ваш сервер Tomcat для Rational Team Concert для соединений SSL. Для создания собственного сертификата можно использовать команду Java JDK keytool. Также можно запросить сертификат, подписанный надежной сертификатной компанией.
      Дополнительная информация о создании собственных сертификатов с помощью команды keytool приведена в документации по Oracle Java. Собственный сертификат можно создать,например, с помощью следующей команды keytool:
      keytool -genkey -alias tomcat -keystore установочный-каталог-tomcat-для-rtc/.keystore

      При запуске этой команды появится запрос на ввод пароля для файла хранилища ключей. По умолчанию применяется пароль changeit, но можно задать и другой пароль. Этот пароль нужно будет потом ввести для доступа к файлу server.xml.

      Многие версии JRE IBM содержат инструмент IBM ikeyman (в каталоге IBM_Java_JRE_install_location/jre/bin/). С помощью этого инструмента можно создавать сертификаты защиты на сервере и управлять ими. Дополнительная информация об использовании инструмента iKeyman приведена в Руководство пользователя iKeyman.

      В папке rtc_install_dir/jazz/server/ также содержится простой сертификат; файл сертификата: ibm-team-ssl.keystore

    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"
           connectionTimeout="20000"
           acceptCount="100"
           scheme="https"
           secure="true" 
           clientAuth="false"
           keystoreFile="файл-хранилища-ключей"
           keystorePass="пароль-хранилища-ключей"
           sslProtocol="протокол-хранилища-ключей"
           algorithm="алгоритм-хранилища-ключей"
           URIEncoding="UTF-8" />
      Где:
      • файл-хранилища-ключей - это имя файла хранилища ключей. Это может быть полный путь или относительный из корневого каталога вашего сервера Tomcat (установочный-каталог-tomcat-для-rtc). При использовании простой команды, приведенной выше, это будет .keystore. При использовании включенного сертификата это будет rtc_install_dir/jazz/server/ibm-team-ssl.keystore .
      • пароль-хранилища-ключей - это пароль файла хранилища ключей. При использовании включенного файла хранилища ключей это будет ibm-team .
      • протокол-хранилища-ключей - это протокол хранилища ключей. Им может быть TLS или SSL_TLS. При использовании включенного файла хранилища ключей это будет SSL_TLS .
      • алгоритм-хранилища-ключей - это алгоритм X509 для хранилища ключей. Чаще всего это SunX509 или IbmX509 в зависимости от источника сертификата. При использовании включенного файла хранилища ключей это будет IbmX509 .
    4. Можно изменить значение порта для использования другого порта, кроме 8443, для соединения без SSL (по умолчанию применяется порт 8080). При изменении значения порта измените значение атрибута redirectPort соответственно номеру порта для соединения SSL.

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

  19. Для Oracle:Для Microsoft SQL Server: Скопируйте соответствующий фал .jar from your database provider:
    • Для Oracle: Скопируйте файл ojdbc14.jar в папку rtc_install_dir/jazz/server/oracle (возможно, потребуется создать папку oracle).

      Файл можно загрузить из Oracle. При работе с Oracle 11 загрузите пакет для Oracle 10g и найдите файл ojdbc14.jar.

    • Для Microsoft SQL Server: Скопируйте следующий файл в папку rtc_install_dir/jazz/server/sqlserver (возможно, потребуется создать папку sqlserver):
      • sqljdbc.jar (Этот файл можно загрузить из Microsoft.)
  20. Настройте параметры свойства запуска Tomcat:
    1. Найдите файл запуска Tomcat и откройте его в текстовом редакторе. В Windows это файл установочный-каталог-tomcat-для-rtc\bin\startup.bat. В Linux, AIX или Linux for zSeries это файл установочный-каталог-tomcat-для-rtc/bin/startup.sh.
    2. В файл запуска введите следующий текст:
      • Для Windows: Замените все символы пробела в rtc_install_dir на %20:
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=rtc_install_dir
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="установочный-каталог-tomcat-для-rtc\shared\lib" -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:
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=rtc_install_dir
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=установочный-каталог-tomcat-для-rtc/shared/lib -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"
      Где:
      • rtc_install_dir - это каталог, извлеченный из файла RTC-server.zip. В Windows замените все символы пробела в rtc_install_dir на %20
      • Для Oracle: oracle_jar_dir - это каталог для файла ojdbc14.jar (rtc_install_dir/jazz/server/oracle)
      • Для Microsoft SQL Server: sqlServer_jar_dir - это каталог для файла sqljdbc.jar (rtc_install_dir/jazz/server/sqlserver)
      • установочный-каталог-tomcat-для-rtc - это установочный каталог для сервера Tomcat
      • Для Windows: Linux:AIX: При установке Rational Asset Manager и Rational Team Concert на тот же сервер приложений используйте эту системную переменную JAVA_OPTS для замены создаваемой при настройке сценария запуска для сервера Tomcat для Rational Asset Manager; это определение переменной еще включает опцию -Djava.library.path.
  21. Найдите и переименуйте соответствующий файл свойств сервера Jazz:
    1. В каталоге rtc_install_dir/jazz/server/conf/ramjazz/ найдите файл teamserver.properties и переименуйте его в teamserver.derby.properties.
    2. Найдите файл для соответствующего сервера базы данных:
      • DB2:Для Windows:Для DB2 в Windows: teamserver.db2.win32.properties
      • DB2:Linux:AIX:Linux для zSeries:Для DB2 в Linux, AIX или Linux for zSeries: teamserver.db2.linux.properties
      • Oracle: teamserver.oracle.properties
      • SQL Server: teamserver.sqlserver.properties
    3. Переименуйте файл в teamserver.properties.
  22. В текстовом редакторе откройте файл teamserver.properties и измените его следующим образом (для вашего провайдера баз данных):
    • DB2:
      1. Найдите следующие строки:
        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
      2. Измените значение com.ibm.team.repository.db.jdbc.location расположения сервера DB2 и имя базы данных для жизненных циклов:
        1. Измените localhost:50000, указав расположение и порт базы данных DB2.
          Совет: В командное окно DB2 введите db2 get dbm cfg, затем найдите строку, содержащую SVCENAME, в которой указано имя или номер порта DB2. Если эта команда возвратит число, используйте его в качестве номера порта (вместо 50000 в предыдущем примере). Если команда возвратит нечисловое значение, определите, какой номер порта определен для этого имени порта. В Linux связи между именами и номерами портов указаны в файле /etc/services; в Windows - в файле C:\windows\system32\drivers\etc\services. Для получения дополнительной информации обратитесь к администратору базы данных или документации.
        2. Замените JAZZ именем базы данных для жизненных циклов.
        3. Замените db2admin именем пользователя базы данных DB2.
          Прим.: Пользователь DB2 должен иметь права доступа для создания таблиц, табличных пространств, а также для изменения параметров конфигурации базы данных. Пользователи DB2 создаются операционной системой.
      3. В свойстве com.ibm.team.repository.db.jdbc.password укажите пароль пользователя.
        Прим.: Не изменяйте текст password={password}, указанный в свойстве com.ibm.team.repository.db.jdbc.location.
      4. В файл teamserver.properties добавьте следующие свойства:
        Где:
        • unsecure_port - незащищенный порт для вашего сервера Tomcat (по умолчанию применяется 8080)
        • secure_port - номер защищенного порта для вашего сервера Tomcat (по умолчанию применяется 8443)
        • team_temp_dir - абсолютный путь к каталогу для хранения временных файлов
        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=защищенный_порт
    • Для Oracle:
      1. Найдите следующие строки:
        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
      2. Измените значение com.ibm.team.repository.db.jdbc.location для расположения сервера Oracle и имя базы данных для жизненных циклов:
        1. Замените jazzDBUser на имя пользователя базы данных Oracle (например, RAMSCHEMA).
        2. Замените @localhost:1521 на расположение и порт базы данных Oracle. Если расположение отличается от localhost, то перед ним необходимо добавить две прямые косые черты (//), например, @//oracleserver.example.com:1521.
        3. Замените ORCL на имя базы данных жизненного цикла; например, rtcdb.
      3. В свойстве com.ibm.team.repository.db.jdbc.password замените JazzDBpswd на пароль указанного выше пользователя Oracle.
        Прим.: Не изменяйте текст {пароль} в свойстве com.ibm.team.repository.db.jdbc.location.
      4. В файл teamserver.properties добавьте следующие свойства:
        Где:
        • unsecure_port - незащищенный порт для вашего сервера Tomcat (по умолчанию применяется 8080)
        • secure_port - номер защищенного порта для вашего сервера Tomcat (по умолчанию применяется 8443)
        • team_temp_dir - абсолютный путь к каталогу для хранения временных файлов
        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=защищенный_порт
      5. При работе с Oracle 11: В файл teamserver.properties добавьте следующее свойство:
        com.ibm.team.repository.db.override.versioncheck=true
    • Для Microsoft SQL Server:
      1. Найдите следующие строки:
        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
      2. Измените значение com.ibm.team.repository.db.jdbc.location для расположения SQL Server и имя базы данных для жизненных циклов:
        1. Замените @localhost:1433 на расположение и порт базы данных SQL Server.
        2. Замените jazz на имя базы данных жизненного цикла, например, RTCDB.
        3. Замените jazzDBUser на имя пользователя базы данных SQL Server.
      3. В свойстве com.ibm.team.repository.db.jdbc.password замените JazzDBpswd на пароль для указанного выше пользователя сервера SQL.
        Прим.: Не изменяйте текст {пароль} в свойстве com.ibm.team.repository.db.jdbc.location.
      4. В файл teamserver.properties добавьте следующие свойства:
        Где:
        • unsecure_port - незащищенный порт для вашего сервера Tomcat (по умолчанию применяется 8080)
        • secure_port - номер защищенного порта для вашего сервера Tomcat (по умолчанию применяется 8443)
        • team_temp_dir - абсолютный путь к каталогу для хранения временных файлов
        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=защищенный_порт
  23. Создайте таблицы для Rational Team Concert:
    1. С помощью командной строки перейдите в каталог rtc_install_dir/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
  24. Настройте права доступа пользователей встроенного Rational Team Concert.
    • Для защиты на основе файлов:
      1. Откройте файл установочный-каталог-tomcat-для-rtc\conf\tomcat-users.xml в текстовом редакторе.
      2. Между тегами <tomcat-users> вставьте следующий текст:
        <role rolename="JazzUsers"/>
        <role rolename="JazzAdmins"/>
        <role rolename="JazzDWAdmins"/>
        <role rolename="JazzGuests"/>
      3. Добавьте пользователя admin и присвойте ему роли admin, manager и JazzAdmins. Для добавления этого пользователя можно скопировать и вставить между тегами <tomcat-users> следующий текст:
        <user username="admin" password=""
        roles="admin,manager,JazzAdmins" />

        Если приложения устанавливаются на том же сервере Tomcat, добавьте роль JazzAdmins существующему администратору.

    • Для идентификации LDAP: Настройте сервер Tomcat на идентификацию LDAP, затем настройте четыре группы LDAP, имена которых должны совпадать с четырьмя ранее упомянутыми ролями. Кроме того, можно связать существующие группы LDAP с ролями сервера Jazz (см. инструкции в техническом комментарии TN0030: User Management in Tomcat. Выполните этапы 2-3 в разделе Настройка Rational Team Concert на Tomcat для использования LDAP.
  25. Запустите сервер Tomcat для Rational Team Concert.
    Для запуска сервера Tomcat запустите следующий файл:
    • Для Windows:установочный-каталог-tomcat-для-rtc\bin\startup.bat
    • Linux:AIX:Linux для zSeries:установочный-каталог-tomcat-для-rtc/bin/startup.sh
  26. Запустите административный веб-интерфейс Rational Team Concert в веб-браузере на https://имя-компьютера:порт-защиты/jazz/admin/. Обратите внимание на префикс https; требуется защищенное соединение.
  27. Введите ИД пользователя и пароль администратора Rational Team Concert. Если до этого никто не входил в Rational Team Concert, используйте ИД пользователя и пароль администратора сервера приложений.
  28. При работе с новой установкой Rational Team Concert: Настройка администратора для Rational Team Concert:
    1. Если будет выдано сообщение об ошибке, связанной с извлечением информации о состоянии сервера, то перезапустите сервер базы данных и сервер приложений и снова войдите в систему.
    2. В административном веб-интерфейсе Rational Team Concert выберите Управление пользователями. Ошибки, связанные с конфигурацией внешнего реестра, можно проигнорировать.
    3. Выберите Создать пользователя.
    4. Введите следующие сведения:
      1. Имя пользователя:: ИД пользователя администратора сервера приложений
      2. ИД пользователя:: ИД пользователя администратора сервера приложений
      3. Адрес электронной почты: Действительный адрес электронной почты администратора сервера приложений
    5. В разделе "Лицензия для доступа к клиенту" выберите Rational Team Concert - Разработчик, чтобы предоставить этому пользователю лицензию разработчика.
    6. Нажмите кнопку Сохранить.
    7. Выйдите из системы и снова войдите в административный веб-интерфейс как администратор сервера приложений.
  29. Импортируйте шаблона процесса управления жизненными циклами в Rational Team Concert:
    1. В Rational Team Concertадминистративном веб-интерфейсе выберите Управление шаблонами процессов. Если ссылка Управление шаблонами процессов не отображается, то выйдите и снова войдите в административный веб-интерфейс.
    2. Выберите Импортировать шаблон и выберите файл com.ibm.ram.lifecycle.zip, расположенный в папке расположение-извлечения-архива/DatabaseScripts/. Нажмите кнопку ОК. Откроется шаблон жизненного цикла RAM.
  30. Создайте область проекта в Rational Team Concert:
    1. В В Rational Team Concertадминистративном веб-интерфейсе нажмите Управление областями проекта. Если ссылка Управление областью проекта не отображается, то выйдите и снова войдите в административный веб-интерфейс.
    2. Выберите Создать область проекта.
    3. Введите следующие данные:
      • Имя проекта: Жизненный цикл RAM
      • Сводка: Область проекта для управления жизненными циклами Rational Asset Manager
      • Описание: Эта область применяется для управления жизненными циклами Rational Asset Manager
    4. Нажмите кнопку Сохранить.
  31. Укажите необходимые роли и участников для области проекта:
    1. На странице "Управление областями проекта" выберите область проекта Жизненный цикл RAM.
    2. В разделе Администраторы нажмите кнопку Добавить. Найдите и выберите администратора для создания. При работе с существующим приложением Rational Team Concert также можно выбрать другого пользователя в качестве администратора этой области проекта.
    3. В разделе Участники нажмите кнопку Добавить и найдите и выберите того же пользователя, который был выбран в качестве администратора области проекта.
    4. После добавления администратора щелкните на значке Роли процесса рядом с именем администратора.
    5. В окне Изменение ролей процесса в списке Доступные роли выберите Администрирование и нажмите кнопку Добавить.
    6. Нажмите кнопку Готово.
    7. Нажмите кнопку Сохранить.
  32. При обновлении из версии 7.1.1.1 или предыдущих: Перейдите к шагу 34.
  33. При обновлении из версии 7.2 или следующих обновите встроенный Rational Team Concert:
    1. Извлеките содержимое файла RTC-Server.zip с установочного носителя в новое расположение на жестком диске, которое в этих инструкциях называется новый-установочный-каталог-rtc).
    2. Скопируйте файл teamserver.properties из старого каталога установочный-каталог-rtc/jazz/server/conf/jazz/ в новый каталог новый-установочный-каталог-rtc/jazz/server/conf/jazz/.

      Текущее расположение установочный-каталог-rtc указано в файле запуска Tomcat. В файле запуска найдите строку, содержащую JAZZ_INSTALL_DIR=; значением переменной JAZZ_INSTALL_DIR является расположение текущих файлов Rational Team Concert.

    3. Найдите файл запуска Tomcat и откройте его в текстовом редакторе. В Windows это файл установочный-каталог-tomcat-для-rtc\bin\startup.bat. В Linux, AIX или Linux for zSeries это файл установочный-каталог-tomcat-для-rtc/bin/startup.sh.
    4. В файле запуска Tomcat найдите строку, содержащую JAZZ_INSTALL_DIR=. Измените значение следующим образом, где новый-установочный-каталог-rtc - это каталог из шага 33.a:
      • Для Windows: (замените пробелы в новый-установочный-каталог-rtc символами %20):
        set JAZZ_INSTALL_DIR=новый-установочный-каталог-rtc
      • Linux:AIX:Linux для zSeries::
        JAZZ_INSTALL_DIR=новый-установочный-каталог-rtc
    5. Запустите сервер Tomcat.
    6. В веб-браузере введите следующий URL: https://host:secure_port/jazz/admin?internal, где host - IP-адрес или имя сервера, secure_port - защищенный порт для сервера Tomcat.
    7. Войдите в систему как администратор сервера приложений.
    8. На боковой панели в разделе Внутренние инструменты выберите Сброс сервера.
    9. Выберите Запросить сброс сервера.
    10. Остановите и перезапустите сервер Tomcat. Встроенное приложение Rational Team Concert обновлено.
  34. Остановите сервер Tomcat для Rational Asset Manager.
  35. Удалите старые файлы .war веб-приложения Rational Asset Manager, установленные на Tomcat:
    1. Перейдите в каталог установочный-каталог-tomcat/webapps/.
    2. Запомните имена папок и файлов веб-приложений для Rational Asset Manager. В предыдущих версиях Rational Asset Manager предлагались следующие имена для этих папок (то есть пути к корневым каталогам приложений):
      • /com.ibm.ram.repository.web.tomcat_runtime
      • /com.ibm.ram.repository.web.ws.tomcat_runtime
      • /help/
      • /abdprocess/
    3. Удалите следующие файлы приложения:
      • com.ibm.ram.repository.web.tomcat_runtime.war
      • com.ibm.ram.repository.web.ws.tomcat_runtime.war
      • ramhelp.war
      • rmcabdgovernprocess.war
      Имена файлов могут отличаться от имен в списке в зависимости от способа установки приложений на вашем сервере.
    4. Удалите связанные папки приложений.
  36. Из каталога расположение-извлечения-архива/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
  37. Для изменения корневого пути приложений переименуйте соответствующие файлы 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 Приложение с документацией по процессам разработки на основе ресурсов.
  38. Очистите кэш для сервера Tomcat. Удалите каталог установочный-каталог-tomcat/work/.
  39. Перезапустите сервер Tomcat для Rational Asset Manager.
  40. Перенесите хранилище Rational Asset Manager в новую версию:
    1. В веб-браузере откройте веб-клиент Rational Asset Manager. При первом открытии веб-клиента после обновления появится появится сообщение о необходимости миграции хранилища.
    2. При необходимости войдите в систему с правами администратора хранилища.
      Прим.: Для сервера SQL: если для существующей базы данных Rational Asset Manager не задана последовательность, заканчивающаяся символами _BIN2 (например, Latin1_General_BIN2), откроется страница Требуется настройка вручную. Можно заново создать базу данных и задать параметр упорядочения с учетом регистра для правильной работы с Rational Asset Manager или принять вероятность непредвиденных конфликтов из-за неверного регистра символов.
    3. Нажмите кнопку Перенести. В больших хранилищах миграция может занять несколько минут; до завершения миграции может быть недоступна отдельная информация о хранилище.
    4. После завершения переноса нажмите Главная страница.
  41. После переноса хранилища перезапустите сервер приложений.
  42. При обновлении из версии 7.1.1.1 или предыдущих: Настройте параметра для соединения с Rational Team Concert из Rational Asset Manager:
    1. В веб-клиенте Rational Asset Manager выберите Администрирование.
    2. Выберите Настройка.
    3. В разделе Внутренний путь к Rational Team Concert введите следующую информацию:
      1. Путь: Защищенный URL настроенного сервера Rational Team Concert. Пример: иhttps://localhost:9443/ramjazz. Обратите внимание на соединение https и номер защищенного порта.
      2. Пользователь: Имя пользователя в Rational Team Concert, который является администратором области проекта "Жизненные циклы RAM".
      3. Пароль: Пароль пользователя, который является администратором области проекта "Жизненные циклы RAM".
      4. Тайм-аут: Период времени в секундах для возможности соединения Rational Asset Manager с Rational Team Concert. По умолчанию применяется 120.
  43. Для обновления требуется отправить запрос на получение нового ключа лицензии. Получите новую лицензию сервера и новые лицензии пользователей. Откройте веб-сайт Rational License Key Center: http://www-01.ibm.com/software/rational/support/licensing/ В случае возникновения ошибки, связанной с Rational License Server, измените параметры конфигурации лицензий:
    1. Выберите Администрирование
    2. На странице "Администрирование" нажмите Конфигурация.
    3. В разделе "Лицензия и версия" выберите тип лицензии сервера для данного хранилища: Стандартная версия или Корпоративная версия.
    4. Нажмите кнопку Сохранить внизу страницы.
    5. В случае повторного возникновения ошибки сервера лицензий нажмите Заново подключиться к серверу лицензий.
  44. Обновите приложение Eclipse Rational Asset Manager тем же способом, который применялся для установки приложения. Дополнительная информация об установке клиента Eclipse приведена в разделе Установка клиента Eclipse Rational Asset Manager.
    Прим.: Перед установкой последней версии клиента Eclipse Rational Asset Manager удалите модуль клиента Eclipse Rational Asset Manager.

    Если клиент Eclipse Rational Asset Manager V7.0.0.2 был установлен в существующем экземпляре Eclipse V3.3 с помощью Installation Manager, то удалять клиент также следует с помощью Installation Manager. Для удаления Rational Asset Manager из клиента Eclipse нельзя использовать Администратор конфигурации Eclipse.

    Если модули клиента Eclipse Rational Asset Manager были установлены с помощью Администратора обновления Eclipse, то перед установкой последней версии Rational Asset Manager удалите все компоненты с именем Rational Asset Manager с помощью Администратора конфигурации Eclipse. Для работы с Администратором конфигурации Eclipse выберите в меню Eclipse Справка > Обновления ПО > Управление конфигурацией.


Комментарии