Running the Sample Program in Sentinel RMS SDKs (UNIX)

The Sentinel RMS SDKs (UNIX) contain the "sample" program under the <installdir>/samples directory. It is built already and can be used for a quick demonstration of how a license is obtained from the License Manager, renewed, and then finally released.

Step 1 - Checking the License Manager Presence

For running most of the example programs, the RMS License Manager process (lserv) is required. You can check its presence using the following command:

 ./lsmon localhost

This command checks for the License Manager running locally on the same system. You may replace it with the hostname\IP address of an external system in the network where the License Manager is running.

NOTE   You would need to switch to super user (or root) to run the License Manager.

Step 2 - Using the License File

NOTE   The license file is available as a apart of the demo kit which can be obtained from the Technical Support

Run the License Manager using the following command to load network licenses:

./lserv –s LicenseFile

This command will load the network licenses contained in the nlservrc file.

NOTE   For standalone licenses, you just need to ensure that the lservrc is placed along with the executable.

Step 3 - Configuring the License Request

The sample allows configuring the following parameters:

Switch	Description
-f	Compulsory. The feature name of the license to be requested
-l	Compulsory. The time (in seconds) after which requested feature needs to be updated. As a result, the license obtained is renewed until the next update call
-v	Optional. The version of the license to be requested
-s	Optional (default is no-net). Can be localhost, no-net, or the hostname\IP address of the system where the License Manager is running
-t	When requesting a capacity license, specify the team capacity to be requested
-u	When requesting a capacity license, specify the user capacity to be requested
-g1 to -g4	Applicable to capacity license request, the criteria (user name, hostname, X display name, and software vendor defined) on which team -d will be created

One of the demo license loaded on the License Manager is for feature “DOTS”. Here, the following command is used to request this feature:

./sample –f DOTS –l 60 -v 1.0 –s localhost

The LSUpdate API call will be made after every “60” seconds to renew the license obtained. Once the sample has executed the operations, it releases the license and exits.