Home >

LunaCM Command Reference Guide > LunaCM Commands > partition

partition

Access the partition-level commands.

Note:  The partition command with no options shows the partition commands available to be used in the current slot.

The availability of partition commands changes according to four possible scenarios:

- the current slot is the HSM administrative partition for an HSM with firmware version 6.22.0 or newer  

- the current slot is an application partition that has its own SO (a PPSO partition), on an HSM with firmware version 6.22.0 or newer  

- the current slot is a separate-but-not-independent application partition that is administered by the HSM SO, and does not have its own separate SO (a legacy-style partition) on an HSM with firmware version 6.22.0 or newer  

- the current slot is the HSM administrative partition and application partition for an HSM with firmware older than version 6.22.0 (a true legacy partition).

No single partition type has access to all the possible partition commands within lunacm.

Syntax of partition command on HSM admin partition, f/w 6.22.0  

(These are the commands that you see if the current-slot partition is the initialized HSM's administrative partition, while the HSM is at firmware version 6.22.0 or newer. Some of these commands act on the current-slot partition; some have a -slot option to direct their action to another partition/slot.)

partition

archive
changepolicy
clear
clone
contents
create
createchallenge
delete
resetpw
resize
restoresim3file
setlegacydomain
showinfo
showmechanism
showpolicies

Parameter Shortcut Description
archive ar > Partition archive management commands. See "partition archive".  
changepolicy changepo Change the Partition Policy value. See "partition changepolicy"
clear clr Delete all of the user's token objects. See "partition clear".  
clone clo Clone user objects. See "partition clone".  
contents con Show the contents of the application partition. See "partition contents".  
create crp Create the application partition. See "partition create".  
createchallenge crc Create the user challenge. See "partition createchallenge".  
delete del Delete an application partition. See saw.  
resetpw rp Reset the partition password. See "partition resetpw".  
resize res Re-size an application partition. See "partition resize".   
restoresim3 rsim3f Restore user objects (using SIM3). See "partition restoresim3".  
setlegacydomain sld Set the legacy domain. "partition setlegacydomain".  
showinfo si Display partition information. See "partition showinfo".  
showmechanism showm Show all available mechanisms. See "partition showpolicies".  
showpolicies sp Get partition policy information. See "partition showpolicies".  

 

Syntax of partition command on PPSO application partition (f/w 6.22.0 or newer)  

(Same as for legacy-style partition, later on this page, except that this version of the partition command set does include an init command for the PPSO application partition. These are the commands that you see if the current-slot application partition was created using the "-slot" option while the HSM was at firmware version 6.22.0 or newer.)

partition

archive
changepolicy
clear
clone
contents
init
restoresim3
setlegacydomain
showinfo
showmechanism
showpolicies

Parameter Shortcut Description
archive ar > Partition archive management commands.See "partition archive".
changepolicy changepo Change the Partition Policy value. See "partition changepolicy"
clear clr Delete all of the user's token objects. See "partition clear".
clone clo Clone user objects. See "partition clone".
contents con Show the contents of the user partition. See "partition contents".
init in Initialize an application partition. See "partition init".  
restoresim3 rsim3 Restore user objects (using SIM3). See "partition restoresim3".
setlegacydomain sld Set the legacy domain. "partition setlegacydomain".
showinfo si Display partition information. See "partition showinfo".
showmechanism showm Show all available mechanisms. See "partition showpolicies".
showpolicies sp Get partition policy information. See "partition showpolicies".

 

Syntax of partition command on legacy application partition (f/w 6.22.0 or newer)  

(Same as for PPSO partition, above, except there is no partition init command for the legacy application partition. These are the commands that you see if the current-slot application partition was created using the "-label" option while the HSM was at firmware version 6.22.0 or newer.)

partition

archive
changepolicy
clear
clone
contents
createchallenge
restoresim3
setlegacydomain
showinfo
showmechanism
showpolicies

Parameter Shortcut Description
archive ar > Partition archive management commands. See "partition archive".
changepolicy changepo Change the Partition Policy value. See "partition changepolicy"
clear clr Delete all of the user's token objects. See "partition clear".
clone clo Clone user objects. See "partition clone".
contents con Show the contents of the user partition. See "partition contents".
createchallenge crc  
restoresim3 rsim3 Restore user objects (using SIM3). See "partition restoresim3".
setlegacydomain sld Set the legacy domain. "partition setlegacydomain".
showinfo si Display partition information. See "partition showinfo".
showmechanism showm Show all available mechanisms. See "partition showpolicies".
showpolicies sp Get partition policy information. See "partition showpolicies".

 

Syntax of partition command on HSM admin and application partition (f/w pre-6.22.0)  

(These are the commands that you see if the current-slot partition is the initialized HSM's administrative partition, while the HSM is at firmware version older than 6.22.0. )

partition  

archive  
changepolicy   
changepw   
clear   
clone
contents   
create   
login   
logout   
recoveryinit   
recoverylogin   
resetpw   
restoreSIM2
restoreSIM3
setlegacydomain   
showinfo   
showmechanism  
showpolicies  

Parameter Shortcut Description
archive ar > Partition archive management commands. See "partition archive".  
changepolicy changepo Change the Partition Policy value. See "partition changepolicy"
changepw changepw Change the partition password. See "partition changepw".
clear clr Delete all of the user's token objects. See "partition clear".
clone clo Clones user objects. See "partition clone".   
contents con Show the contents of the user partition. See "partition contents".
create f Create the user partition. See "partition create".
login logi Login to the HSM as user. See "partition login".
logout logo Logout from the HSM as user. See "partition logout".
recoveryinit ri Setup/configure User for "Recovery Login" (formerly "HA Init", not related to load balancing). See "partition recoveryinit".
recoverylogin rl Login as the User using "Recovery Login" (formerly "HA Login", not related to load balancing). See "partition recoverylogin".
resetpw resetpw Reset the partition password. See "partition resetpw".
restoresim2 rsim2 Restore user objects (using SIM2). See "partition restoresim2".
restoresim3 rsim3 Restore user objects (using SIM3). See "partition restoresim3".
setlegacydomain sld Set the legacy domain. "partition setlegacydomain".
showinfo si Display partition information. See "partition showinfo".
showmechanism showm Show all available mechanisms. See "partition showpolicies".
showpolicies sp Get partition policy information. See "partition showpolicies".