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