Home >

Utilities Reference Guide > VTL > vtl backup

vtl backup

Note:  This command will be deprecated in a future release. It is strongly recommended that you use the lunacm utility to backup your SafeNet Network HSM partitions. See partition archive in the Lunacm Command Reference Guide.

Name

vtl backup - backup SafeNet Network HSM partition to slot

Syntax

vtl backup -source <slot# or label> -p <source password> -target <slot# or label> -partition <backupHSM partitionname> -r <backupHSM SO password> -u <backup partition user password>

Description

This command is used remotely to back up SafeNet Network HSM partition contents to a specified slot or labeled partition on a backup HSM.

See also:

vtl backup append

vtl backup restore

vtl backup delete

vtl backup token

If you use this command without any sub-commands, a partition is created on the backup HSM and the objects on the source HSM slot are cloned to the target partition. Or, if the target partition is found, the objects on the source HSM slot are cloned to the target slot, overwriting any objects already there.

If you wish to preserve objects already on the target partition, then use vtl backup append to add the objects from the source to those already on the target.

If you wish to back up your SafeNet Network HSM partition to a SafeNet Backup HSM that is connected locally to the SafeNet Network HSM appliance, then use the token backup commands instead.  

Options

-source <slot # or label>  [mandatory] The slot number or the label of the source HSM. Do NOT use a numeral as the first character in a slot label. The command looks for a slot number first, and any numeral it sees is interpreted as a slot number.

-p <source password>  source user password, if needed

-target <slot # or label>  [mandatory] The slot number or the label of the target HSM. Do NOT use a numeral as the first character in a slot label. The command looks for a slot number first, and any numeral it sees is interpreted as a slot number.

-partition <backup partition name> [mandatory] The  name of the target partition on the Backup HSM.

-r <backup HSM SO password>  The SO password of the Backup HSM, needed for password-authenticated HSMs only - ignored for PED-authenticated HSMs.

-u <backup HSM User password>  The User password of the Backup HSM partition, needed for password-authenticated HSMs only - ignored for PED-authenticated HSMs.

Example

bash # ./vtl backup -source 5 -target 1 -partition bck1     
Backup partition 'bck1' does not exist on G5backup2. 
*** Are you sure you want to create the new backup? [yes/no]: yes
Luna PED operation required to login to p1 - use User or Partition Owner (black) PED key  
Please enter the secret challenge: userpin  
Luna PED operation required to login to G5backup2 - use Security Officer (blue) PED key  

Luna PED operation required to login to G5backup2 - use User or Partition Owner (black) PED key  
Luna PED operation required to set legacy cloning domain - use Domain (red) PED key.  

Luna PED operation required to login to G5backup2 - use User or Partition Owner (black) PED key  
21 objects found on p1/ (slot #5).  
Cloning object 0 - success 
Cloning object 1 - success
Cloning object 2 - success
Cloning object 3 - success
Cloning object 4 - success
Cloning object 5 - success
Cloning object 6 - success
Cloning object 7 - success
Cloning object 8 - success
Cloning object 9 - success
Cloning object 10 - success
Cloning object 11 - success
Cloning object 12 - success
Cloning object 13 - success
Cloning object 14 - success
Cloning object 15 - success
Cloning object 16 - success
Cloning object 17 - success
Cloning object 18 - success
Cloning object 19 - success
Cloning object 20 - success
21 objects successfully backed up.
bash #.