NAME

monitorlm — monitors MathLM running on a server

SYNOPSIS

monitorlm servername [-file file] [-format f] [-localtime] [-template]

monitorlm servername [-health]

DESCRIPTION

monitorlm gives information on the total number of licenses available and checked out, the fully qualified domain name and username of those who have them checked out, and so on.

EXAMPLES

License Usage Report

Obtain a summary of server status and a detailed listing of in-use licenses in a textual format:

$ monitorlm hostname.domain.com -format text

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

MathLM Version 11.2 
MathLM Server hostname.domain.com 
Date : Thursday, August 29 2017 14: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        11.1            A        username    client1.domain.com    08:49
Mathematica        11.2            A        username    client2.domain.com    06:33
MathKernel        11.1            A        username    client1.domain.com    08:44
MathKernel        11.2            A        username    client2.domain.com    06:52
MathKernel        11.2            A        username    client2.domain.com    06:52
MathKernel        11.2            A        username    client2.domain.com    06:30

Server Health Check

Check the status of a server:

$ monitorlm hostname.domain.com -health

Health check: Server hostname.domain.com is healthy

OPTIONS

-file file — Specify the file to which output should be directed.

-format format — Specify the format for the output of monitorlm.

-health — Perform a health check on the server and exit immediately. Returns an exit code of 0 for a successful health check and 1 otherwise.

-localtime — Specify that all given times should be in local time instead of GMT.

-template file — Specify a file that acts as a template for the output of monitorlm.

DETAILS

If servername is not specified, monitorlm defaults to the local machine.

monitorlm supports both IPv4 and IPv6 environments with no additional configuration required.

Possible formats when using -format are:

	text	send output in text format to stdout
	html	send output in HTML format to a temporary file and launch a web browser to display the file
	cgi	send output in HTML format to stdout (used when called directly from a web browser)

If -health is set, all other options are ignored.