Если продукт и справка развертываются на разных
серверах, то в качестве простого решения сервера приложений для
развертывания справочной
системы можно использовать Apache Tomcat.
Прежде чем начать
- Сервер, на котором настраиваются справочные материалы
должен быть доступен пользователям, которые работают
за брандмауэром.
- Убедитесь, что файл help.war доступен на сервере.
- Если продукт, для которого настраивается справка, установлен на
сервере, то файл help.war уже должен быть
установлен.
- Найдите файл help.war в каталоге
установочный-каталог/help.
- Найдите версию файла с аббревиатурой продукта, например
clmhelp.war или ramhelp.war
- Выполните поиск файла *help.war в установочном каталоге.
- Если продукт установлен не на сервере или не
содержит файл help.war,
загрузите версию файла help.war.
- Установите и настройте Apache Tomcat.
- Установите среду
выполнения Java™ (JRE) или
Java Development Kit (JDK). Для установки можно выбрать один из
наборов разработчиков IBM®.
- Задайте переменную среды с путем к JRE или JDK:
- В случае установки JRE создайте переменную среды
JRE_HOME и укажите в ней путь к установочному
каталогу JRE. Примеры:
- Windows: C:\Program Files\Java70\jre
- Linux: /usr/local/java70/jre
- В случае установки JDK создайте переменную среды
JAVA_HOME и укажите в ней путь к
установочному каталогу JDK. Примеры:
- Windows: C:\Program Files\Java70
- Linux: /usr/local/java70/
- Загрузите приложение сервера Apache Tomcat.
- Распакуйте архив Apache Tomcat.
- Переместите распакованную папку в постоянное расположение: CATALINA_HOME.
Пример: C:\apache-tomcat-version
- Создайте переменную среды CATALINA_HOME и
укажите в ней каталог CATALINA_HOME. Пример: C:\apache-tomcat-version
- Добавьте администратора сервера в файл
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 Application: 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, то справочная система запускается и останавливается
вместе с продуктом.
Дальнейшие действия
- Установите документацию на сервер:
- Предоставьте пользователям имя сервера, номер порта и путь
к справочной системе для ввода на странице Конфигурация
справочной системы в IBM Installation Manager.
Убедитесь, что указан сервер, отличный от
localhost.
Пример:
значения для
http://server.ibm.com:8080/help/index.jsp:
- Сервер:
server.ibm.com
- Порт:
8080
- Путь:
/help