Wenn Sie das Produkt nicht auf dem Server installiert haben,
auf dem Sie die Hilfe implementieren, können Sie den Anwendungsserver "Apache
Tomcat" für die Implementierung verwenden.
Before you begin
- Der Server, auf dem Sie den Inhalt der Hilfe konfigurieren,
muss für Ihre Benutzer hinter der Firewall verfügbar sein.
- Die Datei help.war befindet sich auf Ihrem
Server.
- Wenn das Produkt, für das Sie die Hilfe konfigurieren, auf dem Server installiert ist,
ist die Datei help.war möglicherweise bereits installiert.
- Suchen Sie im Verzeichnis
installationsverzeichnis/help
die Datei help.war.
- Suchen Sie eine Version der Datei, die die Abkürzung des Produkts
enthält, wie clmhelp.war oder
ramhelp.war.
- Suchen Sie in Ihrem Installationsverzeichnis die Datei
*help.war.
- Wenn das Produkt nicht auf dem Server installiert ist oder wenn die
Datei help.war nicht im Lieferumfang Ihres Produkts enthalten war, laden Sie eine Version
der Datei help.war herunter.
- Installieren und konfigurieren Sie Apache Tomcat.
- Installieren Sie eine Java™ Runtime
Environment (JRE) oder ein Java Development
Kit (JDK). Sie können einen der IBM® developer kits installieren.
- Setzen Sie eine Umgebungsvariable mit dem Pfad zur JRE oder zum JDK:
- Wenn Sie eine JRE installiert haben, erstellen Sie die Umgebungsvariable JRE_HOME
und legen Sie für deren Wert den Pfad des Verzeichnisses fest, in dem
Sie die JRE installiert haben, beispielsweise:
- Windows: C:\Program Files\Java70\jre
- Linux: /usr/local/java70/jre
- Wenn Sie ein JDK installiert haben, erstellen Sie die Umgebungsvariable JAVA_HOME
und legen Sie für deren Wert den Pfad des Verzeichnisses fest, in dem Sie das
JDK installiert haben, beispielsweise:
- Windows: C:\Program Files\Java70
- Linux: /usr/local/java70/
- Laden Sie die
Apache Tomcat-Serveranwendung
herunter.
- Extrahieren Sie das Apache Tomcat-Archiv.
- Verschieben Sie den extrahierten Ordner an eine dauerhafte Position. Diese Position
hat den Namen CATALINA_HOME.
Beispiel: C:\apache-tomcat-version
- Erstellen Sie die Umgebungsvariable CATALINA_HOME und
legen Sie für deren Wert das Verzeichnis CATALINA_HOME fest. Beispiel: C:\apache-tomcat-version
- Fügen Sie einen Serveradministrator zur Datei CATALINA_HOME/conf/tomcat-users.xml hinzu
und speichern Sie die Änderungen. Beispiel:
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- Öffnen Sie das Verzeichnis CATALINA_HOME/bin
und starten Sie den Apache Tomcat-Server durch Ausführen der Startdatei. Der Name
der Datei kann je nach Betriebssystem unterschiedlich sein.
- Windows: startup.bat
- Linux: startup.sh
Apache Tomcat wird ausgeführt, wenn die Informationsnachricht in einem Befehlszeilendienstprogramm Server Startup in anzahl ms lautet.
Procedure
Gehen Sie wie folgt vor, um die Datei help.war zu implementieren:
- Geben Sie in einem Browser die folgende URL ein, um die Anwendung "Tomcat
Manager" zu öffnen: http://localhost:8080/manager/html
- Geben Sie den Benutzernamen und das Kennwort ein.
- Klicken Sie im Abschnitt auf Choose
file.
- Wählen Sie die Datei help.war aus.
- Klicken Sie auf Deploy. Die Datei help.war
wird implementiert, gestartet und in den Abschnitt Applications eingefügt.
Außerdem wird die Datei help.war auch
in das Verzeichnis CATALINA_HOME/webapps
kopiert.
- Stellen Sie sicher, dass Sie auf das Hilfesystem zugreifen
können, indem Sie an das Ende der Serveranwendungs-URL die Angabe
hilfe/index.jsp
anfügen, wobei hilfe der Name Ihrer
.war-Datei ist. Beispiel: http://localhost:8080/help/index.jsp.
Note: - Es kann sein, dass im Hilfesystem noch
kein Hilfeinhalt enthalten ist. Installieren Sie im nächsten Schritt die Dokumentation im Hilfesystem.
- Wenn Ihr Hilfesystem auf demselben Apache Tomcat-Server wie
das Produkt installiert ist, wird es gestartet und gestoppt,
wenn die Produktanwendung gestartet und gestoppt wird.
What to do next
- Installieren Sie den Inhalt der Hilfe auf dem Server, indem Sie eine der folgenden
Tasks ausführen:
- Wenn andere Benutzer über die Produkte, die mit
IBM Installation Manager
auf ihren Computern installiert wurden, auf diesen Inhalt der Hilfe zugreifen,
geben Sie diesen die Angaben
für Server, Port und Pfad zum Hilfesystem weiter.
Stellen Sie sicher, dass
Sie nicht den Server localhost angeben.
Beispiel:
http://server.ibm.com:8080/name_der_hilfe/index.jsp- Server: server.ibm.com
- Port: 8080
- Pfad: /name_der_hilfe