token backup partition list

Display a list of the partitions on the specified SafeNet Luna Backup HSM. The serial number and name of each partition is displayed. Login as HSM Admin is not needed for execution of this command.

WHEN to USE LunaSH "token backup" commands:  

LunaSH token backup commands operate a SafeNet Luna Backup HSM attached directly to SafeNet Luna Network HSM via USB, and are not intended for use with remotely connected backup devices.
You might have a locally-connected backup HSM (connects directly to a SafeNet Luna Network HSM via USB cable) and a locally connected serial terminal and be walking them from SafeNet Luna Network HSM to SafeNet Luna Network HSM in your server room to perform backups. Or you might be administering remotely via SSH and lunash:> commands, while a technician in your server center carries the backup HSM from one SafeNet Luna Network HSM to the next. In either case, these token backup commands are the method to use. The important distinction is where the backup HSM is physically connected - from the SafeNet Luna Network HSM perspective, those are both local backup operations to a backup HSM that is locally connected to the appliance.

For true, hands-off, lights-out operation of your SafeNet appliances, use a SafeNet Luna Backup HSM located in your administrator's office (or other convenient location), connected to a computer acting as a Remote Backup server (this could be your administrative workstation, or it could be a completely separate computer). This means the computer and Backup HSM are located near you and remote/distant from your SafeNet Luna Network HSM appliance(s). For that application, use the backup commands in the lunacm utility supplied with the SafeNet Luna Network HSM Client software (which must be installed on the computer that is acting as Remote Backup server) - the appliance token backup commands are not designed to work for Remote Backup.

The HSM firmware needs approximately 2K bytes of memory to manage each partition and data objects in it.  To avoid you having to calculate the exact memory space available for data storage -- with you deducting the memory used by internal data structures --the "partition list" command adjusts  the memory size attributes for you.  Thus, the total available memory reported by "partition list" will be different than that reported by "token backup show" and "token backup partition list."

User Privileges

Users with the following privileges can perform this command:

>Admin

>Operator

>Monitor

Syntax

token backup partition list -serial <serialnum>

Argument(s)	Shortcut	Description
-serial <serialnum>	-s	Specifies the serial number of the backup HSM/token.

Example

lunash:>token backup partition list -serial 496771


                                                      Storage (bytes)
                                                ----------------------------
 Partition    Name                     Objects     Total      Used      Free
 ===========================================================================
 496771005  sa78par1backup                   6      9480      9348       132
 496771010  sa78par2backup                  12     18960     18696       264


Command Result : 0 (Success)