Dell Storage Appliance Tools (DSAT) and SDK Server Hardware Manager Administrator’s Guide
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Copyright © 2015 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 Introduction........................................................................................................... 6 2 Other information you may need ..................................................................... 7 For the Dell PowerVault MD3060e ...................................................................................................... 7 For the Dell PowerVault MD1200 Series ..............................................................................................
Drive power................................................................................................................................... 22 List commands.................................................................................................................................... 22 List adapters...................................................................................................................................22 List physical enclosures..............................................
Drives slots.....................................................................................................................................45 EMM slots.......................................................................................................................................45 Drawers .........................................................................................................................................45 Fans.................................................................
Introduction 1 CAUTION: See the Safety, Environmental, and Regulatory Information document for important safety information before following any procedures listed in this document. An enclosure containing physical disks accessed through EMMs (Enclosure Management Modules) is called a storage enclosure. A storage enclosure includes various hardware components, such as physical disks, EMMs, fans, and power supply units (PSUs).
Other information you may need 2 WARNING: See the safety and regulatory information that shipped with your system. Warranty information may be included within this document or as a separate document. Any media that ships with your system that provides documentation and tools for configuring and managing your system, including those pertaining to the operating system, system management software, system updates, and system components that you purchased with your system.
For the Dell Storage MD1280 • The rack documentation included with your rack solution describes the process of installing your system into a rack. • The Dell Storage MD1280 Service Guide provides information about enclosure service and maintenance. This document is available online at dell.com/support/home. • The Getting Started Guide provides information about initial setup tasks and technical specifications of the Dell MD1280 Storage Enclosure. This document is available online at Dell.
About the Dell Storage enclosure 3 This chapter describes the storage enclosure concepts, which help in configuring and operating the Dell storage enclosures. The shmcli uses a number of terms to describe objects on which the software performs actions. See the Dell Storage PowerTools and SDK Support Matrix for information on supported enclosures. NOTE: For detailed descriptions about the enclosure features, see the Owner's Manual for the specific enclosure.
Installation procedure 4 When connecting the storage enclosure to a Dell PowerEdge server, the server must have a supported SAS HBA installed. See the Dell Storage Appliance Tools (DSAT) and SDK Server Hardware Manager Administrator’s Guide for information about supported SAS Host-bus Adapters (HBAs). If the host is connected to the storage enclosure by using multiple paths (two or more SAS connections), the host must have multipath configured.
4. Run the installation program by running the command: ServerHardwareManagement-x.x.x.x-windows-installer.exe --mode unattended or, modify options.installer and run with switch --options C:\path\to \installer.options for a non-default install. This command installs the Server Hardware Management Software with all the default settings. The default installation directory is C:\Program Files\Dell\ ServerHardwareManagement . 5. Accept all End User License Agreements.
Silent installation NOTE: Linux installation requires full ‘root’ user rights. Console installation is no longer available. Instead, run the installer with switch --mode unattended for the default installation. A default installation requires no arguments. 1. Download the Server Hardware Management Software installation package from Dell.com/support. 2. Navigate to the directory containing the extracted installer. 3. Run the command: ServerHardwareManagement-x.x.x.
5 Server hardware command line interface This guide is intended for system administrators, developers, and engineers who need to use the Server Hardware Command Line Interface (shmcli) and its associated commands. For more information, see the hardware and software manuals that shipped with the system. NOTE: The name of the executable was changed to shmcli. For backward compatibility, during the installation, the older named executable (secli) is installed.
path-to-target-object — is the list of arguments that defines the target object command applies to. Command syntax structure The commands for the Storage Enclosure CLI have a number of mandatory and optional input parameters. Those parameters, in turn, can also have more than one valid attribute. However, each parameter can accept only one valid value for each run. This section outlines the symbols used in the syntax of each command in this document and the syntax layout in the shmcli help. Table 1.
Table 3.
Drive OS Path Description Valid for Parameter Unique path to drive provided by the OS. Valid value for -d parameter NOTE: Ensure the console window is able to fit at least 150 characters for each line to view the output properly. NOTE: The output screenshots shown in the following procedures are examples and may be slightly different from the actual output depending on the version of your Server Hardware Management Software.
• Windows – remove the storelib.dll file in the C:\Program Files\Dell \ServerHardwareManager\ServerHardwareManagerCLI folder. • Linux – uninstall the storelib RPM installed by using OS commands. • ESX – uninstall the storelib RPM installed by using OS commands. Identifying enclosures and EMMs Identifying enclosures For other management actions, you must provide information for a respective enclosure or EMM. These values are presented with respect to a specific adapter value provided.
Identifying drives When identifying drives, there are other optional parameters that you can include to narrow the scope of the drives to obtain information from. You can identify drives from the adapter (all down-chain enclosures attached to a specified HBA), all the drives in a specific enclosure, or all the drives in a specified drawer in a specified enclosure.
Updating drives You can update drive firmware by using the information provided from running other shmcli commands. You can find the latest drive firmware for supported drives at Dell.com/support. Dell recommends stopping all I/O between the server and the attached enclosures containing the drives that you want to update. By default, if the command entered updates multiple drives, the shmcli updates the drives one at a time.
3. Run the following command: shmcli update emm -a=<(SASAddress | AdapterIndex)> -enc=<(WWN | EnclIndex)> -emm=<(WWN | EMMIndex)> -file= NOTE: The progress of the firmware transfer is indicated in the console. 4. The EMM updates the firmware and restarts. NOTE: This process may take up to five minutes.
6 CLI reference This section lists all the commands available for managing your storage enclosure. Commands listed by type Drive commands Blink drive Description Helps visually locate the specified SCSI device by initiating a blink, or ending an existing blink session.
Parameter Description -off Disable the blink mode for the device by running the command. -h Provides more information about the command, description, and usage. Command examples • • • • blink blink blink blink drive drive drive drive -a -a -a -d = = = = 1 -enc = 1 -w = 0 -d = 4 1 -enc = 1 -d = //./PHYSICALDRIVE50 -off 500abcdefgh12345 -enc = 1 -w = 0 -d = 4 500a123456789012 Drive power Description Turns off or turns on of the drive in the specified enclosure slot number.
Command syntax shmcli (list adapters | listadapters | la) outputformat=] [-h] [- Parameters Table 6. List adapters Parameter Descrition -h Provides more information about the command, description and usage. -outputformat You can specify the following output formats: xml or json List physical enclosures Description Shows the list of physical enclosures and related information for the specified adapter.
outputformat=] [-verbose] | -enc= [w=] [-outputformat=] [-verbose] | [-h]) Parameters Table 8. List hard disk drive Parameter Description -a Specify the adapter used for the command. This is either SAS WWID or I. -enc Specify the enclosure used for the command. This is either WWN or EnclIndex. -w Specify the drawer index used for the command. -h Provides more information about the command, description, and usage.
Parameter Desription -outputformat You can specify the following output formats: xml or json. Command examples • list emms -a = 1 • list emms -a = 1 -enc = 0 • list emms -a = 500abcdefgh12345 • list emms -enc = 500a123456789012 -outputformat = xml List drawers Description This command lists the drawers accessible from the specified enclosure. Depending on your enclosure, you may have one drawer or multiple drawers.
outputformat=] | -enc= [outputformat=] | [-h]) Parameters Table 11. List EMM slots Parameter Description -a Specify the adapter used for the command. This can be either SAS WWID or AdapterIndex. -enc Specify the enclosure used for the command. This can be either WWN or EnclIndex. -h Provides more information about the command, description, and usage. -outputformat You can specify the following output formats: xml or json.
• list drive slots -a = 1 -enc = 0 • list drive slots -enc = 500a123456789012 -outputformat = xml • list drive slots -a = 1 -enc = 500a123456789012 -verbose NOTE: On Linux systems, if the verbose argument is supplied, a column labeled Logical Vols is displayed, showing the logical drive mappings of the physical disk drive. For these values to be discovered correctly, the following system items must be installed and configured: Device Mapper Multipath and Smartmontools.
Parameters Table 14. List power supply devices Parameter Description -a Specify the adapter used for the command. This can be either SAS WWID or AdapterIndex. -enc Specify the enclosure used for the command. This is either WWN or EnclIndex. -h Provides more information about the command, description, and usage. -outputformat You can specify the following output formats: xml or json.
List voltage sensors Description This command lists the voltage sensors accessible from the specified enclosure. Command syntax shmcli (list voltage sensors | listvoltagesensors | lvs) (-a=<(SAS WWID | AdapterIndex)> -enc=<(WWN | EnclIndex)> [outputformat=] | -enc= [outputformat=] | [-h]) Parameters Table 16. List voltage sensors Parameter Description -a Specify the adapter used for the command. This can be either SAS WWID or AdapterIndex.
Parameters Table 17. List current sensors Parameter Description -h, -help Provides more information about the command, description, and usage. -outputformat You can specify the following output formats: xml or json. -a, -adapter Specify the adapter used for the command. This is either SAS WWID or the AdapterIndex. -enc Specify the enclosure is used for the command. This is either WWN or the EnclosureIndex.
Command examples • list failed drives • list failed drives –a=0 • list failed drives –enc=500a123456789012 Informational commands Show adapter information Description This command provides information about the specified adapter and status or count of the attached devices. Command syntax shmcli (info adapter | infoadapter | ia) (-a=<(SAS WWID | AdapterIndex)> [outputformat=] | [-h]) Parameters Table 19.
Parameters Table 20. Drive information Parameter Description -a Specify the adapter used for the command. This is either SAS WWID or AdapterIndex. -enc Specify the enclosure used for the command. This is either WWN or EnclIndex. -w Specify the drawer index used for the command. -d Specify the hard disk drive used for the command. This can be any of the following: • WWN — Can be used anytime. • Serial Number — Can be used anytime. • Drive OS path — Can be used anytime.
Parameters Table 21. Enclosure information Parameter Description -a Specify the adapter used for the command. This is either SAS WWID or AdapterIndex. -enc Specify the enclosure used for the command. This is either WWN or EnclIndex. -h Provides more information about the command, description, and usage. -outputformat You can specify the following output formats: xml or json.
View event log Description View all or part of the contents of the event log file based on date range and logging level. Command syntax shmcli (view log | vlog) ([-startDate= -endDate= event=] | [-event= -count=] | [-h]) Parameters Table 23. View event log Parameter Description -h Provides more information about the command, description, and usage. -startDate Display logs recorded on or after this date. Acceptable format is MM/DD/YY.
7 Update commands Update drive firmware Description This command updates the firmware version of the specified drives by using the provided firmware file. This command also verifies the integrity of the firmware file before applying the firmware. Command syntax shmcli (update drive | updatedrive | ud) (-a=<(SAS WWID | AdapterIndex)> [enc=<(WWN | EnclIndex)> [-w=]] [-d=<(WWN | EnclosureSlotIndex | DrawerSlotIndex | Serial Number | Drive OS Path)>] (-file= [force] | -directory=
Parameter Description -h Provides additional information about the command, description, and usage. -show Display the list of drives that are updated using the specified firmware file. The drives are not updated if this option is used. -directory Specify the directory path containing firmware files used for the command.
Table 25. Update EMM firmware Parameter Description -a Specify the adapter used for the command. This can be either SAS WWID or AdapterIndex. -enc Specify the enclosure used for the command. This can be either WWN or EnclIndex. -emm Specify the EMM used for the command. -file Specify the file at the given path used for the command. -h Provides additional information about the command, description and usage.
Table 26. Update Adapter Parameter Description -h, -help Provides additional information about the command, description, and usage. -outputformat Following output format(s) can be specified: xml, json. -a, -adapter Specify the Adapter to be used for the command. This can either be the SAS WWID or the Adapter Index. -file Specify the file at the given path used for the command.
Table 28. Global Topology Parameter Description -h, -help Provides more information about the command, description, and usage.
Server Hardware Manager Monitor 8 The Server Hardware Manager monitors the storage enclosure and informs you about state changes of its elements. The Server Hardware Manager Monitor presents events to you in the following types: • Local log files on Linux and Windows • Windows Event Log • Linux Syslog The Server Hardware Manager runs automatically upon installation. Local log file The local log contains events detected by the Server Hardware Manager Monitor service on Windows and Linux.
SNMP SNMP is another avenue the Server Hardware Manager Monitor uses to present events to the user. Only critical events are sent by using SNMP. The Server Hardware Manager Monitor sends traps to destinations that are contained in the Server Hardware Manager Monitor configuration file (SHM.config). SNMP traps are only generated for critical events. The Server Hardware Manager Monitor configuration file is located in the installation directory.
– Temperature of enclosure is above/below critical threshold • Voltage Sensor – Voltage goes above or below a critical threshold – AC power failure – DC power failure • Drawer – Drawer is opened (warning) – Drawer control module has failed • EMM is removed • EMM is connected • Drive removed • Drive is flagged as predicted to fail (SMART). • Adapter PHY connection status change. • Adapter PHY link rate value change. • Drive is installed (warning). • Physical Enclosure is connected.
The Dell Storage enclosure ReST API 9 The Server Hardware Management software v1.2 added support for the Representational State Transfer (ReST) API. The ReST service is accessible from a client device and from a Web browser. ReST access is enabled by default.
Table 31. Accessing the ReST service Parameter Description Host The address of the host running the ReST server. This address can be the Fully Qualified Domain Name (FQDN) of the host or an IP address. Port The port number opened for ReST traffic. The default port is 8012. Program_Space The application namespace: “SEM”. Version The major working version number. Currently “1.0”. For example, the base URL http://127.0.0.1:8012/api/SEM/1.0/ is used to access the ReST server locally.
Adapters Provides information about all adapters: [base_url]/adapters Provides information about a specified adapter: [base_url]/adapters/<(index | wwid)> Enclosures Provides information about all enclosures attached to a specific adapter: [base_url]/a/<(index | wwid)>/enclosures Provides information about a specified enclosure attached to a specified adapter: [base_url]/a/<(index | wwid)>/enclosures/<(index | wwid)> EMMs Provides information about all EMMs: [base_url]/a/<(index | wwid)>/emms Provides inf
Fans Provides information about all fans in a specified enclosure: [base_url]/a/<(index | wwid)>/enclosures/<(index | wwid)>/fans Power supplies Provides information about all power supplies in a specified enclosure: [base_url]/a/<(index | wwid)>/enclosures/<(index | wwid)>/powersupplies Voltage sensors Provides information about all voltage sensors in a specified enclosure: [base_url]/a/<(index | wwid)>/enclosures/<(index | wwid)>/voltagesensors Current sensors Provides information about all EMM slots in
Blink drive To toggle blink on a single drive: [base_url]/adapters/<(index | wwid)>/enclosures/<(index | wwid)>/drive/<(index | wwid)>?action=blink&toggle= To toggle blink on all drives within a specified enclosure: [base_url]/adapters/<(index | wwid)>/enclosures/<(index | wwid)>/drive/? action=blink&toggle=<(ON | OFF)> Update firmware Table 32.
Microsoft System Center Operations Manager Management Pack 10 This section describes the activities that you can perform by using Dell Storage PowerTools Server Hardware Manager SCOM management pack.
Figure 9. Management Packs 5. Click Add, and then click Add from disk.
Figure 10.
Figure 11. Import Management Packs 6. The Online Catalog Connection dialog box is displayed. Click No. Figure 12. Online Catalog Connection 7. Navigate to theSCOM folder within the SHM installation folder hierarchy. By default, the location is C: \Program Files\Dell\ServerHardwareManager\Extras\SCOM. Select the PowerToolsShmScom.mpb file, and then click Open. 8. PowerToolsShmScom is displayed in the Import List. Click Install to install the management pack.
Figure 13. Import Management Packs 9. The following message is displayed.
Figure 14.
The above diagram displays the objects discovered. All objects are monitored for state except for Host Bus Adapters. The connection arrows denote container relationships between objects. Views created The following views are created during the installation of the management pack. The views are created in Dell Storage PowerTools SHM in the Monitoring section of the Microsoft Operations Manager application.
Figure 15. SHM Host Bus Adapters • • • • • • • • • • • SHM Host Bus Adapters SHM Enclosures SHM Emms SHM Fans SHM Temperature Sensors SHM Current Sensors SHM Voltage Sensors SHM Power Supplies SHM Drawers SHM Drive Slots SHM Drives Severity Level Indicators The following table lists the icons that indicate the state severity levels of the discovered Dell devices on the OpsMgr console.
Table 33. Security Level Indicators Icon Severity Level Normal/OK — The component is working as expected. Warning/Noncritical —A probe or other monitoring device has detected a reading for the component that is above or below the acceptable level. The component may still be functioning, but it could fail. The component may also be functioning in an impaired state. Critical/Failure/Error — The component has either failed or failure is imminent.
Getting help 11 Contacting Dell Dell provides several online and telephone-based support and service options. If you do not have an active internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical assistance, or customer-service issues: 1. Go to Dell.com/support. 2.