table of contents
IPMCTL-CHANGE-DEVICE-PASSPHRASE(1) | ipmctl | IPMCTL-CHANGE-DEVICE-PASSPHRASE(1) |
NAME¶
ipmctl-change-device-passphrase - Changes the security passphrase on DCPMM on supported OS
SYNOPSIS¶
ipmctl set [OPTIONS] -dimm [TARGETS] Passphrase=(string) NewPassphrase=(string) ConfirmPassphrase=(string)
DESCRIPTION¶
Changes the security passphrase on one or more DCPMMs.
Note
This command is subject to OS Vendor (OSV) support. It will return "Not Supported."
OPTIONS¶
-h, -help
-ddrt
-smbus
Note
The -ddrt and -smbus options are mutually exclusive and may not be used together.
-master
-default
-source (path)
Note
The file does not need to contain the ConfirmPassphrase property
TARGETS¶
-dimm [DimmIDs]
PROPERTIES¶
Passphrase
NewPassphrase
ConfirmPassphrase
EXAMPLES¶
Changes the passphrase from mypassphrase to mynewpassphrase on all DCPMMs.
ipmctl set -dimm Passphrase=mypassphrase NewPassphrase=mynewpassphrase
ConfirmPassphrase=mynewpassphrase
Changes the passphrase on all DCPMMs by having the CLI prompt for the current and new passphrases.
ipmctl set -dimm Passphrase="" NewPassphrase="" ConfirmPassphrase=""
Changes the passphrase on all DCPMMs by supplying the current and new passphrases from the specified file. In this example, the format of the file would be:
#ascii
Passphrase=myOldPassphrase
NewPassphrase=myNewPassphrase
ipmctl set -source passphrase.file -dimm Passphrase="" NewPassphrase="" ConfirmPassphrase=""
Changes the default master passphrase to masterpassphrase on all DCPMMs.
ipmctl set -master -default -dimm NewPassphrase=masterpassphrase ConfirmPassphrase= masterpassphrase
Changes the master passphrase from masterpassphrase to newmasterpassphrase on all DCPMMs.
ipmctl set -master -dimm Passphrase=masterpassphrase NewPassphrase=newmasterpassphrase ConfirmPassphrase=newmasterpassphrase
LIMITATIONS¶
In order to successfully execute this command:
Command is subject to OS Vendor (OSV) support. If OSV does not provide support, command will return "Not Supported."
RETURN DATA¶
If empty strings are provided for the passphrase properties and the source option is not included, the user will be prompted (once for all DCPMM) to enter the current passphrase, then again for the new passphrase and then again to confirm the new passphrase as described below. The passphrase characters are hidden.
Current passphrase: ****
For each DIMM, the CLI will indicate the status of the passphrase change operation. If a failure occurs when updating the passphrase on multiple DCPMMs, the process will exit and not continue updating the remaining DCPMMs.
SAMPLE OUTPUT¶
Change passphrase on DIMM (DimmID): Success
Change passphrase on DIMM (DimmID): Error (Code)-(Description)
2019-12-15 | ipmctl |