Hitachi

Cosminexus V11 アプリケーションサーバ 運用管理ポータル操作ガイド


10.8.1 J2EEサーバの基本設定

[J2EEサーバの基本設定]画面を次の図に示します。

図10‒12 [J2EEサーバの基本設定]画面(1/2)

[図データ]

図10‒13 [J2EEサーバの基本設定]画面(2/2)

[図データ]

〈この項の構成〉

(1) 機能概要

J2EEサーバを稼働させるための基本的な情報を設定します。

(2) 表示手順

  1. 運用管理ポータルで[論理サーバの環境設定]アンカーをクリックします。

  2. 次のどちらか一方の操作をします。

    J2EEサーバの場合

    [サーバビュー]タブ−[論理J2EEサーバ]−[J2EEサーバ]−[<J2EEサーバ名>]をクリックします。

    J2EEサーバクラスタの場合

    [サーバビュー]タブ−[論理J2EEサーバ]−[J2EEサーバクラスタ]−[<J2EEサーバクラスタ名>]−[<J2EEサーバ名>]をクリックします。

  3. [基本設定]タブをクリックします。

(3) 操作手順

画面での操作手順を次に示します。

  1. コンテナやネーミングサービスなどの基本的な情報を指定します。

  2. [適用]ボタンをクリックします。

    指定した情報が反映されます。

    エラーが表示された場合は,エラーの内容を確認して[戻る]アンカーをクリックします。指定した内容を見直し,再度[適用]ボタンをクリックします。

起動コマンドオプションは,J2EEサーバの起動時に使用されます。

(4) 画面詳細

画面に表示される項目およびボタンについて説明します。

コンテナの設定
互換モード

J2EEサーバの互換モードを表示します。デフォルトは,「-」です。この値は変更できません。

  • -

    互換モードを使用しません。

  • V9

    V9互換モードを表示します。

動作モード

動作モードは「1.4」から変更しないでください。

管理用サーバのポート番号

管理用サーバのポート(usrconf.propertiesファイルのejbserver.http.portキー)を指定します。デフォルトは,「28008」です。

http/ajp13のポート番号

次のどれかを選択し,ポート番号を1〜65535の整数で指定します。

  • NIO HTTP

    NIO HTTPサーバを使用する場合のポート番号(usrconf.propertiesファイルのwebserver.connector.nio_http.portキー)を選択します。デフォルトは,「8008」です。

  • インプロセスHTTP

    インプロセスHTTPサーバを使用する場合のポート番号(usrconf.propertiesファイルのwebserver.connector.inprocess_http.portキー)を選択します。デフォルトは,「80」です。

  • ajp13

    Webサーバのリダイレクタと接続する場合のポート番号(usrconf.propertiesファイルのwebserver.connector.inprocess_http.portキー)を選択します。デフォルトは,「8007」です。

V9互換モードではインプロセスHTTPおよびajp13を選択できます。V9互換モード以外ではNIO HTTPだけ選択できます。

httpsのポート番号

Webサーバが使用しているHTTPSのポート番号(usrconf.propertiesファイルのwebserver.connector.redirect_https.portキー)を指定します。この指定がない場合,HTTPSポートにリダイレクトしません。なお,この指定は,V9互換モードでリダイレクタによるWebサーバ連携使用時にだけ有効になります。

RMIレジストリの設定
ポート番号

J2EEサーバが利用するRMIレジストリのポート番号(usrconf.propertiesファイルのejbserver.rmi.naming.portキー)を1〜65535の整数で指定します。デフォルトは「23152」です。

利用するネーミングサービスの設定
プロトコル

J2EEサーバが利用するネーミングサービスへのアクセスプロトコル(usrconf.propertiesファイルのejbserver.naming.protocolキー)が表示されます。このバージョンでは,「corbaname」が表示されます(変更できません)。

利用するネーミングサービス

利用するネーミングサービス(usrconf.propertiesファイルのejbserver.naming.startupModeキー,ejbserver.naming.hostキー,ejbserver.naming.portキー,ejbserver.naming.startupWaitTimeキー)を選択します。「インプロセス」および「運用管理ドメインの構成定義」で定義したネーミングサービスが表示されます。デフォルトは,「インプロセス」です。

