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