MathLM の監視

MonitorLM とは？

MonitorLM は使用可能なライセンス数およびチェックアウトされているライセンス数，完全修飾ドメイン名，ライセンスをチェックアウトしているユーザ名等の情報を与える．MonitorLM は出力をターミナルに送ったり，Webのブラウザを開いたり，ファイルに書き込んだりすることができる．MonitorLM の出力は環境設定設定ファイルによってカスタマイズすることができる．MonitorLM は自動的にIPv4およびIPv6の環境をサポートする．

MonitorLM の起動

MonitorLM を起動するためには，MathLM がインストールされている場所にディレクトリを変更し，.\monitorlm servername（Windows），あるいは./monitorlm servername（Linux，Mac OS X）とタイプする．monitorlmコマンドの第1引数には MathLM を起動しているライセンスサーバの名前を指定する．明示的にサーバ名を指定しなかったら，デフォルトでローカルマシン名が選ばれる．

MonitorLM コマンドラインオプション

monitorlmコマンドで使えるオプションには以下のようなものがある．オプションを指定するための文法は，monitorlm である．

monitorlmコマンドラインオプション

-fileが設定されていない場合，MonitorLM はstdoutに書き出す．

以下は-formatで可能な3つの出力形式である．

-format出力形式

MonitorLM がWebブラウザにより直接起動されたらcgi形式が使われる．

-formatをtextにすると MonitorLM の出力は以下のようになる．

Online help is available at
http://reference.wolfram.com/network

MathLM Version 8.0 
MathLM Server hostname.domain.com 
Date : Thursday, October 17 2010 21:11:59 
    
License Usage Summary:

                            License    Total    Total
Program                        Class    in Use    Authorized
------------------------------------------------------

Mathematica                    A        2        20
MathKernel                    A        4        40


Sub Mathematica                A        0        80
Sub MathKernel                A        0        80

Licenses in Use:

                            License
Program            Version        Class    Username    Hostname            Duration
----------------------------------------------------------------------------
Mathematica        7.0            A        username    client1.domain.com    08:49
Mathematica        8.0            A        username    client2.domain.com    06:33
MathKernel        7.0            A        username    client1.domain.com    08:44
MathKernel        8.0            A        username    client2.domain.com    06:52
MathKernel        8.0            A        username    client2.domain.com    06:52
MathKernel        8.0            A        username    client2.domain.com    06:30

-formatをhtmlにしてWebブラウザで見ると，MonitorLM の出力は以下のようになる．

-formatをcgiにすると，MonitorLM の出力はHTML形式でstdoutに送られる点に注意のこと．以下は，出力がWebのブラウザで表示されたところである．

MonitorLM の出力のカスタマイズ

テンプレートファイルを編集することにより，MonitorLM からの出力の内容と形式をカスタマイズすることができる．テンプレートファイルはテキストファイルで，以下のような種類の要素を含むことができる．

• 定数タグ—このタグは，現在の日付のように，MonitorLM の実行中に変化せずライセンスに依存しないデータを表す．このカテゴリのタグの名前はすべてCONSTで始まる．

• 変数タグ—このタグは定数タグのラッパーとして働く．現在の MathLM ユーザの表のように，連続して出力されるデータの形式を定義するのに便利である．テンプレートファイルを読みやすくするという利点もある．このカテゴリのタグの名前はすべてVARで始まる．

• プロセス依存タグ—このタグの値はどの Mathematica プロセスが表示されているかに依存し，プロセス所有者のユーザ名やIPアドレスのようなデータが含まれる．このカテゴリのタグの名前はすべてPROCで始まる．

• 繰返しタグ—このタグは未知数のライセンスに関する情報のためのプレースホルダの役目を果たす．前もってサイズが決められていない唯一のタグである．チェックアウトの行のみが繰り返される．1ライセンスにつきチェックアウトの行は1行のみである．このカテゴリのタグはすべてREPで始まる．

• テキストラッパー—これはユーザが，プレゼンテーションやフォーマット用にタグをラップすることができるテキストである．

テンプレートファイルの各タグには %var# という形式が含まれている．それぞれ以下の意味を持つ．

• var は変数を表し，その値はサーバによって提供される．

• # は変数 var の表示形式を定義する数字である．

%var# コマンドに加え，テンプレートファイルにはカッコ，ダッシュ，クォーテーションマークや任意のコメントのようなテキストを入れることもできる．テキストはフォーマットの目的で，サーバメッセージにコメントやセパレータを入れるために使うことができる．文字列に含まれたテキストはすべて，以下の2つの例外を除いて文字通りサーバメッセージに現れる．2つの例外とは，ダブルクォート(")を使う代りに%qを使うことと，パーセント記号(%)の代りに%%を使うことである．

定義済みの定数タグ

以下はテンプレートファイルに入れることのできるタグ名および可能なファイル形式に対する数値を示した2つの表である．

日付の定数タグ

以下は MonitorLM の日付の定数タグである．

MonitorLM 日付の定数タグ

サーバおよびプロセスの定数タグ

以下は MonitorLM のサーバおよびプロセスの定数タグである．

MonitorLM サーバおよびプロセスの定数タグ

カスタマイズ可能な変数タグ

以下は MonitorLM のカスタマイズ可能な変数タグである．

MonitorLM カスタマイズ可能な変数タグ

注：このセクションで提供する文字列は，デフォルトの設定ではなく可能な値の例である．これらのタグを使うときは，自分のテンプレートで定義しなければならない．

プロセス依存タグ

次は MonitorLM のプロセス依存タグである．

