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 должна предварять косая черта (/). Например:
В спецификации сервлетов, реализованной в Tomcat 5.5, отсутствует интерфейс сервлета для извлечения context. Значение context передается в Rational Change явно посредством записи в файле web.xml.
Удалите приведенный ниже тег servlet-mapping из файла web.xml в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\:
Значением 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, и отредактируйте атрибуты при необходимости.
Примечание. Этот шаг является необязательным. Чтобы узнать больше об AccessLogValve, следуйте инструкциям в разделе Valve Component документации Apache Tomcat Configuration Reference на Web-сайте Apache.org
Вот пример элемента Valve, модифицированного для приложения Rational Change:
Обратитесь к приложению по этому 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\:
Значением port в файле web.xml должен быть номер порта, прослушиваемого сервером Tomcat. 8080 - это значение порта по умолчанию в Tomcat.
В файле ehcache.xml, который находится в каталоге TOMCAT_HOME \webapps\ context \WEB-INF\classes\, измените значение атрибута path в теге diskStore. Новым значением должно быть:
(Необязательно) Измените файл TOMCAT_HOME \conf\server.xml для включения запроса на вход в систему. Раскомментируйте тег Valve, который использует класс AccessLogValve, и отредактируйте атрибуты при необходимости. Пример:
Примечание. Этот шаг является необязательным. Чтобы узнать больше об AccessLogValve, посетите http://tomcat.apache.org/tomcat-6.0-doc/config/valve.html. Вот пример элемента Valve, модифицированного для Rational Change:
Обратитесь к приложению по 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/.