Развертывание Rational Change версии 5.2 и выше на Apache Tomcat

Источник: IBM

IBM Rational Change 5.2 включает в себя Web-сервер Jetty 5.1.14. Его можно развернуть на серверах IBM WebSphere Application Server и WebSphere Application Server Community Edition. Однако в программе установки отсутствует опция развертывания Rational Change на сервере Apache Tomcat. В данной статье объясняется, как развернуть Rational Change 5.2 на сервере Tomcat 5.5 с использованием IBM Java Runtime Environment версии 6.0 (JRE 6).

Развертывание Rational Change 5.2 на Tomcat 5.5 с использованием IBM JRE 6.0

Предварительная установка пакета Rational Change service pack 5.2.0.2

  1. Установите Rational Change 5.2, выбрав сервер Jetty в диалоговом окне программы установки.

    Компоненты Jetty встроены в программу установки. Поэтому установщик скопирует в файловую систему компоненты как Rational Change, так и Jetty.

  2. Запустите Rational Change, развернутый на Jetty, выполнив csctl.sh (для UNIX) или services (для Microsoft Windows).
  3. Перейдите на страницу входа администратора в систему:
    http:// hostname : port / context/ admin (курсивом выделена изменяемая информация).

    При установке используйте уникальные значения для port и context.

  4. При первом обращении к странице входа администратора в систему откроется страница настройки Rational Directory Server (RDS). Укажите информацию RDS-соединения.

    Вы увидите страницу учетных данных RDS только в первый раз. После установки соединения вы будете перенаправлены на страницу входа администратора в систему. Детали соединения будут сохранены в файле в wsconfig/rds_config.xml.

  5. На странице входа администратора в систему введите учетные данные и войдите в систему.
  6. Извлеките пакет Rational Change 5.2.0.2 и установить его на вкладке Package Installer. (Чтобы установить пакет обновления, следуйте инструкциям файла README.txt.)
  7. Отключите сервер Jetty. Это позволит выбрать новые библиотеки в пакете обновления 5.2.0.2.

Редактирование конфигурационных файлов Rational Change для Tomcat 5.5

  1. Скопируйте каталог Rational Change из каталога CHANGE_APP_HOME \jetty\webapps\ в каталог TOMCAT_HOME \webapps\.

    Совет.
    Во время копирования не обращайте внимания на install.log.

    Имя папки Rational Change в webapps то же, что и имя context, указанное в ходе установки. Как упоминалось ранее, установка будет содержать компоненты и Jetty, и Rational Change. В область установки Tomcat нужно скопировать только компоненты Rational Change. Например, если при установке Rational Change на Jetty вы создали каталог context с именем foo в C:\Program Files\Change52, скопируйте каталог foo из каталога
    C:\Program Files\Change52\jetty\webapps\

    в каталог

    TOMCAT_HOME \webapps\.

  2. Добавьте новый тег <context-param>, с именем и значением параметра, в файл web.xml, находящийся в TOMCAT_HOME \webapps\ context \WEB-INF\.

    Имя каталога context должна предварять косая черта (/). Например:

    <context-param>
    <param-name>context</param-name>
    <param-value>/foo</param-value>
    </context-param>


    В спецификации сервлетов, реализованной в Tomcat 5.5, отсутствует интерфейс сервлета для извлечения context. Значение context передается в Rational Change явно посредством записи в файле web.xml.

  3. Удалите приведенный ниже тег servlet-mapping из файла web.xml в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\:
    <servlet-mapping>
    <servlet-name>action</servlet-name>
    <url-pattern>/</url-pattern>
    </servlet-mapping>

  4. Измените значение port в файле web.xml. Например:
    <context-param>
    <param-name>port</param-name>
    <param-value>8080</param-value>
    </context-param>

    Значением port в файле web.xml должен быть номер порта, прослушиваемого сервером Tomcat. 8080 - это значение порта по умолчанию в Tomcat.
  5. В файле ehcache.xml, который находится в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\classes\ измените значение атрибута path в теге diskStore.

    Новым значением должно быть TOMCAT_HOME \ webapps\ context \ WEB-INF\wsconfig\tmpdir.

  6. (Необязательно) Измените файл TOMCAT_HOME\conf\server.xml для включения запроса на вход в систему. Раскомментируйте тег Valve, который использует класс AccessLogValve, и отредактируйте атрибуты при необходимости.

    <!--
    <Valve className="org.apache.catalina.valves.AccessLogValve"
    directory="logs" prefix="localhost_access_log." suffix=".txt"
    pattern="common" resolveHosts="false"/>
    -->

    Примечание.
    Этот шаг является необязательным. Чтобы узнать больше об AccessLogValve, следуйте инструкциям в разделе Valve Component документации Apache Tomcat Configuration Reference на Web-сайте Apache.org.

    Вот пример элемента Valve, модифицированного для приложения Rational Change:

    <Valve className="org.apache.catalina.valves.AccessLogValve"
    directory="logs"
    fileDateFormat="yyyy-MM-dd"
    prefix="access_log."
    suffix=".log"
    pattern="%h %t "%m %U" "%{Referer}i"
    "%{User-Agent}i" %s %b %D %{CSInfoCookie}c"
    resolveHosts="false"/>

  7. Перезапустите сервер Tomcat.

