Referenz für ferne Flags für die Anwendung "Ferne Services"

Die folgende Liste enthält die fernen Flags und Java™-Eigenschaften, die in der Anwendung "Ferne Services" verwendet werden können.
Wählen Sie in der Liste ein Flag aus und lesen Sie die Informationen zum Verwenden dieses Flags im Artikel "Ferne Flags konfigurieren" für WebSphere Application Server oder Apache Tomcat.
Tabelle 1. Ferne Flags
Flag Wert Beschreibung
-Dcom.ibm.rational.rpe.docgen.concurrentlimit Eine Zahl

Beispiel: -Dcom.ibm.rational.rpe.docgen.concurrentlimit=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.
Wichtig: Berücksichtigen Sie bei der Auswahl der Anzahl der Dokumentgenerierungsanforderungen die in Ihrem Unternehmen verfügbare Anzahl von Lizenzen. Ist bei Beginn der Dokumentgenerierung keine Lizenz verfügbar, weil entweder der für gleichzeitige Generierung gesetzte Grenzwert über der Anzahl der verfügbaren Lizenzen liegt oder weil alle Lizenzen zu dem Zeitpunkt im Gebrauch sind, passiert je nach Situation Folgendes:
  • Bei Angabe der Flags com.ibm.rational.rpe.license.attempts.count und com.ibm.rational.rpe.license.retry.timeout wird die Dokumentgenerierung der Warteschlange hinzugefügt und die Operation wird an den angegebenen Intervallen wiederholt.
  • Wenn die Flags com.ibm.rational.rpe.license.attempts.count und com.ibm.rational.rpe.license.retry.timeout nicht angegeben wurden, kann die Dokumentgenerierung nicht ausgeführt werden. Die Dokumentgenerierung wird beendet.
-Dcom.ibm.rational.rpe.license.attempts.count Eine Zahl

Standardwert: 1

Beispiel: -Dcom.ibm.rational.rpe.license.attempts.count=2

Gibt an, wie oft geprüft werden soll, ob eine Lizenz verfügbar ist. Wenn der eingegebene Wert kleiner als 1 ist, wird der Wert ignoriert.
-Dcom.ibm.rational.rpe.license.retry.timeout Eine Zahl in Sekunden.

Standardwert: 5 Sekunden

Beispiel: -Dcom.ibm.rational.rpe.license.retry.timeout=6

Gibt an nach vielen Sekunden erneut geprüft werden soll, ob eine Lizenz verfügbar 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

Standardwert: false

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

Bei Angabe von true ignoriert die Anwendung "Ferne 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

Standardwert: -Xmx1024m

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

Sie können die Speichermenge, die die Anwendung "Ferne Services" für die Dokumentgenerierung zuordnet, erhöhen.

Wenn Sie eine 32-Bit-JRE (Java Runtime Environment) für die Anwendung "Ferne 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 "Ferne 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 Rational Publishing Engine-Anwendungsdateien 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-Systemen 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.rational.rpe.ssl Einer der folgenden Sicherheitstypen:
  • SSL
  • SSLv2
  • SSLv3
  • TLS
  • TLSv1
  • TLSv1.1

Beispiel: -Dcom.ibm.rational.rpe.ssl=TLSv1

Wenn Sie einen bestimmten Sicherheitstyp angeben, verwendet Rational Publishing Engine für die Kommunikation nur diesen Sicherheitstyp.

Für TLS v1.2 konfigurieren Sie stattdessen das Flag -Dcom.ibm.rational.rpe.tls12only. Wenn die Flags -Dcom.ibm.rational.rpe.tls12only und -Dcom.ibm.rational.rpe.ssl beide konfiguriert sind, hat -Dcom.ibm.rational.rpe.tls12only Vorrang.

-Dcom.ibm.rational.rpe.tls12only true, false

Beispiel: -Dcom.ibm.rational.rpe.tls12only=true

Wenn Sie diese Eigenschaft auf true setzen, kommuniziert Rational Publishing Engine nur im Modus von Transport Layer Security (TLS) 1.2. Andere Eigenschafteneinstellungen der Java Virtual Machine (JVM) werden von Rational Publishing Engine nicht geprüft, um das verwendete SSL-Protokoll (Secure Sockets Layer) zu ermitteln.

Wenn die Flags -Dcom.ibm.rational.rpe.tls12only und -Dcom.ibm.rational.rpe.ssl beide konfiguriert sind, hat -Dcom.ibm.rational.rpe.tls12only Vorrang.

-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.

Feedback