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 (meaning, this is 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 (meaning, this is 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
changeLabel
changePolicy
clear
clone
contents
create
createchallenge
delete
policyTemplateChange
policyTemplateCreate
policyTemplateDelete
policyTemplateList
policyTemplateLoad
policyTemplateSave
policyTemplateShow
resetpw
resize
restoresim3file
setlegacydomain
showinfo
showmechanism
showpolicies

Parameter Shortcut Description
archive ar > Partition archive management commands. See partition archive.  
changeLabel changeL Change the Partition Label of a PPSO partition. See partition changelabel
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 partition delete.  
policyTemplateChange tch Modify policy settings. See partition policyTemplateChange  .
policyTemplateCreate tcr Create partition policy template . See partition policyTemplatecreate   .
policyTemplateDelete td Delete partition policy template . See partition policyTemplateDelete   .
policyTemplateList tli List partition policy templates . See partition policyTemplateList.
policyTemplateLoad tchlo Load partition policy template . See partition policytemplateload  .
policyTemplateSave tsa Save partition policy template . See partition policyTemplateSave  .
policyTemplateShow tsh Show partition policy template . See partition policyTemplateShow  .
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 Scalable Key Storage3). 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 showmechanism .  
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 Scalable Key Storage3). 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 showmechanism .
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 Create the user challenge. See partition createchallenge.  
restoresim3 rsim3 Restore user objects (using Scalable Key Storage3). 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 showmechanism .
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 Scalable Key Storage2). See partition restoresim2.
restoresim3 rsim3 Restore user objects (using Scalable Key Storage3). See partition restoresim3.
setlegacydomain sld Set the legacy domain. See partition setlegacydomain.
showinfo si Display partition information. See partition showinfo.
showmechanism showm Show all available mechanisms. See partition showmechanism .
showpolicies sp Get partition policy information. See partition showpolicies.