HP StorageWorks MSA2000 G2 SMI-S Proxy Provider User Guide This document provides information for network administrators who are managing MSA2000 G2 product from a storage management application through SMI-S, including use of the MSA2000 Proxy Settings Manager (PSM).
Legal and notice information © Copyright 2009 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Introduction ....................................................................................... 7 SMI-S Support ............................................................................................................................ 8 2 Installing and uninstalling the SMI-S Proxy Provider ............................... 11 Windows ................................................................................................................................. 11 Linux ...................
Documentation feedback ........................................................................................................... 45 Glossary ............................................................................................
Figures 1 SMI-S Proxy Provider overview .................................................................................... 7 2 HP Package Setup dialog ......................................................................................... 11 3 Pegasus service in the Services window ..................................................................... 12 4 Pegasus installation directory ....................................................................................
Tables 1 Supported SMI-S profiles ............................................................................................ 8 2 Supported indication events ....................................................................................... 9 3 PSM commands ...................................................................................................... 16 4 Pegasus CIMOM operations ..................................................................................... 37 5 Document conventions ...
1 Introduction The SMI-S Proxy Provider provides an industry-standard WBEM-based management software framework for MSA2000 G2 products that can be integrated with various HP Enterprise management software applications, such as HP SIM. This release supports: • • • • MSA2312fc and 2324fc MSA2312sa and 2324sa MSA2312i and 2324i Passive management features Support for the following is planned for future releases: • Active management features, such as RAID provisioning Figure 1 SMI-S Proxy Provider overview .
This product carries OpenPegasus CIMOM and is supported on both Windows and Linux platforms. The proxy provider set includes the following: • • • • Instance Provider Association Provider Method Provider Indication Provider SMI-S Support The SMI-S Proxy Provider supports passive management features described in Table 1, page 8. Table 1 Supported SMI-S profiles Profile / Subprofile Description Array Describes RAID array systems. It provides a high-level overview of the array system.
This provider supports the following CIM operations: • • • • • • • • • • • getClass enumerateClasses enumerateClassNames getInstance enumerateInstances enumerateInstaneceNames associators associatorNames references referenceNames invokeMethod The Proxy Provider supports the CIM Alert Indication events listed in Table 2, page 9.
Introduction
2 Installing and uninstalling the SMI-S Proxy Provider Windows The Windows package comes as a Smart Component with installers for Pegasus CIMOM, HP Proxy Settings Manager, and MSA2000 G2 SMI-S Proxy Provider. The SMI-S Proxy Provider can be installed on any ProLiant Server running Windows or Linux that has Ethernet connection to the MSA2000 G2 Storage Enclosures. The SMI-S proxy will communicate to all of the MSA2000 G2 Storage enclosures via the Ethernet-based embedded storage management processor.
5. Select Typical Installation and click OK to install Pegasus, the Proxy Providers, and PSM automatically. The installation status is displayed on the user interface. Installation typically takes 6–8 minutes. NOTE: If a Pegasus CIMOM is already installed on the server and is version 2.7.0 or above, the installer will skip the CIMOM installation and integrate the provider set into the existing CIMOM installation. If a Pegasus CIMOM is already installed on the server and is a version lower than 2.7.
7. Click View Logs to see the installation logs. For additional log files see: • /cpqsystem/log/Installbat.log — log of scripts run during installation • /cpqsystem/log/msiexec_PSM.log — log of PSM msi installation • /cpqsystem/log/cp009873.log — log of SmartComponent installation NOTE: For a typical installation, Open Pegasus and Proxy Providers are installed into the HPMSAPegasus folder under the Windows system drive as shown in Figure 4, page 13.
• Port 5989 should be free and available for use by the Pegasus CIMOM. To install the package: 1. 1. Untar the package using the following command: tar -zxvf HPMSA2000_Proxy.tgz nl This creates the HPMSA2000_Proxy directory and extracts all of the files into it. 2. Navigate into the HPMSA2000_Proxy folder. 3. Execute the install script, ./install.sh, to install the Proxy Providers and PSM products. The installation log is in the msaproxyinstall.log file. To uninstall the package: 1.
3 Configuring the Proxy Provider The PSM is a CLI-based MSA storage management software tool that provides simple configuration and management tasks of the proxy providers. The PSM is installed as part of the SMI-S Proxy Provider.
To assign a free port, edit the service.properties configuration file located in the \hpmsa\fcproxy folder with the SSL port number (httpsPort=xxxx) and try starting the CIMOM again through the service application. If the service application is successful in starting the CIMOM, it updates the service.properties file with the actual port number. For the non-SSL connections, port 5988 must be available for the CIMOM to support non-SSL connection requests from clients such as PSM.
Add system Description Adds an MSA2000 device to the proxy provider management repository. Syntax add Prompts IP address of the device to be added Output On success, displays the TopComputerSystem object path. Additionally, retrieves the list of devices currently added to the server as shown in Figure 5, page 17. Refer to View Systems section for the output of the view systems option. On failure, displays the error message with possible cause. Figure 5 Output of add system command .
Remove system Description Removes an already added MSA2000 device from the proxy provider management repository. Syntax remove Prompts Retrieves the list of devices currently added in the server and prompts the user to enter the index number of the device to be removed. The index number is a unique number generated by the proxy settings manager application per device in the proxy provider management repository. Refer to View Systems section for the output of the view systems option.
Discover systems Description Discovers all the MSA2000 devices present in the local subnet where the application is running. Subsequently, adds all the discovered devices to the proxy provider management repository. The discover option can only be run when Pegasus CIMOM and PSM are running on the same system. Syntax discover Prompts Displays a warning message This might take a very long time depending on the subnet and asks the user whether to proceed or not.
View systems Description Displays the list of MSA2000 devices currently in the proxy provider management repository. Syntax view Output On success, the view command displays information about all devices currently added in the proxy provider management repository in the format nl as shown in Figure 8, page 20.
Figure 9 Output of the view op command .
Clear systems Description Removes all the currently added MSA2000 devices in the proxy provider management repository. Syntax clear Prompts Retrieves the list of currently added devices in the proxy provider management repository and asks the user whether to proceed or not. Output On success, acknowledges the removal of all the devices from the proxy provider management repository as shown in Figure 10, page 22. On failure, displays the error message with possible cause.
Manage system Description Helps user to perform some simple management tasks on a particular MSA2000 device. Only the devices that are part of the proxy provider management repository can be managed through this interface. The manage command lets the user to create a user account, delete a user account, and change the password of an existing user account in the MSA2000 device. Syntax manage Prompts Displays the list of currently added MSA2000 devices in the proxy provider management repository.
Create user account in the MSA device Description Creates a Manage/Monitor user account in the MSA device. This command is invoked from the PSM MANAGE prompt. Syntax create Prompts User login details necessary to create new user account if not yet entered in this session. Then prompts for all the input parameters required to create a new user account – username, password, account level, account type and interfaces. Enter nothing to consider the default values.
Change user password in the MSA device Description Changes the password of an existing Manage/ Monitor user account in the MSA device. Syntax change Prompts User login details needed to change the password for an existing user account, if not yet entered in this session, and then prompts for the user name and the new password. Output On success, acknowledges the change of the password as shown in Figure 13, page 25. On failure, displays the error message with possible cause.
Delete user account in the MSA device Description Deletes an existing Manage/ Monitor user account in the MSA device. Syntax delete Prompts User login details needed to change the password for an existing user account, if not yet entered in this session, and then prompts for the user name to delete. Output On success, acknowledges the deletion of the user account as shown in Figure 14, page 26. On failure, displays the error message with possible cause.
Get or set provider attributes Description Gets or sets the Proxy Provider timeout value, the indication provider polling interval value, and the debug log level currently set for the proxy provider. When entered without any parameters, retrieves the respective values of the attributes from the proxy provider. Syntax get set Output On success, displays the attribute values as shown in Figure 15, page 27. On failure, displays the error message with possible cause.
Set Proxy Provider timeout Description Sets the Proxy Provider timeout value for the proxy providers. Syntax set timeout Prompts Enter the timeout value in seconds. The minimum proxy timeout value is 60 seconds and the maximum value is 300 seconds. The default value is 60 seconds. Output On success, acknowledges setting of the timeout value as shown in Figure 15, page 27. On failure, displays the error message with possible cause.
Set indication provider polling interval Description Sets the indication provider polling interval value for the proxy providers. Syntax set interval Prompts Enter the interval value in seconds. The minimum polling interval value is 60 seconds and the maximum value is 300 seconds. The default value is 60 seconds. Output On success, acknowledges setting of the interval value as shown in Figure 15, page 27. On failure, displays the error message with possible cause.
Set proxy provider debug log level Description Gets or sets the debug log level for the proxy providers. Syntax set loglevel Prompts Enter the log level value. The default value is 0. Supported log levels • • • • Output 30 0 1 2 3 — — — — log comment, status, and critical log status, and critical log only critical disable logging On success, acknowledges setting of the log level value as shown in Figure 15, page 27. On failure, displays the error message with possible cause.
4 Integrating the Proxy Provider with HP SIM HP SIM is the foundation of the HP unified server-storage management strategy. HP SIM is a hardware-level management product that supports multiple operating systems on HP ProLiant, Integrity and HP 9000 servers, HP StorageWorks MSA, EVA, XP arrays, and third-party arrays.
The default collection Storage Systems is listed under Systems by Type in the tree in the System and Event Collections panel. The following collections are available under Storage Systems: • All Storage Systems — includes all devices that were discovered through an SMI-S provider. • All Storage Hosts — includes all servers, desktops, and workstations that are connected by an HBA to a SAN Storage host. Storage hosts are also included in the All Servers and All Systems collections.
3. Click Run Now to run the newly created discovery task. Click View Task results to see the discovery processing flow. Identifying an MSA2000 G2 Array The identification process follows automatic or manual system discovery and identifies the following information about the discovered system: • • • • • Management protocol the system uses (for example SNMP or WBEM).
2. Create a new task for subscribing to WBEM events for the MSA2000 G2 array that is being managed. 3. Return to the MSA2000 G2 Array Identification page and click the Events tab. The events will be logged in this tab. 4. Click an event type to display the full details for each of the reported events. Generating reports With HP SIM, you can generate reports, both for a single managed system and a collection of managed systems. Please refer to the HP SIM manual for more details on this feature.
5 Client API Interface Client applications can use any supported client interface that is supported by the Pegasus CIMOM. Please refer to http://cvs.opengroup.org/pegasus-doc/ClientInterfaces.html for more details on the client interfaces supplied by Open Pegasus. Provided below is a sample C++ client application to collect Disk asset information using the HP MSA2000 G2 proxy provider. This application assumes that the proxy provider has already been configured to manage at least one MSA2000 G2 system.
true, false, false, false); std::cout << "Completed EI..." << endl; // There should always be one and only one Top Computer System instance if (cimNInstances.size() == 0) { std::cout << "No instances. Disconnecting..." << endl; client->disconnect(); return; } // Print the properties of Top Computer System instance std::cout<< "DHS_TopComputerSystem Instance" << std::endl; std::cout << "====================================================" << std::endl; for (Uint32 j = 0; j < cimNInstances[0].
/////////////////////////////////////////////////////////////// int main(int argc, char** argv) { char *address_string = NULL; Boolean localConnection = false; Boolean useSSL = false; Uint32 timeout = 60000; char host[20], userName[20], password[20]; Uint32 portNumber; char ch; std::cout << "Enter Proxy Provider IP:"; std::cin >> host; std::cout << "Enter Port Number:"; std::cin >> portNumber; std::cout << "Enter User Name:"; std::cin >> userName; std::cout << "Enter Password:"; std::cin >> password; CIMCli
sq setQualifier Not supported eq enumerateQualifiers Enumerate all Qualifiers dq deleteQualifier Delete qualifier of a associators Enumerate Associators of | an associatorNames Enumerate Associator Names of | r references Enumerate References of | rn referenceNames Enumerate Reference Names | im invokeMethod Invoke Method for
6 Frequently asked questions 6.1. Which servers can this be installed on? x86- and x64-based servers or workstations. 6.2. What operating systems are supported? Windows x86_64). Linux 2003 Server edition (x86 and x86_64) and 2008 Server edition (x86 and RedHat4 (U7 onwards), RHEL5 (U2 onwards) and SLES10 (SP2 onwards). 6.3. Is it supported on SLES9? No, this release of proxy provider package is supported only on SLES10 6.4.
6.11. Can HP SIM running on Windows discover a CIMOM running on Linux and vise versa? Yes, the HP SIM running on Windows discover a CIMOM running on Linux and vise versa. 6.12. I am not able to create Indication subscription through HP SIM. What could be the issue? CIMOM running on Windows: • The server on which the CIMOM is running might have firewall turned ON. Turn OFF the firewall and try again. CIMOM running on Linux: • Edit the wbemportlist.
This release of Proxy Providers does not support Life Cycle Indications only hardware Alert Indications are supported. 6.18. How can I increase the resolution for indication reporting? By setting the polling interval via the PSM, the indication resolution can be fine tuned. See Set indication provider polling interval, page 29. 6.19. How can I set the timeout value for CIM query? By setting the timeout value via the Proxy Settings Manager (PSM), CIM query timeout value can be controlled.
a. b. Under \hpmsa\fcproxy there is a file service.properties. This will have an entry similar to httpsPort=PortNumber. Do not edit this file. Open this file in an editor, such as Notepad or Wordpad, and note the value for PortNumber. Run netstat –abn and redirect the output to a file. Open the file in a editor, such as Notepad or Wordpad, and search for process cimserver. Linux By default the SSL port is 5989. 6.26.
7 Support and other resources Document conventions and symbols Table 5 Document conventions Convention Element Blue text: Table 5 Cross-reference links and e-mail addresses Blue, underlined text: http://www.hp.
NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts. HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
• http://www.compaq.com/storage/smis-matrix.html • http://h18013.www1.hp.com/products/servers/management/hpsim/providers.html — HP SMIS provider information on the HP SIM website, where updates to this product can be found Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, please send a message to storagedocsFeedback@hp.com. All submissions become the property of HP.
Support and other resources
Glossary CMS Central management server — server on which the management is installed HP SIM HP Systems Insight Manager — a hardware-level management product PSM MSA2000 Proxy Settings Manager MSA2000 G2 SMI-S Proxy Provider User Guide 47
