background image

Global Topology

Description

Shows a global list of all objects in the system. Output is displayed only in XML format.

Command syntax

shmcli  (global topology | global top | gt) [-h]

Parameters

Table 29. Global Topology

Parameter

Description

-h, -help

Provides more information about the command, description, and 
usage.

40

Update commands

Summary of Contents for MD1280

Page 1: ...Dell Storage PowerTools Server Hardware Manager Administrator s Guide Release 2 1 ...

Page 2: ... 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 2018 Dell Inc or its subsidiaries All rights reserved Dell EMC and other trademarks are trademarks of Dell Inc or its subsidiaries Other trademarks may be trademarks of their respective owners 2018 02 Rev A06 ...

Page 3: ...installing server hardware management 12 Server Hardware Management Installation Linux 12 Device Mapper Multipath 12 Graphical installation 12 Silent installation 13 Console uninstallation 13 5 SHM CLI 14 Using the CLI 14 Command syntax structure 15 Command help 16 Identifying installed HBAs 17 PERC or MegaRAID controllers 17 Identifying enclosures and EMMs 17 Identifying enclosures 17 Updating dr...

Page 4: ...ent log 35 View MD3060e SAS diagnostics 35 7 Update commands 37 Update drive firmware 37 Update EMM firmware 38 Update Adapter 39 Status Adapter 39 Global Topology 40 8 Monitoring 41 Logging or Monitor Service 42 Local log file 42 Windows event log 42 Linux syslog 43 Monitor Configuration File 43 Logging Functionality Modification Directions 43 SNMP 43 Events 44 JBOD LEDs 44 9 The Dell Storage enc...

Page 5: ...e firmware file 52 10 Microsoft System Center Operations Manager Management Pack 53 Overview of the Dell Storage PowerTools Server Hardware Manager SCOM management pack 53 Installing Dell Storage PowerTools Server Hardware Manager SCOM Management Pack 53 Views created 54 Severity Level Indicators 55 11 Getting help 57 Contacting Dell 57 Contents 5 ...

Page 6: ... software and the storage enclosure communicate management requests and event information by using in band SAS connections Terminology This document describes the functions of the Server Hardware Management software The Server Hardware Management Software is consists of two major components Server Hardware Manager Command Line Interface SHM CLI This component provides a CLI used to obtain device a...

Page 7: ...dates on Dell com support manuals because they often supersede information in other documents The following sections provide information about the documentation resources specific for your product Topics Dell Storage and Microsoft Storage Spaces Solution Dell PowerVault MD3060e Dell PowerVault MD1200 series Dell Storage MD1280 Dell Storage MD1400 series Dell Storage and Microsoft Storage Spaces So...

Page 8: ...ces Best Practices Guide Provides guidance about the best practices associated for this solution Dell PowerVault MD3060e Rack Installation Instructions Describes how to install your system into a rack This document is also shipped with your rack solution Dell PowerVault MD3060e Storage Enclosure Deployment Guide Provides information about deploying the storage system in the direct attached archite...

Page 9: ...tasks and technical specifications This document is available online at Dell com support home Dell Storage MD1400 series Rack Installation Instructions Describes how to install your system into a rack This document is also shipped with your rack solution The Getting Started Guide Provides an overview of system features setting up your system and technical specifications The OpenManage Server Admin...

Page 10: ...s a number of terms to describe objects on which the software performs actions See the Dell Storage PowerTools Server Hardware Manager Support Matrix for information on supported enclosures NOTE For more information about the enclosure features see the Owner s Manual for the specific enclosure 3 10 About the Dell Storage enclosure ...

Page 11: ...allation Windows Multipath I O MPIO You must configure Windows MPIO for the Server Hardware Management Software to recognize the hardware For more information about MPIO configuration procedures see Microsoft documentation related to MPIO for configuration procedures NOTE Dell recommends the Failover Only policy Graphical installation 1 Download the Server Hardware Management Software installation...

