lunareset

The lunareset utility allows you to reset an HSM that has become unresponsive, without having to reboot the host computer. This command does not affect the contents of the HSM.

NOTE   On Linux clients, lunareset is installed in the /usr/safenet/lunaclient/sbin directory.

Syntax

Linux lunareset <dev_path> [-F | --function-level-reset] [-h | --help] [-v | --verbose]
Windows lunareset <dev_path> [-h|--help] [-v| --verbose]

 

Argument(s) Description
-F | --function-level-reset

Perform a function-level reset. This option resets only a specific function running on the card - it does not reset the entire card.

Note: This option is reserved for use in a future release. Use only under the direction of Technical Support.

-h | --help Display usage instructions for the lunareset command.
-v | --verbose Display additional operating information.
<dev_path>

Specify the path to the device you wish to reset, as follows:

>/dev/k7pf<#> - reset the specified Release 7.x Luna PCIe HSM 7 installed in the host computer.

>/dev/viper<#> - reset the specified Release 6.x (or earlier) Luna PCIe HSM 7 installed in the host computer.

>/dev/lunauhd<#> - reset the specified Release 6.x Luna USB HSM connected to the host computer.

>/dev/lunag7<#> - reset the specified Luna USB HSM 7 or Luna Backup HSM 7 connected to the host computer.

NOTE   If you have multiple devices installed in the host computer, you will need to determine the device path before using this command.

Example

LunaCM v7.0.0 - Copyright (c) 2026 Thales Group

        Available HSMs:

        Slot Id ->              5
        Label ->                PCIe7PWD1par1
        Serial Number ->        349297122736
        Model ->                Luna K7
        Firmware Version ->     7.0.3
        Configuration ->        Luna User Partition With SO (PW) Signing With Cloning Mode
        Slot Description ->     User Token Slot

        Slot Id ->              6
        Label ->                PCIe7PWD1
        Serial Number ->        150022
        Model ->                Luna K7
        Firmware Version ->     7.0.3
        Configuration ->        Luna HSM Admin Partition (PW) Signing With Cloning Mode
        Slot Description ->     Admin Token Slot
        HSM Configuration ->    Luna HSM Admin Partition (PW)
        HSM Status ->           L3 Device
               
        Current Slot Id: 0

lunacm:> exit

c:\Program Files\SafeNet\LunaClient> lunareset.exe /dev/k7pf0
lunareset.exe (64-bit) v10.9.2-282. Copyright (c) 2026 Thales Group. All rights reserved

c:\Program Files\SafeNet\LunaClient>