Hvis produktet ikke er installeret på den server, hvor hjælpen implementeres, kan du implementere hjælpen på Apache
Tomcat-applikationsserveren.
Inden du begynder
- Den server, hvor du konfigurerer hjælpen, skal være tilgængelig for dine brugere bag firmaets firewall.
- Der ligger en help.war-fil på serveren.
- Der kan allerede være installeret en help.war-fil, hvis det produkt, du er ved at konfigurere, er installeret på serveren.
- Kig i biblioteket installationsbibliotek/help efter filen help.war.
- Kig efter en version af filen, der inkluderer produktforkortelsen, f.eks. clmhelp.war eller ramhelp.war
- Søg i installationsbiblioteket efter *help.war.
- Hvis produktet ikke er installeret på serveren, eller hvis en help.war-fil ikke fulgte med produktet, kan du downloade en version af help.war-filen.
- Installér og konfigurér Apache Tomcat.
- Installér et JRE (Java™ Runtime
Environment) eller JDK (Java Development
Kit). Du kan installere et IBM® Developer Kit.
- Angiv en systemvariabel med stien til JRE'et eller JDK'et:
- Hvis du har installeret et JRE, skal du oprette en JRE_HOME-systemvariabel og angive værdien til stien for det bibliotek, hvor du installerede JRE'et, f.eks.:
- Windows: C:\Programmer\Java70\jre
- Linux: /usr/local/java70/jre
- Hvis du har installeret et JDK, skal du oprette en JAVA_HOME-systemvariabel og angive værdien til stien for det bibliotek, hvor du installerede JDK'et, f.eks.:
- Windows: C:\Programmer\Java70
- Linux: /usr/local/java70/
- Download Apache Tomcat-serverapplikationen.
- Pak det komprimerede Apache Tomcat-arkiv ud.
- Flyt den udpakkede folder til en permanent placering. Denne placering kaldes for CATALINA_HOME, f.eks. C:\apache-tomcat-version
- Opret en CATALINA_HOME-systemvariabel, og angiv værdien til CATALINA_HOME-biblioteket, f.eks.: C:\apache-tomcat-version
- Tilføj en serveradministratorbruger til filen CATALINA_HOME/conf/tomcat-users.xml, og gem ændringerne, f.eks.:
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- Åbn biblioteket CATALINA_HOME/bin, og start Apache Tomcat-serveren ved at udføre startfilen. Navnet på filen afhænger af styresystemet.
- Windows: startup.bat
- Linux: startup.sh
Apache Tomcat kører, når informationsmeddelelsen i et kommandolinjeværktøj viser Server Startup in antal ms.
Fremgangsmåde
Sådan distribuerer du help.war-filen:
- Angiv følgende URL i en browser for at åbne Tomcat
Manager-applikationen: http://localhost:8080/manager/html
- Indtast brugernavn og kodeord.
- Klik på Choose
file i afsnittet .
- Vælg help.war-filen.
- Klik på Deploy. Filen help.war distribueres, startes og medtages i afsnittet Applications.
Filen help.war kopieres også til biblioteket CATALINA_HOME/webapps.
- Kontrollér, at du kan få adgang til hjælpesystemet, ved at tilføje help/index.jsp til slutningen af URL'en til serverapplikationen, hvor help er navnet på din .war-fil. Eksempel: http://localhost:8080/help/index.jsp.
Bemærk: - Hjælpesystemet indeholder muligvis ikke noget hjælpeindhold
endnu. Installér derefter dokumentationen i hjælpesystemet.
- Hvis dit hjælpesystem er implementeret på samme Apache Tomcat-server som produktet, starter
og stopper hjælpesystemet, når produktapplikationen startes og stoppes.
Næste trin
- Installér hjælpen på serveren ved at udføre en af følgende opgaver:
- Oplys brugerne i organisationen om URL'en til informationscentret, så de kan angive den i deres indstillinger. Sørg for, at den server, du angiver, ikke er localhost.
Eksempel: http://server.ibm.com:8080/help/index.jsp