Page 12: ...nstall exe mode unattended Windows Explorer 5 To uninstall a software application on the taskbar click Start Control Panel Programs and Features 6 Click the ServerHardwareManagement program 7 Click Uninstall 8 Complete the on screen instructions to complete the uninstallation Server Hardware Management Installation Linux Device Mapper Multipath For the Server Hardware Management Software to recogn...

Page 13: ...ectory uncomment and edit the following line in the installer options file prefix opt dell ServerHardwareManagement 6 To start the SNMP daemon after installation set the value of SNMP to 1 SNMP 1 7 Run the command ServerHardwareManagement x x x x OS installer mode unattended options path to installer options Console uninstallation About this task NOTE Linux uninstallation requires full root user p...

Page 14: ...e CLI is a software application that enables storage installers developers and engineers to monitor and update storage enclosures and HDDs or SSDs By using the CLI commands can run from an OS prompt such as the Microsoft Windows command prompt or a Linux operating system terminal Use the SHM CLI to perform the following functions Display status information about the objects in the system Update st...

Page 15: ...ues a Indicates target adapter SAS WWID or Adapter Index d Indicates target drive WWN World Wide Name Enclosure Slot Index Drawer Slot Index Serial Number or Drive OS Path w Indicates target enclosure drawer Drawer Index 0 1 2 3 or 4 s Indicates target enclosure slot Enclosure Slot Index startDate Target start date StartDate in the format of MM DD YY endDate Target end date EndDate in the format o...

Page 16: ...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 parameter EndDate End date to view logs in the format MM DD YY Valid va...

Page 17: ...b dll file from the Installation_base_path Dell ServerHardwareManager Extras Storelib folder to the Installation_base_path Dell ServerHardwareManager ServerHardwareManagerCLI folder Linux Install the RPM file located in Installation_base_path dell ServerHardwareManager storelib using OS commands ESX Install the RPM file that will be packaged along with the shmcli utility To remove support Windows ...

Page 18: ...ation about 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 SHM CLI updates the drives one at a time If multi argument is entered at the CLI the SHM CLI updates the drives simultaneously curren...

Page 19: ...t is back online NOTE If you have more than one storage enclosure in a daisy chain Dell recommends that you update the EMMs starting in the lowest tier of the chain and working back up to the top enclosure 3 Run the following command shmcli update emm a SASAddress AdapterIndex enc WWN EnclIndex emm WWN EMMIndex file FW FilePath NOTE The progress of the firmware transfer is indicated in the console...

Page 20: ...wer within an enclosure shmcli list drives a SASAddress AdapterIndex enc WWN EnclIndex w DrawerIndex Output For all the drives in a drawer within an enclosure Figure 8 Identifying drives in a drawer within an enclosure The relevant information to record from the list drives command are the Enclosure Slot Index and the WWN These values are required to perform actions on a specific drive such as upd...

Page 21: ...linkdrive bd a SAS WWID AdapterIndex enc WWN EnclIndex w DrawerIndex d WWN EnclosureSlotIndex DrawerSlotIndex Serial Number Drive OS Path off d WWN Serial Number Drive OS Path off h Parameters Table 4 Drive commands Parameter Description a Specifies the adapter to use for the command This can be either SASAddress or AdapterIndex enc Specifies the enclosure to use for the command This is either WWN...

Page 22: ... 1 w 0 d 4 blink drive d 500a123456789012 Drive power Description Turns off or turns on the drive in the specified enclosure slot number Command syntax shmcli drive power drivepower dp a SAS WWID AdapterIndex enc WWN EnclIndex s EnclosureSlotIndex on off h Parameters Table 5 Drive power status Parameter Description a Specifies the adapter used for the command This can be either SAS WWID or Adapter...

Page 23: ...cription 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 Default output no adapter input specified lists all enclosures accessible by every supported adapter in the local system Command...

Page 24: ... to obtain drives for all drives accessible by supported adapters in the local system are listed Command syntax shmcli list drives listdrives ld a SAS WWID AdapterIndex enc WWN EnclIndex w DrawerIndex outputformat SupportedOutputFormats verbose enc WWN w DrawerIndex outputformat SupportedOutputFormats verbose h Parameters Table 8 List hard disk drive Parameter Description a Specifies the adapter u...

