EMC CLARiiON PRO Storage System Performance Management Pack Guide for Operations Manager 2007 Published: 04/14/2011
Copyright EMC2, EMC, and where information lives are registered trademarks or trademarks of EMC Corporation in the United States and other countries. All other trademarks used herein are the property of their respective owners. Copyright 2010 EMC Corporation. All rights reserved.
Contents EMC CLARiiON PRO Storage System Performance Management Pack Guide... 5 Introduction to the EMC CLARiiON PRO Storage System Performance Management Pack... 5 What's New... 5 Supported Configurations... 6 Getting Started... 6 Before You Import the Management Pack... 6 Files in This Management Pack... 7 Recommended Additional Management Packs... 8 Other Requirements... 9 How to Import the EMC CLARiiON PRO Storage System Performance Management Pack. 11 Create a New Management Pack for Customizations... 12 Optional Configuration... 12 Configuring Discovery Rules... 12 Collection Rules... 13 Security Considerations... 13 Low-Privilege Environments... 13 Run As Profiles... 14 Understanding Management Pack Operations... 14 Objects the Management Pack Discovers... 14 Classes... 15 How Health Rolls Up... 18 Key Monitoring Scenarios... 18 Troubleshooting... 19 Appendix: Scripts... 19 Storage System Host Discovery... 20 Virtual Machine Discovery... 21 Create Proxy Event... 22 Create Recovery Event... 24 Storage Migration Recovery... 26
EMC CLARiiON PRO Storage System Performance Management Pack Guide Document Version This guide was written based on the 1.0.0.0 version of the EMC CLARiiON PRO Storage System Performance Management Pack. Revision History Release Date Changes 12/31/2010 Original release of this guide 04/14/2011 Removed symapi_licenses.dat file requirement for VDS and added configuration step. Removed volatile FreeSpace property from class EMC.CLARiiON.PRO.StorageSystem.Performance.Host.LogicalDisk. Introduction to the EMC CLARiiON PRO Storage System Performance Management Pack SAN and Hyper-V administrators will find the EMC CLARiiON PRO Storage System Performance Management Pack a valuable addition to managing their virtualization infrastructure with System Center Virtual Machine Manager (SCVMM). It will enable them to either manually or automatically remediate storage performance issues with their CLARiiON storage systems. It is ideally suited for environments where administrators create virtual machines that use dynamically expanding hard disks. Getting the Latest Management Pack and Documentation The EMC CLARiiON PRO Storage System Performance Management Pack is part of the EMC System Center PRO Management Packs. You can find a link to these management packs in the System Center Management Pack Catalog or on Powerlink. What's New The following features are new in this release of the EMC CLARiiON PRO Storage System Performance Management Pack: Discovery of CLARiiON storage system volumes and their hosted Virtual Hard Disks (VHDs) on Hyper-V Servers. 5
Performance health monitoring of CLARiiON storage system volumes. Performance Resource Optimization (PRO) Tips and Operations Manager alerts for when a storage system volume is low on disk space for Virtual Machines (VMs). Health monitoring dashboard views for storage system hosts and logical disks. Configuration diagram views for current SCVMM PRO settings. Storage system host diagram views for computer and host groups. Supported Configurations The EMC CLARiiON PRO Storage System Performance Management Pack for Operations Manager 2007 supports the following configurations: System Center Virtual Machine Manager 2008 R2 Operations Manager 2007 R2 Windows Server 2008 R2 configured with the Hyper-V Role and acting as a CLARiiON storage system host Operations Manager 2007 Agent installed on the Windows server Any EMC CLARiiON Storage System in the AX and CX series There are no known limitations except for system resource constraints. Getting Started This section describes the actions you should take before you import the management pack, any steps you should take after you import the management pack, and information about customizations. Before You Import the Management Pack Before you import the EMC CLARiiON PRO Storage System Performance Management Pack, note the following limitations of the management pack: SCOM agentless monitoring should be possible but has not yet been tested and verified. Before you import the EMC CLARiiON PRO Storage System Performance Management Pack, take the following actions: Make a list of your Hyper-V servers that are using CLARiiON storage system volumes. Decide which of those Hyper-V servers will be supporting VMs that may grow beyond the current storage allocation. Make a list of the storage systems being hosted by those Hyper-V servers. 6
Make a list of the storage system serial numbers and their management ports. Configure the SCOM Run As account as an administrator on those Hyper-V servers. Files in This Management Pack The EMC CLARiiON PRO Storage System Performance Management Pack is part of the EMC System Center PRO Management Packs. You can find a link to these management packs in the System Center Management Pack Catalog or on Powerlink. The files associated with the management pack are: EMC.CLARiiON.PRO.StorageSystem.Performance.mp EMC.CLARiiON.PRO.StorageSystem.Performance.MPGuide.doc ReadMe.rtf ReleaseNotes.doc EULA.rtf EMC.CLARiiON.PRO.StorageSystem.Performance.Overrides.xml Microsoft.Windows.HyperV.2008.Discovery.Overrides.xml Microsoft.Windows.HyperV.2008.Monitoring.Overrides.xml Before you import the EMC CLARiiON PRO Storage System Performance Management Pack, you must install the following dependent management packs: Windows Core Library Microsoft.Windows.Library.mp Version 6.0.6278.0 Note: imported during the SCOM 2007 installation Windows Server Operating System Library Microsoft.Windows.Server.Library.mp Version 6.0.6321.5 Download: Windows Server Operating System Management Pack for Operations Manager 2007 Windows Server 2008 Operating System (Discovery) Microsoft.Windows.Server.2008.Discovery.mp Version 6.0.6667.0 Download: Windows Server Operating System Management Pack for Operations Manager 2007 Microsoft Windows Hyper-V Library Microsoft.Windows.HyperV.Library.mp 7
Version 6.0.6633.0 Download: Windows Server Hyper-V Management Pack for System Center Operations Manager 2007 Microsoft Windows Hyper-V 2008 Discovery Microsoft.Windows.HyperV.2008.Discovery.mp Version 6.0.6633.0 Download: Windows Server Hyper-V Management Pack for System Center Operations Manager 2007 Microsoft Windows Hyper-V 2008 Monitoring Microsoft.Windows.HyperV.2008.Monitoring.mp Version 6.0.6633.0 Download: Windows Server Hyper-V Management Pack for System Center Operations Manager 2007 System Center Virtual Machine Manager 2008 R2 PRO Library Microsoft.SystemCenter.VirtualMachineManager.Pro.2008.Library.mp Version 2.0.3451.0 Download: System Center Virtual Machine Manager 2008 Management Pack for System Center Operations Manager 2007 Note If you do not install these management packs before you install the EMC CLARiiON PRO Storage System Performance Management Pack, your installation will fail. Recommended Additional Management Packs The following are additional management packs that assist in managing EMC CLARiiON storage systems: EMCPowerPathManagementPackOpsMgr EMCPowerPathManagementPackOpsMgr.mp Version: 1.0.0.0 Download: PowerPath Management Pack for Microsoft Operations Manager SCOM-2007 This management pack raises alerts for SNMP traps related to Multipath I/O (MPIO) issues. 8
EMC System Center Management Packs Version 1.0.0 Download: Search System Center Management Pack Catalog These management packs provide service discovery and health monitoring of CLARiiON storage systems, SMI-S Management Servers and the SAN Fabric. Other Requirements The EMC CLARiiON PRO Storage System Performance Management Pack in order to perform PRO recovery actions has the following other requirements. CLARiiON command line interface (CLI) is must be installed on the SCOM Management Server. Run the Naviseccli installation program. To check what version of the command line interface (CLI) that you have installed execute naviseccli -help in a command shell. Security credentials for accessing the storage systems must be stored on the SCOM Management Server. To create and save the credentials perform the following steps: o o Log on to the SCOM server. Add the storage system administration account(s) to the security file by executing the following in a command shell. naviseccli -AddUserSecurity -scope 0 -user Username -password Pswd Note: This will create the security files SecuredCLISecurityFile.xml and SecuredCLIXMLEncrypted.key in your %USERPROFILE% path. Scope can be either local or global. Here we show global. Check your storage system domain administration accounts for their correct scoping. o o Copy the security files SecuredCLISecurityFile.xml and SecuredCLIXMLEncrypted.key from your %USERPROFILE% path to the Navisphere CLI installation folder i.e. C:\Program Files (x86)\emc\navisphere CLI. Delete the security files from your %USERPROFILE% path. A LUN must be manually pre-provision for storage migration on each CLARiiON storage system that is supporting a managed Hyper-V server. The LUN should be at least 2 GB larger than any of the LUNs currently in use by the Hyper-V server. Use either the Navisphere or Unisphere Manager, depending on your FLARE version, to create the LUN. Append to the name of the new LUN the following text - PRO Storage Migration. 9
Virtual Disk Service (VDS) support is required on the SCOM Management Server and on each storage system host that is supporting a managed Hyper-V server. Install the EMC Hybrid VDS Hardware Provider 4.4.0 or later by running the Solution Enabler (SE) VDS installation program version 7.2.0.0-1108 or later. VDS must be configured with each CLARiiON storage system that the host will manage. See the EMC VDS Provider Release Notes, on EMC Powerlink, for using the symcfg utility to authorize and discover CLARiiON storage systems. File microsoft.storage.vds.dll, Microsoft Storage VDS.NET library version 1.0.0.0, file version 6.1.7600.16385, or later, should be available on all Windows Server 2008 R2 machines. A CLARiiON Storage System Configuration file. This file can be created by performing the following steps: o Get EMC storage system serial number to management port IP Address mapping. This can be done by executing the following Naviseccli command for each storage system. The IP address is for one of the storage system management ports. C:\Users\administrator.SR5DOM>naviseccli -address 10.5.223.183 domain -list Node: APM00091400029 IP Address: 10.5.223.184 Name: B-IMAGE Port: 80 Secure Port: 443 IP Address: 10.5.223.183 (Master) Name: A-IMAGE Port: 80 Secure Port: 443 C:\Users\administrator.SR5DOM>naviseccli -address 10.5.223.185 domain -list Node: APM00091400031 IP Address: 10.5.223.185 (Master) Name: A-IMAGE Port: 80 Secure Port: 443 IP Address: 10.5.223.186 Name: B-IMAGE Port: 80 10
Secure Port: 443 o o Create a simple empty text file named ClarStorageSystems.cfg in the Navisphere CLI installation folder. Add to the configuration file the storage system serial number and management port as shown below. Note that both management ports have been added for the first storage system and while only one for the second. Which management ports you add depends on how you want or need to control access to the storage system. APM00091400029, 10.5.223.183 APM00091400029, 10.5.223.184 APM00091400031, 10.5.223.185 How to Import the EMC CLARiiON PRO Storage System Performance Management Pack For instructions about importing a management pack, see How to Import a Management Pack in Operations Manager 2007 (http://go.microsoft.com/fwlink/?linkid=142351). After the EMC CLARiiON PRO Storage System Performance Management Pack is imported, for each of the following management packs, create a new management pack in which to store overrides and other customizations or import the one provided. 1. EMC CLARiiON PRO Storage System Performance Management Pack EMC CLARiiON PRO Storage System Performance Overrides EMC.CLARiiON.PRO.StorageSystem.Performance.Overrides.xml Version: 1.0.0.0 2. Microsoft Windows Hyper-V 2008 Discovery Management Pack Microsoft Windows Hyper-V 2008 Discovery Overrides Microsoft.Windows.HyperV.2008.Discovery.Overrides.xml Version: 1.0.0.0 3. Microsoft Windows Hyper-V 2008 Monitoring Management Pack 11
Microsoft Windows Hyper-V 2008 Monitoring Overrides Microsoft.Windows.HyperV.Monitoring.Overrides.xml Version: 1.0.0.0 Create a New Management Pack for Customizations Most vendor management packs are sealed so that you cannot change any of the original settings in the management pack file. However, you can create customizations, such as overrides or new monitoring objects, and save them to a different management pack. By default, Operations Manager 2007 saves all customizations to the default management pack. As a best practice, you should instead create a separate management pack for each sealed management pack you want to customize. Creating a new management pack for storing overrides has the following advantages: It simplifies the process of exporting customizations that were created in your test and preproduction environments to your production environment. For example, instead of exporting a default management pack that contains customizations from multiple management packs, you can export just the management pack that contains customizations of a single management pack. You can delete the original management pack without first needing to delete the default management pack. A management pack that contains customizations is dependent on the original management pack. This dependency requires you to delete the management pack with customizations before you can delete the original management pack. If all of your customizations are saved to the default management pack, you must delete the default management pack before you can delete an original management pack. It is easier to track and update customizations to individual management packs. Optional Configuration Depending upon how dynamic your virtualized environment is and existing Service Level Agreements (SLAs), you may need to adjust certain discovery and monitoring rules within the management pack. All rules are enabled by default. Configuring Discovery Rules The following EMC CLARiiON PRO Storage System Performance Management Pack discovery intervals should be tuned to how frequently your environment is changing. If a default value is not appropriate for your environment, you should adjust the value overriding it. 12
Rule Name CLARiiON Storage System Host Discovery Virtual Machine Discovery Interval (seconds) Default Value 14400 (4 hours) 14400 (4 hours) Also, in the Microsoft Windows Hyper-V 2008 Discovery Management Pack is the following discovery for a Hyper-V 2008 Virtual Machine that the Free Disk Space Collection Rule in the Microsoft Windows Hyper-V 2008 Monitoring Management Pack is targeted against. Rule Name Hyper-V 2008 Virtual Machine Discovery Interval (seconds) Default Value 43200 (12 hours) Collection Rules The following Microsoft Windows Hyper-V 2008 Monitoring Management Pack collection interval should be tuned to how frequently your environment is changing. If a default value is not appropriate for your environment, you should adjust the value overriding it. Rule Name Interval (seconds) Default Value Category Free Disk Space Collection Rule 3600 (1 hour) State Collection Security Considerations The EMC CLARiiON PRO Storage System Performance management pack has no special security considerations other than having storage system credentials stored on hosts. See previous section on Other Requirements. Low-Privilege Environments A low-privilege agent action account must meet the following requirements: Member of the local administrators group on the Hyper-V servers and SCOM Server. The following management pack tasks cannot be run using a low-privilege account. These tasks require that the Action account have Admin user rights on the agent computer: Discoveries Monitors Recoveries 13
Run As Profiles Discoveries, Monitors and Write Action Modules all use Default Run As profile. Data Source Modules use System.PrivilegedMonitoringAccount profile. Understanding Management Pack Operations The EMC CLARiiON PRO Storage System Performance Management Pack monitors Hyper-V servers that are experiencing storage issues with CLARiiON volumes being used to host VHD files. Objects the Management Pack Discovers In addition to the boilerplate text below, you should include information about object discoveries that will help your customer deploy the management pack. For example, if one type of discovery before the next object type is discovered, it s helpful for the customer to know that, and also to know how long (by default settings) it will take for complete discovery. The EMC CLARiiON PRO Storage System Performance Management Pack discovers the object types described in the following table. All of these objects are automatically discovered. Use overrides to tune their discovery intervals or disable their discovery. For information about discovering objects, see the "Object Discoveries in Operations Manager 2007" topic in Operations Manager 2007 Help (http://go.microsoft.com/fwlink/?linkid=108505). Discovery Name Object Type Interval (seconds) Default Value CLARiiON Storage System Host Discovery CLARiiON Storage System Host 14400 (4 hours) Virtual Machine Discovery Hyper-V Virtual Hard Disk 14400 (4 hours) CLARiiON Storage System Host CLARiiON Storage System Host Logical Disk CLARiiON Storage System Host Computer Group Discovery PRO Critical Alerts Host Group Health Discovery PRO Warnings and Critical Alerts Host Group Discovery CLARiiON Storage System Host Computer Group CLARiiON Storage System Hosts Enabled for Critical PRO Tips Group CLARiiON Storage System Hosts Enabled for Warning and Critical PRO Tips Group SCOM On Demand SCOM On Demand SCOM On Demand 14
CLARiiON Storage System Host Group Discovery PRO Automatic Recovery Critical Alerts Host Group Discovery PRO Automatic Recovery Warnings and Critical Alerts Host Group Discovery CLARiiON Storage System Host Group CLARiiON Storage System Hosts Enabled for Automatic Implementation of Critical PRO Tips Group CLARiiON Storage System Hosts Enabled for Automatic Implementation of Warning and Critical PRO Tips Group SCOM On Demand SCOM On Demand SCOM On Demand Use the following procedure to enable or disable automatic discovery. The procedure enables the SQL 2005 Agent Job as an example. To use an override to change the setting for automatic discovery 1. In the Authoring pane, expand Management Pack Objects, and then click Object Discoveries. 2. On the Operations Manager toolbar, click Scope, and then filter the objects that appear in the details pane to include only CLARiiON Storage System Host objects. 3. Under Object Discoveries click CLARiiON Storage System Host Discovery. Note: In Operations Manager 2007 R2, click Change Scope. 4. On the Operations Manager toolbar, click Overrides, click Override the Object Discovery, and then click For all objects of class: PRO Hyper-V Host Target. 5. In the Overrides Properties dialog box, click the Override box for the Interval in seconds parameter and enter the desired value in Override Value column. 6. Under Management Pack, click New to create an unsealed version of the management pack, and then click OK, or select an unsealed management pack that you previously created in which to save this override. As a best practice, you should not save overrides to the Default Management Pack. After you change the override setting the object type will now be discovered using the new interval value. Classes The following diagrams show the class inheritance and relationships defined in this management pack. 15
Figure 1 Class Inheritance 16
Figure 2 Class Relationships 17
How Health Rolls Up Performance health is rolled up to the CLARiiON Storage System Host and then to respective groups depending on the monitoring context. CLARiiON Storage System Host Computer Group CLARiiON Storage System Hosts Enabled for Critical PRO Tips Group CLARiiON Storage System Hosts Enabled for Warning and Critical PRO Tips Group CLARiiON Storage System Host Group CLARiiON Storage System Hosts Enabled for Automatic Implementation of Critical PRO Tips Group CLARiiON Storage System Hosts Enabled for Automatic Implementation of Warning and Critical PRO Tips Group Rollup to the CLARiiON Storage System Host is as follows: Logical Disk for Host Performance Health Rollup: this is a dependency monitor that rolls up CLARiiON Storage System Host Logical Disk performance to the host. Virtual Hard Disk Free Disk Space Health Rollup: This is a dependency monitor that rolls up Hyper-V 2008 Virtual Machine health to its CLARiiON Storage System Host Logical Disk. Virtual Hard Disk free disk space: this is a unit monitor that changes state based on available disk space on a logical disk. Key Monitoring Scenarios The EMC CLARiiON PRO Storage System Performance Management Pack supports monitoring CLARiiON storage system issues for Hyper-V servers. The following table lists some of those monitoring scenarios and indicates the elements that can be modified. Scenario Low Disk Space for VMs Configurable Elements The Virtual Hard Disk free disk space monitor is targeted at the Hyper-V Virtual Hard Disk. It is configured, by default, to enter a Warning State when the available free space on a logical disk falls below 2048 MB or 2 GB. The Critical State is entered when space falls below 2 MB. The management will provide remediation when the monitor enters the Critical State. 18
Troubleshooting Scripts contained within the EMC CLARiiON PRO Storage System Performance Management Pack will raise events in the Windows Application Log using an event source of EMC.CLARiiON.PRO.StorageSystem.Performance. Event IDs have been allocated for the following use. 100-199 Events typically used for only informational purposes. They may sometimes also be used to control management pack workflow. 200-299 Informational events used only for controlling management pack workflow. 300-399 Error events that indicated script failures. Appendix: Scripts This section provides information about each of the scripts contained within the EMC CLARiiON PRO Storage System Performance Management Pack. Script Purpose Rule Default Frequency Storage System Host Discovery Discovers Hyper-V servers that are also CLARiiON Storage System Hosts. CLARiiON Storage System Host Discovery 14400 seconds or 4 hours Virtual Machine Discovery Discovers Virtual Machine VHDs on Logical Disks hosted by CLARiiON Storage System Hosts. Virtual Machine Discovery 14400 seconds or 4 hours Create Proxy Event Creates event 100 in the Windows Application Log containing the logical and physical identity of a disk. This event will cause an alert and corresponding PRO Tip against the host. Virtual Hard Disk Free Disk Space Health Rollup Monitor Runs when dependent monitor Virtual Hard Disk free disk space enters Critical State Create Recovery Event Creates event 200 in the Windows Application Log containing the logical and physical identity of a disk as well as the information required to Logical Disk Has No Free Disk Space Monitor Runs administrator implements the PRO Tip either automatically or 19
Script Purpose Rule Default execute a PRO Tip recovery on the SCOM Management server. This script only initiates the PRO recovery. It does not perform it. Frequency manually Storage Migration Recovery Implements the PRO Tip recovery. Performs a LUN Migration on the CLARiiON storage system for the logical disk that was detected as being low on free disk space. Logical Disk No Free Disk Space Recovery Rule Runs when event 200 appears in the Windows Application Log Storage System Host Discovery The Storage System Host Discovery script discovers Hyper-V servers that are also CLARiiON Storage System Hosts. Parameters The script has no configurable parameters. Parameter Name Default Value Valid Range What it Does strsourceid $MPElement$ GUID of the discovery object that runs the script. strmanagedentityid $Target/Id$ GUID of the computer class that is targeted by the script. strprincipalname $Target/Host/Property [Type="Windows! Microsoft.Windows.Computer"]/ PrincipalName$ Fully Qualified Domain Name of the computer that is targeted by the script. Permissions For the script to run successfully the Run As account must have enumerate and read access to WMI classes in the root\cimv2 namespace on the targeted computer. 20
How the Script Works The script creates a discovery data class instance as identified by the input parameters for the EMC.CLARiiON.PRO.StorageSystem.Performance.Host class. The properties of the class are only set if it finds a CLARiiON disk drive being hosted by the targeted computer. The targeted computer is a managed Hyper-V server. A CLARiiON disk drive is identified based on the values contained in the Caption, DeviceID, Model and PNPDeviceID properties of the Win32_DiskDrive class. Events The script raises no events. Virtual Machine Discovery The Virtual Machine Discovery script discovers virtual machine hard disks on logical disks hosted by CLARiiON storage systems hosts. Parameters The script has no configurable parameters. Parameter Name Default Value Valid Range What it Does strsourceid $MPElement$ GUID of the discovery object that runs the script. strmanagedentityid $Target/Id$ GUID of the computer class that is targeted by the script. strprincipalname strnetworkname $Target/Host/Property [Type="Windows! Microsoft.Windows.Computer"]/ PrincipalName$ $Target/Host/Property [Type="Windows! Microsoft.Windows.Computer"]/ NetworkName$ Fully Qualified Domain Name of the computer that is targeted by the script. The computer name of the computer that is targeted by the script. Permissions For the script to run successfully the Run As account must have enumerate and read access to WMI classes in the root\virtualization and root\cimv2 namespaces on the targeted computer. 21
How the Script Works The script discovers the Virtual Hard Drive (VHD) files of all VMs running on the targeted host computer. For any CLARiiON disk drive that is hosting one or more of these VHD files, it creates the following discovery data class instances based on the specified input parameters. EMC.CLARiiON.PRO.StorageSystem.Performance.Host EMC.CLARiiON.PRO.StorageSystem.Performance.Host.LogicalDisk Microsoft.Windows.HyperV.VirtualDrive Note that the Microsoft.Windows.HyperV.VirtualDrive class is not part of this management pack but the Microsoft.Windows.HyperV.Library management pack. The script also discovers these local relationships for the discovered classes. EMC.CLARiiON.PRO.StorageSystem.Performance.LogicalDiskContainsVirtualDrive EMC.CLARiiON.PRO.StorageSystem.Performance.HostHostsLogicalDisk Events The script raises no events. Create Proxy Event The Create Proxy Event script creates event 100 in the Windows Application Log containing the logical and physical identity of a disk. This event will cause an alert and corresponding PRO Tip against the host. Parameters The script has no configurable parameters. Parameter Name Default Value Valid Range What it Does $Config/EventParameter$ "$Target/Property[Type= "EMC.CLARiiON.PRO. StorageSystem.Performance. Host.LogicalDisk"]/DeviceID$" ; "$Target/Property[Type= The disk drive ID and computer hosting that disk. For example: C:;computer.corp.co.com 22
Parameter Name Default Value Valid "EMC.CLARiiON.PRO. StorageSystem.Performance. Host.LogicalDisk"]/SystemFQ DN$" Range What it Does Permissions For the script to run the Run As account must have administrator rights on the target computer. How the Script Works The script creates an informational event with ID 100 and source EMC.CLARiiON.PRO.StorageSystem.Performance in the Windows Application Event Log. The event description contains a string of the following format. DriveLetterID:SerialNumber:Caption:DeviceID For example: E:APM00091400029:DGC RAID 10 SCSI Disk Device:\\.\PHYSICALDRIVE14 S:APM00091400029:PowerDevice by PowerPath:\\.\PHYSICALDRIVE8 Events The script raises the following events in the Windows Application Event Log with source EMC.CLARiiON.PRO.StorageSystem.Performance. Event Number Purpose 100 To cause an alert and corresponding PRO Tip against the host. To pass along the logical and physical identity of a disk, DriveLetterID:SerialNumber:Caption:DeviceID, to the Create Recovery Event script. 300 Error message: "Invalid number of parameters passed to script executing to get the physical disk drive identity of a logical disk drive" 301 Error message: "Invalid parameter content passed to script executing to get the physical disk drive identity of a logical disk drive" 23
Event Number Purpose 302 Error message: "Invalid drive letter identifier passed to script executing to get the physical disk drive identity of a logical disk drive" 303 Error message: "Failed to get physical disk drive identity of logical disk drive " Rules The script generates alerts using the rules in the following table. Rule Logical Disk Has No Free Disk Space Description A unit monitor that changes to an unhealthy state for event ID 100, generates an alert and runs response Logical Disk Has No Free Disk Space Recovery. Create Recovery Event The Create Recovery Event creates event 200 in the Windows Application Log containing the logical and physical identity of a disk as well as the information required to execute a PRO Tip recovery on the SCOM Management server. This script only initiates the PRO recovery. It does not perform it. Parameters The script has no configurable parameters. Parameter Name Default Value Valid Range What it Does EventParameter "$Target/Property[Type= "SCVMMPro2008Library!Microsoft.SystemCenter. VirtualMachineManager.Pro.2008.Base"]/Name$" : "$Target/Property[Type= "SCVMMPro2008Library!Microsoft.SystemCenter. VirtualMachineManager.Pro.2008.Base"]/VMMServer$" : "$Data/StateChange/DataItem/EventOriginId$" : "200" : ""$Data/StateChange/DataItem/Context/DataItem/Event Description$"" Provides the data that is included in the event description of the created event. 24
Permissions For the script to run the Run As account must have administrator rights on the target computer. How the Script Works The script creates an informational event with ID 200 and source EMC.CLARiiON.PRO.StorageSystem.Performance in the Windows Application Event Log on the SCOM Management Server. The event description contains a string of the following format. ScomServer : VmmServer: EventOriginId : 200 : DriveLetterID:SerialNumber:Caption:DeviceID For example: ScomServer.domain.company.com : VmmServer.domain.company.com: {20f14265-1432-4a20-94c2-a2e4c44f2350} : 200 : E:APM00091400029:DGC RAID 10 SCSI Disk Device:\\.\PHYSICALDRIVE14 ScomServer.domain.company.com : VmmServer.domain.company.com: {20f14265-1432-4a20-94c2-a2e4c44f2351} : 200 : S:APM00091400029:PowerDevice by PowerPath:\\.\PHYSICALDRIVE8 Where EventOriginId, the GUID string, above is the PRO Tip ID. Events The script raises the following events in the Windows Application Event Log with source EMC.CLARiiON.PRO.StorageSystem.Performance. Event Number Purpose 200 To implement a PRO Tip that runs on the SCOM Management Server. To pass along the data received from the Create Proxy Event script to the Storage Migration Recovery script. To include any other information required to run the recovery, ScomServer : VmmServer: EventOriginId : 200 : DriveLetterID:SerialNumber:Caption:DeviceID. 300 Error message: "Invalid number of parameters passed to script executing to initiate PRO recovery" 301 Error message: "Invalid parameter content passed to script executing to initiate PRO 25
Event Number Purpose recovery" Storage Migration Recovery The Storage Migration Recovery script implements the PRO Tip recovery. It performs a LUN Migration on the CLARiiON storage system for the logical disk that was detected as being low on free disk space. Parameters The script has no configurable parameters. Parameter Name Default Value Valid Range What it Does EventDescription $Data/EventDescription$ Contains the script parameters. Permissions For the script to run the Run As account must have administrator rights on the SCOM Management Server. How the Script Works This is a PowerShell script that parses its input parameter, the event description, to extract the following parameters. Parameter Name $hostname $servername $ProtipId $eventid $driveletter $serialnumber $caption What it Does Storage system host VMM Server PRO Tip associated with this recovery Windows Event ID initiating this recovery Drive on host to be migrated Serial number of storage system Friendly name of disk device on host 26
Parameter Name $deviceid What it Does Physical device ID of disk on host It then performs the following steps: 1. Connects to the VMM Server, $servername, and sets the status of the specified PRO Tip, $ProtipId, to Running. 2. Migrate the LUN specified by $hostname, $serialnumber, $caption, $deviceid, and $driveletter to the LUN that has - PRO Storage Migration appended to its name. a. Connect to the VDS service and EMC provider, "EMC Hybrid VDS Hardware Provider", on the target host. b. Get the specified storage system, subsystem, using the EMC VDS provider. c. Get the source LUN ID based on the specified physical device ID. d. Re-enumerate the subsystem in order to pick up any storage system changes. e. Get the destination LUN ID based on the name of the pre-provisioned marked LUN i.e. - PRO Storage Migration. f. Get the management port IP addresses for the specified storage system from the ClarStorageSystems.cfg file. g. Migrate storage by using navisseccli targeted against each of the available management ports for the storage system until one is reached. h. Re-enumerate the subsystem in order to pick up any storage system changes. i. Refresh the VDS service in order to update disk ownership and layout information. j. Get the Basic software provider, "Microsoft Virtual Disk Service Basic Provider" and extend the specified volume now that it has larger LUN. 3. Set the PRO Tip status according to the result of the storage migration, Failed or Resolved, and raise an event in the Windows Application Event Log. Events The script raises the following events in the Windows Application Event Log with source EMC.CLARiiON.PRO.StorageSystem.Performance. Event Number Purpose 101 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 using management port "IP Address" has started the migration of LUN "Source LUN ID" to LUN "Destination LUN ID" 102 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 successfully migrated storage for drive $driveletter: on host $hostname 27
Event Number Purpose 300 Invalid number of parameters passed to script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 301 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to migrate storage for drive $driveletter: on host $hostname 302 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to connect to the VDS service and EMC Hybrid VDS Hardware Provider on host $hostname 303 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to get an EMC Hybrid VDS Hardware Provider instance on host $hostname 304 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to get a subsystem instance on host $hostname for storage system $serialnumber 305 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to get the physical disk instance for device ID $deviceid on host $hostname 306 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to find the LUN in storage system $serialnumber with 'PRO Storage Migration' appended to its name 307 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to get value InstalledLocation under registry key HKLM:\Software\EMC\Navisphere CLI 308 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to access or get the contents of storage system configuration file %USERPROFILE%\ClarStorageSystems.cfg 309 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 using management port "IP Address" failed to monitor or timed out monitoring migrating LUN "Source LUN ID" to LUN "Destination LUN ID" 310 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 using management port "IP Address" failed to migrate LUN "Source LUN ID" to LUN "Destination LUN ID"; Result Message 311 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to reenumerate subsystem instance $serialnumber on host $hostname; "Exception Message" 312 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to refresh the VDS service on host $hostname; :Exception Message" 313 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to get a Microsoft Virtual Disk Service Basic Provider instance on host $hostname 28
Event Number Purpose 314 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 failed to find an instance of volume $driveletter: on the physical disk 315 Script EMC.CLARiiON.PRO.StorageSystem.Performance.Recovery.ps1 did not extend volume?: 29
This document was created with Win2PDF available at http://www.win2pdf.com. The unregistered version of Win2PDF is for evaluation or non-commercial use only. This page will not be added after purchasing Win2PDF.