'\" t
.\"     Title: ipmctl-run-diagnostic
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.12
.\"      Date: 2021-02-17
.\"    Manual: ipmctl
.\"    Source: ipmctl
.\"  Language: English
.\"
.TH "IPMCTL\-START\-DIAGNOSTIC" "1" "2021-02-17" "ipmctl" "ipmctl"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
ipmctl\-start\-diagnostic \- Starts a diagnostic test
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
ipmctl start [OPTIONS] \-diagnostic [TARGETS]
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
Starts a diagnostic test.
.SH "OPTIONS"
.sp
\-h, \-help
.RS 4
Displays help for the command.
.RE
.sp
\-ddrt
.RS 4
Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.
.RE
.sp
\-smbus
.RS 4
Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
The \-ddrt and \-smbus options are mutually exclusive and may not be used together.
.sp .5v
.RE
.sp
\-lpmb
.RS 4
Used to specify large transport payload size for the current invocation of ipmctl.
.RE
.sp
\-spmb
.RS 4
Used to specify small transport payload size for the current invocation of ipmctl.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
The \-lpmb and \-spmb options are mutually exclusive and may not be used together.
.sp .5v
.RE
.sp
\-o (text|nvmxml), \-output (text|nvmxml)
.RS 4
Changes the output format. One of: "text" (default) or "nvmxml".
.RE
.SH "TARGETS"
.sp
\-diagnostic [Quick|Config|Security|FW]
.RS 4
Start a specific test by supplying its name. All tests are run by default.
One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Quick" \- This test verifies that the PMem module host mailbox is accessible and
that basic health indicators can be read and are currently reporting
acceptable values.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Config" \- This test verifies that the BIOS platform configuration matches
the installed hardware and the platform configuration conform to best known
practices.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Security" \- This test verifies that all PMem modules have a consistent security
state. It is a best practice to enable security on all PMem modules rather than
just some.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"FW" \- This test verifies that all PMem modules of a given model have consistent
FW installed and other FW modifiable attributes are set in accordance with
best practices.
.br
Note that the test does not have a means of verifying that
the installed FW is the optimal version for a given PMem module model just that
it has been consistently applied across the system.
.RE
.RE
.sp
\-dimm [DimmIDS]
.RS 4
Starts a diagnostic test on specific PMem modules by optionally supplying one or more
comma separated PMem module identifiers. The default is to start the specified tests
on all manageable PMem modules. Only valid for the Quick diagnostic test.
.RE
.SH "EXAMPLES"
.sp
Starts all diagnostics.
.sp
.if n .RS 4
.nf
.fam C
ipmctl start \-diagnostic
.fam
.fi
.if n .RE
.sp
Starts the quick check diagnostic on PMem module 0x0001.
.sp
.if n .RS 4
.nf
.fam C
ipmctl start \-diagnostic Quick \-dimm 0x0001
.fam
.fi
.if n .RE
.SH "LIMITATIONS"
.sp
If a PMem module is unmanageable, then Quick test will report the reason, while
Config, Security and FW tests will skip unmanageable PMem modules.
.SH "RETURN DATA"
.sp
Each diagnostic generates one or more log messages. A successful test generates a
single log message per PMem module indicating that no errors were found. A failed test
might generate multiple log messages each highlighting a specific error with all
the relevant details. Each log contains the following information.
.sp
Test
.RS 4
The test name along with overall execution result. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Quick"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Config"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Security"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"FW"
.RE
.RE
.sp
State
.RS 4
The collective result state for each test. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Ok"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Warning"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Failed"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Aborted"
.RE
.RE
.sp
Message
.RS 4
The message indicates the status of the test. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Ok"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Failed"
.RE
.RE
.sp
SubTestName
.RS 4
The subtest name for given Test.
.RE
.TS
allbox tab(:);
lt lt.
T{
.sp
Test Name
T}:T{
.sp
Valid SubTest Names
T}
T{
.sp
Quick
T}:T{
.sp
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Manageability
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Boot status
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Health
.RE
T}
T{
.sp
Config
T}:T{
.sp
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PMem module specs
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Duplicate PMem module
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
System Capability
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Namespace LSA
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PCD
.RE
T}
T{
.sp
Security
T}:T{
.sp
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Encryption status
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Inconsistency
.RE
T}
T{
.sp
FW
T}:T{
.sp
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FW Consistency
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Viral Policy
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Threshold check
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
System Time
.RE
T}
.TE
.sp
.sp
State
.RS 4
The severity of the error for each sub\-test displayed with SubTestName. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Ok"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Warning"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Failed"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Aborted"
.RE
.RE
.sp
Unresolved directive in ipmctl\-start\-diagnostic.txt \- include::ipmctl\-diagnostic\-events.txt[leveloffset=+1]