Miscellaneous Utilities

Sentinel RMS provides various utilities for you and your customers.

The following sections provide an overview of these utilities:

>D: Denotes the audience as you (the developer)

>S: Denotes the audience as system administrator (at the customer site responsible for controlling the License Manager).

>E: Denotes the audience as a licensed application end user

NOTE   From Sentinel RMS v9.7 onwards, Linux ARM operating system is supported.

NOTE   The utilities meant for the system administrators and application end users are installed in the \Delivery folder of the Windows installation. You should refer to this section; Before you package your licensed application.

Utility/Category

Description and Installation Location

Audience

More information

 Sentinel RMS Demo

slmdemo

>Graphical sample program to show basic API functions.

>Windows only: ...\Redistributable\Tools

D

--

From RMS v9.5 onwards, slmdemo supports license hard limit up to 4,294,967,294. This is applicable for license version 20 (or above). Further, this high value is applicable only when hard limit is used as a quantity.

 

NOTE   Slmdemo.exe will crash on Windows 10 and Windows Server 2019. This is due to a known issue with the CreateWindow/Ex Windows API on Windows 10 and Windows Server 2019 respectively.

For Locking Code Generation

echoid1,2

>Command-line utility to determine a system’s locking code based on its fingerprint.

>Windows - ...\Redistributable\Tools

>UNIX - .../redistributable/tools

>Linux ARM - .../redistributable/tools

• E - When a locking code of the user system is needed.

• S - When a locking code of the License Manager system is needed.

Refer to the Sentinel RMS SDK System Administrator Help

wechoid

>Graphical utility to determine a system’s locking code based on its fingerprint.

>Windows only: ...\Redistributable\Tools

Same as echoid

Refer to the Sentinel RMS SDK System Administrator Help

echouid1,2

>Command-line utility to generate locking code for upgrade licenses.

>Windows: ..\Redistributable\Tools

>UNIX - .../redistributable/tools

>Linux ARM - .../redistributable/tools

Same as echoid

 

Refer to the Sentinel RMS SDK System Administrator Help or Generating Upgrade Locking Code.

For License Code Generation (not shipped with the SDK)

lscgen

>Command-line utility to generate license codes, including upgrade licenses.

>Windows and Linux

D

Refer to the WlscGen Help and License Generation Using_lscGen

Wlscgen

>Graphical utility to generate license codes, including upgrade licenses.

>Windows only.

D

Refer to the WlscGen Help and License Generation Using_WlscGen

ulscgen

>Command-line utility to generate upgrade licenses.

>Windows and Linux

D

Refer to Generating Upgrade License Codes 

For license distribution and installation

lslic1

>Command-line utility to add/delete license codes dynamically (without stopping and restarting the License Manager).

>Windows - ...\Redistributable\Tools

>UNIX - .../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For commuter licenses

lcommute1

>Command-line utility to check-out and check-in license from a License Manager.

>Windows - ...\Redistributable\Tools

>UNIX - .../redistributable/tools

S/E

Refer to the Sentinel RMS SDK System Administrator Help

WCommute

>Graphical utility to check-out and check-in license from a License Manager.

>Windows only: ..\Redistributable\Tools

S/E

 

Refer to the Sentinel RMS SDK System Administrator Help

rcommute1

>Command-line utility to obtain a commuter locking code for the remote machine and install the remote commuter authorization.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

E

Refer to the Sentinel RMS SDK System Administrator Help

WRCommute

>Graphical utility to obtain a commuter locking code for the remote machine and install the remote commuter authorization.

>Windows only: ..\Redistributable\Tools

E

Refer to the Sentinel RMS SDK System Administrator Help

For License Manager

loadls

>Graphical utility to install/uninstall the License Manager into the system services registry.

>This is installed along with the License Manager.

>Windows only

S

Refer to the Sentinel RMS SDK System Administrator Help

lservnt

>Command-line utility to install, start, stop, and obtain status of the Sentinel RMS License Manager service.

>This is installed along with the License Manager.

>Windows only

S

Refer to the Sentinel RMS SDK System Administrator Help

lsmail

>Command-line utility to set the SMTP server, which will be used by the Sentinel RMS License Manager to send alerts via e-mail.

>This is installed along with the License Manager.

>Windows only

S

Refer to the Sentinel RMS SDK System Administrator Help

lsrvdown1,2

>Command-line utility to stop the License Manager.

>Windows: This is installed along with the License Manager.

>UNIX: ../redistributable/tools

>Linux ARM: ../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

WlmAdmin

>Graphical utility to add and manage licenses on customer site, plus few other administrator tasks (like, shutting down the License Manager, locating the License Managers in the subnet, and creating reservation file and redundant license file).

>Windows only: ..\Redistributable\Tools

>From RMS v9.5 onwards, WlmAdmin supports license hard limit up to 4,294,967,294. This is applicable for license version 20 (or above). Further, this high value is applicable only when hard limit is used as a quantity.

S

Refer to the Sentinel RMS SDK System Administrator Help

lsmon1,2

>Command-line utility to retrieve information about the licenses installed on a particular License Manager.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

>From RMS v9.5 onwards, lsmon supports license hard limit up to 4,294,967,294. This is applicable for license version 20 (or above). Further, this high value is applicable only when hard limit is used as a quantity.

S

Refer to the Sentinel RMS SDK System Administrator Help

lswhere1,2

>Command-line utility to locate the License Managers in a subnet.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For License Manager redundancy

lspool1

>Command-line utility to view the list of redundant License Managers and perform few other administrator tasks, like adding/removing a License Manager in a redundant License Manager pool.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>From RMS v9.5 onwards, lspool supports license hard limit up to 4,294,967,294. This is applicable for license version 20 (or above). Further, this high value is applicable only when hard limit is used as a quantity.

S

Refer to the Sentinel RMS SDK System Administrator Help

rlftool1

>Command-line utility to create redundant license files (for specifying redundant license configuration)

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

WRlfTool

>Graphical utility to create redundant license configuration file.

>Windows only: ..\Redistributable\Tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For license reservation

Wlsgrmgr

>Graphical utility to generate a group reservation file.

>Windows only: ..\Redistributable\Tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For cleaning and recovery

lscgcln1

>Command-line utility to generate a license for the lsclean utility.

>Windows: ..\VendorTools

>UNIX: ../vendorTools

D

Refer to Persistence Cleaning Workflow Using Utilities

 

lsclean

>Command-line utility to clean up the persistence information on a system.

>Windows and other operating systems

>Windows: ..\VendorTools

>All other platforms (except Linux ARM):
../vendorTools

S

For displaying license code

lsdecode1,2

>Command-line utility to decrypt license codes.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

D

Refer to Decoding (Base) License Codes.

ulsdcod1,2

>Command-line utility to decrypt upgrade license codes.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

D

For standalone system initialization

lsgeninit and lsinitstub

 

>Command-line utilities to generate the lsinit utility for standalone system initialization.

>Windows only: ..\VendorTools

D

Refer to "Using the Lsgeninit Utility"

For displaying the usage log details

lsusage1,2

>Command-line utility to display the License Manager usage log details (on the customer site).

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

vusage2

>Command-line utility to display the License Manager usage log details (on the developer site). It can read and display more details than lsusage.

>Windows: ..\VendorTools

>UNIX: ../vendorTools

>Linux ARM: ../vendorTools

D

Refer to "Displaying Encrypted/Readable License Manager Log File"

1 For Linux and Mac operating systems, we have also provided a 64-bit variant of this utility.
2 For Linux ARM operating system, we have also provided a 64-bit variant of this utility.