Настройка сервера Tomcat для работы с Rational Engineering Lifecycle Manager

Развертывание и запуск Jazz Team Server начинается с выбора сервера приложений, на котором размещены Jazz Team Server и его приложения.

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

Развертывание и запуск Jazz Team Server начинается с выбора сервера приложений, на котором размещены Jazz Team Server и его приложения.

Если планируется в качестве управляющей среды Jazz Team Server использовать встроенный сервер приложений Apache Tomcat, щелкните на ссылке Развертывание и запуск сервера Apache Tomcat.

Если планируется в качестве управляющей среды использовать IBM® WebSphere Application Service, щелкните на ссылке Развертывание и запуск WebSphere Application Server.

Устранение ошибок, возникающих при запуске сервера RM в консольном режиме в системе Linux. Приложение RM включает преобразователь, предоставляющий визуальное представление графических артефактов, таких как диаграммы бизнес-процессов, диаграммы прецедентов, компоненты, эскизы, раскадровки и последовательности экранов. Преобразователь работает на сервере. При запуске сервера RM в консольном режиме в системе Linux происходит сбой операции без вывода сообщений и ошибка CRRRW8010E. В этом случае необходимо завершить процесс Java™ и выполнить корректирующую операцию для успешного запуска сервера. Дополнительная информация приведена на следующей странице вики: https://jazz.net/wiki/bin/view/Main/RRCConverterTroubleshooting.

Запуск Apache Tomcat в качестве службы Windows (64-разр.)

Для запуска Jazz Team Server в качестве службы в 64-разрядной системе необходимо настроить 64-разрядную версию Tomcat, поставляемую с Jazz Team Server.

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

Совет: Во избежание проблем не используйте пробелы в путях к файлам. Например, для каталога Program Files можно использовать PROGRA~1.
Если в качестве базы данных для хранилища Jazz используется Derby, измените файл teamserver.properties для каждого приложения и укажите расположения DB в виде абсолютных путей. Замените переменную имя приложения на соответствующее имя каталога приложения, например jts, ccm, qm. В примерах ниже JazzInstallDir указывает на расположение, в котором установлен Jazz Team Server.
  1. Откройте файл JazzInstallDir\server\conf\имя приложения\teamserver.properties file.
  2. Замените запись com.ibm.team.repository.db.jdbc.location=conf/имя приложения/derby/repositoryDB на com.ibm.team.repository.db.jdbc.location=C:/JazzInstallDir/server/conf/имя приложения/derby/repositoryDB. Обратите внимание на прямую косую черту (/) в пути.
  3. Замените также запись com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/conf/jts/derby/warehouseDB на com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/C:/JazzInstallDir/server/conf/jts/derby/warehouseDB для приложений и запись com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB на com.ibm.team.datawarehouse.db.jdbc.location=C:/JazzInstallDir/server/conf/jts/derby/warehouseDB для JTS. Обратите внимание на прямую косую черту (/) в пути.
Кроме изменения файла teamserver.properties необходимо также изменить файл log4j.properties для указания абсолютного пути к файлу протокола. Замените переменную имя переменной на соответствующие имена каталогов приложений, например jts, ccm, qm, rm, admin. Замените переменные app name.log и app name-etl.log на имя соответствующего файла протокола приложения, например jts.log, ccm.log, qm.log, rm.log, admin.log and jts-etl.log, ccm-etl.log, qm-etl.log (*-etl.log для admin и rm отсутствует):
  1. Откройте файла JazzInstallDir\server\conf\имя приложения\log4j.properties.
  2. Замените запись log4j.appender.file.File=logs/appName.log на log4j.appender.file.File=C:/JazzInstallDir/server/logs/appName.log. Обратите внимание на прямую косую черту (/) в пути.
  3. Замените запись log4j.appender.etl.File=logs/appName-etl.log на log4j.appender.etl.File=C:/JazzInstallDir/server/logs/appName-etl.log. Обратите внимание на прямую косую черту (/) в пути.
Прим.: Если этот этап будет пропущен, и путь для файлов протоколов не будет указан, то файлы протоколов будут записываться в каталог Windows по умолчанию. Например, в Windows 7 каталог протоколов - это C:\Windows\System32\LogFiles.

Убедитесь, что служба не установлена. Если служба установлена, удалите ее и перезапустите систему. После этого установите новую службу.

Процедура

  1. Задайте переменную CATALINA_HOME, выполнив следующие действия:
    1. В панели управления Windows откройте окно Свойства системы.
    2. Откройте вкладку Дополнительно затем выберите Переменные среды.
    3. В разделе Системные переменные выберите Создать.
    4. В поле Имя переменной введите CATALINA_HOME, а в Значение переменной введите C:\JazzInstallDir\server\tomcat.
  2. Для вступления изменений в силу перезапустите систему.
  3. Откройте командную строку и установите новую службу 64-разрядную службу путем перехода в каталог JazzInstallDir\server\tomcat\bin и выполнения следующей команды:

    service.bat install tomcat7.

    Прим.: В операционных системах Windows с контролем учетных записей (UAC), таких как Windows 7, командную строку необходимо запускать от имени администратора.
  4. Для настройки службы выполните программу JazzInstallDir\server\tomcat\bin\tomcat7w.exe.
  5. Откройте вкладку Java и выключите переключатель Использовать значение по умолчанию.
  6. Добавьте в Виртуальная машина Java следующий путь. Можно также щелкнуть на значке многоточия для поиска файла jvm.dll.
    JazzInstallDir\server\jre\bin\j9vm\jvm.dll
  7. В конец текстового поля Опции Java добавьте следующие строки
    Прим.: Путь к -DJAZZ_HOME и -Dlog4j.configuration должны вводиться в виде URL. Обратите внимание на три прямых косых черты (///) после "file:" и прямые косые черты в пути. Путь к tempDir должен быть абсолютным путем.
    -DJAZZ_HOME=file:///C:/JazzInstallDir/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=C:\JazzInstallDir\server\tomcat\temp
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/JazzInstallDir/server/conf/startup_log4j.properties
    -Xmx4g
    -Xms4g
    -Xgcpolicy:gencon
    -Xcompressedrefs 
    Если Jazz Team Server установлен на платформе Windows, но используется сервер базы данных DB2 для z/OS, добавьте следующую строку вместо пути к расположению драйвера.
    Прим.: Путь к драйверу должен быть путем к файлам, обратите внимание на прямые косые черты.
    -DDB2Z_JDBC=D:/JazzInstallDir/server/db2z
    При использовании базы данных Oracle добавьте вместо пути к расположению драйвера следующую строку.
    Прим.: Путь к драйверу должен быть путем к файлам.
    -DORACLE_JDBC_DRIVER_FILE=C:\OJDBCLocation\ojdbc6.jar
    При использовании базы данных SQL добавьте вместо пути к расположению драйвера следующую строку.
    Прим.: Путь к драйверу должен быть путем к файлам.
    -DSQLSERVER_JDBC_DRIVER_FILE=C:\SQLJDBCLocation\sqljdbc4.jar
  8. В Максимальное значение пула памяти укажите размер пула 4000.
  9. На вкладках Запуск и Выключение убедитесь, что в качестве значения Режим выбран jvm.
  10. Откройте вкладку Общие и измените Тип запуска на Автоматический для автоматического запуска службы при запуске Windows.
  11. После запуска службы убедитесь, что сервер запущен. Для этого войдите на него с помощью браузера.

Комментарии