Ferne Flags für die Anwendung "Web Services" konfigurieren

Sie können den Konfigurationsdateien Ihres Anwendungsservers Parameter hinzufügen, die als Flags bezeichnet werden, um für die Anwendung "Web Services" bestimmte Parameter festzulegen.

Vorbereitende Schritte

Prüfen Sie die Liste der fernen Flags, die für die Anwendung "Web Services" verfügbar sind, und wählen Sie ein Flag aus, das zur Ausführung dieser Aufgabe verwendet werden soll.
Tabelle 1. Ferne Flags
Flag Wert Beschreibung
-Dcom.ibm.rational.rpe.docgen.concurentlimit Eine Zahl

Beispiel: -Dcom.ibm.rational.rpe.docgen.concurentlimit=5

Legen Sie die maximale Anzahl der Dokumentgenerierungsanforderungen von Rational Publishing Engine fest, die gleichzeitig ausgeführt werden können. Wenn der Grenzwert erreicht ist, werden die nachfolgenden Jobanforderungen in eine Warteschlange gestellt und der Reihe nach gestartet, wenn der jeweils aktuelle Job abgeschlossen ist.
-Dcom.ibm.rational.rpe.remote.debug true, false

Beispiel: -Dcom.ibm.rational.rpe.remote.debug=true

Sie können zum Zweck der Fehlerbehebung bei Dokumentgenerierungsfehlern ausführlichere Protokollinformationen anzeigen.
-Dcom.ibm.rational.rpe.remote.filestore Ein Dateipfad, der mit \\ beginnt.

Beispiel: -Dcom.ibm.rational.rpe.remote.filestore=\\storage\rpe\files

Wenn Sie eine Lastausgleichsumgebung konfigurieren möchten, können Sie die Position des gemeinsam genutzten Speicherverzeichnisses festlegen.
-Dcom.ibm.rational.rpe.remote.ignorelanguage true, false

Beispiel: -Dcom.ibm.rational.rpe.remote.ignorelanguage=true

Bei Angabe von true ignoriert die Anwendung "Web Services" die vom Benutzer festgelegten Flags -Duser.country und -Duser.language und legt die Standardsprache fest, die der Administrator für den Server definiert hat.
-Dcom.ibm.rational.rpe.remote.javaopts Größe des Heapspeichers

Beispiel: -Dcom.ibm.rational.rpe.remote.javaopts=-Xmx1280m

Sie können die Speichermenge, die die Anwendung "Web Services" für die Dokumentgenerierung zuordnet, erhöhen. Der Standardwert ist -Xmx1024m.

Wenn Sie eine 32-Bit-JRE (Java Runtime Environment) für die Anwendung "Web Services" verwenden, können Sie die Größe des Heapspeichers lediglich von 1 in 1,5 GB ändern. Wenn Sie eine 64-Bit-JRE für die Anwendung "Web Services" verwenden, können Sie die Größe des Heapspeichers auf über 1,5 GB einstellen.

-Dcom.ibm.rational.rpe.remote.jre Ein absoluter Pfad zu den JRE-Anwendungsdateien (Java Runtime Environment).

Beispiel: -Dcom.ibm.rational.rpe.remote.jre=C:\Programme\Java\jre7

Sie können einen anderen Pfad für Java Runtime Environment angeben, als den in den RPE-Anwendungsdateien (Rational Publishing Engine) enthaltenen Pfad %RPE_HOME%\jre.
-Dcom.ibm.rational.rpe.remote.jrearch 32 oder 64 Bit.

Beispiel: -Dcom.ibm.rational.rpe.remote.jrearch=32

Wenn Rational Publishing Engine nicht die richtige JRE-Version (Java Runtime Environment) zur Ausführung von Dokumentgenerierungen erkennt, können Sie die Version angeben, die verwendet werden soll.
-Dcom.ibm.rational.rpe.remote.rpecommandjar Ein absoluter Pfad zur Datei rpecommand.jar.

Beispiel: -Dcom.ibm.rational.rpe.remote.rpecommandjar=C:\Programme\Rational\Publishing Engine

