You are here: Reference Manual > Client-side Commands (VTL) > vtl backup Client Commands > vtl backup Client Command

Client-Computer Commands (vtl)

vtl backup Client Command

NAME

vtl backup - backup Luna SA partition to slot

SYNOPSIS

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 Luna SA 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 Luna SA partition to a Luna Backup HSM that is connected locally to the Luna SA 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.

SAMPLE OUTPUT

 

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

See Also