Обращение к Rational Change 5.2 из Tomcat 5.5

  1. Обратитесь к приложению по этому URL-адресу:
    http://hostname:port/context/admin
  2. Используйте в URL новое значение port. Новым значением port должен быть номер порта, прослушиваемого сервером Tomcat.
  3. Удалите экземпляр Rational Change, который был установлен с использованием Jetty.

Развертывание Rational Change 5.2 на Tomcat 6.0 с использованием IBM JRE 6.0

  1. Выберите любой экземпляр (только что созданный или существующий) Rational Change 5.2, установленный с использованием Jetty.

    Это может быть любой экземпляр Rational Change 5.2 (с установленными пакетами обновления или без них).

  2. Скопируйте каталог Rational Change из каталога
    < CHANGE_APP_HOME >\jetty\webapps\
    в каталог

    TOMCAT_HOME \webapps\.

    Совет.
    Во время копирования не обращайте внимания на install.log

    Имя папки Rational Change в webapps то же, что и имя context , указанное в ходе установки. Как упоминалось ранее, установка будет содержать компоненты и Jetty, и Rational Change, но в область установки Tomcat нужно скопировать только компоненты Rational Change. Например, если при установке Rational Change на Jetty вы создали каталог context с именем foo в C:\Program Files\Change52, скопируйте каталог foo из каталога

    C:\Program Files\Change52\jetty\webapps\
    в каталог

    TOMCAT_HOME \webapps\.

  3. Удалите приведенный ниже тег servlet-mapping из файла web.xml в каталоге TOMCAT_HOME\webapps\context\WEB-INF\:
    <servlet-mapping>
    <servlet-name>action</servlet-name>
    <url-pattern>/</url-pattern>
    </servlet-mapping>

  4. Измените значение port в файле web.xml. Например:
    <context-param>
    <param-name>port</param-name>
    <param-value>8080</param-value>
    </context-param>

    Значением port в файле web.xml должен быть номер порта, прослушиваемого сервером Tomcat. 8080 - это значение порта по умолчанию в Tomcat.
  5. В файле ehcache.xml, который находится в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\classes\, измените значение атрибута path в теге diskStore. Новым значением должно быть:

    TOMCAT_HOME \webapps\ context \WEB-INF\wsconfig\tmpdir.

  6. (Необязательно) Измените файл TOMCAT_HOME \conf\server.xml для включения запроса на вход в систему. Раскомментируйте тег Valve, который использует класс AccessLogValve, и отредактируйте атрибуты при необходимости. Пример:
    <!-
    <Valve className="org.apache.catalina.valves.AccessLogValve"
    directory="logs" prefix="localhost_access_log." suffix=".txt"
    pattern="common" resolveHosts="false"/>
    -->

    Примечание.
    Этот шаг является необязательным. Чтобы узнать больше об AccessLogValve, посетите http://tomcat.apache.org/tomcat-6.0-doc/config/valve.html. Вот пример элемента Valve, модифицированного для Rational Change:
    <Valve className="org.apache.catalina.valves.AccessLogValve"
    directory="logs"
    fileDateFormat="yyyy-MM-dd"
    prefix="access_log."
    suffix=".log"
    pattern="%h %t "%m %U" "%{Referer}i"
    "%{User-Agent}i" %s %b %D %{CSInfoCookie}c"
    resolveHosts="false"/>

  7. Перезапустите сервер Tomcat.
  8. Обратитесь к приложению по URL-адресу http:// hostname : port / context /admin.

    Используйте в URL новое значение port. Новым значением port должен быть номер порта, прослушиваемого сервером Tomcat.

  9. Удалите экземпляр Rational Change, который был установлен с использованием Jetty.

