Home >

LunaSH Command Reference Guide > LunaSH Commands > hsm > hsm setlegacydomain

hsm setlegacydomain

Set the legacy cloning domain on an HSM:

for password-authenticated HSMs, this is the text string that was used as a cloning domain on the legacy token HSM whose contents are to be migrated to the SafeNet Network HSM.

for PED-authenticated HSMs, this is the cloning domain secret on the red PED Key for the legacy PED-authenticated token HSM whose contents are to be migrated to the SafeNet Network HSM.

Your target SafeNet Network HSM has, and retains, whatever modern HSM cloning domain was imprinted (on a red PED Key) when the HSM was initialized. This command takes the domain value from your legacy HSM's red PED Key and associates that with the modern-format domain of the current HSM, to allow the HSM to be the cloning (restore...) recipient of objects from the legacy (token) HSM. The legacy domain associated with your SafeNet Network HSM is attached until the HSM is reinitialized.

Objects from legacy token/HSMs can only be migrated (restored) onto SafeNet Enterprise HSMs configured to use their legacy domain. In other words, you cannot defeat the security provision that prevents cloning of objects across different domains.

As well, you cannot migrate objects from a Password authenticated token/HSM to a PED authenticated SafeNet Network HSM, and you cannot migrate objects from a PED authenticated token/HSM to a Password authenticated SafeNet Network HSM. Again, this is a security provision.

See Legacy Domains and Migrationin the Administration Guide for a description and summary of the possible combinations of source (legacy) tokens/HSMs and target (modern) HSMs and the disposition of token objects from one to the other.

Syntax

hsm setlegacydomain [-domain <domain>]

Parameter Shortcut Description
-domain -d Specifies the Legacy Cloning Domain name. This parameter is required on password-authenticated HSMs. It is ignored on PED-authenticated HSMs, which retreive the legacy domain name from the red PED key.

Example

lunash:> hsm  setLegacyDomain 
 
Luna PED operation required to set legacy cloning domain - use Domain (red) PED Key.
The PED prompts for the legacy red domain PED Key (notice mention of "raw data" in the PED message).
 
Command result: Success!