sscontrol advisor

sscontrol advisor コマンドを使用して、advisor を制御します。

構文

構文図を読む構文図をスキップする
>>-sscontrol--file--+-delete--filename.ext-----------------------------------+-><
                    +-appendload--filename.ext-------------------------------+   
                    +-report-------------------------------------------------+   
                    +-save--filename.ext-------------------------------------+   
                    +-logsize--name--+-port---------+--+-unlimited---------+-+   
                    |                '-cluster@port-'  '-number of records-' |   
                    +-receivetimeout--name--+-port---------+--seconds--------+   
                    |                       '-cluster@port-'                 |   
                    +-report--save--filename.ext-----------------------------+   
                    '-force--newload--filename.ext---------------------------'   

構文図を読む構文図をスキップする
>>-connecttimeout--name--port--sitename@port--seconds----------->

>--interval--name--port--sitename@port--seconds--list----------->

>--loglevel--name--port--sitename@port--level--logsize--name---->

>--port--sitename@port--size | unlimited--bytes----------------->

>--receivetimeout--name--port--sitename@port--seconds--report--->

>--name--port--sitename@port--retries--name--port--------------->

>--sitename@port--numretries--start--name--port----------------->

>--sitename@port--log file--status--name--port--sitename@port--->

>--stop--name--port--sitename@port--timeout--name--port--------->

>--sitename@port--version--name--port--sitename@port--seconds--><

パラメーター

connecttimeout
サーバー (サービス) の特定のポートについて、サーバーへの接続失敗を報告するまでに advisor が待機する時間を設定します。 詳しくは、『サーバーの advisor 接続タイムアウトおよび受信タイムアウト (Advisor connect timeout and receive timeout for servers)』トピックを 参照してください。
  • name

    advisor の名前。 可能な値は、httphttpsftpsipsslsmtpimappop3ldapldapsnntptelnetconnectpingWLM、および WTE です。 カスタマイズされた advisor の名前は xxxx の形式になっています。ここで、ADV_xxxx は、カスタム advisor を実装するクラスの名前です。

  • port

    advisor がモニターしているポートの番号。

  • seconds

    タイムアウトを秒数で表す正整数であり、advisor はサーバーとの接続の失敗を報告するまでに、その秒数だけ待機します。デフォルトは、advisor 間隔に指定された値の 3 倍です。

interval
advisor がサーバーに情報を照会する頻度を設定します。
  • seconds

    サーバーの現在の状況についてサーバーに問い合わせる間隔を秒数で表す正整数。デフォルトは 7 です。

list
現在、manager に情報を提供している advisor のリストを表示します。
loglevel
advisor ログのロギング・レベルを設定します。
  • level
    レベルの数 (0 から 5)。デフォルトは 1 です。この数が大きければ大きいほど、多くの情報が advisor ログに書き込まれます。 指定できる値は以下のとおりです。
    • 0 は「なし」です。
    • 1 は「最小」です。
    • 2 は「基本」です。
    • 3 は「普通」です。
    • 4 は「拡張」です。
    • 5 は「詳細」です。
logsize
advisor ログの最大サイズを設定します。ログ・ファイルに最大サイズを設定すると、ファイルが循環して使用されます。すなわち、ファイルが指定のサイズに達した場合は、それ以降の項目はファイルの先頭から書き込まれて、以前のログ項目を上書きします。ログ・サイズは、現行のログ・サイズよりも小さく設定することはできません。ログ項目にはタイム・スタンプが記録されるので、ログが書き込まれた順番が分かります。ログ・レベルの設定が高いほど、ログ・サイズの選択には注意を要します。これは、高いレベルでログを記録すると、すぐに スペースを使い切ってしまうからです。
  • size | unlimited

    advisor ログ・ファイルの最大サイズ (バイト)。ゼロより大きい正数または unlimited のいずれかを指定できます。 ログ項目のサイズは同じでないので、上書きされる前に、正確に最大サイズにならないことがあります。 デフォルト値は 1 MB です。

receivetimeout
サーバー (サービス) の特定のポートからの受信が失敗したことを報告するまでに advisor が待機する時間を設定します。
  • seconds

    タイムアウトを秒数で表す正整数であり、advisor はサーバーからの受信の失敗を報告するまでに、その秒数だけ待機します。デフォルトは、advisor 間隔に指定された値の 3 倍です。

report
advisor の状態に関する報告書を表示します。
retries
サーバーにダウンのマークを付ける前に行える、advisor による再試行の回数を設定します。
  • numretries

    ゼロ以上の整数。この値は 3 以下にしてください。 retries キーワードが構成されていない場合、デフォルトで再試行の回数はゼロになります。