「インプロセス」を選択した場合は,J2EEサーバ内のネーミングサービスが利用されます。

「インプロセス」以外のネーミングサービスを選択した場合は,選択された「運用管理ドメインの構成定義」で定義したネーミングサービスが利用されます。また,ejbserver.naming.startupModeには「manual」が,ejbserver.naming.startupWaitTimeには「0」が設定されます。

インプロセス用のポート番号(必須)

「利用するネーミングサービス」で「インプロセス」を選択した場合に使用するポート番号(usrconf.propertiesファイルのejbserver.naming.portキー)を1〜65535の整数で指定します。デフォルトは,「900」です。

「利用するネーミングサービス」で「インプロセス」以外を選択した場合,ここでの指定は無視されます。ただし,ここでの指定内容は保存されます。

利用する論理サーバの設定
利用するパフォーマンストレーサ(必須)

利用するパフォーマンストレーサ(usrconf.propertiesファイルのejbserver.server.prf.PRFIDキー)を選択します。

利用するスマートエージェント

利用するスマートエージェント(usrconf.propertiesファイルのvbroker.agent.portキー)を選択します。デフォルトは,「設定しない」です。

なお,次のどちらかの場合は「利用するスマートエージェント」を指定する必要があります。

  • 「接続するCTM」を指定した場合

  • 「ライトトランザクション機能」に無効を指定した場合

接続するCTM

J2EEサーバで利用するCTM(usrconf.propertiesファイルのejbserver.ctm.enabledキー,ejbserver.ctm.CTMDomainキー,ejbserver.ctm.CTMIDキー)を選択します。「設定しない」およびJ2EEサーバと同じホストに定義されているCTMが表示されます。デフォルトは,「設定しない」です。「設定しない」を選択した場合は,CTMは利用されません。

トランザクションに関する設定
ライトトランザクション機能

ライトトランザクション機能を有効にするか無効にするか(usrconf.propertiesファイルのejbserver.distributedtx.XATransaction.enabledキー)を選択します。デフォルトは,「有効」です。「有効」を選択した場合は,XAリソースがあるとJ2EEサーバ起動時にエラーとなります。

JTAリカバリの固定ポート番号

JTAリカバリを実行するために使用する固定ポート番号(usrconf.propertiesファイルのejbserver.distributedtx.recovery.portキー)を指定します。デフォルトは,「20302」です。同一マシン内でライトトランザクション機能が無効のJ2EEサーバを複数起動する場合,このポートが重複しないようにする必要があります。ここで指定したポートの割り当てができない場合,J2EEサーバは起動されません。

運用監視エージェントの設定
運用監視

J2EEサーバの監視(メトリックの参照)をするかどうか(usrconf.propertiesファイルのejbserver.instrumentation.enabledキー)を指定します。デフォルトは,「する」です。

  • する

    「論理サーバの運用監視」機能でJ2EEサーバのメトリックを参照できます。

  • しない

    「論理サーバの運用監視」機能でJ2EEサーバのメトリックを参照できません。また,「論理サーバのアプリケーション管理」機能,mngsvrutilコマンドのサブコマンドlistで,J2EEアプリケーションやJ2EEリソースのステータスを確認できません。

Managementイベント発行機能の設定
Managementイベントの発行

Managementイベントを発行するかどうか(usrconf.propertiesファイルのejbserver.manager.agent.MEventAgent.enabledキー)を指定します。デフォルトは「する」です。

  • する

    J2EEサーバからManagement ServerにManagementイベントを発行します。「する」を指定した場合,ejbserver.manager.agent.MEventAgent.confキーには「<Application Serverのインストールディレクトリ>/manager/config/mevent.<実サーバ名>.properties」が設定されます。

  • しない

    J2EEサーバからManagementイベントを発行しません。

起動オプションの設定
セキュリティマネージャの使用

セキュリティマネージャを使用するかどうか(cjstartsvコマンドの-nosecurityキー)を指定します。デフォルトは,「する」です。「する」を指定した場合,cjstartsvコマンドに-nosecurityキーは設定されません。

バッチサーバを作成した場合は,デフォルトは「しない」になります。バッチサーバを作成した場合は,この項目を変更しないでください。

