IPMCTL User Guide
HomePMDKNDCTLBlog
Version 1.x
Version 1.x
  • IPMCTL User Guide
  • Installing IPMCTL
    • Installing IPMCTL packages on Linux
    • Building and Installing IPMCTL from Source on Linux
    • Installing IPMCTL on Microsoft Windows using the MSI Installer
    • Building and Installing IPMCTL on Microsoft Windows from Source
  • Basic Usage
  • Module Discovery
    • Show System Capabilities
    • Show Socket
    • Show Topology
    • Show Memory Resources
    • Show Device
  • Provisioning
    • Concepts
    • Create Memory Allocation Goal
    • Provision App Direct
    • Provision Memory Mode
    • Provision Mixed Mode
    • Show Memory Allocation Goal
    • Dump Memory Allocation Settings
    • Load Memory Allocation Goal
    • Delete Memory Allocation Goal
  • Security
    • Enable Device Security
    • Change Device Passphrase
    • Change Device Security
    • Erase Device Data
  • Instrumentation
    • Show Sensor
    • Change Sensor Settings
    • Show Device Performance
  • Debug
    • Run Diagnostic
    • Show Error Log
    • Dump Debug Log
    • Show ACPI Tables
    • Show Device Platform Configuration Data
    • Delete Device Platform Configuration Data
    • Inject Error
  • Support and Maintenance
    • Show Events
    • Version and Firmware
Powered by GitBook
On this page
  • Targets
  • Properties
  • Examples
  • Limitations

Was this helpful?

  1. Security

Change Device Passphrase

Changes the security passphrase on one or more persistent memory modules. For better passphrase protection, specify an empty string (e.g., Passphrase="") to be prompted for the current passphrase or to use a file containing the passphrases with the source option.

ipmctl set [OPTIONS] -dimm [TARGETS] Passphrase=(string) NewPassphrase=(string) ConfirmPassphrase=(string)

Targets

  • -dimm (DimmIDs): Changes the passphrase on specific module by supplying one or more comma separated persistent memory module identifiers. However, this is not recommended as it may put the system in an undesirable state. The default is to change the passphrase on all manageable modules.

Properties

  • Passphrase: The current passphrase (1-32 characters).

  • NewPassphrase: The new passphrase (1-32 characters).

  • ConfirmPassphrase: Confirmation of the new passphrase (1-32 character and must match NewPassphrase).

Examples

Change the passphrase from mypassphrase to mynewpassphrase on all modules.

$ ipmctl set -dimm Passphrase=mypassphrase NewPassphrase=mynewpassphrase ConfirmPassphrase=mynewpassphrase

Change the passphrase on all modules by having the CLI prompt for the current and new passphrases.

$ ipmctl set -dimm Passphrase="" NewPassphrase="" ConfirmPassphrase=""

Change the passphrase on all modules by supplying the current and new passphrases from the specified file.

$ ipmctl set -source passphrase.file -dimm Passphrase="" NewPassphrase="" ConfirmPassphrase=""

In the previous example, the format of the file would be:

#ascii
Passphrase=myOldPassphrase
NewPassphrase=myNewPassphrase

Limitations

  • The specified module must be manageable by the host software, have security enabled and not be in the "Unlocked, Frozen", "Disabled, Frozen", or "Exceeded" lock states.

  • Command is subject to OS Vendor (OSV) support. If OSV does not provide support, command will return "Not Supported."

PreviousEnable Device SecurityNextChange Device Security

Last updated 5 years ago

Was this helpful?