Pokud jste nenainstalovali produkt na serveru, na kterém implementujete nápovědu, můžete použít produkt Apache Tomcat jako ukázkové řešení aplikačního serveru, na kterém máte implementovat váš systém nápovědy.
Než začnete
- Server, na kterém konfigurujete obsah nápovědy, musí být k dispozici uživatelům za bránou firewall.
- Ověřte, zda máte soubor help.war k dispozici na serveru.
- Pokud jste nainstalovali produkt, pro který konfigurujete nápovědu na serveru, soubor help.war může být již nainstalován.
- Vyhledejte v adresáři installation_directory/help soubor help.war.
- Vyhledejte verzi souboru, která zahrnuje zkratky produktu, jako např. clmhelp.war nebo ramhelp.war
- Vyhledejte váš instalační adresář pro soubor *help.war.
- Pokud jste nenainstalovali produkt na serveru, nebo váš produkt
nezahrnuje soubor help.war, stáhněte verzi
souboru help.war.
- Nainstalujte a nakonfigurujte produkt Apache Tomcat.
- Nainstalujte prostředí Java™ Runtime
Environment (JRE) nebo sadu Java Development
Kit (JDK). K instalaci můžete zvolit jeden z následujících produktů IBM® developer kit.
- Nastavte proměnnou prostředí s cestou k JRE nebo JDK:
- Pokud jste nainstalovali prostředí JRE, vytvořte proměnnou prostředí JRE_HOME a
nastavte hodnotu k cestě adresáře, kde jste nainstalovali prostředí JRE. Příklady:
- Windows: C:\Program
Files\Java70\jre
- Linux: /usr/local/java70/jre
- Pokud jste nainstalovali prostředí JDK, vytvořte proměnnou prostředí JAVA_HOME a
nastavte hodnotu k cestě adresáře, kde jste nainstalovali prostředí JDK. Příklady:
- Windows: C:\Program
Files\Java70
- Linux: /usr/local/java70/
- Stáhněte aplikační server Apache Tomcat.
- Extrahujte archiv produktu Apache Tomcat.
- Přesuňte extrahovanou složku do trvalého umístění. Toto umístění
se označuje jako CATALINA_HOME.
Příklad: C:\apache-tomcat-version
- Vytvořte proměnnou prostředí CATALINA_HOME a
nastavte hodnotu do adresáře CATALINA_HOME. Příklad: C:\apache-tomcat-version
- Přidejte uživatele administrátora serveru do souboru CATALINA_HOME/conf/tomcat-users.xml a uložte změny. Příklad:
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- Otevřete adresář CATALINA_HOME/bin a
spusťte spouštěcí soubor ke spuštění serveru Apache Tomcat.
- Windows: startup.bat
- Linux: startup.sh
Server Apache Tomcat se spustí, když informační zpráva zobrazí Spuštění serveru v number ms v obslužném programu příkazového řádku.
Postup
Chcete-li implementovat soubor help.war, postupujte takto:
- V prohlížeči zadejte následující adresu URL k otevření produktu Tomcat
Manager Application: http://localhost:8080/manager/html
- Zadejte jméno uživatele a heslo.
- V sekci klepněte na volbu Zvolit soubor.
- Vyberte soubor help.war.
- Klepněte na tlačítko Implementovat. Soubor help.war je
implementován, spuštěn a zobrazen v sekci Aplikace.
Soubor help.war se také zkopíruje do adresáře CATALINA_HOME/webapps.
- Ověřte, zda máte přístup k systému nápovědy přidáním help/index.jsp na
konec adresy URL serverové aplikace, kde help je název vašeho souboru .war. Příklad: http://localhost:8080/help/index.jsp.
Poznámka: - Systém nápovědy možná ještě neobsahuje obsah nápovědy. Při dalším kroku můžete být vyzváni k instalaci dokumentace do systému nápovědy.
- Pokud je váš systém nápovědy implementován na stejném serveru Apache Tomcat jako produkt, systém nápovědy se spustí a zastaví, když se spustí a zastaví aplikace produktu.
Jak pokračovat dále
- Nainstalujte dokumentaci na serveru:
- Poskytněte uživatele se serverem, portem a cestou k systému nápovědy, abyste zadali stránku Konfigurace systému nápovědy v sekci IBM Installation Manager.
Ujistěte se, že vámi poskytnutý server není localhost.
Příklad: Pro
http://server.ibm.com:8080/help/index.jsp,
jsou hodnoty následující:
- Server: server.ibm.com
- Port: 8080
- Cesta: /help