RLM Status (rlmstat)

Obtains status from the license servers

Usage:

rlmutil rlmstat [-a] [-f] [-i [isv] ] [-I] [-l [ isv] ] [-n [host] ] [-p [product] ] [-u [user] ][-z password]

rlmstat retrieves status from the license servers and prints it. Control over the status retrieved from rlmstat is specified as follows:

Option	Parameter (meaning if present)	Result
-a	(no parameters)	Print all status from RLM and all ISV servers.
-avail	[-i isv] [-p product] [-b]	Reports free license availability (see below).
-f	“full” license listing	Reports more information about the licenses in use.
-i	Display this ISB only	Display license checkout info from ISVs.
-I	Display isv-defined checkout data	“[I: isv-data]” appended to each user line.
-I	Display this isv only	Display license pooling info from ISVs.
-n	Display licenses from this host only.	Display license checkout info from ISVs.
-p	Display licenses for this product only.	Display license checkout info from ISVs.
-u	Display licenses from this user only.	Display license checkout info from ISVs.
-z	License password.	Supplies password to license server.

Example rlmstat output:

    % rlmutil rlmstat -a 
    rlmstat v9.1 
    Copyright (C) 2006-2011, Reprise Software, Inc. All rights reserved.

    rlm status on bigserver (port 5053), up 00:03:51
    rlm software version v9.1 (build:3)
    rlm comm version: v1.1
    Startup time: Wed Jul 6 13:27:42 2011
    Todays Statistics (00:03:50), init time: Wed Jul 6 13:27:43 2011
    Recent Statistics (00:03:50), init time: Wed Jul 6 13:27:43 2011

                    Recent Stats    Todays Stats    Total Stats
                    00:03:50         00:03:50         00:03:51
    Messages:       9 (0/sec)        9 (0/sec)        9 (0/sec)
    Connections:    7 (0/sec)        7 (0/sec)        7 (0/sec)

    --------- ISV servers ----------
    Name Port Running Restarts
    reprise 62503 Yes 0
    ------------------------

    reprise ISV server status on bigserver (port 62503), up 00:03:49
    reprise software version v9.1 (build: 3)
    reprise comm version: v1.1
    reprise Debug log filename: <stdout>
    reprise Report log filename: <stdout>
    Startup time: Wed Jul 6 13:27:44 2011
    Todays Statistics (00:03:49), init time: Wed Jul 6 13:27:44 2011
    Recent Statistics (00:03:49), init time: Wed Jul 6 13:27:44 2011

                    Recent Stats    Todays Stats    Total Stats
                    00:03:49        00:03:49        00:03:49
    Messages:       17 (0/sec)      17 (0/sec)      17 (0/sec)
    Connections:    6 (0/sec)       6 (0/sec)       6 (0/sec)
    Checkouts:      2 (0/sec)       2 (0/sec)       2 (0/sec)
    Denials:        0 (0/sec)       0 (0/sec)       0 (0/sec)
    Removals:       0 (0/sec)       0 (0/sec)       0 (0/sec)

    ------------------------

    reprise license pool status on bigserver (port 62503)

    test v1.0
            count: 1, # reservations: 0, inuse: 1, exp: 1-jan-0
            obsolete: 0, min_remove: 20, total checkouts: 1
    test2 v1.0
            count: 1, # reservations: 0, inuse: 1, exp: 1-jan-0
            obsolete: 0, min_remove: 20, total checkouts: 1
    test3 v1.0
            count: 100, # reservations: 0, inuse: 0, exp: 1-jan-0
            obsolete: 0, min_remove: 20, total checkouts: 0

    ------------------------

    reprise license usage status on bigserver (port 62503)

    test v1.0: joe@library 1/0 at 07/06 13:27 (handle: 41)
    test2 v1.0: sam@kitchen 1/0 at 07/06 13:28 (handle: 81)

In this output, the first section (before the dashed lines ———) is the status of the RLM server, the next section is the status of the ISV server reprise (there would actually be one section of status for each ISV server if there were more than one running). The next section is the status of the ISV server reprise, each additional ISV server would have it's own status section here.

