Name

miccheck — A utility to verify the configuration and current status of the Intel(R) Xeon Phi(TM) coprocessor software stack.

Synopsis

miccheck(.py)? [options]

DESCRIPTION

miccheck(1) is a utility which performs sanity checks on a host system with Intel® Xeon Phi™ coprocessors installed, by running a suite of diagnostic tests. By default, a subset of all available tests are run; tests can also be enabled individually. The default behavior is to run all enabled tests on the host system first, and then on all Intel® Xeon Phi™ coprocessors in turn.

There are two forms of the miccheck utility in Linux: (1) is a python program, callable directly as miccheck.py; (2) is a binary program, executable as miccheck. Both versions behave exactly the same and will produce the same output.

OPTIONS

General
-h or --help
Display the help message.
-v or --verbose
Enables verbosity.
-d or --device
Select device on which to run. Example: --device=0. Only one device can be selected.
Host tests available
--pci_numdev
Check whether Intel® Xeon Phi™ coprocessors are detected over PCI. This test is enabled by default.
--driver_loaded
Check whether Intel® Xeon Phi™ driver is loaded. This test is enabled by default.
--driver_numdev
Check whether the device driver detected the same number of devices as PCI enumeration did. This test is enabled by default.
--mpssd_loaded
Check whether MPSS daemon is running. This test is enabled by default.
--driver_ver
Check whether the loaded device driver version is correct. This test is disabled by default.
Device tests available
--dev_state
Check whether device state is online and its postcode is FF. This test is enabled by default.
--dev_rasdaemon
Check whether the network interface of the device can be pinged. This test is enabled by default.
--flash_ver
Check whether the running flash version of the device is correct . This test is enabled by default.
--ping
Check whether the network interface of the device can pinged. This test is disabled by default.
--ssh
Check whether the network interface of the device can be accessed through SSH. This test is disabled by default.

EXAMPLES

Example 1. Normal usage

The following example will run all enabled tests by default.

$ miccheck

Executing default tests for host
  Test 1: Check number of devices the OS sees in the system ... pass
  Test 2: Check mic driver is loaded ... pass
  Test 3: Check number of devices driver sees in the system ... pass
  Test 4: Check mpssd daemon is running ... pass
Executing default tests for device: 0
  Test 5 (mic0): Check device is in online state and its postcode is FF ... pass
  Test 6 (mic0): Check ras daemon is available in device ... pass
  Test 7 (mic0): Check running flash version is correct ... pass
Executing default tests for device: 1
  Test 8 (mic1): Check device is in online state and its postcode is FF ... pass
  Test 9 (mic1): Check ras daemon is available in device ... pass
  Test 10 (mic1): Check running flash version is correct ... pass

Status: OK.

Example 2. Enabling optional tests

$ miccheck --ssh --ping

BUGS

No bugs listed so far.

AUTHOR

miccheck(1) was written by Intel for use with Intel Intel® Xeon Phi™ coprocessors.