Ferne Flags für die Anwendung "Ferne Services" in WebSphere Application Server konfigurieren

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

Vorbereitende Schritte

Prüfen Sie die Liste der fernen Flags, die für die Anwendung "Ferne 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.license.attempts.count Eine Zahl

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

Gibt an, wie oft geprüft werden soll, ob eine Lizenz verfügbar ist. Der Standardwert ist 1 Mal. Wenn der eingegebene Wert kleiner als 1 ist, wird der Wert ignoriert.
-Dcom.ibm.rational.rpe.license.retry.timeout Eine Zahl in 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. Der Standardwert ist 5 Sekunden.
-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 "Ferne 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 "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 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-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.

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.

Feedback