Page 25: ...tFormats enc WWN outputformat SupportedOutputFormats h Parameters Table 9 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 h Provides more information about the command description and usage outputformat You can specify the following output formats XM...

Page 26: ...dapterIndex 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 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 ...

Page 27: ...st drive slots Description This command lists the HDD slots and associated information about the specified enclosure Command syntax shmcli list drive slots listdriveslots lds a SAS WWID AdapterIndex enc WWN EnclIndex outputformat SupportedOutputFormats verbose enc WWN outputformat SupportedOutputFormats verbose h Parameters Table 12 List hard disk drive slots Parameter Description a Specifies the ...

Page 28: ...and lists the fans accessible from the specified enclosure Command syntax shmcli list fans listfans lf a SAS WWID AdapterIndex enc WWN EnclIndex outputformat SupportedOutputFormats enc WWN outputformat SupportedOutputFormats h Parameters Table 13 List fans Parameter Description a Specifies the adapter used for the command This can be either SAS WWID or AdapterIndex enc Specifies the enclosure used...

Page 29: ...es 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 Command examples list power supplies a 1 enc 500a123456789012 list power supplies a 1 enc 0 list power supplies enc 500a123456789012 outputformat xml List temperature sensors Description This ...

Page 30: ...utputformat xml 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 SupportedOutputFormats enc WWN outputformat SupportedOutputFormats h Parameters Table 16 List voltage sensors Parameter Description a Specify the adapt...

Page 31: ...lp 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 current sensors a 1 enc 500a123456789012 list current...

Page 32: ...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 Command syntax shmcli info adapter infoadapter ia a SAS WWID Adap...

Page 33: ... 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 Drawer Slot Index Index of the drive in the specific drawer Use if the drawer argument is used for the command Enclosure Slot Index Use if drawer argument is not...

Page 34: ...terIndex enc Specifies the enclosure used for the command This is either WWN or EnclIndex 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...

Page 35: ...entType count LatestEventCount 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 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 view...

Page 36: ...agnostics 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 information about the command description and usage outputformat You can specify the following output formats XML or JSON 36 CLI reference ...

Page 37: ... 25 Update drive firmware Parameter Description a Specifies the adapter used for the command This is either SAS WWID or AdapterIndex d Specifies the HDD 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 Enclosure Slot Index Use if drawer argument is not used for the command Drawer Slot Index Index of th...

Page 38: ...ommand updates the firmware version of the specified EMM by using the provided firmware file This command also verifies the integrity of the firmware file before applying the firmware NOTE Default behavior of the command uses the wait functionality Command syntax shmcli update emm updateemm a SAS WWID AdapterIndex enc WWN EnclIndex emm WWN EMMIndex file FW Filepath emm WWN file FW Filepath nowait ...

Page 39: ...iption and usage outputformat Following output formats can be specified XML JSON a adapter Specifies the adapter to be used for the command This can either be the SAS WWID or the Adapter Index file Specifies the file at the given path used for the command NOTE If the filename contains special characters you must enclose the file path within escaped double quotation marks Status Adapter Description...

Page 40: ...cts in the system Output is displayed only in XML format Command syntax shmcli global topology global top gt h Parameters Table 29 Global Topology Parameter Description h help Provides more information about the command description and usage 40 Update commands ...

Page 41: ...Emm installed Power Supply removed an enclosure power supply was removed Power Supply installed an enclosure power supply was installed Fan Removed an enclosure fan was removed Fan Installed an enclosure fan was installed Voltage Sensor removed an enclosure voltage sensor was removed Voltage Sensor installed an enclosure voltage sensor was installed Current Sensor removed an enclosure current sens...

Page 42: ... 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 30 Log file location Operating System Location Windows C Users Default Dell ServerHardwareManager logs ServerHardwareManagerMonitor log Linux var log dell ServerHardwareManager ServerHardwareManagerMonitor log NOT...

Page 43: ...tical 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 generated only for critical events The Server Hardware Manager Monitor configuration file is located in the installation directory The following is the default location of the configuration files T...

Page 44: ...tage goes more than or less than 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 Physical Enclosure is remo...

