Dell EMC Storage PowerTools Server Hardware Manager Administrator’s Guide Release 2.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. 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. © 2018 – 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents 1 Introduction................................................................................................................................. 6 2 Other information you may need ................................................................................................... 7 Dell EMC Storage and Microsoft Storage Spaces Solution............................................................................................. 7 Dell EMC PowerVault MD3060e ............................................
List drive slots................................................................................................................................................................ 24 List fans.......................................................................................................................................................................... 25 List power supply units..............................................................................................................................
Severity Level Indicators ................................................................................................................................................... 49 10 Getting help..............................................................................................................................51 Contacting Dell EMC...........................................................................................................................................................
1 Introduction CAUTION: See the Safety, Environmental, and Regulatory Information document for important safety information before following any procedures listed in this document. An enclosure containing hard drives accessed through Enclosure Management Modules (EMMs) is called a storage enclosure. A storage enclosure includes various hardware components, such as hard drives, EMMs, fans, and power supply units (PSUs).
2 Other information you may need WARNING: See the safety and regulatory information that shipped with your system. Warranty information can be included within this document or be included in a separate document. You will need the documentation that ships with your system. It provides information 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.
• • • • • DSMS 630 DSMS 730 DSMS 3060e DSMS 1400 DSMS 1420 This solution is described in the following documentation, which you can download from Dell.com/dsmsmanuals. • • • • Dell Storage with Microsoft Storage Spaces Support Matrix—Provides information about the software and hardware compatibility for Dell EMC Storage with Microsoft Storage Spaces solution.
3 Installation procedure When connecting the storage enclosure to a Dell EMC PowerEdge server, the server must have a supported SAS HBA installed. See the Dell Storage PowerTools Server Hardware Manager Support Matrix for information about supported SAS 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.
2. Go to the download directory, and extract the installation files from the ServerHardwareManager-x.x.x.x-installer.zip file. 3. Run the command prompt as an Administrator. NOTE: The command prompt must be an Administrator prompt for proper use of the CLI. 4. Go to the directory where the installation files were extracted. 5. To perform a silent (unattended) install using the default settings, run the following command: ServerHardwareManager-x.x.x.x-windows-installer.
Graphical installation Steps 1. Download the Server Hardware Manager Software installation package from Dell.com/support. 2. Go to the download directory, and extract the installation files from the ServerHardwareManager-x.x.x.x-installer.tar.gz file. 3. Go to the directory where the installation files were extracted. 4. Double-click the installation program: ServerHardwareManager-x.x.x.x--installer . NOTE: Installation of the SNMP monitoring service is optional. 5.
2. To uninstall the software, run the following command: ./ServerHardwareManager_uninstall To perform a silent uninstallation, run the following command: ./ServerHardwareManager_uninstall --mode unattended. 3. Follow the on-screen instructions to complete the uninstallation. Server Hardware Manager Installation - ESXi The Server Hardware Manager software for ESXi is installed by extracting the files from the ServerHardwareManager_ESXi.tar.gz file. Steps 1.
4 Storage Hardware Manager CLI This guide is intended for system administrators, developers, and engineers who use the Storage Hardware Manager CLI and its associated commands. For more information, see the hardware and software manuals that are shipped with the system. NOTE: • For Server Hardware Manager 1.7 and all future releases, the secli executable is deprecated. The shmcli executable is used to run Server Hardware Manager Command Line Interface. The shmcli maintains the command syntax from secli.
Table 1. Command syntax structure Input Parameter Description a|b Pipe symbol indicating alternative (“a” or “b”) italicized-words Input value […] Optional input <> Enclosed input value is required for parameter Table 2.
Description Valid for Parameter Enclosure Slot Index Reference value that Indicates a target drive Valid value for the -d and-s parameter Drawer Slot Index Indicates reference value for a drive slot in a specified drawer Valid value for the -d parameter EMM Index (Enclosure Management Module Index) Indicates the reference value for EMMs in an specific enclosure Valid value for the -emm parameter StartDate Starting date to view logs in the format: MM/DD/YY Valid value for the -startDate paramete
PERC or MegaRAID controllers The Storage Hardware Manager system also supports drives that are connected using a PERC or MegaRAID controller. This functionality is not available by default. A system library must be installed to enable this functionality. • Windows - Copy the storelib.dll file from the {Installation_base_path}\Dell\ServerHardwareManager \Extras\Storelib folder to the {Installation_base_path}\Dell\ServerHardwareManager \ServerHardwareManagerCLI folder.
Note the Enclosure Slot Index and the WWN columns. These values are required for command parameters. Identifying drawers Verify the status and number of drives in the drawers of an enclosure by running the following command: shmcli list drawers -a=<(SASAddress | AdapterIndex)> -enc=<(WWN | EnclIndex)> Figure 5. Drawer 0 is the top draw or the only drawer for the enclosure. Updating drives You can update drive firmware by using the information provided from running other SHM CLI commands.
Updating EMM firmware Steps 1. Download the latest firmware package from Dell.com/support. 2. Stop all I/O between the server and the attached enclosures containing the EMMs you intend to update. NOTE: • After this update process begins, you may lose access to the drives or enclosures connected to the update target. The EMM does not respond to commands again until it is back online.
To retrieve information about all of the drives in a drawer within an enclosure: shmcli list drives -a=<(SASAddress | AdapterIndex)> -enc=<(WWN | EnclIndex)> -w= Output For all the drives in a drawer within an enclosure: Figure 8. Identifying drives in a drawer within an enclosure Record the Enclosure Slot Index and the WWN provided by the list drives command.
5 CLI reference Drive commands Blink drive Descriptio n Helps visually locate the specified SCSI device by initiating a blink, or ending an existing blink session. Syntax shmcli (blink drive | blinkdrive | bd) (-a=<(SAS WWID | AdapterIndex)> [enc=<(WWN | EnclIndex)> [-w=]] -d=<(WWN | EnclosureSlotIndex | DrawerSlotIndex | Serial Number | Drive OS Path)> [-off] | -d=<(WWN | Serial Number | Drive OS Path)> [-off] | [-h]) Parameter s -a Specifies the adapter to use for the command.
-on Turns on the drive on the specified enclosure slot. -off Turns off the drive on the specified enclosure slot. -h Provides more information about the command, description, and usage. List commands List adapters Description This command lists the adapters accessible from the host. Command syntax shmcli (list adapters | listadapters | la) [-outputformat=] [-h] Parameters Table 4.
• list physical enclosures -a = 1 • list physical enclosures -a = 500abcdefgh12345 List drives Description Shows the list of HDDs or SSDs and related information for the specified device. If no device is specified to obtain drives for, all drives accessible by supported adapters in the local system are listed.
Command syntax shmcli (list emms | listemms | le) (-a=<(SAS WWID | AdapterIndex)> [-enc=<(WWN | EnclIndex)>] [-outputformat=] | -enc= [outputformat=] | [-h]) Parameters Table 7. List EMMs Parameter Description -a Specifies the adapter used for the command. This is either SAS WWID or AdapterIndex. -enc Specifies the enclosure used for the command. This is either WWN or EnclIndex.
Command examples • list drawers -a = 1 -enc = 500a123456789012 • list drawers -a = 1 -enc = 0 • list drawers -enc = 500a123456789012 -outputformat = xml List EMM slots Description This command lists the EMM Slots and associated information for the specified enclosure.
Parameters Table 10. List hard disk drive slots Parameter Description -a Specifies the adapter used for the command. This can be either SAS WWID or AdapterIndex. -enc Specifies 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 fans -a = 1 -enc = 0 • list fans -enc = 500a123456789012 -outputformat = xml List power supply units Description This command lists the power supply units (PSUs) accessible from the specified enclosure. Command syntax shmcli (list power supplies | listpowersupplies | lps) (-a=<(SAS WWID | AdapterIndex)> enc=<(WWN | EnclIndex)> [-outputformat=] | -enc= [outputformat=] | [-h]) Parameters Table 12.
Parameters Table 13. List temperature sensors Parameter Description -a Specifies the adapter used for the command. This is either SAS WWID or AdapterIndex. -enc Specifies 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 current sensors Description Lists the current sensors accessible from the specified enclosure. Command syntax shmcli (list current sensors | listcurrentsensors | lcs) (-a=<(SAS WWID| AdapterIndex)> enc=<(WWN | EnclIndex)> [-outputformat=] | -enc= [outputformat=] | [-h]) Parameters Table 15. List current sensors Parameter Description -h, -help Provides more information about the command, description, and usage.
Parameter Description -outputformat You can specify the following output formats: XML or JSON. 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.
Parameters Table 18. Drive information Parameter Description -a Specifies the adapter used for the command. This is either SAS WWID or AdapterIndex. -enc Specifies the enclosure used for the command. This is either WWN or EnclIndex. -w Specifies the drawer index used for the command. -d Specifies 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.
Parameter Description -h Provides information about the command, description, and usage. -outputformat You can specify the following output formats: XML or JSON. Command examples • info enclosure -a = 1 -enc = 500a123456789012 • info enclosure -a = 1 -enc = 0 • info enclosure -enc = 500a123456789012 -outputformat = xml Show firmware file information Description This command provides detailed information for the specified Firmware File such as its type and properties.
Parameters Table 21. 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. -endDate Display logs recorded no later than this date. Acceptable format is MM/DD/YY. -count Display the latest number of events of a specified category. The viewable count of latest events can be a value from 1 to 1000. -event Display logs of the given event severity type.
6 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 -multi Using this option causes drive updates to happen simultaneously, increasing overall update speed significantly. The speed increase is apparent during multi drive updates. Command examples • update drive -a = 1 -enc = 1 -w = 2 -file = C:\Users\Administrator\firmware\upgrade.fwh • update drive -enc = EnclosureWWN -file = C:\Users\Administrator\firmware\upgrade.fwh -force • update drive -a = 1 -directory = C:\Users\Administrator\firmware -multi • update drive -d = DriveW
• update emm -enc = 500rg67890123456 -emm = 500a123456789012 -file = C:\Users\Administrator \firmwares\emm_upgrade.esm • update emm -emm = 500a123456789012 -file = C:\Users\Administrator\firmwares\emm_upgrade.esm Update Adapter Description After running the following command, the updated firmware file’s version is installed. Command syntax shmcli (update adapter | updateadapter) ( -a=<(SAS WWID | AdapterIndex)> -file= | [-h]) Parameters Table 25.
Command syntax shmcli (global topology | global top | gt) [-h] Parameters Table 27. Global Topology Parameter Description -h, -help Provides more information about the command, description, and usage.
7 Monitoring 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: • • • Logging or Monitor service SNMP SCOM The following list describes events raised by the monitoring parts of the Server Hardware Manager solution. Not all the enclosure events apply to all enclosure models.
NOTE: If any modifications are made to the Monitor or SNMP services, the services must be restarted for the changes to take place. Local log file The local log contains events detected by the Server Hardware Manager Monitor service on Windows and Linux. This log includes warnings and critical events. The contents of this file is viewed in the following directories: Table 28. Log file location Operating System Location Windows C:\Users\Default\Dell\ServerHardwareManager\logs \ServerHardwareManagerMonitor
To add Linux syslog logging (Linux only): • Add the StSysLogAppender string to thelog4cplus.rootLogger entry. For example, log4cplus.rootLogger=WARN, file, StSysLogAppender SNMP SNMP is another avenue that 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).
• • 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 Physical Enclosure is removed Fan state change (warning) Fan state is critical Current sensor is in 'critical' status JBOD LEDs The Server Hardware
8 Dell Storage enclosure REST API Server Hardware Manager software version 1.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.
Accessing the REST service The base URL for a REST request is in the following format: http://:/api// Table 30. 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 mainly supported version is 1.
/api/SEM/1.0/adapters/{id}/drives [GET] /api/SEM/1.0/adapters/{id}/drives/{id} [GET] /api/SEM/1.0/adapters/{id}/enclosures [GET] /api/SEM/1.0/adapters/{id}/enclosures/{id} [GET] /api/SEM/1.0/adapters/{id}/enclosures/{id}/drives [GET] /api/SEM/1.0/adapters/{id}/enclosures/{id}/drives/{id} [GET] /api/SEM/1.0/adapters/{id}/enclosures/{id}/drawers [GET] /api/SEM/1.0/adapters/{id}/enclosures/{id}/drawers [GET] /api/SEM/1.0/adapters/{id}/enclosures/{id}/drawers/{id}/drives [GET] /api/SEM/1.
Device Actions SHM REST resources include device actions. /api/SEM/1.0/adapters/{id}/drives/{id}/blink/ON|OFF [PUT] /api/SEM/1.0/drives/{id}/firmware/blink/ON|OFF [PUT] /api/SEM/1.0/adapters/{id}/enclosures/{id}/drives/{id}/blink/ON|OFF [PUT] Firmware File Information SHM REST resources include firmware file information. /api/SEM/1.0/system/firmware [GET] Object Aliases For several of the object types, an alias may be used in place of the full name of the object as indicated in the table here: Table 31.
Device actions HTTP GET methods Certain devices can have actions performed on them such as updating firmware or blinking a drive’s LED. Also, firmware files can be validated. These device actions require additional options at the end of the URL for a device inventory query: [base_url]//<(index | wwid)>/?action=&
Updating firmware by using REST Update Firmware with GET verb Table 32.
9 Microsoft System Center Operations Manager Management Pack This section describes the activities that you can perform by using Dell Storage PowerTools Server Hardware Manager SCOM Management Pack.
Figure 11. Schematic of components discovered in an enclosure The above diagram depicts the objects discovered. All objects are monitored for state except HBAs. 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 12. SHM Host Bus Adapters • • • • • • • • • • • • SHM Hosts 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. Severity Level Indicators Icon Severity Normal/OK — The component is working as expected.
Icon Severity Warning/Noncritical —A probe or other monitoring device has detected a reading for the component that is more than or less than the acceptable level. The component may still be functioning, but it could fail. The component may also be functioning in an impaired state. Figure 14. Component expected to fail Critical/Failure/Error — The component has either failed or failure is imminent. The component requires immediate attention and may need to be replaced. Data loss may have occurred.
10 Getting help Topics: • Contacting Dell EMC Contacting Dell EMC Dell EMC provides several online and telephone based support and service options. If you do not have an active internet connection, you can find contact information about your purchase invoice, packing slip, bill, or Dell EMC product catalog. Availability varies by country and product, and some services may not be available in your area. To contact Dell EMC for sales, technical assistance, or customer service issues: Steps 1. Go to Dell.
