Развертывание Rational Change версии 5.2 и выше на Apache Tomcat
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
- Установите Rational Change 5.2, выбрав сервер Jetty в диалоговом окне программы установки.
Компоненты Jetty встроены в программу установки. Поэтому установщик скопирует в файловую систему компоненты как Rational Change, так и Jetty.
- Запустите Rational Change, развернутый на Jetty, выполнив csctl.sh (для UNIX) или services (для Microsoft Windows).
- Перейдите на страницу входа администратора в систему:
http:// hostname : port / context/ admin (курсивом выделена изменяемая информация).
При установке используйте уникальные значения для port и context.
- При первом обращении к странице входа администратора в систему откроется страница настройки Rational Directory Server (RDS). Укажите информацию RDS-соединения.
Вы увидите страницу учетных данных RDS только в первый раз. После установки соединения вы будете перенаправлены на страницу входа администратора в систему. Детали соединения будут сохранены в файле в wsconfig/rds_config.xml.
- На странице входа администратора в систему введите учетные данные и войдите в систему.
- Извлеките пакет Rational Change 5.2.0.2 и установить его на вкладке Package Installer. (Чтобы установить пакет обновления, следуйте инструкциям файла README.txt.)
- Отключите сервер Jetty. Это позволит выбрать новые библиотеки в пакете обновления 5.2.0.2.
Редактирование конфигурационных файлов Rational Change для Tomcat 5.5
- Скопируйте каталог 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\.
- Добавьте новый тег
<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.
- Удалите приведенный ниже тег servlet-mapping из файла web.xml в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\:
<servlet-mapping> <servlet-name>action</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
- Измените значение port в файле web.xml. Например:
<context-param> <param-name>port</param-name> <param-value>8080</param-value> </context-param> Значением port в файле web.xml должен быть номер порта, прослушиваемого сервером Tomcat. 8080 - это значение порта по умолчанию в Tomcat.
- В файле ehcache.xml, который находится в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\classes\ измените значение атрибута path в теге
diskStore .
Новым значением должно быть TOMCAT_HOME \ webapps\ context \ WEB-INF\wsconfig\tmpdir.
- (Необязательно) Измените файл 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"/>
- Перезапустите сервер Tomcat.
Обращение к Rational Change 5.2 из Tomcat 5.5
- Обратитесь к приложению по этому URL-адресу:
http://hostname:port/context/admin
- Используйте в URL новое значение port. Новым значением port должен быть номер порта, прослушиваемого сервером Tomcat.
- Удалите экземпляр Rational Change, который был установлен с использованием Jetty.
Развертывание Rational Change 5.2 на Tomcat 6.0 с использованием IBM JRE 6.0
- Выберите любой экземпляр (только что созданный или существующий) Rational Change 5.2, установленный с использованием Jetty.
Это может быть любой экземпляр Rational Change 5.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\.
- Удалите приведенный ниже тег servlet-mapping из файла web.xml в каталоге TOMCAT_HOME\webapps\context\WEB-INF\:
<servlet-mapping> <servlet-name>action</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
- Измените значение port в файле web.xml. Например:
<context-param> <param-name>port</param-name> <param-value>8080</param-value> </context-param> Значением port в файле web.xml должен быть номер порта, прослушиваемого сервером Tomcat. 8080 - это значение порта по умолчанию в Tomcat.
- В файле ehcache.xml, который находится в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\classes\, измените значение атрибута path в теге
diskStore . Новым значением должно быть:
TOMCAT_HOME \webapps\ context \WEB-INF\wsconfig\tmpdir.
- (Необязательно) Измените файл 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"/>
- Перезапустите сервер Tomcat.
- Обратитесь к приложению по URL-адресу http:// hostname : port / context /admin.
Используйте в URL новое значение port. Новым значением port должен быть номер порта, прослушиваемого сервером Tomcat.
- Удалите экземпляр Rational Change, который был установлен с использованием Jetty.
Настройка Tomcat для использования JRE в комплекте с Rational Synergy
Windows
Сервисный режим
- Если Tomcat настроен на запуск в сервисном режиме, запустите диалоговое окно Apache Tomcat Properties, нажав tomcat5w.exe или tomcat6w.exe в каталоге TOMCAT_HOME \bin.
- Перейдите на вкладку Java, и укажите путь к файлу jvm.dll. Например, в поле Java Virtual Machine укажите:
SYNERGY_HOME \jre\bin\classic\jvm.dll.
Сценарий запуска
- Если Tomcat настроен на запуск посредством сценария запуска TOMCAT_HOME \bin\startup.bat, укажите значение JRE_HOME в сценарии TOMCAT_HOME \bin\setenv.bat. Если сценарий setenv.bat не существует, нужно создать новый в каталоге TOMCAT_HOME \bin\.
- Скопируйте эту строку в начало файла сценария:
set JRE_HOME="<SYNERGY_HOME>\jre"
UNIX
Сценарий запуска
- Укажите значение JRE_HOME в сценарии TOMCAT_HOME /bin/setenv.sh. Если сценарий setenv.sh не существует, нужно создать новый в каталоге TOMCAT_HOME /bin/.
- Скопируйте эту строку в начало файла сценария:
JRE_HOME="< SYNERGY_HOME >/jre"; export JRE_HOME
Установка на Tomcat параметров Java и настроек памяти
Windows
Сервисный режим
- Если Tomcat настроен на запуск в сервисном режиме, запустите диалоговое окно Apache Tomcat Properties, нажав tomcat5w.exe или tomcat6w.exe в каталоге TOMCAT_HOME \bin.
- Перейдите на вкладку Java, чтобы указать параметры Java и настройки памяти.
Сценарий запуска
- Если Tomcat настроен на запуск посредством сценария запуска TOMCAT_HOME \bin\startup.bat, укажите значение переменной CATALINA_OPTS , скопировав в начало файла сценария TOMCAT_HOME \bin\setenv.bat следующую строку:
set CATALINA_OPTS="-Xms128m -Xmx512m" Если сценарий setenv.bat не существует, нужно создать новый в каталоге TOMCAT_HOME \bin\.
UNIX
Сценарий запуска
- Укажите значение переменной CATALINA_OPTS в сценарии TOMCAT_HOME /bin/setenv.sh. Если сценарий setenv.sh не существует, нужно создать новый в каталоге TOMCAT_HOME /bin/.
- Скопируйте эту строку в начало файла сценария:
CATALINA_OPTS="-Xms128m -Xmx512m"; export CATALINA_OPTS
|