micsmc — Provides a GUI to perform many tasks related to Intel(R) Xeon Phi(TM) coprocessors (also known as Many Integrated Core or MIC). The available tasks include retrieving device and driver info, and monitoring device performance, temperatures, and core usage.
Intel® Xeon Phi™ Coprocessor Platform Status Panel (micsmc(1)) is a graphical tool designed to facilitate the administration of Intel® Xeon Phi™ coprocessors (also referred to in this document as MIC devices or MIC cards). micsmc(1) can function in two modes: GUI mode and command-line (CLI) mode. GUI mode provides continuously updated information regarding MIC core utilization, core temperature, memory usage, and power usage statistics. CLI mode produces similar information, but is a one-shot operation which allows for use in scripting applications.
By design, micsmc operates on all cards in the system. GUI mode provides both system-level and per-card views, while CLI mode always operates on all cards.
micsmc(1) can also be used to perform more advanced functions: viewing error logs, monitoring and connecting to MIC devices, viewing/rotating logs, and changing individual card settings such as enabling ECC, power states, and Turbo Modes on K1OM devices.
For more information regarding the usage of micsmc(1), please refer to the Platform Status Panel User Guide, which can be found at "/usr/share/doc/micmgmt" or by running micsmc --help.
micsmc(1) is based in part on the work of the Qwt project (http://qwt.sf.net)
When invoked without arguments, micsmc(1) will run in GUI mode. GUI mode provides real-time monitoring of all detected Intel® Xeon Phi™ coprocessors through a graphical interface. Additionally, micsmc(1) can be invoked in command-line mode using any of the arguments below:
Enables, disables or displays the ECC Mode for all/selected devices.
Enables, disables or displays the Turbo Mode for all/selected devices.
Enables, disables or displays the LED Alert for all/selected devices.
Enables/disables the Power Management Features for all/selected devices.
Sets the sub-process timeout value for the current invocation. Affects only
Example 1. Starting the control panel
The control panel is started in GUI mode by simply running micsmc(1) with no arguments. The system must have a valid X-server. The example below will start micsmc in the background, leaving the terminal available for other operations.
$ micsmc &
Example 2. Displaying memory status for all cards
The micsmc(1) GUI displays Intel® Xeon Phi™ coprocessor card and overall system memory usage continuously. Viewing the coprocessor memory usage via the command-line is shown below.
$ micsmc -m mic0 (mem): Free Memory: ............. 5483.34 MB Total Memory: ............ 5740.85 MB Memory Usage: ............ 257.51 MB
Example 3. Enabling ECC mode
K1OM devices have ECC mode available, which can be statused, enabled, or disabled through the micsmc(1) GUI or command line. Enabling ECC via the command-line is shown below. For enabling ECC via the GUI, see the Platform Status Panel User Guide, located at "/usr/share/doc/micmgmt".
In order to change the status of ECC mode, the devices must be in either the offline or ready state. To place the available devices in the ready state, run the following as the root user:
# micctrl -r # micctrl -w mic0: ready mic1: ready mic2: ready
Now that the devices are in the ready state, you may proceed with enabling/disabling ECC mode.
$ micsmc --ecc enable mic0, mic1, mic2 Information: enabling ECC on devices: mic0, mic1, mic2... Information: 1 of 3 complete Information: 2 of 3 complete Information: 3 of 3 complete Status: mic0: ECC enabled successfully Status: mic1: ECC enabled successfully Status: mic2: ECC enabled successfully Information: you must restart your Intel(R) Xeon Phi(TM) Coprocessor(s) now for the ECC mode changes to take effect
Use the --verbose flag to request verbose output.
$ micsmc --ecc enable mic0, mic1, mic2 --verbose Information: enabling ECC on devices: mic0, mic1, mic2... Status: mic0: enabling ECC... Status: mic1: putting device in maintenance mode... Status: mic2: putting device in maintenance mode... Status: mic0: resetting to 'ready' state Status: mic1: resetting to 'ready' state Status: mic2: enabling ECC... Status: mic0: resetting to 'ready' state Status: mic1: resetting to 'ready' state Status: mic2: resetting to 'ready' state Status: mic0: resetting to 'ready' state Status: mic1: resetting to 'ready' state Status: mic2: resetting to 'ready' state Status: mic0: resetting to 'ready' state Status: mic1: resetting to 'ready' state Status: mic2: resetting to 'ready' state Status: mic0: ECC enabled successfully Status: mic1: ECC enabled successfully Status: mic2: ECC enabled successfully Information: you must restart your Intel(R) Xeon Phi(TM) Coprocessor(s) now for the ECC mode changes to take effect
To return the devices to the online state after enabling/disabling ECC mode, run the following as the root user:
# micctrl -b # micctrl -w mic0: online mic1: online mic2: online
The Platform Status Panel User Guide is available in all supported languages, in PDF and HTML formats, at: "/usr/share/doc/micmgmt".