-Dcom.ibm.nio.rdma.conf (Linux® のみ)

コマンド行でこのシステム・プロパティーを指定することにより、Java NIO アプリケーション・サーバーおよびクライアント・システムで Java™ Sockets over RDMA (JSOR) を使用可能にすることができます。各ホスト・システムで、有効な構成ファイルが必要です。

注：

以前非推奨であった RDMA 実装は、 IBM® SDK, Java Technology Edition, Version 8 から削除された。サービスリフレッシュ8 フィックスパック30の変更終了について

-Dcom.ibm.nio.rdma.conf=< パス> < config_file>

ここで、

< path> は、構成ファイルへの絶対パス、または Java プロセスが開始されるディレクトリーからの相対パスです。
<config_file>は、1 つ以上のルールを指定する構成ファイルです。

構成ファイル

JSOR 構成ファイルは、1 行ごとに 1 つのルールが含まれるプレーン・テキスト・ファイルである必要があります。コメントは#文字から始めなければなりません。

ルールには以下の構文が適用されます。

<net-spec><sp>(<connect-entry> | <accept-entry> | <bind-entry>)

ここで、

<net-spec> = rdma
<sp>=1*LWSP-char
<connect-entry> = connect <host-spec><sp><port-spec>
<accept-entry> = accept <host-spec><sp><port-spec><sp>(*| any | all | <client-spec>[<sp><client-spec>])
<bind-entry> = bind <host-spec><sp><port-spec>

以下のサブオプションは、<connect-entry>、<accept-entry>または<bind-entry>に適用されます。

<host-spec> = (hostname | ipaddress [/ prefix])
<port-spec> = (* | port)[ - (* | port) ]
<client-spec> = (hostname | ipaddress [/ prefix])

構文には以下の注意点があります。

任意数の線形空白文字(1*LWSP-char) (タブやスペースなど)で<options>を区切ることができます。
大括弧 [] はオプションのテキストを示します。
括弧 () 内の垂直バー文字(|)は、値の選択を示します。値を 1 つだけ選択する必要があります。

サーバー構成の詳細

サーバー構成ファイルに適用されるルール。

サーバー構成ファイルには、<accept-entry>と<bind-entry>パラメーターが含められます。各<accept-entry>は、 <bind-entry>も暗黙的に生成します。
指定された各 hostname または ipaddress は、ホスト上の有効な InfiniBand インターフェース・アドレスである必要があります。
hostname が指定された場合、hostname と InfiniBand インターフェース・アドレスの適切なマッピングが存在する必要があります。これがない場合、デフォルト・ドメイン・ネーム解決によって、InfiniBand アドレスではなくイーサネット・アドレスにマッピングされます。
<accept-entry>:
- <host-spec>と<port-spec> の値は、ローカル・ホストでなければなりません。
- すべての<client-spec> 値はローカル・ホストでなければなりません。
- ローカルの hostname または ipaddress には、NULL または LOOPBACK を指定できます。
<bind-entry>:
- <host-spec>と<port-spec> の値は、ローカル・ホストでなければなりません。
- hostname または ipaddress の値には、NULL または LOOPBACK を指定できます。
NULL または LOOPBACK アドレスは、バインド・プロセス中に InfiniBand インターフェース・アドレスで置き換えられます。
- 構成内の NULL アドレスは、0、0.0、0.0.0、0.0.0.0または::のいずれかです。
- LOOPBACK IP アドレスは 127.0.0.1でなければなりません。
システムは、使用可能な InfiniBand インターフェースの中からインターフェースを選択します。システムに選択されたデフォルト・アドレスをオーバーライドする場合、-Dcom.ibm.nio.rdma.preferredAddressシステム・プロパティーを指定してください。

クライアント構成の詳細

クライアント構成ファイルに適用されるルール。

クライアント構成ファイルは、<connect-entry>と<bind-entry>パラメーターを持つ場合があります。
指定された各 hostname または ipaddress は、ホスト上の有効な InfiniBand インターフェース・アドレスである必要があります。
hostname が指定された場合、hostname と InfiniBand インターフェース・アドレスの適切なマッピングが存在する必要があります。これがない場合、デフォルト・ドメイン・ネーム解決によって、InfiniBand アドレスではなくイーサネット・アドレスにマッピングされます。
<connect-entry>:
- <host-spec>と<port-spec>の値は、リモート・ホストでなければなりません。
- <host-spec> 値はNULLまたはLOCALにすることができます。このアドレスは接続時に優先 RDMA 対応アドレスに置き換えられます。これにより、JSOR クライアントは同一ホスト上の JSOR サーバーに接続できます。
- <port-spec> 値は NULL または LOCALであってはなりません。
<bind-entry>:
- <host-spec> 、の値はローカルホストでなければならない。 <port-spec>
- hostname または ipaddress の値には、NULL または LOOPBACK を指定できます。
- NULL または LOOPBACK アドレスは、バインド・プロセス中に InfiniBand インターフェース・アドレスで置き換えられます。
  - 構成内の NULL アドレスは、0、0.0、0.0.0、0.0.0.0または::のいずれかです。
  - LOOPBACK IP アドレスは 127.0.0.1でなければなりません。
  システムは、使用可能な InfiniBand インターフェースの中からインターフェースを選択します。システムに選択されたデフォルト・アドレスをオーバーライドする場合、-Dcom.ibm.nio.rdma.preferredAddressシステム・プロパティーを指定してください。

例: サーバー構成

この例は、host1のサーバー側構成エントリーを示しています。

# My server configuration
rdma accept host1 2000-3000 host2 host3

このルールは、ポート2000〜3000（両端を含む）でRDMA接続としてリッスンしているサーバーソケット host2とhost3のhost1に受け入れられる接続を構成します。

この場合、各受け入れルールに対応するバインド・ルールが内部的に作成され、ルールに一致するすべてのソケットに対して特定のバインド操作が強制されます。そのため、サーバーではバインド・ルールが不要であり、クライアントでは受け入れルールが不要です。

例: クライアント構成

以下の例は、host2のクライアント・サイド構成エントリーを示しています。

# My client configuration
rdma connect host1 2435

このルールは、host2からポート2435のhost1への接続をRDMA 接続として扱うように構成します。

例: NULL、LOCAL、または LOOPBACK アドレスへのバインド

次の例は、NULL、LOCAL、または LOOPBACK アドレスを使用したバインド・エントリーを示しています。

rdma bind 0 *
rdma bind :: *
rdma bind 127.0.0.1 *

これらのルールは、ローカル・アドレスへのすべてのバインド接続を選択し、RDMA 対応のアドレスにバインドすることを構成します。システムは、使用可能な IB インターフェースの中からインターフェースを選択します。システムに選択されたデフォルト・アドレスをオーバーライドする場合、-Dcom.ibm.nio.rdma.preferredAddressシステム・プロパティーを指定してください。

ローカルipv6 アドレスをオーバーライドするには、::形式を使ってください。