MonitorLM プロセス依存タグ

繰返しタグ

次は MonitorLM の繰返しタグである．

MonitorLM 繰返しタグ

注：このセクションで提供されている文字列は可能な値の例であり，デフォルトの設定ではない．これらのタグを使うためには，自分のテンプレートでそれを定義しなければならない．

注：テンプレートファイルでは，キーワード%TEXT（前後に空白がない）のみが含まれる行の後に，MonitorLM の出力を構成するテキストラッパーとタグを置かなければならない．カスタマイズされた変数タグの定義は%TEXT行の前に置く．カスタマイズされた変数タグがない場合は，%TEXT行がファイルの最初の行になる．

サンプルと動作

これは，許可されたプロセス数，使用可能なプロセス数，使用中のプロセス数を示す簡単なテキストファイルである．この例では変数定義のタグを定義する必要はない．

%TEXT
Time/Date : [%CONST_DATE_T2] [%CONST_DATE_M3 %CONST_DATE_D, %CONST_DATE_Y2]
Front End Processes Authorized: %CONST_TOTAL_FE_AUTHORIZED
Kernel Processes Authorized: %CONST_TOTAL_KE_AUTHORIZED
Front End Processes Available: %CONST_TOTAL_FE_AVAILABLE
Kernel Processes Available: %CONST_TOTAL_KE_AVAILABLE
Front End Processes In Use: %CONST_TOTAL_FE_OUT
Kernel Processes In Use: %CONST_TOTAL_KE_OUT

結果の出力は以下のような形式になる．

Time/Date : [00:05:26] [October 20, 2010]
Front End Processes Authorized: 5
Kernel Processes Authorized: 5
Front End Processes Available: 4
Kernel Processes Available: 4
Front End Processes In Use: 1
Kernel Processes In Use: 1

次はもう少し高度な例である．この例は，使用中のプロセスとカスタマイズされた変数タグもリストしている点を除いては上の例と等しい．

# Begin variable tag definitions
%VAR_MPROCESS = "FE" "KE" "SFE" "SKE"
%VAR_TOTAL_CHECKEDOUT_HEADER = "Slot\t Program\t User\t Host\n"
%REP_GENERAL_CHECKOUT_LINE = "%PROC_SLOTNUM\t %VAR_MPROCESS\t %PROC_USER\t %PROC_HOST\n"

%TEXT
Time/Date : [%CONST_DATE_T2] [%CONST_DATE_M3 %CONST_DATE_D, %CONST_DATE_Y2]
Front End Processes Authorized: %CONST_TOTAL_FE_AUTHORIZED
Kernel Processes Authorized: %CONST_TOTAL_KE_AUTHORIZED
Front End Processes Available: %CONST_TOTAL_FE_AVAILABLE
Kernel Processes Available: %CONST_TOTAL_KE_AVAILABLE
Front End Processes In Use: %CONST_TOTAL_FE_OUT
Kernel Processes In Use: %CONST_TOTAL_KE_OUT 

%VAR_TOTAL_CHECKEDOUT_HEADER
%REP_GENERAL_CHECKOUT_LINE

結果の出力は次のような形式になる．

Time/Date : [00:05:26] [October 20, 2010]
Front End Processes Authorized: 5
Kernel Processes Authorized: 5
Front End Processes Available: 4
Kernel Processes Available: 4
Front End Processes In Use: 1
Kernel Processes In Use: 1

Slot    Program   User       Host
6       FE        username   hostname
1       KE        username   hostname

次はHTML出力の例である．例えば MonitorLM の出力をWebのブラウザで見たいときに便利である．

%VAR_MPROCESS = "FE" "KE" "SFE" "SKE"
%VAR_TOTAL_CHECKEDOUT_HEADER = "<TR><TD><B>Slot</B></TD> <TD><B>Program</B></TD> <TD><B>User</B></TD> <TD><B>FQDN</B></TD> </TR>\n"
%REP_GENERAL_CHECKOUT_LINE = "<TR> <TD>%PROC_SLOTNUM</TD> <TD>%VAR_MPROCESS</TD> <TD>%PROC_USER</TD> <TD>%PROC_FQDN</TD> </TR>\n"

%TEXT
<HTML>
<HEAD> <TITLE> MathLM Status </TITLE> </HEAD>
<BODY>
<TABLE BORDER=1 CELLPADDING=5>
<TR><TD COLSPAN=2><B>MathLM Server</B></TD> <TD COLSPAN=2><B>%CONST_SERVER_FQDN</B></TD> </TR>
<TR><TD COLSPAN=2>Time/Date</TD> <TD COLSPAN=2>[%CONST_DATE_T2] [%CONST_DATE_M3 %CONST_DATE_D, %CONST_DATE_Y2]</TD> </TR>
<TR><TD COLSPAN=2>Authorized</TD> <TD>%CONST_TOTAL_FE_AUTHORIZED</TD> <TD>%CONST_TOTAL_KE_AUTHORIZED</TD></TR>
<TR><TD COLSPAN=2>Available</TD> <TD>%CONST_TOTAL_FE_AVAILABLE</TD> <TD>%CONST_TOTAL_KE_AVAILABLE</TD></TR>
<TR><TD COLSPAN=2>In Use</TD> <TD>%CONST_TOTAL_FE_OUT</TD> <TD>%CONST_TOTAL_KE_OUT</TD></TR>
 
%VAR_TOTAL_CHECKEDOUT_HEADER
%REP_GENERAL_CHECKOUT_LINE

</TABLE>
</BODY>
</HTML>

結果としての出力は次のような形式になる．