Wenn Rational Publishing Engine nicht den richtigen Pfad zur Datei rpecommand.jar erkennt, können Sie den Pfad angeben, der verwendet werden soll.
-Dcom.ibm.rational.rpe.remote.showconsole true, false.

-Dcom.ibm.rational.rpe.remote.debug muss ebenfalls auf true gesetzt sein.

Beispiel:

-Dcom.ibm.rational.rpe.remote.showconsole=true
-Dcom.ibm.rational.rpe.remote.debug=true

Windows-Symbol: Auf Windows-Computern können Sie die ausführlichen Protokollinformationen aus com.ibm.rational.rpe.remote.debug in einer separaten Konsole aufrufen. Verwenden Sie diese Eigenschaft nicht, wenn der Anwendungsserver als Windows NT-Dienst ausgeführt wird.
-Dcom.ibm.rational.rpe.remote.workarea Ein absoluter Pfad, auf den der Benutzer Schreibzugriff hat.

Beispiel: -Dcom.ibm.rational.rpe.remote.workarea=C:\temp

Die Position, in der während der Dokumentgenerierung temporäre Dateien erstellt werden. Wird kein Pfad angegeben, wird das temporäre Verzeichnis für das System verwendet.
-Dcom.ibm.ws.classloader.encodeResourceURLs true, false

-Dcom.ibm.rational.rpe.remote.debug muss ebenfalls auf true gesetzt sein.

Beispiel:

-Dcom.ibm.ws.classloader.encodeResourceURLs=false
-Dcom.ibm.rational.rpe.remote.debug=true

Nur erforderlich für WebSphere Application Server 8. Dieses Flag verhindert die Verschlüsselung von URLs. Werden URLs von WebSphere Application Server 8 verschlüsselt, können Sie von Rational Publishing Engine nicht gelesen werden.

Informationen zu diesem Vorgang

Sie können ein oder mehrere dieser fernen Flags für diese Anwendungsserver konfigurieren:

WebSphere Application Server

Vorgehensweise

  1. Öffnen Sie die Administrationskonsole in einem Browser. Beispiel: http://Server:Port/ibm/console/logon.jsp
  2. Klicken Sie auf Server > Servertypen.
  3. Klicken Sie auf WebSphere-Anwendungsserver.
  4. Öffnen Sie die Servereigenschaften, indem Sie den Servernamen anklicken.
  5. Klicken Sie im Abschnitt "Serverinfrastruktur" auf Java- und Prozessverwaltung.
  6. Klicken Sie auf Prozessdefinition.
  7. Klicken Sie im Abschnitt "Weitere Eigenschaften" auf Java Virtual Machine.
  8. Klicken Sie im Abschnitt "Weitere Eigenschaften" auf Angepasste Eigenschaften.
  9. Klicken Sie auf Neu, um das Flag hinzuzufügen.
  10. Geben Sie im Feld "Name" den Namen des ausgewählten Flags ein.
  11. Löschen Sie das Anfangszeichen -D im Namen des kopierten Flags. Beispiel: -Dcom.ibm.rational.rpe.Flag wird zu com.ibm.rational.rpe.Flag.
  12. Geben Sie im Feld "Wert" den Parameter für das Flag ein.
  13. Optional: Geben Sie eine Beschreibung ein, die den Zweck für die Verwendung dieses Flags angibt.
  14. Klicken Sie auf OK.
  15. Führen Sie einen Neustart des Servers durch.

Apache Tomcat

Vorgehensweise

  1. Klicken Sie in den Apache-Tomcat-Anwendungsdateien mit der rechten Maustaste auf die Datei startup, die zum Starten des Servers verwendet wird.
  2. Klicken Sie auf Properties.
  3. Wählen Sie das Register Java aus.
  4. Geben Sie im Feld "Java options" das ausgewählte Flag und den zugehörigen Wert ein. Beispiel:
    -Dcom.ibm.rational.rpe.Flag=Wert
  5. Klicken Sie auf OK.
  6. Starten Sie Apache Tomcat erneut.

Feedback