Liberty 環境のカスタマイズ

特定の変数を使用して Liberty 環境をカスタマイズして、読み取り専用ファイル・システム内への製品バイナリー・ファイルと共有リソースの配置をサポートできます。

このタスクについて

以下のリストにある Liberty に固有の環境変数を server.env ファイル内で構成して、Liberty 環境をカスタマイズできます。${wlp.install.dir} 構成変数には、推定されるロケーションが使用され、常に、起動スクリプトを含んでいるディレクトリーの親に設定されます。

  • WLP_USER_DIR

    この環境変数を使用して、${wlp.user.dir} の代替ロケーションを指定できます。この変数は、絶対パスでなければなりません。この変数を指定した場合、ランタイム環境は、指定されたディレクトリーで共有リソースおよびサーバー定義を探します。${server.config.dir}${wlp.user.dir}/servers/serverName と等価です。この環境変数が指定されない場合、${wlp.user.dir}${wlp.install.dir}/usr に設定されます。

  • WLP_OUTPUT_DIR

    この環境変数は、ログ、workarea ディレクトリー、および生成されたファイルなどの、サーバーが生成した出力の代替ロケーションを指定するために使用できます。logs ディレクトリー内のファイルには、console.logmessages.log、およびすべての生成された FFDC ファイルを含めることができます。生成されたファイルには、server dump コマンドまたは server javadump コマンドを使用して作成されるサーバー・ダンプを含めることができます。この変数は、絶対パスでなければなりません。この環境変数が指定された場合、${server.output.dir} は、WLP_OUTPUT_DIR/serverName と等価になるように設定されます。この環境変数が指定されない場合、${server.output.dir}${server.config.dir} と同じです。

    サーバー・コマンドが使用される場合、サーバー・プロセスは出力ディレクトリーを現行作業ディレクトリーとして使用します。

  • For z/OS platformsWLP_ZOS_PROCEDURE

    この環境変数を使用して、UNIX System Services バックグラウンド・プロセスではなく、z/OS® 開始タスクとしてサーバーを始動するために使用する STC プロシージャーの名前を指定します。デフォルトでは、コマンド・ポートは有効のままになり、サーバー・スクリプトからのサーバーの継続した管理が可能になります。 オプションで、コマンド・ポートを手動で無効にして、サーバー管理を z/OS オペレーター・コンソールに限定することも可能です。 『Liberty のブートストラップ・プロパティーの指定』を参照してください。

  • For z/OS platforms

    WLP_ZOS_JOBNAME

    WLP_ZOS_PROCEDURE 変数に加えてこの環境変数を使用して、z/OS 開始タスクとして始動された Liberty サーバーのジョブ名を指定できます。

  • WLP_DEBUG_ADDRESS

    この環境変数を使用して、デバッグ・モードでサーバーを実行する場合の代替ポートを指定できます。デフォルト値は 7777 です。Liberty がサーバー・コマンドからデバッグ・モードで実行される場合は、次の値が設定されます。 JAVA_DEBUG="-Dwas.debug.mode=true -Dcom.ibm.websphere.ras.inject.at.transform=true -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=${WLP_DEBUG_ADDRESS}" ただし、実行可能 JAR ファイル ws-server.jar、または組み込み Liberty サーバー SPI から Liberty を実行する場合は、 同じ設定を使用して、Liberty のデバッグ・モードを有効にする必要があります。

server.env ファイルに WLP_OUTPUT_DIRWLP_USER_DIRWLP_DEBUG_ADDRESS の各環境変数を指定できます。また、jvm.options ファイルで JVM オプションを指定することもできます。server.env ファイルと jvm.options ファイルは両方とも、サーバー管理スクリプトを使用した場合にのみ機能します。ws-server.jar 実行可能 JAR ファイルを使用してサーバーを起動する場合、これらのファイルはサポートされません。

手順

次のタスク

サーバー・スクリプトを使用して Liberty サーバーを開始する場合、現行セッションからのすべてのオペレーティング・システム環境変数が使用可能です。MBean または Admin Center を使用してサーバーを開始する場合、使用可能な環境変数は、そのシステム上で実行されるリモート・コマンドに使用可能な環境変数のみです。


トピックのタイプを示すアイコン タスク・トピック

ファイル名: twlp_admin_customvars.html