在 Apache Tomcat 上為「遠端服務」應用程式配置執行時期和格式化旗標

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

開始之前

檢閱可供「遠端服務」應用程式使用的執行時期和格式化旗標清單,然後選取一個旗標,以用來完成這項作業。
表 1. 執行時期和格式化旗標
旗標 類型 說明
-Dcom.ibm.rational.rpe.config.oslcServiceProviders 完整的檔案路徑、UNC 路徑或 HTTP 位置
範例:

-Dcom.ibm.rational.rpe.config.oslcServiceProviders=
C:\rpe\oslcServiceProviders.xml

Rational® Publishing Engine 旗標 Rational DOORS® Web Access 資料來源配置 OAuth-OSLC 鑑別方法。您必須在指定給這個旗標的 oslcServiceProviders.xml 檔中,輸入有效的 base_urlconsumer_keysecret 內容值。如需相關資訊,請參閱建立 oslcServiceProviders.xml 檔案以用於 OAuth-OSLC 鑑別,並參閱 Rational Publishing Engine 安裝目錄中的範例:%RPE_HOME%/config/oslcServiceProviders-sample.xml
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd 字串

範例:-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd=password

Rational Publishing Engine 旗標 使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 旗標執行 OAuth-OSLC 鑑別時,需使用的密碼。
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr 字串

範例:-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr=user

Rational Publishing Engine 旗標 使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 旗標執行 OAuth-OSLC 鑑別時,需使用的使用者名稱。
-Dcom.ibm.rational.rpe.disablecommands truefalse

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

Rational Publishing Engine 旗標 如需額外的安全,您可以設定這個旗標,讓「遠端服務」應用程式停止執行任何前置指令及後置指令。
-Dcom.ibm.rational.rpe.mc.maxerrorcount 數字

範例:-Dcom.ibm.rational.rpe.mc.maxerrorcount=

Rational Publishing Engine 旗標 用戶端嘗試連接「監視和控制」元件來列出文件產生工作的次數。預設次數是 3。 一般而言,如果在連續嘗試 6 次之後仍無法聯絡伺服器,就表示伺服器可能已關閉,管理者必須重新啟動它。
-Dcom.ibm.rational.rpe.console.limit 字元數

範例:-Dcom.ibm.rational.rpe.console.limit=90000

Rational Publishing Engine 旗標 您可以控制主控台視圖中所保留的日誌資訊大小。依預設,大小上限會設為 100000 個字元。
-Dcom.ibm.rational.rpe.doors.data 要傳送至 Rational DOORS 指令行的資料引數。

範例:-Dcom.ibm.rational.rpe.doors.data=36677@localhost

Rational Publishing Engine 旗標 您可以包含這個旗標,來識別您的 Rational DOORS 資料庫,這樣 Rational Publishing Engine 就不必識別它。當您的 Rational DOORS 很穩定,或者您的文件產生作業是在不允許執行 reg.exe 指令的電腦上設定,設定這個值可以改良效能。當配置這個旗標時,它會置換您在文件規格中指定給 doors_param 內容的值。您可以將這個旗標指定為系統或 Java™ 執行時期變數。Java 執行時期變數會比系統變數優先採用。

在配置這個旗標時,您必須將 new_instance 內容設為 true

-Dcom.ibm.rational.rpe.doors.flags Rational DOORS 指令行選項

範例:-Dcom.ibm.rational.rpe.doors.flags="-addins file path"

Rational Publishing Engine 旗標 您可以為 Rational DOORS 指定指令行選項。您可以將這個旗標指定為系統或 Java 執行時期變數。Java 執行時期變數會比系統變數優先採用。
-Dcom.ibm.rational.rpe.doors.home Rational DOORS 執行檔的路徑
範例:

-Dcom.ibm.rational.rpe.doors.home=
C:\Program Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe

Rational Publishing Engine 旗標 您可以包含這個旗標,來識別您的 Rational DOORS 版本,這樣 Rational Publishing Engine 就不必識別它。當您的 Rational DOORS 很穩定,或者您的文件產生作業是在不允許執行 reg.exe 指令的虛擬機器上設定時,設定這個值可以增進效能。當配置這個旗標時,它會置換您在文件規格中指定給 doors_home 內容的值。您可以將這個旗標指定為系統或 Java 執行時期變數。Java 執行時期變數會比系統變數優先採用。

在配置這個旗標時,您必須將 new_instance 內容設為 true

-Dcom.ibm.rational.rpe.dxl.enable.memory.management truefalse

範例:-Dcom.ibm.rational.rpe.dxl.enable.memory.management=true

Rational Publishing Engine 旗標

Rational DOORS 模組鏈結至其他模組時,Rational Publishing Engine 必須在產生文件時,在背景中開啟那些鏈結的模組。此外,當使用佈置 DXL 程式碼時,會在背景中開啟模組,直到 DXL 完成為止。

在這兩種情況下,都會使用 Rational DOORS 用戶端記憶體,在背景中開啟和關閉模組。您可以配置登錄機碼,以便在到達記憶體限制時,背景程序就會在讀取完現行物件時關閉,並且只在必要時,才重新開啟物件。

-Dcom.ibm.rational.rpe.dxl.enable.memory.management 設為 true 時,使用者可以設定登錄機碼,來定義這個記憶體限制,否則,會使用 DXL 程式碼中所設定的預設記憶體限制 2GB。如需登錄機碼的相關資訊,請參閱疑難排解 Rational DOORS 的文件產生

預設值是 false,登錄機碼不會對文件產生程序造成影響。

-Dcom.ibm.rational.rpe.nonunicodefonts 一個非 Unicode 字型名稱,或若干用分號區隔的字型名稱。

範例:-Dcom.ibm.rational.rpe.nonunicodefonts=Akshar

Rational Publishing Engine 旗標 您可以指定 Rational Publishing Engine 中所用的非 Unicode 字型。 您指定的非 Unicode 字型必須安裝在執行用戶端應用程式的同一部電腦中。

在 Microsoft Word 輸出中,不一定能正確產生非 Unicode 字型。 請將字型設為 Arial Unicode MS,或任何其他能夠呈現這個字元的字型,就能夠正確產生輸出。

-Dcom.ibm.rational.rpe.output.default 暫存目錄

範例:-Dcom.ibm.rational.rpe.output.default=C:\RPE\output

Rational Publishing Engine 旗標 您可以將暫存目錄變更為預設目錄 %TEMP%\rpe\output 以外的位置。您可以將這個旗標指定為系統或 Java 執行時期變數。Java 執行時期變數會比系統變數優先採用。
-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory 一個目錄,或用分號區隔的若干目錄。
範例:

-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=
C:\Windows\Fonts;d:\fontlib

Rational Publishing Engine 旗標 如果系統在非預設目錄中安裝了其他字型,您可以指定這些字型目錄。
-Dcom.ibm.rational.rpe.rpews.scheduler.pwd 要接受報告排程器鑑別的使用者密碼。

範例:-Dcom.ibm.rational.rpe.rpews.scheduler.pwd=password

Rational Publishing Engine 旗標 如果要接受「遠端服務」應用程式的報告排程器元件的鑑別,請為這個旗標配置一個密碼。
-Dcom.ibm.rational.rpe.rpews.scheduler.url 報告排程器的 URL。
範例:

-Dcom.ibm.rational.rpe.rpews.scheduler.url=
http://server:port/rpews/scheduler

Rational Publishing Engine 旗標 如果要接受「遠端服務」應用程式的報告排程器元件的鑑別,請為這個旗標配置一個 URL。
-Dcom.ibm.rational.rpe.rpews.scheduler.usr 要接受報告排程器鑑別的使用者名稱。

範例:-Dcom.ibm.rational.rpe.rpews.scheduler.usr=user