Page 45: ... the behavior by default is off 3 Save the file 4 Restart the monitoring service If the LED control behavior is turned on the following LED control will occur 1 If a drive is reporting a predicted failure state a The drive slot LED will be set to the Identify state b The enclosure LED will be set to the Failure state 2 If a drive is determined to be in a failed state a The drive slot LED will be s...

Page 46: ... slot within an enclosure Figure 10 Storage enclosure REST queries are built into the device hierarchy Topics Modifying REST Configuration Accessing the REST service SHM REST Resources Updating firmware by using REST Modifying REST Configuration NOTE Modifying the REST configuration file can disable or disrupt REST functionality The Server Hardware Manager REST configuration exists in a file named...

Page 47: ...nd later For example the base URL http 127 0 0 1 8012 api SEM 1 0 is used to access the REST server locally NOTE For the remainder of this chapter base_url is used in place of the base URL syntax To obtain information about different devices you must use the following REST query base_url item_group To obtain information about a single device you must use the following REST query base_url item_grou...

Page 48: ...M 1 0 adapters id enclosures id drawers id drives GET api SEM 1 0 adapters id enclosures id drawers id drives id GET api SEM 1 0 adapters id enclosures id fans GET api SEM 1 0 adapters id enclosures id powersupplies GET api SEM 1 0 adapters id enclosures id voltagesensors GET api SEM 1 0 adapters id enclosures id temperaturesensors GET api SEM 1 0 adapters id enclosures id emmslots GET api SEM 1 0...

Page 49: ...HM REST resources include firmware updates api SEM 1 0 adapters id enclosures id emms id firmware POST api SEM 1 0 enclosures id emms id firmware POST api SEM 1 0 emms id firmware POST api SEM 1 0 adapters id drives id firmware POST api SEM 1 0 drives id firmware POST api SEM 1 0 adapters id enclosures id drives id firmware POST Device Actions SHM REST resources include device actions api SEM 1 0 ...

Page 50: ...d in the REST API The information returned from a REST query is different from the output of a SHM CLI command REST API calls return output equivalent to the output of SHM CLI information commands For example Get a list of adapters base_url api SEM 1 0 adapters Get a list of enclosures for a specific adapter base_url api SEM 1 0 adapters 0 enclosures Get a list of fans for specific enclosure base_...

Page 51: ...s File paths in Windows can either be percent encoded or entered with forward slashes The following are examples of valid Windows filepaths for a firmware file C 5Cdrivefirmwares 5CSeagate 22firmwares 5Cmyfirmwarefile fwh C drivefirmwares Seagate 22firmwares myfirmwarefile fwh NOTE 5C is the encoding for Windows and 22 represents spaces in the path name Here is an example of a valid Linux filepath...

Page 52: ...ives action update File Path to firmware file force on Update all drives within a specified enclosure with a firmware file multi threaded base_url adapters index wwid enclosures index wwid drives action update File Path to firmware file multi on Single enclosure management module EMM with a firmware file base_url adapters index wwid enc index wwid emm index wwid action update File Path to firmware...

Page 53: ...nagement pack Installing Dell Storage PowerTools Server Hardware Manager SCOM Management Pack Views created Severity Level Indicators Overview of the Dell Storage PowerTools Server Hardware Manager SCOM management pack The Dell Dell Storage PowerTools Server Hardware Manager SCOM management pack enables you to Discover supported HBAs Discover supported connected JBOD enclosures installed enclosure...

Page 54: ...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 54 Microsoft System Center Operations Manager Management Pack ...

Page 55: ...ors 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 Microsoft System Center Operations Manager Management Pack 55 ...

Page 56: ...may still be functioning but it could fail The component may also be functioning in an impaired state Figure 15 Component status critical 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 Figure 16 Component status not applicable The health status is not applicable for the...

Page 57: ...your country from the drop down menu on the lower right corner of the page 3 For customized support a Enter your system Service Tag in the Enter your Service Tag field b Click Submit The support page that lists the various support categories is displayed 4 For general support a Select your product category b Select your product segment c Select your product The support page that lists the various ...

Reviews: