Если продукт и справка развертываются на разных серверах, то в качестве сервера
приложений для развертывания справочной системы можно использовать 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-версия
- Создайте переменную среды 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 справочной системы Information Center
пользователям организации. Убедитесь, что указан сервер,
отличный от localhost.
Пример: http://server.ibm.com:8080/help/index.jsp