Jeśli produkt nie został zainstalowany na serwerze, na
którym jest wdrażana pomoc, można zastosować serwer Apache Tomcat jako prosty
serwer aplikacji i wdrożyć na nim system pomocy.
Zanim rozpoczniesz
- Serwer, na którym jest konfigurowana treść pomocy, musi być
dostępny dla użytkowników za firewallem.
- Sprawdź, czy na serwerze jest dostępny plik
help.war.
- Jeśli produkt, dla którego konfigurowana jest pomoc, został zainstalowany
na serwerze, plik help.war może już być zainstalowany.
- Sprawdź, czy plik help.war znajduje się w katalogu
katalog_instalacyjny/help.
- Znajdź wersję pliku, która zawiera skrót nazwy produktu, na przykład
clmhelp.war lub ramhelp.war.
- Poszukaj w katalogu instalacyjnym plików *help.war.
- Jeśli produkt nie został zainstalowany na serwerze lub nie zawiera pliku
help.war, pobierz wersję pliku
help.war.
- Zainstaluj i skonfiguruj serwer Apache Tomcat.
- Zainstaluj środowisko Java™
Runtime Environment (JRE) lub pakiet Java
Development Kit (JDK). Zainstalować możesz jeden z pakietów
IBM®
Developer Kit.
- Ustaw w zmiennej środowiskowej ścieżkę do środowiska JRE lub pakietu JDK:
- Jeśli zainstalowano środowisko JRE, utwórz zmienną środowiskową
JRE_HOME i ustaw wartość na ścieżkę do katalogu, w którym
jest zainstalowane środowisko JRE. Przykłady:
- Windows: C:\Program
Files\Java70\jre
- Linux:
/usr/local/java70/jre
- Jeśli zainstalowano pakiet JDK, utwórz zmienną środowiskową
JAVA_HOME i ustaw wartość na ścieżkę do katalogu, w którym jest
zainstalowany pakiet JDK. Przykłady:
- Windows: C:\Program
Files\Java70
- Linux:
/usr/local/java70/
- Pobierz
aplikację
serwera Apache Tomcat.
- Rozpakuj archiwum serwera Apache Tomcat.
- Przenieś wyodrębniony folder do stałego położenia. To położenie jest
określane jako
KATALOG_GŁÓWNY_CATALINA. Na przykład:
C:\apache-tomcat-wersja.
- Utwórz zmienną środowiskową CATALINA_HOME i ustaw wartość
na katalog KATALOG_GŁÓWNY_CATALINA. Na przykład:
C:\apache-tomcat-wersja.
- Dodaj użytkownika administratora serwera do pliku
KATALOG_GŁÓWNY_CATALINA/conf/tomcat-users.xml i
zapisz zmiany. Na przykład:
<role rolename="manager-gui"/>
<user username="admin"
password="admin" roles="manager-gui"/>
- Otwórz katalog KATALOG_GŁÓWNY_CATALINA/bin i
uruchom plik startup, aby uruchomić serwer Apache Tomcat.
- Windows: startup.bat
- Linux:
startup.sh
Serwer Apache Tomcat działa, gdy w
narzędziu wiersza komend zostanie wyświetlony komunikat informacyjny
Server Startup in liczba ms
(Uruchamianie serwera trwało liczba ms).
Procedura
Aby wdrożyć plik help.war:
- W przeglądarce wpisz następujący adres URL, aby otworzyć aplikację
menedżera Tomcat: http://localhost:8080/manager/html.
- Wpisz nazwę i hasło użytkownika.
- W sekcji (Wdróż - Plik WAR do wdrożenia) kliknij opcję
Choose file (Wybierz plik).
- Wybierz plik help.war.
- Kliknij przycisk Deploy (Wdróż). Plik help.war zostanie wdrożony, uruchomiony i
wyświetlony w sekcji Applications (Aplikacje). Plik
help.war zostanie również skopiowany do katalogu
KATALOG_GŁÓWNY_CATALINA/webapps.
- Sprawdź, czy można uzyskać dostęp do systemu pomocy, dodając
łańcuch pomoc/index.jsp na końcu adresu
URL aplikacji serwera, gdzie pomoc jest nazwą pliku
.war. Na przykład:
http://localhost:8080/help/index.jsp.
Uwaga: - System pomocy może nie zawierać jeszcze treści
pomocy. Konieczne może być następnie zainstalowanie dokumentacji w systemie
pomocy.
- Jeśli system pomocy jest wdrożony na tym samym serwerze Apache Tomcat co
produkt, system pomocy jest uruchamiany i zatrzymywany, gdy jest uruchamiana i
zatrzymywana aplikacja produktu.
Co dalej
- Zainstaluj dokumentację na serwerze:
- Podaj użytkownikom serwer, port i ścieżkę do systemu pomocy w
celu wprowadzenia tych danych na stronie Konfiguracja systemu
pomocy w programie
IBM Installation Manager.
Upewnij się, że podaną nazwą serwera nie jest localhost.
Na przykład dla adresu
http://serwer.ibm.com:8080/pomoc/index.jsp
wartości są następujące:
- Serwer: serwer.ibm.com
- Port: 8080
- Ścieżka:
/pomoc