Apache Tomcat で Document Builder 用にランタイム・フラグおよびフォーマット設定フラグを構成

フラグと呼ばれるプロパティーを追加して、使用アプリケーションの特定のパラメーターを指定できます。

始める前に

Document Builder アプリケーションに使用できるランタイム・フラグおよびフォーマット設定フラグのリストを調べて、このタスクを実行するのに使用するものを選択します。
表 1. ランタイム・フラグおよびフォーマット設定フラグ
フラグ 説明
-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.enable_commands truefalse

例: -Dcom.ibm.rational.rpe.enable_commands=true

Rational Publishing Engine フラグ Document Builder アプリケーションのプレコマンドおよびポストコマンドを実行可能にするには、このフラグを true に設定します。
-Dcom.ibm.rational.rpe.console.limit 文字数

デフォルト値: 100000 文字

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

Rational Publishing Engine フラグ 「コンソール」ビューに保持されるログ情報のサイズを 制御できます。
-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

デフォルト値: false

例: -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.managementtrue に設定すると、ユーザーはレジストリー・キーを設定してこのメモリー制限を定義できます。そうしない場合、DXL コードに設定された 2GB のデフォルト・メモリー制限が使用されます。 レジストリー・キーについて詳しくは、『Rational DOORS 文書生成のトラブルシューティング』を参照してください。

デフォルト値は false であり、レジストリー・キーは文書生成プロセスに影響しません。

-Dcom.ibm.rational.rpe.enable.surrogate.char.processing truefalse

デフォルト値: false

例: -Dcom.ibm.rational.rpe.enable.surrogate.char.processing=true

Rational Publishing Engine フラグ Microsoft Word および PDF 出力では、ユニコード・サロゲート (多くの場合、アジア言語の文字) が出力から削除されます。 -Dcom.ibm.rational.rpe.enable.surrogate.char.processing を有効にすると、これらの文字を文書の生成中に正しく処理できるため、文字は予期するとおりに出力に組み込まれます。
-Dcom.ibm.rational.rpe.nonunicodefonts 1 つの非 Unicode フォント名 またはセミコロンで区切られた複数のフォント名。

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

Rational Publishing Engine フラグ Rational Publishing Engine で使用する非 Unicode のフォントを 指定できます。指定する非 Unicode フォントは、クライアント・アプリケーションが実行されているコンピューターと同じコンピューターにインストールされている必要があります。

非 Unicode フォントは、Microsoft Word 出力では正しく生成されない場合があります。 フォントを Arial Unicode MS またはこの文字をレンダリングできる他のフォントに設定すると、出力は正しく生成されます。

-Dcom.ibm.rational.rpe.output.default 一時ディレクトリー

デフォルト値: TEMP¥rpe¥output

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

Rational Publishing Engine フラグ 一時ディレクトリーは、デフォルトとは異なるロケーションに変更できます。このフラグは、システムまたは Java ランタイム変数のいずれかとして指定できます。 Java ランタイム変数は、システム変数に優先します。
-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory 1 つのディレクトリーまたはセミコロンで区切られた 複数のディレクトリー。
例:

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

Rational Publishing Engine フラグ システムにデフォルト以外のディレクトリーに追加のフォントが インストールされている場合、これらのフォント・ディレクトリーを指定できます。
-Dcom.ibm.rational.rpeng.cookies

例: -Dcom.ibm.rational.rpe.cookies=

Rational Publishing Engine フラグ Document Builder の秘密 Cookie (例: rpeng-secret) を入力します。 正常にログインしていれば、rpeng/api/secret API を使用して秘密情報を取得できます。
-Dcom.ibm.rational.rpeng.pwd Document Builder で認証するユーザー・パスワード。

例: -Dcom.ibm.rational.rpeng.pwd=password

Rational Publishing Engine フラグ Document Builder アプリケーションで認証するには、このフラグをパスワードを使用して構成します。
-Dcom.ibm.rational.rpeng.url URL
例:

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

Rational Publishing Engine フラグ Document Builder アプリケーションに接続するための URL。管理者がユーザーにロケーションの変更を許可していない場合には、この URL は編集できない可能性があります。
-Dcom.ibm.rational.rpeng.usr Document Builder で認証するユーザー名。

例: -Dcom.ibm.rational.rpeng.usr=user

Rational Publishing Engine フラグ Document Builder アプリケーションで認証するには、このフラグをユーザー名を使用して構成します。
-Dcom.ibm.rational.rpe.tls12only truefalse

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

Rational Publishing Engine フラグ true に設定すると、Rational Publishing Engine はトランスポート層セキュリティー (TLS) 1.2 モードのみで通信します。 Rational Publishing Engine は、どの Secure Sockets Layer プロトコルが使用中であるかを識別するために他の Java 仮想マシン・プロパティー設定を調べることはしません。
-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.country を含める必要があるのは、-Duser.language と組み合わせたときに参照する特定言語の翻訳が使用可能な場合のみです。
-Duser.language 言語コード

日本語の場合の例: -Duser.language=ja

標準 Java フラグ 言語の略語にこのフラグを設定して、文書生成のロケールを設定します。 言語コードの例について詳しくは、『HTML Language Code Reference』を参照してください。
-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 は、Rational Publishing Engine に固有ではない標準の Java パラメーターです。

TELELOGIC_LICENSE_FILE TELELOGIC_LICENSE_FILE システム変数に port@license_server_hostname_or_IP_address のフォームでリストされるライセンス・サーバー値。

例: 19353@LicenseServer2

Rational Publishing Engine フラグ ライセンス・サーバーのアドレスをリストする システム変数。

手順