1IPMCTL-CHANGE-DEVICE-PASSPHRASE(1)  ipmctl  IPMCTL-CHANGE-DEVICE-PASSPHRASE(1)
2
3
4

NAME

6       ipmctl-change-device-passphrase - Changes the security passphrase on
7       DCPMM
8
9           Note
10           This command is subject to OS Vendor (OSV) support. It will return
11           "Not Supported."
12

SYNOPSIS

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

DESCRIPTION

18       Changes the security passphrase on one or more DCPMMs.
19

OPTIONS

21       -h, -help
22           Displays help for the command.
23
24       -source (path)
25           File path to a local file containing the new passphrase (1-32
26           characters).
27
28           Note
29           The file does not need to contain the ConfirmPassphrase property
30

TARGETS

32       -dimm (DimmIDs)
33           Changes the passphrase on specific DCPMMs by supplying one or more
34           comma separated DCPMM identifiers. However, this is not recommended
35           as it may put the system in an undesirable state. The default is to
36           change the passphrase on all manageable DCPMMs.
37

PROPERTIES

39       Passphrase
40           The current passphrase (1-32 characters). For better passphrase
41           protection, specify an empty string (e.g., Passphrase="") to be
42           prompted for the current passphrase or to use a file containing the
43           passphrases with the source option.
44
45       NewPassphrase
46           The new passphrase (1-32 characters). For better passphrase
47           protection, specify an empty string (e.g., NewPassphrase="") to be
48           prompted for the passphrase or to use a file containing the
49           passphrase with the source option.
50
51       ConfirmPassphrase
52           Confirmation of the new passphrase (1-32 character and must match
53           NewPassphrase). For better passphrase protection, specify an empty
54           string (e.g., ConfirmPassphrase="") to be prompted for the
55           passphrase or to use a file containing the passphrase with the
56           source option.
57

EXAMPLES

59       Changes the passphrase from mypassphrase to mynewpassphrase on all
60       DCPMMs.
61
62       ipmctl set -dimm Passphrase=mypassphrase NewPassphrase=mynewpassphrase
63        ConfirmPassphrase=mynewpassphrase
64
65       Changes the passphrase on all DCPMMs by having the CLI prompt for the
66       current and new passphrases.
67
68       ipmctl set -dimm Passphrase="" NewPassphrase="" ConfirmPassphrase=""
69
70       Changes the passphrase on all DCPMMs by supplying the current and new
71       passphrases from the specified file. In this example, the format of the
72       file would be:
73
74       #ascii
75       Passphrase=myOldPassphrase
76       NewPassphrase=myNewPassphrase
77
78       ipmctl set -source passphrase.file -dimm Passphrase="" NewPassphrase=""
79       ConfirmPassphrase=""
80

LIMITATIONS

82       The specified DCPMM must be manageable by the host software, have
83       security enabled and not be in the "Unlocked, Frozen", "Disabled,
84       Frozen", or "Exceeded" lock states.
85
86       Command is subject to OS Vendor (OSV) support. If OSV does not provide
87       support, command will return "Not Supported."
88

RETURN DATA

90       If empty strings are provided for the passphrase properties and the
91       source option is not included, the user will be prompted (once for all
92       DCPMM) to enter the current passphrase, then again for the new
93       passphrase and then again to confirm the new passphrase as described
94       below. The passphrase characters are hidden.
95
96       Current passphrase: ****
97
98       For each DIMM, the CLI will indicate the status of the passphrase
99       change operation. If a failure occurs when updating the passphrase on
100       multiple DCPMMs, the process will exit and not continue updating the
101       remaining DCPMMs.
102

SAMPLE OUTPUT

104       Change passphrase on DIMM (DimmID): Success
105       Change passphrase on DIMM (DimmID): Error (Code)-(Description)
106
107
108
109ipmctl                            2019-04-10IPMCTL-CHANGE-DEVICE-PASSPHRASE(1)
Impressum