Rational Publishing Engine 旗標 如果要接受「遠端服務」應用程式的報告排程器元件的鑑別,請為這個旗標配置一個使用者名稱。
-Dcom.ibm.rational.rpe.wstimeout 時間(毫秒)

範例:-Dcom.ibm.rational.rpe.wstimeout=35000

Rational Publishing Engine 旗標 當建立複雜的文件規格而將其配置成使用遠端發佈引擎時,Launcher 將會逾時。如果您發現用戶端過早逾時,請增加逾時值。預設逾時值是 30000 毫秒。
-Dcom.ibm.rational.rpews.pwd 要接受「遠端服務」鑑別的使用者密碼。

範例:-Dcom.ibm.rational.rpews.pwd=password

Rational Publishing Engine 旗標 如果要接受「遠端服務」應用程式的鑑別,請為這個旗標配置一個密碼。
-Dcom.ibm.rational.rpews.url URL
範例:

-Dcom.ibm.rational.rpews.url=
http://server:port/rpews/

Rational Publishing Engine 旗標 用來連接「遠端服務」應用程式的 URL。如果管理者不允許使用者變更位置,可能無法編輯這個 URL。
-Dcom.ibm.rational.rpews.usr 要接受「遠端服務」鑑別的使用者名稱。

範例:-Dcom.ibm.rational.rpews.usr=user

Rational Publishing Engine 旗標 如果要接受「遠端服務」應用程式的鑑別,請為這個旗標配置一個使用者名稱。
-Dosgi.configuration.area 檔案路徑
範例:

-Dosgi.configuration.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

標準 Java 旗標 如果要變更您文件產生作業的預設輸出位置,您可以變更這個參數的檔案路徑。請為 -Dosgi.instance.area-Dosgi.configuration.area 參數指定相同的值。
-Dosgi.instance.area 檔案路徑
範例:

-Dosgi.instance.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

標準 Java 旗標 如果要變更您文件產生作業的預設輸出位置,您可以變更這個參數的檔案路徑。請為 -Dosgi.configuration.area-Dosgi.instance.area 參數指定相同的值。
-Duser.country 國碼
巴西葡萄牙文範例:

-Duser.country=BR -Duser.language=pt

標準 Java 旗標 將這個旗標設為與您的語言碼相對應的國家縮寫,來設定文件產生作業的語言環境。 將這個旗標與 -Duser.language 一起使用時,如果這個旗標所參照的特定語言已有翻譯可用,那麼只需要併入 -Duser.country
-Duser.language 語言碼

日文範例:-Duser.language=ja

標準 Java 旗標 將這個旗標設為某個語言的縮寫,來設定文件產生作業的語言環境。 如需語言碼的其他範例,請參閱 HTML 語言碼參照
-Duser.timezone GMT+offset

範例:-Duser.timezone=GMT+02:00

標準 Java 旗標 Rational Publishing Engine 會將日期和時間轉換成安裝 Rational Publishing Engine 的電腦的時區,而不是在遠端產生文件的伺服器的時區。 如果要將日期和時間指定為伺服器的時區,請輸入 GMT,以及伺服器位置距離「格林威治標準時間」的偏移時數。
–Xmx<value>m Java 資料堆設定

範例:–Xmx512m

IBM® Java 執行時期環境旗標 如果要讓 Rational Publishing Engine 能夠在虛擬機器上啟動,請在產品配置檔中降低這個參數的值。

當您在虛擬機器以外的其他環境中產生大量文件時,如果要改良效能,請增加值。

–Xmx 是標準 Java 參數,不是 Rational Publishing Engine 才有。

TELELOGIC_LICENSE_FILE TELELOGIC_LICENSE_FILE 系統變數中所列的授權伺服器值,格式為 port@license_server_hostname_or_IP_address

範例:19353@LicenseServer2

Rational Publishing Engine 旗標 列出授權伺服器位址的系統變數。

程序


意見