Wenn Sie das Produkt nicht auf dem Server installiert haben, auf dem Sie die Hilfe implementieren, können Sie die Hilfe auf Apache Tomcat als Anwendungsserver installieren.
Vorbereitende Schritte
- Der Server, auf dem Sie den Hilfeinhalt konfigurieren, ist für Ihre Benutzer jenseits der Firewall verfügbar.
- Auf Ihrem Server befindet sich eine Datei help.war.
- Wenn das Produkt, für das Sie die Hilfe konfigurieren, auf dem Server installiert ist, so 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 keine Datei help.war zu Ihrem Produkt gehört, laden Sie die Datei 'help.war' von der Adresse http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war herunter.
- Installieren und konfigurieren Sie Apache Tomcat.
- Installieren Sie eine Java™ Runtime
Environment (JRE) oder ein Java-Entwicklerkit. Sie können sich bei der Installation für eines der IBM® Entwicklerkits entscheiden.
- Definieren Sie eine Umgebungsvariable mit dem Pfad zu der JRE oder dem Java-Entwicklerkit:
- Wenn Sie eine JRE installiert haben, erstellen Sie die Umgebungsvariable JRE_HOME und legen Sie als Wert für diese neue Variable den Pfad zu dem Verzeichnis fest, in dem Sie die JRE installiert haben. Beispiel:
- Windows: C:\Programme\Java70\jre
- Linux: /usr/local/java70/jre
- Wenn Sie ein Java-Entwicklerkit installiert haben, erstellen Sie die Umgebungsvariable
JAVA_HOME und legen Sie als Wert für diese neue Variable den Pfad zu dem Verzeichnis fest, in dem Sie das
Java-Entwicklerkit installiert haben. Beispiel:
- Windows: C:\Programme\Java70
- Linux: /usr/local/java70/
- Laden Sie die
Apache Tomcat-Serveranwendung
herunter.
- Extrahieren Sie die Apache Tomcat-Archivdatei.
- Verschieben Sie den extrahierten Ordner an eine dauerhafte Position. Diese Position wird als CATALINA_HOME bezeichnet. Beispiel: C:\apache-tomcat-version
- Erstellen Sie eine Umgebungsvariable namens CATALINA_HOME und legen Sie als Wert für diese Variable das Verzeichnis CATALINA_HOME fest. Beispiel: C:\apache-tomcat-version
- Fügen Sie in der Datei CATALINA_HOME/conf/tomcat-users.xml einen Serveradministrator als Benutzer 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, indem Sie die Startdatei ausführen. Hierbei richtet sich der Name dieser Datei jeweils nach dem verwendeten Betriebssystem:
- Windows: startup.bat
- Linux: startup.sh
Apache Tomcat ist aktiv, wenn die Informationsnachricht in einem Befehlszeilendienstprogramm inhaltlich besagt, dass der Server-Start in anzahl ms erfolgt.
Vorgehensweise
Gehen Sie wie folgt vor, um die Datei help.war zu implementieren:
- Geben Sie in einem Browser die folgende URL ein, um 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 im Abschnitt Applications angezeigt. 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. Fügen Sie hierzu an das Ende der URL für die Serveranwendung die Angabe hilfe/index.jsp an. Hierbei steht hilfe für den Namen Ihrer .war-Datei. Beispiel: http://localhost:8080/help/index.jsp
Anmerkung: - Es kann sein, dass im Hilfesystem noch
kein Hilfeinhalt enthalten ist. Unter Umständen müssen Sie im nächsten Schritt die Dokumentation
im Hilfesystem installieren.
- 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.
Nächste Schritte
- Installieren Sie durch Ausführen einer der folgenden Tasks den Inhalt der Hilfe auf dem Server:
- Geben Sie die URL für das Information Center an die Teammitglieder in Ihrem Unternehmen weiter. Sie
können diese als Vorgabe für die Hilfe ihres Rational DOORS-Clients
angeben, sodass dieser wie in Auswahl für den Hilfeinhalt ändern erläutert auf die Hilfe auf dem Intranet-Server zugreift. Stellen Sie sicher, dass die von Ihnen bereitgestellte URL nicht etwa localhost als Servernamen enthält. Beispiel: http://server.ibm.com:8080/help/index.jsp