Update Function
Description
Write an update to a local or remote Sentinel protection key.
Syntax
hasp_status_t HASP_CALLCONV hasp_update (
const char * update_data,
char ** ack_data
)
Parameters
|
|
Update data |
|
|
|
Return Values
HASP_IDENTITY_RATE_LIMIT_EXCEEDED
Usage Notes
hasp_update() applies a V2C or V2CP file to an existing protection key on a local or remote machine.
The Licensing API does not need to be logged in to a Feature on a Sentinel protection key in order to use this function.
hasp_update() can automatically determine where an online detach or cancel license update is applied. For the operation to succeed, the local License Manager must be active and connected to the remote server.
The update code contains all necessary data to perform the update on a deployed Sentinel protection key including:
>The Sentinel protection key on which the updated information is to be written
>The Vendor Code that is required to access the Sentinel protection key
>The actual update information
Depending on the update data, the function returns an
acknowledgement code that is signed/encrypted by the update. The code
is evidence that an update has been applied to a license. Free
function.
This function is an extension of the main Sentinel Licensing API and is utilized by the Sentinel RUS utility to update Sentinel LDK licenses.
NOTE When this function is called, a write cycle is performed for the Sentinel protection key. Sentinel HL keys are certified to withstand a specific number of write cycles. For information on the number of write cycles for which Sentinel HL keys are certified, see the Sentinel HL Data Sheet.
High-Availability License Update Installation
In high-availability configurations, hasp_update() applies high-availability license updates (V2C or V2CP files generated by Sentinel EMS) to the quorum. When an administrator applies a high-availability V2C or V2CP file to any single participating License Manager, that License Manager automatically distributes and synchronizes the license across all reachable quorum members via the TCP/UDP Port (default 1947).
If an update is applied to a License Manager that has already received the synchronized license update from a peer License Manager, hasp_update() returns status code 65 (HASP_UPDATE_ALREADY_ADDED). This status confirms that the key update has already been applied.
NOTE You can apply a high-availability license update only to a participating License Manager in the high-availability quorum.