WebSphere Application Server 上為「遠端服務」應用程式配置遠端旗標

您可以將稱為旗標 (flag) 的參數新增到應用程式伺服器配置檔中,以指定「遠端服務」應用程式的特定參數。

開始之前

檢閱可供「遠端服務」應用程式使用的遠端旗標清單,並選取一個旗標,以用來完成這項作業。
表 1. 遠端旗標
旗標 說明
-Dcom.ibm.rational.rpe.docgen.concurentlimit 數字

範例:-Dcom.ibm.rational.rpe.docgen.concurentlimit=5

設定一次可執行的並行 Rational® Publishing Engine 文件產生要求數上限。如果到達此限制,後續的工作要求會放在佇列中,於現行工作完成後才啟動。
-Dcom.ibm.rational.rpe.license.attempts.count 數字

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

檢查是否有可用授權的次數。預設值是 1 次。如果所輸入的值小於 1,會忽略該值。
-Dcom.ibm.rational.rpe.license.retry.timeout 秒數

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

嘗試檢查是否有可用授權的等待間隔秒數。預設值是 5 秒。
-Dcom.ibm.rational.rpe.remote.debug truefalse

範例:-Dcom.ibm.rational.rpe.remote.debug=true

如果要對文件產生問題進行除錯,您可以檢閱更詳細的日誌資訊。
-Dcom.ibm.rational.rpe.remote.filestore \\ 開頭的檔案路徑

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

如果您要配置負載平衡環境,您可以指派共用儲存體目錄的位置。
-Dcom.ibm.rational.rpe.remote.ignorelanguage truefalse

範例:-Dcom.ibm.rational.rpe.remote.ignorelanguage=true

如果設為 true,Web 服務應用程式會忽略使用者所設定的 -Duser.country-Duser.language 旗標,並設定由管理者指定給伺服器的預設語言。
-Dcom.ibm.rational.rpe.remote.javaopts 資料堆大小

範例:-Dcom.ibm.rational.rpe.remote.javaopts=-Xmx1280m

您可以增加配置給「遠端服務」應用程式用來產生文件的記憶體量。預設值為 -Xmx1024m

如果您對「遠端服務」應用程式使用 32 位元的「Java™ 執行環境 (JRE)」,則可以將資料堆大小從 1 調整為 1.5 GB。如果您對「遠端服務」應用程式使用 64 位元 JRE,則可以將資料堆大小調整為大於 1.5 GB。

-Dcom.ibm.rational.rpe.remote.jre 「Java 執行時期環境」應用程式檔案的絕對路徑。

範例:-Dcom.ibm.rational.rpe.remote.jre=C:\Program Files\Java\jre7

您可以指定與 Rational Publishing Engine 應用程式檔案(位於 %RPE_HOME%\jre)所含路徑不同的「Java 執行時期環境」的路徑。
-Dcom.ibm.rational.rpe.remote.jrearch 3264 位元。

範例:-Dcom.ibm.rational.rpe.remote.jrearch=32

如果 Rational Publishing Engine 未偵測到正確的「Java 執行時期環境」來執行文件產生作業,您可以指定必須使用的版本。
-Dcom.ibm.rational.rpe.remote.rpecommandjar rpecommand.jar 檔的絕對路徑。

範例:-Dcom.ibm.rational.rpe.remote.rpecommandjar=C:\Program Files\Rational\Publishing Engine

如果 Rational Publishing Engine 未偵測到 rpecommand.jar 的正確路徑,您可以指定必須使用的路徑。
-Dcom.ibm.rational.rpe.remote.showconsole truefalse

-Dcom.ibm.rational.rpe.remote.debug 也必須設為 true

範例:

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

Windows 圖示:您可以在 Windows 系統上的個別主控台中,從 com.ibm.rational.rpe.remote.debug 開啟詳細的日誌資訊。 如果應用程式伺服器是作為 Windows NT 服務來執行,請勿使用這個內容。
-Dcom.ibm.rational.rpe.remote.workarea 使用者有其寫入權的絕對路徑。

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

在文件產生期間所建立之暫存檔的位置。如果未指定路徑,則會使用系統的暫存目錄。
-Dcom.ibm.rational.rpe.ssl 安全類型:
  • SSL
  • SSLv2
  • SSLv3
  • TLS
  • TLSv1
  • TLSv1.1

範例:-Dcom.ibm.rational.rpe.ssl=TLSv1

當設定為特定安全類型時,Rational Publishing Engine 只會使用該安全類型進行通訊。

對於 TLS 1.2 版,請改為配置 -Dcom.ibm.rational.rpe.tls12only 旗標。 如果同時配置了 -Dcom.ibm.rational.rpe.tls12only-Dcom.ibm.rational.rpe.ssl-Dcom.ibm.rational.rpe.tls12only 的優先順序較高。

-Dcom.ibm.rational.rpe.tls12only truefalse

範例:-Dcom.ibm.rational.rpe.tls12only=true

當設為 true 時,Rational Publishing Engine 只會在「傳輸層安全 (TLS)」1.2 模式下通訊。Rational Publishing Engine 不會檢查其他的「Java 虛擬機器 (JVM)」內容設定,來識別正在使用的 Secure Sockets Layer (SSL) 通訊協定。

如果同時配置了 -Dcom.ibm.rational.rpe.tls12only-Dcom.ibm.rational.rpe.ssl-Dcom.ibm.rational.rpe.tls12only 的優先順序較高。

-Dcom.ibm.ws.classloader.encodeResourceURLs truefalse

-Dcom.ibm.rational.rpe.remote.debug 也必須設為 true

範例:

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

WebSphere® Application Server 8 需要此項目。 這個旗標可避免 URL 被編碼。當 WebSphere Application Server 8 將 URL 編碼時,Rational Publishing Engine 即無法讀取。

程序

  1. 在瀏覽器中開啟管理主控台。 範例:http://server:port/ibm/console/logon.jsp
  2. 展開伺服器 > 伺服器類型
  3. 按一下 WebSphere Application Server
  4. 按一下 server_name 來開啟伺服器內容。
  5. 在「伺服器基礎架構」區段中,展開 Java 和程序管理
  6. 按一下程序定義
  7. 在「其他內容」區段中,按一下 Java 虛擬機器
  8. 在「其他內容」區段中,按一下自訂內容
  9. 按一下新建來新增旗標。
  10. 在「名稱」欄位中,輸入所選旗標的名稱。
  11. 刪除所複製旗標名稱開頭的 -D 例如,-Dcom.ibm.rational.rpe.flag 會成為 com.ibm.rational.rpe.flag
  12. 在「值」欄位中,輸入旗標的參數。
  13. 選擇性的: 輸入說明,指出旗標的用途。
  14. 按一下確定
  15. 重新啟動伺服器。

意見