监控 MathLM

什么是 MonitorLM？

MonitorLM 还介绍可用的许可证和已被签出（checked out）的许可证，完全合格的域名以及已经签出的用户名等等. MonitorLM 可以把输出发送到终端，打开一个网页浏览器，或者写入一个文件. MonitorLM 的输出通过一个配置文件自定义. MonitorLM 自动支持 IPv4 和 IPv6 环境.

启动 MonitorLM

若要启动 MonitorLM，把目录更改到 MathLM 安装的地址，并且输入 .\monitorlm servername（在 Windows　上）或者 ./monitorlm servername（在 Linux 或者 Mac OS X 上）. monitorlm 命令的第一个变量指定运行 MathLM 的许可证服务器名称．如果用户没有明确指定一个服务器名称，则选择本地机器名作为默认值.

MonitorLM 命令行选项

以下选项使用 monitorlm 命令可用．指定一个选项的语法为 monitorlm .

monitorlm 命令行选项

如果 -file 没有设置，MonitorLM 将写入 stdout.

-format 中的三个可能输出格式如下：

-format 输出格式

当直接使用网页浏览器启动 MonitorLM 时，使用 cgi 格式.

这里显示 MonitorLM 的输出看起来是什么样子的，当 -format 设为 text.

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

这里显示在一个网页浏览器中 MonitorLM 的输出看起来是什么样子的，当 -format 设为 html.

注意当 -format 设为 cgi，MonitorLM 的输出以 ＨＴＭＬ 格式发送至 stdout. 这里显示当在网页浏览器中显示时，输出看起来是什么样子的.

自定义 MonitorLM 的输出

用户可以通过编辑一个模板文件，自定义从 MonitorLM 得到的输出的内容和格式. 这是一个普通文本文件，它可以包含以下元素类别.

• 常量标签 — 这些标签表示在 MonitorLM 的执行过程中，它是静态的并且与许可证无关，比如当前日期. 这些标签名称的每一个都具有前缀 CONST.

• 变量标签 — 这些标签作为常量标签的包装（wrappers）. 它们对于定义作为级数中的输出的数据是有用的，比如一个当前 MathLM 用户的表格. 它们对于提高模板文件的可读性是有用的. 这些标签名的每一个都具有前缀 VAR.

• 取决于进程的标签 — 这些标签的值取决于哪个 Mathematica 进程正在显示，并且包括数据如进程所有者的用户名和 IP 地址. 每个标签名具有前缀 PROC.

• 重复标签 — 这些标签充当了未知数目的许可证的信息的占位符. 它们是唯一大小没有预定的标签. 只有签出行重复，而对于每个许可证有一个签出行. 这些标签名的每一个都具有前缀 REP.

• 文本包装（Text wrappers）— 这是用户可以用来包装标签的文本，用于演示和格式化.

在模板文件中的每个标签具有形式 %var#，其中

• var 表示一个变量，该变量的值由服务器提供.

• # 是定义特定格式的数字，用以显示变量 var.

除了 %var# 命令，模板文件也可以包括普通文本，比如括号、破折号、引号和任意注释. 该文本可以用来在服务器消息中包含注意和分隔符，用以进行格式化. 包括在该字符串中的所有文本出现在服务器消息中，除了以下两个例外情况：使用 %q 包含双引号（"），以及使用 %% 包含百分号（%）.

预定义常量标签

以下是可用包括在模板文件中的常量标签名的两个表格，以及它们可能格式的数值值.

日期常量标签

以下是 MonitorLM 的日期常量标签.

MonitorLM 日期常量标签

服务器和进程常量标签

以下是 MonitorLM 的服务器和进程常量标签.

MonitorLM 服务器和进程常量标签

可定制的变量标签

以下是 MonitorLM 的可定制的变量标签.

MonitorLM 可定制的变量标签.

注意：在本节中提供的字符串是可能值的例子，而不是默认设置的例子. 若要使用这些标签，用户必须在模板中定义它们.

取决于进程的标签

以下是 MonitorLM　的取决于进程的标签.

MonitorLM 取决于进程的标签.

重复标签

以下是 MonitorLM　的重复标签.

MonitorLM 重复标签

注意：本节中提供的字符串是可能值的实例，而不是默认设置. 若要使用这些标签，用户必须在模板中定义它们.

注意：在模板文件中，构成 MonitorLM 输出的文本包装（wrappers）和标签必须在仅包含关键词 %TEXT 的文本之后，而在该关键词之前和之后没有空格. 自定义变量标签必须在 %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 输出.

%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>

输出的结果具有以下显示的形式.