| On this page |
TCPを介した要求/応答を使用する軽量メッセージキューサーバー。 Push/Pullメッセージメカニズムを使用し、メッセージはクライアントによってPushされ、他のクライアントによってPullされます。
mqserver.exe [-i ip] [-p port]
[-n max_connections]
[-l log_level] [-c connection_file]
[-g log_file]
[-w port max_connections urlpath]
[-t max_idle_seconds]
[-m max_events]
[-r]
[-s]サンプル ¶
| To... | Do this |
|---|---|
持続型MQ Serverを起動する |
Callback Port を53001、 Relay Port を53000に設定しています。 PDGジョブが使用するポート( Callback Port )はHTTPサーバーポートです。 このようなポートはマシンのファイアーウォールを介してアクセスすることができるので、既にほかのプログラムで選択されている場合があります。 この Callback Port ポートは、ファームマシンからの発信接続、MQ Serverを起動しているマシンへの着信接続に対して開いている必要があります。 同様に、 Relay Port ポートはMQ Serverを起動しているマシンへの着信接続、ジョブ投入マシン(TOPクックを実行するマシン)からの発信接続に対して開いている必要があります。 #!/bin/bash
RELAYPORT=53000
HTTP_CALLBACK_PORT=53001
echo "STARTING MQSERVER with RELAY PORT ${RELAYPORT} and HTTP CALLBACK PORT ${HTTP_CALLBACK_PORT}"
/mnt/hq/houdini_distros/hfs.linux-x86_64/bin/mqserver -s -p ${RELAYPORT} -n 1024 -l 2 -w ${HTTP_CALLBACK_PORT} 1024 result
|
持続型MQ Serverに接続する |
上記のサンプルを実行しているホストが
|
オプション ¶
-iオプションを指定すると、MQ Serverは、それをクライアントエンドポイントのIPアドレスとして使用します。
このオプションを指定しなかった場合または引数に*を指定した場合は、MQ Serverはサーバーに割り当てられているIPを自動的に使用します。
例えば、-i 127.0.0.1。
-pオプションを指定すると、MQ Serverは、指定されたポートで起動されます。
このオプションを指定しなかった場合、プログラムは1番目に利用可能なポートを自動的にスキャンします。
-nオプションには、最大接続数を指定します。
このオプションを指定しなかった場合、最大接続数はデフォルトの1024になります。
-lオプションには、ログレベルを指定します。このログレベルは次のとおりです:
0 - なし, 1 - エラー, 2 - 警告, 3 - すべて。
このオプションを指定しなかった場合、ログレベルは1(エラー)に設定されます。
-cオプションを指定すると、MQ Serverは、指定したパスのファイルに接続の詳細を書き出します。
-gオプションを指定すると、MQ Serverは、stdoutとstderrをリダイレクトさせて、指定したファイルにすべてのログを書き出します。
-wオプションを指定すると、指定したポートと最大接続数とURL相対パスでHTTPサーバーも起動されます。
(例えば、-w 5001 64 report/resultは最大接続数64でhttp://127.0.0.1:5001/report/resultをリッスンします)
-tオプションを指定すると、指定した秒数の間に何もネットワークのアクティビティがなければ、サーバーを自動的にシャットダウンします。
-mオプションを指定すると、ティックあたりのイベントの最大数が、指定した値に設定されます。
デフォルトは50です。
-kオプションを指定すると、サーバーは、指定したファイル内の証明書と秘密鍵でTLSを使用して、クライアントに対して自身を認証するようになります。
PDG_MQ_SERVER_CERT_KEY環境変数を使用してこれを指定することもできます。
-aオプションを指定すると、クライアントが接続するにはTLS認証が必要になります。クライアントは、指定されたCAチェーンを使用して検証されます。
CAチェーンファイル名は、スペースではなくカンマで区切らなければなりません。また、標準の'パターン'構文(例えば、'-a *.pem,dir/extra.pem')を使用することもできます。
PDG_MQ_SERVER_CA_CHAINS環境変数を使用してこれを指定することもできます(ファイルは、Windowsではセミコロン(;)、Mac/Linuxではコロン(:)で区切ってください)。
PDG_MQ_CLIENT_CERT_KEY環境変数に証明書/秘密鍵のファイルパス、(サーバーの証明書に存在する場合)PDG_MQ_CLIENT_SERVER_NAME環境変数にサーバー名をそれぞれ設定することで、クライアントは、tls+tcpプロトコルを使用して接続することができます。
クライアントがサーバーを認証する必要がある場合、PDG_MQ_CLIENT_CA_CHAIN環境変数にそのサーバーの証明書ファイルパスを設定することもできます。
-rオプションを指定すると、MQ Serverは、メッセージを同じ名前のクライアントに送信する際に、Round Robin Load Balancing(均等負荷分散)を使用します。
-sオプションを指定すると、MQ Serverは、持続型サーバー(例えばサービス)として起動します。
つまり、リモートでシャットダウンすることができず、クライアントが接続されていない時にタイムアウトすることもありません。