Diablo: ULLtraDIMM - CLI Display Device Information

From Define Wiki
Revision as of 15:41, 23 May 2014 by Jon (talk | contribs)
Jump to navigation Jump to search

Device Information Commands

This section describes the commands that are used to obtain information about a device and the device attributes:

  • version
  • list devices
  • device status
  • device groups
  • device group status
  • firmware information
  • alias
  • block statistics

'version' - Display driver and CLI version

The version command is used to display the current version of the device driver and the CLI. 

[root@mcs ~]# td-cli version
TeraDIMM CLI Version: 1.4.4.89
TeraDIMM LIB Version: 1.4.4.89
TeraDIMM Driver Version: "1.4.4.105"
Running on Linux

'device --list' - List devices

The list parameter of the device command is used to view a list of the devices (the device ids) in the system. 

[root@mcs ~]# td-cli device --list
Device List:
tda
tdb
tdc
tdd

'device --status' - Display Device Status

The status parameter of the device command is used to view the status of a particular device in the system. 

[root@mcs ~]# td-cli device tda --status
tda: 
    Product Number: SDLOOCAM-400G-6K51, SN: 01190000
    Device Alias: 
    UUID: 44C73BF7-89B6-E2BF-C797-6AB19EDA04E2
    Firmware Version: 1.4.4.70
    Backup Firmware: 1.4.4.70
    DIMM Slot: P2_DIMME2
    DIMM Address: 0x14A0000000, DIMM Size: 0x100000000
    DDR Speed: 1600, IRQ: 0
    DIMM Voltage: 1.5V
    Device Group: td-cpu-31
    Control Device: /dev/tda-ctrl
    Flash Status: Read/Write
    Percentage of Warranty Remaining: 100%
    Flash Temperature: 43.0 C, Max: 61.0 C
    Performance Status: Optimal (0%)
    Lifetime: 353 hours, 256 GB read, 2816 GB written
    Block Device: /dev/tda <ok>
    Block Size: 4096 bytes, Disk Size: 400099295232 bytes
    Stride: 4 kbytes
    Block Provisioning: 100%
    DRAM Protection Status: Protected
    TRIM : Disabled
    Predictive Failure Detected: FALSE
    Commit Mode: normal

'device-group --list' - List Device Groups

Processor affinity is set by attaching a device to a group. Device groups are used to ensure that devices are using specific CPUs. Each device must be in a device group.
The list parameter of the device-group command is used to list the device thread groups defined in the system. 

[root@mcs ~]# td-cli device-group --list
Device Groups:
td-cpu-23
td-cpu-22
td-cpu-21
td-cpu-20
td-cpu-31
td-cpu-29
td-cpu-30
td-cpu-28

You can also list the device groups with the status for each group by using the global option --verbose or -v: 

[root@mcs ~]# td-cli -v device-group --list
Device Groups:
Device Group Name:    td-cpu-23
CPU:                  23
Devices:              None

Device Group Name:    td-cpu-22
CPU:                  22
Devices:              None

Device Group Name:    td-cpu-21
CPU:                  21
Devices:              None

Device Group Name:    td-cpu-20
CPU:                  20
Devices:              None

Device Group Name:    td-cpu-31
CPU:                  31
Devices:              tda 

Device Group Name:    td-cpu-29
CPU:                  29
Devices:              tdc 

Device Group Name:    td-cpu-30
CPU:                  30
Devices:              tdb 

Device Group Name:    td-cpu-28
CPU:                  28
Devices:              tdd

'device-group --status' - List Device Group Status

Device group names consist of a maximum of 16 characters. Longer names will be truncated to 16 characters.
The status parameter of the device-group command is used to display the device group status information for the specified group. 

[root@mcs ~]# td-cli device-group td-cpu-30 --status
Device Group Name:    td-cpu-30
CPU:                  30
Devices:              tdb

'device-firmware --query' - Display Frimware Information

The query parameter of the device-firmware command is used to display the information for a particular device.
If you do not specify a device ID, the firmware information for all devices is shown. 

