| Oracle® WebLogic Server SIP Container管理者ガイド 11g リリース1(11.1.1) B61429-02 |
|
 前 |
 次 |
次の項では、Diameterの構成ファイルであるdiameter.xmlへの完全なリファレンスを提供します。
diameter.xmlファイルには、次のようなDiameterノードの属性が構成されています。
Diameterノードのホスト・アイデンティティ
ノードにデプロイされているDiameterアプリケーション
Diameterピア・ノードの接続情報
Diameterメッセージの処理に使用されるルーティング情報とデフォルト・ルート
Diameterプロトコルの実装は起動時に構成ファイルを読み込みます。diameter.xmlはDOMAIN_DIR/config/customサブディレクトリに格納されます。DOMAIN_DIRはOracle WebLogic Server SIP Containerドメインのルート・ディレクトリです。
通常の操作中に、diameter.xmlファイルを移動、変更や削除しません。
手動ではなく管理コンソールの使用で間接的にdiameter.xmlファイルを変更することをお薦めします。管理コンソールを使用してdiameter.xmlドキュメントは常に有効なXMLが含まれていることを保証します。
Oracle WebLogic Server SIP Containerのインストールやアップグレードの場合に、diameter.xmlを手動で表示や編集して問題の構成をトラブルシューティングし、破損したファイルを修復して、または多数のマシンにカスタムDiameterノード構成をロールアウトする必要があります。diameter.xmlを手動で編集する場合に、Diameterノードを再起動して変更を適用する必要があります。
|
注意: 構成ガイドに説明したエンジン層コンテナのプロパティの構成によって、常に管理コンソールでのDiameterノードまたはWLSTユーティリティを使用して実行中のOracle WebLogic Server SIP Containerのデプロイメントを変更します。 |
本番システム上でdiameter.xmlを変更するには、次の手順を実行します。
テキスト・エディタを使用してDOMAIN_DIR/config/custom/diameter.xmlファイルを開きます。DOMAIN_DIRはOracle WebLogic Server SIP Containerドメインのルート・ディレクトリです。
必要に応じてdiameter.xmlファイルを変更します。XML要素の詳細な説明は、C.6項「XML要素の説明」を参照してください。
変更を保存してテキスト・エディタを終了します。
サーバーを再起動して、変更内容を有効にします。
|
注意: 構成ガイドに説明したエンジン層コンテナのプロパティの構成によって、常に管理コンソールでの直径ノードまたはWLSTユーティリティを使用して実行中のOracle WebLogic Server SIP Containerのデプロイメントを変更します。 |
更新後のシステムをテストして、構成を検証します。
XMLスキーマ・ファイル(wcp-diameter.xsd)がWLSS_HOME/server/lib/wlssディレクトリにインストールされているwlssdiameter.jarライブラリ内にバンドルされます。
diameter.xml構成ファイル例の複数のリストは、ネットワーク・リソースの構成のDiameter Shクライアント・ノードとリレー・エージェントの構成を参照してください。
次の項では、diameter.xmlの各XML要素を説明します。
ノード構成が適用されている1つ以上のターゲットOracle WebLogic Server SIP Containerのインスタンスを指定します。ターゲット・サーバーがドメインのconfig.xmlファイルで定義される必要があります。
このDiameterノードのホスト・アイデンティティを指定します。host要素が指定されていない場合に、アイデンティティがローカル・サーバーのホスト名から取得されます。ホスト・アイデンティティはDNS名と一致しない場合がありますので注意してください。
|
注意: 複数のshクライアント・ノードを対象にdiameterサポートを構成する場合は、diameter.xmlファイルのhost要素を省略することをお薦めします。これにより、同じDiameter Webアプリケーションをエンジン層クラスタのすべてのサーバーにデプロイすることができます。その際、各サーバー・インスタンスのホスト名が動的に取得されます。 |
Diameterノードに対応するレルム名を指定します。異なるレルムとリスニング・ポート番号を使用すると、同一ホスト上で複数のDiameterノードを運用することができます。HSS、アプリケーション・サーバー、リレー・エージェントはすべて、レルム名または名前が一致している必要があります。HSSとアプリケーション・サーバーのレルム名は一致していなくてもかまいません。
realm要素を省略した場合、レルム名は、ホスト名が完全修飾名(たとえば、host@oracle.com)である場合、ホスト名のドメイン名部分を使用して導出されます。
DNS名またはIPアドレスを使用してこのDiameterノードのリスニング・アドレスを指定します。アドレスを指定していない場合、ノードはhostアイデンティティをリスニング・アドレスとして使用します。
|
注意: host IDはDiameterノードのDNS名と同じであっても違っていても、どちらでもかまいません。構成エラーを回避するため、address要素と一緒にDNS名またはIPアドレスを明示的に指定することをお薦めします。 |
この要素は、TLS機能を公開するためにスタンドアロン・ノード操作のみに使用されます。
Oracle WebLogic Server SIP Containerでは、サーバー・インスタンス内で実行しているノードのtls-enabled要素が無視されます。そのかわりに、サーバー・インスタンスは、TLSサポートのあるネットワーク・チャネル(Diameterチャネル)を構成している場合、TLSトランスポートは有効と報告されます。ネットワーク・リソースの構成のDiameterプロトコルのネットワーク・チャネルの作成を参照してください。
この要素は、SCTP機能を公開するためのスタンドアロン・ノード操作にのみ使用されます。
Oracle WebLogic Server SIP Containerでは、サーバー・インスタンス内で実行しているノードのsctp-enabled要素が無視されます。そのかわりに、サーバー・インスタンスは、SCTPサポートのあるネットワーク・チャネル(diameter-sctpチャネル)を構成している場合、SCTPトランスポートは有効と報告されます。ネットワーク・リソースの構成のDiameterプロトコルのネットワーク・チャネルの作成を参照してください。
選択したノード上で実行するように特定の直径アプリケーションを構成します。Oracle WebLogic Server SIP Containerには、Diameter Sh、Ro、とRfクライアント、Diameterリレー・エージェントまたはホーム・サブスクライバ・サーバー(HSS)として機能するノードをサポートするアプリケーションが含まれます。HSSのアプリケーションは、開発またはテスト目的でのみ提供されるシミュレータであることに注意してください。
ピアの動的な構成有効または無効にするブール値を指定します。デフォルトでは、動的なピアは無効化されています。動的なピアを有効にするのは、TLSトランスポートを使用する場合のみにします。ピアになるホストを制限するためのアクセス制御メカニズムがないからです。
個々のDiameterピアの接続情報を指定します。ピア・ノードごとに接続情報を設定するか、ノードをピアとして動的に追加することを許可するかの、どちらかを選択することができます。ただし、動的なピアを有効にするのは、TLSトランスポートを使用する場合のみにしてください。なぜなら、動的なピアを有効にすると、ピアになるホストをフィルタしたり制限したりできなくなるからです。
Shクライアント・ノードを構成する場合に、peers要素はシステムにデプロイされた各Diameterリレー・エージェントのピアの定義を含める必要があります。システムはリレー・エージェントを使用していない場合は、システム内のホーム・サブスクライバ・サーバー(HSS)とShクライアント・ノードとして機能する他のすべてのエンジン層ノードのピアのエントリを含める必要があります。
Diameterリレー・エージェント・ノードを構成する場合に、peers要素はピアおよびHSSにアクセスするすべてのDiameterクライアント・ノードのピア・エントリを含める必要があります。
メッセージを解決するためにノードが使用するレルム・ベースのルートを指定します。
Shクライアント・ノードを設定する場合に、システム内にデプロイされた各Diameterリレー・エージェント・ノードへのルートと選択されたリレーへのdefault-routeを指定する必要があります。システムでは、リレー・エージェントを使用していない場合に、HSSへの単一のdefault-routeを設定します。
Diameterリレー・エージェント・ノードを構成する場合に、HSSへの単一のdefault-routeを設定します。
このルートを使用するときのDiameterノードのロールを説明するアクションの種類です。この要素には次の値のいずれかを指定できます。
なし
ローカル
リレー
プロキシ
リダイレクト
