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

>Windows only

>Graphical sample program to show basic API functions.

>...\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 (build number 1709 or 1803) and Windows 2019 (build number 1809) respectively.

For Locking Code Generation

echoid1

>Windows and UNIX

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

>Windows - ...\Redistributable\Tools

>UNIX - .../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’s Help

wechoid

>Windows only.

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

>...\Redistributable\Tools

Same as echoid

Refer to the Sentinel RMS SDK System Administrator’s Help

echouid1

>Windows and UNIX

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

  • >Windows - ...\Redistributable\Tools

  • >UNIX - .../redistributable/tools

    Same as echoid

     

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

    For License Code Generation (not shipped with the SDK)

    lscgen

    >Windows and Linux

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

    D

    Refer to the WlscGen Help and License Generation Using_lscGen

    Wlscgen

    >Windows only.

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

    D

    Refer to the WlscGen Help and License Generation Using_WlscGen

    ulscgen

    >Windows and Linux

    >Command-line utility to generate upgrade licenses.

    D

    Refer to Generating Upgrade License Codes 

    For license distribution and installation

    lslic1

    >Windows and UNIX

    >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’s Help

    For commuter licenses

    lcommute1

    >Windows and UNIX

    >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’s Help

    WCommute

    >Windows only

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

    Windows - ...\Redistributable\Tools

    S/E

     

    Refer to the Sentinel RMS SDK System Administrator’s Help

    rcommute1

    >Windows and UNIX

    >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’s Help

    WRCommute

    >Windows only

    >Graphical 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’s Help

    For License Manager

    loadls

    >Windows only

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

    >This is installed along with the License Manager.

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    lservnt

    >Windows only

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

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    lsmail

    >Windows only

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

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    lsrvdown1

    >Windows and UNIX

    >Command-line utility to stop the License Manager.

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

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    WlmAdmin

    >Windows only

    >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).

    >..\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’s Help

    lsmon1

    >Windows and UNIX.

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

    >Windows: ..\Redistributable\Tools

    >UNIX: ../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’s Help

    lswhere1

    >Windows and UNIX

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

    >Windows: ..\Redistributable\Tools

    >UNIX: ../redistributable/tools

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    For License Manager redundancy

    lspool1

    >Windows and UNIX

    >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’s Help

    rlftool1

    >Windows and UNIX

    >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’s Help

    WRlfTool

    >Windows only

    >Graphical utility to create redundant license configuration file.

    >Windows: ..\Redistributable\Tools

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    For license reservation

    Wlsgrmgr

    >Windows only

    >Graphical utility to generate a group reservation file.

    >Windows: ..\Redistributable\Tools

    S

    Refer to the Sentinel RMS SDK System Administrator’s Help

    For cleaning and recovery

    lscgcln1

    >Windows and UNIX

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

    >Windows: ..\VendorTools

    >UNIX: ../vendorTools

    D

    Refer to Persistence Cleaning Workflow Using Utilities

     

    lsclean

    >Windows and other operating systems

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

    >Windows: ..\VendorTools

    >All other platforms: ../vendorTools

    S

    For displaying license code

    lsdecode1

    >Windows and UNIX

    >Command-line utility to decrypt license codes.

    >Windows: ..\Redistributable\Tools

    >UNIX: ../redistributable/tools

    D

    Refer to Decoding (Base) License Codes.

    ulsdcod1

    >Windows and UNIX

    >Command-line utility to decrypt upgrade license codes.

    >Windows: ..\Redistributable\Tools

    >UNIX: ../redistributable/tools

    D

    For standalone system initialization

    lsgeninit and lsinitstub

     

    >Windows only

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

    >Windows: \VendorTools

    D

    Refer to "Using the Lsgeninit Utility"

    For displaying the usage log details

    lsusage1

    >Windows and UNIX

    >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’s Help

    vusage

    >Windows and UNIX

    >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

    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.