Настройка Tomcat для использования JRE в комплекте с Rational Synergy

Windows

Сервисный режим

  1. Если Tomcat настроен на запуск в сервисном режиме, запустите диалоговое окно Apache Tomcat Properties, нажав tomcat5w.exe или tomcat6w.exe в каталоге TOMCAT_HOME \bin.
  2. Перейдите на вкладку Java, и укажите путь к файлу jvm.dll. Например, в поле Java Virtual Machine укажите:

    SYNERGY_HOME \jre\bin\classic\jvm.dll.

Сценарий запуска

  1. Если Tomcat настроен на запуск посредством сценария запуска TOMCAT_HOME \bin\startup.bat, укажите значение JRE_HOME в сценарии TOMCAT_HOME \bin\setenv.bat. Если сценарий setenv.bat не существует, нужно создать новый в каталоге TOMCAT_HOME \bin\.
  2. Скопируйте эту строку в начало файла сценария:
    set JRE_HOME="<SYNERGY_HOME>\jre"

UNIX

Сценарий запуска

  1. Укажите значение JRE_HOME в сценарии TOMCAT_HOME /bin/setenv.sh. Если сценарий setenv.sh не существует, нужно создать новый в каталоге TOMCAT_HOME /bin/.
  2. Скопируйте эту строку в начало файла сценария:
    JRE_HOME="< SYNERGY_HOME >/jre"; export JRE_HOME

Установка на Tomcat параметров Java и настроек памяти

Windows

Сервисный режим

  1. Если Tomcat настроен на запуск в сервисном режиме, запустите диалоговое окно Apache Tomcat Properties, нажав tomcat5w.exe или tomcat6w.exe в каталоге TOMCAT_HOME \bin.
  2. Перейдите на вкладку Java, чтобы указать параметры Java и настройки памяти.

Сценарий запуска

  1. Если Tomcat настроен на запуск посредством сценария запуска TOMCAT_HOME \bin\startup.bat, укажите значение переменной CATALINA_OPTS , скопировав в начало файла сценария TOMCAT_HOME \bin\setenv.bat следующую строку:
    set CATALINA_OPTS="-Xms128m -Xmx512m"

    Если сценарий setenv.bat не существует, нужно создать новый в каталоге TOMCAT_HOME \bin\.

UNIX

Сценарий запуска

  1. Укажите значение переменной CATALINA_OPTS в сценарии TOMCAT_HOME /bin/setenv.sh. Если сценарий setenv.sh не существует, нужно создать новый в каталоге TOMCAT_HOME /bin/.
  2. Скопируйте эту строку в начало файла сценария:
    CATALINA_OPTS="-Xms128m -Xmx512m"; export CATALINA_OPTS

Страница сайта http://www.interface.ru
Оригинал находится по адресу http://www.interface.ru/home.asp?artId=32525