[root@mcs ~]# td-cli device-firmware --query

Version information for /dev/tda
Bank 1 Firmware : 1.4.4.70 Primary (ACTIVE)
Bank 2 Firmware : 1.4.4.70 Secondary
Factory default : 1.3.4.16

Version information for /dev/tdb
Bank 1 Firmware : 1.4.4.67 Secondary
Bank 2 Firmware : 1.4.4.67 Primary (ACTIVE)
Factory default : 1.4.2.55

Version information for /dev/tdc
Bank 1 Firmware : 1.4.1.48 Secondary
Bank 2 Firmware : 1.4.4.70 Primary (ACTIVE)
Factory default : 1.3.4.16

Version information for /dev/tdd
Bank 1 Firmware : 1.4.4.67 Secondary
Bank 2 Firmware : 1.4.4.67 Primary (ACTIVE)
Factory default : 1.4.2.55
Command handling complete

To display additional details, such as the build date and build ID, use the --details option 

[root@mcs ~]# td-cli device-firmware --details --query tda

Version information for /dev/tda
Bank 1 Firmware : 1.4.4.70 Primary (ACTIVE)
       Date     : Fri May  9 00:01:09 2014
       ID       : labuser
Bank 2 Firmware : 1.4.4.70 Secondary
       Date     : Fri May  9 00:01:09 2014
       ID       : labuser
Factory default : 1.3.4.16
       Date     : Fri Feb 21 21:31:42 2014
       ID       : labuser
Command handling complete

'device-alias --get' - Display Device Alias

A device alias is useful for substituting a user-friendly, easy-to-remember name for a device. The --get parameter of the device-alias command is used to display the device alias (if one is set). 

[root@mcs ~]# td-cli device-alias tda --get
Device alias not set

'device-stats' - Display Block Statistics

The device-stats command is used to view the statistics for Reads and Writes in megabytes, as well as IOPS/s for the particular device. The Read and Write figures reflect the performance of the device under the current traffic conditions with the selected configuration settings.
This command displays the statistics at the interval specified by the --delay option, and repeats until the process is manually stopped.

  • delay <seconds> — repeats the stats with the specified delay; default: 1 second
  • repeat <#> — displays the stats for the set number of iterations; default: infinite
  • reprint <#> — repeats the header after the set number of entries; default: every 10 prints)
[root@mcs ~]# td-cli device-stats tda --delay 2 --repeat 3
Press CTRL-C to exit
           |--------------- tda ---------------|
Time:         wMB/2s   rMB/2s   wkIO/2s   rkIO/2s
13:33:50     149.68   350.29     36.54    85.52
13:33:52     152.13   355.99     37.14    86.91
13:33:54     155.56   362.98     37.98    88.62
[root@mcs ~]# 

[root@mcs ~]# td-cli device-stats tda --delay 2 --reprint 5
Press CTRL-C to exit
           |--------------- tda ---------------|
Time:         wMB/2s   rMB/2s   wkIO/2s   rkIO/2s
13:33:48       0.33     0.94      0.08     0.23
13:33:50     149.68   350.29     36.54    85.52
13:33:52     152.13   355.99     37.14    86.91
13:33:54     155.56   362.98     37.98    88.62
13:33:56     159.04   371.52     38.83    90.70
           |--------------- tda ---------------|
Time:         wMB/2s   rMB/2s   wkIO/2s   rkIO/2s
13:33:48       0.33     0.94      0.08     0.23
13:33:50     149.68   350.29     36.54    85.52
13:33:52     152.13   355.99     37.14    86.91
13:33:54     155.56   362.98     37.98    88.62
13:33:56     159.04   371.52     38.83    90.70
           |--------------- tda ---------------|
Time:         wMB/2s   rMB/2s   wkIO/2s   rkIO/2s
13:33:48       0.33     0.94      0.08     0.23
^C
Retrieved from "http://wiki.define-technology.com/mediawiki-1.35.0/index.php?title=Diablo:_ULLtraDIMM_-_CLI_Display_Device_Information&oldid=4533"