統合ユーザ管理に関する設定
JAAS機能(統合ユーザ管理機能)

JAAS機能(統合ユーザ管理機能)を有効にするかどうか(usrconf.propertiesファイルのjava.security.auth.login.configキー,com.cosminexus.admin.auth.configキー,com.cosminexus.admin.auth.passwordScramble.enableキー)を指定します。デフォルトは,「有効」です。

  • 有効

    JAAS機能が有効となり,統合ユーザ管理機能を使用したアプリケーションが利用できるようになります。

    [JAASのコンフィグレーションファイル],[統合ユーザ管理のコンフィグレーションファイル],および[スクランブル化されたパスワードの複号化機能]に指定した内容が,usrconf.propertiesに配布されます。

  • 無効

    JAAS機能が無効となり,統合ユーザ管理機能を使用したアプリケーションは利用できなくなります。

    java.security.auth.login.configキー,com.cosminexus.admin.auth.configキー,およびcom.cosminexus.admin.auth.passwordScramble.enableキーが,usrconf.propertiesから削除されます。

JAASのコンフィグレーションファイル

JAAS機能(統合ユーザ管理機能)で使用するjaas.conf(JAASのコンフィグレーションファイル)(usrconf.propertiesファイルのjava.security.auth.login.configキー)を指定します。相対パスで指定する場合は,<Application Serverのインストールディレクトリ>/manager/configからのパスが適用されます。デフォルトは,「jaas.conf」です。

統合ユーザ管理のコンフィグレーションファイル

JAAS機能(統合ユーザ管理機能)で使用するua.conf(統合ユーザ管理のコンフィグレーションファイル)(usrconf.propertiesファイルのcom.cosminexus.admin.auth.configキー)を指定します。相対パスで指定する場合は,<Application Serverのインストールディレクトリ>/manager/configからのパスが適用されます。デフォルトは,「ua.conf」です。

スクランブル化されたパスワードの複号化機能

ua.conf(統合ユーザ管理のコンフィグレーションファイル)でスクランブル化されたパスワードを複合化する機能を有効にするかどうか(usrconf.propertiesファイルのcom.cosminexus.admin.auth.passwordScramble.enableキー)を指定します。デフォルトは,「無効」です。

  • 有効

    スクランブル化されたパスワードの複号化機能を有効にします。

  • 無効

    スクランブル化されたパスワードの複号化機能を無効にします。

次の場合は「有効」を指定してください。

  • ua.confでパスワードをスクランブル化している場合

  • uachpwコマンドでパスワードをスクランブル化する場合

JAASのコンフィグレーションファイル以外で指定されたログイン構成は無視

[JAASのコンフィグレーションファイル]に指定したファイル以外で指定されたログイン構成を無視するかどうか(usrconf.propertiesファイルのjava.security.auth.login.configキー)を指定します。デフォルトは,「する(推奨)」です。

  • する(推奨)

    J2EEサーバに,[JAASコンフィグレーションファイル]に指定したファイル以外でログイン構成が指定されていても,その構成は無視されて,jaas.confに指定された構成が有効になります。

    [JAASのコンフィグレーションファイル]に指定したjaas.confは,先頭に\=を付けて配布されます。

    (例)java.security.auth.login.config=\=/temp/jaas.conf

  • しない

    J2EEサーバに指定されているファイルのログイン構成が有効になります。

    [JAASのコンフィグレーションファイル]に指定したjaas.confは,そのまま配布されます。

    (例)java.security.auth.login.config=/temp/jaas.conf

[適用]ボタン

指定した情報を反映します。

[リセット]ボタン

指定した情報をリセットします。起動コマンドオプションは,J2EEサーバの起動時に使用されます。

(5) 注意事項

複数のJ2EEサーバを起動する場合,Webコンテナ提供のリダイレクタと接続するためのポートは,必ず,複数のJ2EEサーバ間で異なる値を指定してください。同じポート番号を指定した場合は,J2EEサーバを起動できません。また,デフォルトのまま使用すると,ポート番号は同じ設定値(8007)になります。このため,複数のJ2EEサーバを起動する場合は,ポート番号にデフォルトを使用しないようにして,必ず設定し直してください。