| 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オプションを指定すると、指定した秒数の間に何もネットワークのアクティビティがなければ、サーバーを自動的にシャットダウンします。
If the -m option is provided, then the maximum number of events per tick will be set to the specified value.
The default is 50.
If the -k option is provided, the server will authenticate itself to clients using TLS with the certificate and private key in the file given.
This can also be provided using an environment variable with the name PDG_MQ_SERVER_CERT_KEY.
If the -a option is provided, TLS authentication will be required for clients to connect; clients will be verified using the CA chains given.
CA chain file names must be comma separated without spaces; you can also use standard 'globbing' syntax, ex: '-a *.pem,dir/extra.pem'.
This can also be provided using an environment variable with the name PDG_MQ_SERVER_CA_CHAINS(files should be semicolon separated on windows and colon separated on mac/linux).
Clients can connect using the tls+tcp protocol by setting the environment variables PDG_MQ_CLIENT_CERT_KEY and PDG_MQ_CLIENT_SERVER_NAME to their certificate/private key file path and server name (if present in the server’s certificate) respectively.
The enviroment variable PDG_MQ_CLIENT_CA_CHAIN can also be set to the server’s certificate file path if clients should be required to authenticate the server.
-rオプションを指定すると、MQ Serverは、メッセージを同じ名前のクライアントに送信する際に、Round Robin Load Balancing(均等負荷分散)を使用します。
-sオプションを指定すると、MQ Serverは、持続型サーバー(例えばサービス)として起動します。
つまり、リモートでシャットダウンすることができず、クライアントが接続されていない時にタイムアウトすることもありません。