View Source

The information on this page refers to LM-X v5.5.6 and newer, which introduced the LM-X Reset Client Borrow utility.

Overview

The LM-X Reset Client Borrow utility (lmxresetclientborrow) is a specialized utility within the LM-X License Manager SDK designed to manage issues related to borrowed licenses. This utility helps resolve complications that may arise when licenses are borrowed from a licensing server and retained in the client's borrow store.

This page describes how to use the LM-X Reset Client Borrow utility to help end users maintain optimal functionality and compliance with licensing terms, thereby ensuring the smooth operation of borrowed licenses within their environment.

Purpose

The purpose of the LM-X Reset Client Borrow utility is to provide a mechanism for end users to manage and resolve issues with their borrowed licenses. This utility is crucial for ensuring that licenses which are no longer needed or which have become problematic due to system issues can be reset, thus preventing license hoarding and potential conflicts within the licensing environment.

Usage

Command line options

This utility offers several command-line options to manage and diagnose the status of borrowed licenses, as described in the table below.

Option	Usage
`-v [ --verify ]`	Checks for the presence of borrowed licenses in the client's borrow store and reports them
`-r [ --reset ]`	Clears all borrowed licenses from the client's borrow store
`-h [ --help ]`	Displays usage information and help for the utility

Command line usage examples

Verifying borrowed licenses

To check for any borrowed licenses currently stored by the user, use lmxresetclientborrow as shown in the following example.

$ ./lmxresetclientborrow -verify
LM-X Reset Client Borrow Utility v5.5.6
Copyright (C) 2002-2024 X-Formation. All rights reserved.

Found borrowed licenses for user alice.

Resetting borrowed licenses

To reset and remove all borrowed licenses from the client's store, use lmxresetclientborrow as shown in the following example.

$ ./lmxresetclientborrow -reset 
LM-X Reset Client Borrow Utility v5.5.6
Copyright (C) 2002-2024 X-Formation. All rights reserved.

Successfully reset the client borrow for user alice.

Important considerations

Usage restrictions: It is critical to understand that this utility cannot manipulate licenses on the server side. Its functionality is restricted to the client borrow store.
Borrow license documentation: For more detailed information on how licenses are borrowed and managed, refer to the documentation on license borrowing.
User-specific operations: This utility affects only the borrowed licenses of the user who runs the utility, ensuring that other users' licenses are not inadvertently affected.