start
advisor を開始します。各プロトコル用の advisor があります。デフォルトのポートは、以下のとおりです。
表 1. advisor のデフォルトのポート
advisor 名 プロトコル ポート
connect 適用なし ユーザー定義
DB2 プライベート 50000
ftp FTP 21
http HTTP 80
https SSL 443
imap IMAP 143
ldap LDAP 389
nntp NNTP 119
ping PING 適用なし
pop3 POP3 110
sip SIP 5060
smtp SMTP 25
ssl SSL 443
telnet Telnet 23
name

advisor 名。

sitename@port

sitename 値は advisor コマンドでは任意指定ですが、ポート値は必須です。 sitename 値を指定しないと、advisor は使用可能なすべての構成済みサイト名上での実行を開始します。サイト名を指定すると、advisor は指定のサイト名の実行だけを開始します。サイト名を追加するときは、正符号 (+) で区切ります。

  • log file

    管理データのログを記録するファイル名。ログの各レコードにはタイム・スタンプが記されます。

    デフォルト・ファイルは、advisorname_port.log です (例えば、http_80.log など)。ログ・ファイルを保存する ディレクトリーを変更するには、『ログ・ファイル・パスの変更 (Changing the log file paths)』トピックを参照してください。

    各サイト名ごとに 1 つの advisor だけを始動できます。

status
グローバルに設定できる advisor のすべての値の現在の状態と、それらのデフォルトを表示します。
stop
advisor を停止します。
タイムアウト (timeout)
manager が advisor からの情報を有効であると見なす 秒数を設定します。advisor 情報がこのタイムアウト期間を過ぎたものであることを manager が検出すると、advisor がモニターしているポート上のサーバーの重みを判別する際、この情報は使用されません。このタイムアウトの例外は、特定のサーバーがダウンしていることを manager に通知したときです。 manager は、advisor 情報がタイムアウトになった後も、サーバーに関してその情報を使用します。
  • seconds

    秒数を表す正数、または「unlimited」のいずれかを指定します。デフォルト値は、unlimited です。

version
advisor の現行バージョンを表示します。

  • サーバーへの接続の失敗を報告する前に HTTP advisor (ポート 80) が待機する時間 (30 秒) は次のように設定します。
    sscontrol advisor connecttimeout http 80 30
  • FTP advisor (ポート 21) の間隔は次のように 6 秒に設定します。
    sscontrol advisor interval ftp 21 6
  • 現在 manager に情報を提供している advisor のリストを表示するには、以下のように入力します。
    sscontrol advisor list
    このコマンドによって、以下のような出力が生成されます。
    --------------------------------------- 
    | ADVISOR | SITENAME@PORT |  TIMEOUT  |
    ---------------------------------------
    |    http |              80 | unlimited |
    |  ftp    |    21          | unlimited |
    --------------------------------------- 
  • mysite のサイト名において http advisor ログのログ・レベルを 0 に変更してパフォーマンスを向上させるには、以下を入力します。
    sscontrol advisor loglevel http mysite@80 0
  • mysite のサイト名において ftp advisor ログ・サイズを 5000 バイトに変更するには、以下を入力します。
    sscontrol advisor logsize ftp mysite@21 5000
  • サーバーからの受信の失敗を報告するまでに HTTP advisor (ポート 80) が待機する時間 (60 秒) を設定するには、以下のように入力します。
    sscontrol advisor receivetimeout http 80 60
  • ftp advisor (ポート 21) の状態に関する報告書は次のように表示します。
    sscontrol advisor report ftp 21
    このコマンドによって、以下のような出力が生成されます。
    Advisor Report:
    ---------------
    Advisor name ............. http
    Port number .............. 80
    
    sitename ................. mySite
    Server address ........... 9.67.129.230
    Load ..................... 8
  • ftpadv.log ファイルで advisor を開始するには、以下のように入力します。
    sscontrol advisor start ftp 21 ftpadv.log
  • http advisor に関連する値の現在の状況を表示するには、以下のように入力します。
    sscontrol advisor status http 80
    このコマンドにより、以下のような出力が生成されます。
    Advisor Status:
    ---------------
    Interval (seconds) ............ 7
    Timeout (seconds) ............. Unlimited
    Connect timeout (seconds).......21
    Receive timeout (seconds).......21
    Advisor log filename .......... Http_80.log
    Log level ..................... 1
    Maximum log size (bytes) ...... Unlimited
    Number of retries ............. 0
  • ポート 80 で http advisor を停止するには、以下のように入力します。
    sscontrol advisor stop http 80
  • advisor 情報のタイムアウト値を 5 秒に設定するには、以下のように入力します。
    sscontrol advisor timeout ftp 21 5
  • ssl advisor の現行のバージョン番号を調べるには、以下のように入力します。
    sscontrol advisor version ssl 443
Reference topic    

Terms and conditions for information centers | Feedback

Last updated: May 28, 2013 08:30 AM EDT
File name: rcmd_sscontroladvisor.html