Если продукт и справка развертываются на разных серверах, то в
качестве сервера приложений для развертывания справочной системы
можно использовать Apache Tomcat.
Прежде чем начать
- Сервер, на котором настраиваются справочные материалы, должен
быть доступен пользователям, которые работают за брандмауэром.
- Файл help.war доступен на сервере.
- Если продукт, для которого настраивается справка, установлен на
сервере, то файл help.war уже должен быть
установлен.
- Найдите файл help.war в каталоге
установочный-каталог/help.
- Найдите версию файла с аббревиатурой продукта, например
clmhelp.war или ramhelp.war
- Выполните поиск файла *help.war в установочном каталоге.
- Если продукт установлен не на сервере или не содержит файл
help.war, загрузите файл help.war по следующему
адресу: http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war.
- Установите и настройте Apache Tomcat.
- Установите среду выполнения Java™
(JRE) или комплект разработчика
Java. Для установки можно выбрать один из
наборов
разработчиков IBM®.
- Задайте переменную среды с путем к JRE или Java Developer Kit:
- В случае установки JRE создайте переменную среды
JRE_HOME и укажите в ней путь к установочному
каталогу JRE, например:
- Windows: C:\Program Files\Java70\jre
- Linux: /usr/local/java70/jre
- В случае установки Java Developer Kit создайте переменную среды
JAVA_HOME и укажите в ней путь к установочному
каталогу Java Developer Kit, например:
- Windows: C:\Program Files\Java70
- Linux: /usr/local/java70/
- Загрузите приложение сервера Apache Tomcat.
- Распакуйте файл архива Apache Tomcat.
- Переместите распакованную папку в постоянное расположение. Это расположение указывается как
CATALINA_HOME, например:
C:\apache-tomcat-версия
- Создайте переменную среды CATALINA_HOME укажите
в ней каталог CATALINA_HOME например:
C:\apache-tomcat-версия
- В файле CATALINA_HOME/conf/tomcat-users.xml
добавьте администратора сервера и сохраните изменения; пример:
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- Перейдите в каталог
CATALINA_HOME/bin и запустите
сервер Apache Tomcat с помощью файла startup. Имя файла различается в зависимости от операционной системы:
- Windows: startup.bat
- Linux: startup.sh
Apache Tomcat запущен после выдачи в командной строке сообщения
Сервер запущен через число
мс.
Процедура
Для развертывания файла help.war выполните
следующие действия:
- В браузере введите следующий URL, чтобы открыть приложение
Tomcat Manager:
http://localhost:8080/manager/html
- Введите имя и пароль пользователя.
- В разделе выберите
Выбрать файл.
- Выберите файл help.war.
- Выберите Развернуть. Файл help.war развертывается,
запускается и отображается в разделе Приложения. Кроме того, файл help.war копируется в каталог
CATALINA_HOME/webapps.
- Убедитесь, что справочная система доступна. Для этого добавьте
строку справка/index.jsp в
конец URL сервера приложений, где справка - это
имя файла .war. Пример: http://localhost:8080/help/index.jsp.
Прим.: - В справочной системе может отсутствовать содержимое. Далее может потребоваться установить документацию в справочной системе.
- Если справочная система и продукт развернуты на одном сервере
Apache Tomcat, то справочная система запускается и останавливается
вместе с продуктом.
Дальнейшие действия
- Установите справочные материалы на сервере с
помощью одной из следующих задач:
- Предоставьте URL справки участникам коллектива в организации. Они могут ввести URL в
конфигурации справки клиента Rational DOORS и настроить доступ к
справке на внутреннем сервере в соответствии с инструкциями из
раздела Изменение выбранного варианта справочных материалов. Указанный URL не должен содержать строку
localhost в качестве имени сервера; например,
http://server.ibm.com:8080/help/index.jsp