Also, please note that the expiration date shown in this output is the expiration date of the first license to expire out of all the licenses used to create the license pool in the license server. When more than one license is used to create a single license pool (licenses are combined when all relevant parameters of 2 different licenses match), then only the earliest expiration date is shown. The other license(s) may have any expiration date that has not yet expired. To determine the expiration date of all licenses used to make up a license pool the actual license file must be consulted. Also note that licenses from different license files could be combined to make a single license pool.

Beginning in RLM v14.2, the first line of the product information (“test v1.0” in the example above), will contain the server’s license pool #, and an ID, if specified. So rather than

    test v1.0

it will be something like this:

    test v1.0, pool: 7, id: 60

The meaning of the license usage line:

    test v1.0: joe@library 1/0 at 07/06 13:27 (handle: 41)

is as follows:

test is the product name
v1.0 is the license version (from the license file) for test
joe is the user who is using the license
library is the host on which joe is using the license
(41) is the license handle in the server. This handle is used by the rlmremove command.
1/0 indicates that 1 unreserved and 0 reserved licenses are in use
at 07/06 13:28 is the time the licenses were checked out

And if the optional “-I” switch is specified, the following will be appended to the line, if there is any isv-defined checkout data:

    [I: isv-data]

where “isv_data” is the isv-defined checkout data.

If the -f option is used with rlmstat, additional information about the license usage will be displayed. -f is available in RLM v12.5, and in v12.5, the additional information displayed is the requested version, displayed as such:

    test v1.0 (req: v0.8): joe@library 1/0 at 07/06 13:27 (handle: 41)

rlmstat -avail command

The rlmstat -avail command reports on license availability for a specified license, a specified ISV, or all licenses from all ISVs.

Usage:

    rlmutil rlmstat -avail [-i isv] [-p product] [-b]

If -i isv is specified, only licenses from the selected ISV are displayed. If -p product is specified, only the selected product is displayed. If -b is specified, license availability is combined across license servers.

If you are looking for the availability of a license from a particular ISV, it is more efficient to specify the ISV name in the command. If you do not specify the ISV name, rlmstat must contact the RLM server to request a list of ISV servers, then request information from each ISV server. If you specify the ISV, then only that ISV server is contacted.

Note also that there are situations when you may not be able to check out a license that is listed as available. This can happen if, for example, you are on the EXCLUDE list for a particular product, not on the INCLUDE list, already exceeded your MAX usage, etc.

Conversely, you might be able to check out one that is listed as not available. This could happen if that license is shared and you can share an existing checked-out license, or if one of the reservations for the license is for you (rlmstat -avail lists free available licenses; reservations are not generally available).

Example rlmstat -avail output

    % rlmutil rlmstat -avail -i reprise
    rlmstat v15.1
    Copyright (C) 2006-2011, Reprise Software, Inc. All rights reserved.
    License availability for all products from ISV "reprise"

    server host: telecard (port 5053)
            test1 v1.000 available: 15
            test1 v1.000 hostid: a8c00301 available: 10
            test5 v3.000 hostid: a8c00301 available: 2
            test5 v3.000 available: 10
            test v1.000 available: 10

    server host: spinout (port 5053)
            test1 v1.000 available: 15
            test1 v1.000 hostid: a8c00301 available: 10
            test5 v4.000 hostid: ip=172.16.7.28 available: unlimited
            test5 v2.300 available: 15
            test5 v3.000 hostid: a8c00301 available: unlimited
            test5 v3.000 available: 73

Example rlmstat -avail -b output (same situation as above)

    % rlmutil rlmstat -avail -i reprise -b
    rlmstat v15.1
    Copyright (C) 2006-2011, Reprise Software, Inc. All rights reserved.
    License availability for all products from ISV "reprise"

    ISV: reprise
            test1 v1.000 available: 30
            test1 v1.000 hostid: a8c00301 available: 20
            test5 v3.000 hostid: a8c00301 available: unlimited
            test5 v3.000 available: 83
            test5 v4.000 hostid: ip=172.16.7.28 available: unlimited
            test5 v2.300 available: 15