hasp_transfer Screen
Description
Performs one of the following functions:
> Removes a Sentinel SL key from its host machine and prepares it to be transferred ("rehosted") to a target machine. The protection key must be defined with rehosting allowed.
> Detaches a license for a Product from a Sentinel SL key (on the host machine), according to customizable parameters. Features defined as detachable and memory files that belong to the Product are detached.
> Cancels a detached license from the Sentinel SL key (on the recipient machine), typically before the detached license was due to expire.
NOTE This function supersedes hasp_detach().
You do not need to be logged in to a Feature or Sentinel protection key in order to use this function.
The hasp_transfer
screen contains the following fields:
Scope template |
Select the template that specifies the parameters within which the Licensing API will search for the required data. |
|
Scope |
Displays the search parameters specified in the selected Scope template, in XML format. You can modify the XML code as necessary. Click Check XML Code to validate the XML code in the Scope field. |
|
Action |
Select the action to perform and provide the required information: |
|
Rehost |
Specify the Key ID of the Sentinel protection key to be transferred. |
|
Detach |
Specify the Product ID of the Product license to detach and the duration of the detached license (in seconds). |
|
Network_Detach |
Specify the Product ID of the Product license with concurrency to detach, the number of seats, and the duration of the detached license (in seconds). For more information, see Detaching a License With Concurrency. |
|
Cancel Detach |
Specify the Key ID of the Sentinel protection key to which the detached license was transferred. |
|
Recipient |
Displays information about the recipient machine to which the license will be attached. |
|
Vendor Code |
If you are working online, this field displays an automatically generated list of Vendor Codes. Select the code that you require. If you are not working online, use the browse button to navigate to and select the required Vendor Code file. |
NOTE To best utilize the functionality of Sentinel LDK ToolBox, Thales recommends that you work online.
Select a Scope template and click Manage Templates to display the Scope Template Manager dialog box.
Click Save Template to open the Save Template dialog box. You can overwrite an existing template, or save a modified template with a new name.
Click OK to save, or Cancel to close the dialog box without saving.
Click Load to navigate to and load the file that provides information about the recipient machine to which the license will be attached. The loaded file is displayed in the Recipient field.
You use hasp_get_info (with HASP_RECIPIENT selected in the Format Template) to generate the recipient machine information file. (You can also create the recipient machine information file, in the Diagnostics page in Admin Control Center.)
Click Execute to transfer the function and field definitions to the Sentinel Licensing API. After the function is executed, corresponding values are displayed in the status fields and the executed function call is logged in the API Call History.