HP StorageWorks Essentials SAN Visibility 5.0 User Guide This document describes how to use the HP StorageWorks Essentials SAN Visibility user interface to review the topology and inventory in a complex Storage Area Network (SAN) environment. This document is intended for users and HP authorized service providers who use the HP StorageWorks Essentials SAN Visibility software to obtain SAN analysis reports.
Legal and notice information © Copyright 2006, 2010 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 Overview .......................................................................................... 7 SAN Visibility package contents ................................................................................................... 7 Hardware and software requirements ............................................................................................ 8 2 Installing and removing SAN Visibility .................................................. 9 Prerequisites ..........................
Determining the SMTP server IP address ......................................................................... Viewing reports .................................................................................................................. Comparing SAN ................................................................................................................ Saving the current configuration file ......................................................................................
Figures 1 SAN Visibility welcome screen .................................................................................. 11 2 SAN Visibility GUI .................................................................................................. 12 3 SAN Settings window .............................................................................................. 14 4 Switch Settings window ...........................................................................................
Tables 1 Hardware requirements ............................................................................................. 8 2 SAN Visibility file menus .......................................................................................... 12 3 Host discovery interfaces ......................................................................................... 21 4 Document conventions .............................................................................................
1 Overview HP StorageWorks Essentials SAN Visibility provides a quick and easy way to review the topology and inventory in a complex Storage Area Network (SAN) environment. HP StorageWorks Essentials SAN Visibility offers the following features: • Provides an intuitive, simple, and easy to use graphical user interface (GUI).
Hardware and software requirements This section discusses the hardware and software requirements for installing HP StorageWorks Essentials SAN Visibility. • Standard LAN connectivity with target FC switches and hosts • To use HP StorageWorks Essentials SAN Visibility, following are the necessary applications that need to be installed on a host where HP StorageWorks Essentials SAN Visibility is installed: • Internet Explorer v5.01 or later • Java 2 Runtime Environment (JRE) SE v1.
2 Installing and removing SAN Visibility Prerequisites Following are the prerequisites to install and run HP StorageWorks Essentials SAN Visibility: • Microsoft Windows system with any of the following operating systems: • Microsoft Windows Server 2003 Standard or Enterprise edition with Service Pack 2 • Microsoft Windows XP Professional edition with Service Pack 2 • Microsoft Windows Server 2008 Enterprise Edition with Service Pack 2 (x86) • Microsoft Windows Vista Enterprise Edition with Service Pack 2 (x
2. Select a folder (for example, C:\temp) to save the HP StorageWorks Essentials SAN Visibility install package. 3. Run SANVisibility_Setup.exe, and follow the steps to install HP StorageWorks Essentials SAN Visibility files. NOTE: If you have the previous version of the software installed, select Upgrade. 4. Review and accept the license agreement.
3 Using SAN Visibility This chapter addresses the following topics: • SAN Visibility GUI • Using SAN Visibility The following procedure provides a brief overview of using HP StorageWorks Essentials SAN Visibility: 1. Specify the SAN details. 2. Specify the switch details. 3. Specify the host details. 4. Specify your contact information. 5. Run data collection. 6. Email the data collected (with .hp extension) to HP at: “SAN_Visibility@hp.com” for analysis.
• B — Main display area • C — SAN explorer area • D — Message area Use the up and down arrow button available in the message area to expand it for a better view of the messages. Figure 2 SAN Visibility GUI . SAN Visibility menus Table 2 lists the SAN Visibility menu items. Table 2 SAN Visibility file menus File menu: To... Select...
File menu: To... Select...
Specifying SAN details The SAN Settings window displays SAN details. It enables you to add and modify a SAN group. Figure 3 shows the SAN Settings window. Figure 3 SAN Settings window . Adding SAN details To add SAN details, complete the following steps: 1. Click SAN Settings from the navigation area. The SAN Settings window is displayed in the main display area. The default SAN name, MySAN, is displayed in the SAN Name box, as shown in Figure 3.
To enter the Component Group Name, complete the following steps: 1. Enter the name of your component group in the Component Group Name box. The default component group name, MyComponentGroup, is displayed in the Component Group Name box, as shown in Figure 3. 2. Click Add. The component group name appears in the SAN explorer area under the SAN name. NOTE: To add multiple component groups under the SAN, repeat the steps 1-2. 3. Click Next to enter the switch details.
NOTE: HP StorageWorks Essentials SAN Visibility 5.0 supports switches configured with Internet Protocol version 6 (IPv6) addresses. • IP Address: If you know the IP address of the switch to scan. a. Enter the IP address of the switch to be scanned in the IP Address box, as shown in Figure 4. b. Select Discover connected switches check box if you want to discover all the connected switches. c. Enter the access information, as required, to initiate data capture for the selected switch.
Figure 5 Brocade AG mode switch example . Modifying switch details To modify switch details, complete the following steps: 1. Select the switch you want to modify from the SAN explorer area to view its details. 2. Modify the switch details as required. 3. Click Update to save the modified switch details. Removing a switch To remove a switch from the component group, complete the following steps: 1. Select the switch you want to remove from the SAN explorer area. 2.
Removing a component group To remove a component group from the SAN, complete the following steps: 1. Select the component group name you want to remove from the SAN explorer area. 2. Right-click and select Remove from the pop-up menu, as shown in Figure 7. The component group is removed from the SAN. CAUTION: Removing a component group removes all the switches attached to that group. Figure 7 Removing component group .
Figure 8 Renaming component group . Specifying host details The Host Settings window enables you to discover and add hosts in a SAN environment. Figure 9 displays the Host Settings window. HP StorageWorks Essentials SAN Visibility 5.
Figure 9 Host Settings window . Supported operating systems The following operating systems support host discovery: • Microsoft Windows 2003 Standard or Enterprise edition - Service Pack 2 • Microsoft Windows Server 2008 Enterprise Edition with Service Pack 1 (x86) • Microsoft Windows 2003 R2 • Microsoft Windows Server 2008 Enterprise Edition with Service Pack 2 X64 • Microsoft Windows Server 2008 Enterprise Edition with Service Pack 1 IA64 • HP-UX 11.23 • HP-UX 11.
Host discovery interfaces Table 3 describes the interfaces used for host discovery and data collection: Table 3 Host discovery interfaces Interface Operating system WBEM ESX, HP-UX SSH ESX, Linux, and HP-UX WMI Windows (including HyperV) Server configurations Microsoft Windows Ensure the following: • The WMI service is running and it includes the Windows installer provider component • DCOM is configured and you have access to DCOM DCOM configuration To configure DCOM: 1.
NOTE: Ensure that the Connection-oriented TCP/IP is listed first. 9. Configure the COM application you choose to access. a. Expand the Component Services node followed by the Computers and My Computer nodes, click DCOM Configuration. Right-click on the application you want to configure, and select Properties. If your COM application is a DLL, you must first create a surrogate EXE for it using the SetDllHost tool. Once a surrogate EXE is created, the surrogate name will appear in the list of applications.
• The Wbem service or the CIMServer is configured for remote access for a given user Discovering hosts To discover hosts, complete the following steps: 1. Select Host Settings from the navigation pane. The Host Settings window is displayed. 2. Under Discover Host, select one of the following options: • IP Address: Enter the IP address of the host in the IP Address field. • Subnet: If you want to discover hosts for a range of IP addresses: • Enter the starting IP address in the Start at IP Address field.
Figure 10 Customer Details window . Adding contact details To add your contact details, complete the following steps: 1. Click Customer Details from the navigation area. Customer Details window appears in the main display area. 2. Enter your contact information in the Customer Details window. NOTE: Ensure that the email address you enter is accurate. SAN Visibility reports are sent to this email address. SAN Visibility enables you to enter multiple email address in the E-mail box.
3. Select the appropriate option if you want to receive additional information (such as special offers, new product information, events, service or support information) from HP. 4. Click Next to go to the Advanced Settings window. Specifying Advanced Settings details is optional. 5. Click Next to initiate the data collection.
Specifying HBA-Host map details (optional) HBA-Host map file contains HBA-Node WWN and host mapping details. If this map file is provided in the raw report, then the processed report maps the HBA-Node WWNs to the host names, and the same information is displayed in the processed report. You can create a new HBA-Host map file or you can import an existing HBA-Host map file. HBA-Host map file can be a .csv file (comma separated file) or it can be a Fnames.conf file. The Fnames.
1. Click Advanced Settings from the navigation area of the SAN Visibility GUI. 2. Click the Map HBA to Host tab. 3. Click Create File. 4. Click Add Row to enter the WWN for HBA, and host name details. NOTE: To delete a row, click Delete Row. 5. Click Save File. The created file is saved at the mentioned location. If you want to remove the loaded HBA-Host map file, click Remove File. Ensure that you provide the HBA-Node WWN and the host name details in the correct format.
4. Browse and select the IOCP file that you want to load, and click Open. Figure 13 displays the IOCP file details. NOTE: The IOCP file is a .txt file. Figure 13 IOCP files window . IMPORTANT: SAN Visibility does not generate IOCP files. Removing IOCP files To remove an IOCP file, complete the following steps: 1. Select the IOCP file you want to remove 2. Click Remove. The selected IOCP file is removed.
1. Click Advanced Settings from the navigation area of the SAN Visibility GUI. 2. Click the Filter SAN Components tab. Figure 14 displays the filter SAN components details. Figure 14 Filter SAN components window . 3. Select Yes if you want to receive storage device details in the processed report. 4. Select Yes if you want to receive host and HBA details in the processed report. 5. Select Yes if you want to receive virtual machine details in the processed report.
Example 2. Filtering storage device details in the processed report Figure 16 shows an example of how the processed report appears if you have opted not to display storage details in the processed report. Even though your SAN environment may contain storage devices, the processed report, including the topology diagram, will not display the storage details. Figure 16 Filtering storage device details . Example 3.
Customizing SAN device labels to be displayed in the topology diagrams (optional) HP StorageWorks Essentials SAN Visibility 5.0 provides an option to customize the SAN device labels that you want to view in the processed report. Only the SAN device labels that are selected will be displayed in the SAN topology diagram. To specify the SAN device labels that you want to view in the SAN topology diagram, complete the following steps: 1.
Example 4. Customizing storage device labels in the processed report Figure 19 shows an example of how the processed report looks like if you have opted to view only specific SAN device labels in the processed report. Only the SAN device labels that are selected in the Customize Topology Labels window will be displayed in the processed SAN topology diagram. A — Array details. Only the array name, model number and firmware version is displayed as selected in the SAN Visibility GUI before data collection.
1. Click Data Collection from the navigation area of the SAN Visibility GUI. The Data Collection window opens, as shown in Figure 21. 2. Select a component group from the Select a component group for data collection dropdown list, or select Collect data for all component groups check box if you want to initiate data collection for all the component groups. 3. Select Schedule data collection check box if you want to schedule data collection. When you select this option, the Schedule button is enabled.
4. Select Capture Performance data check box if you want to capture the performance data for all the component groups in the SAN. NOTE: Selecting Capture Performance data may increase the total time for the data collection. The performance charts are available in the SAN Visibility report only if this option is chosen. 5. Select Mask IP Address check box if you do not want to send the IP address information (in the raw report) outside your network. 6.
Figure 21 Data Collection window . Data collection methods The SAN Visibility uses the following two methods for data collection: • SNMP based data collection • SMI-Agent based data collection (for Brocade switch) SNMP based data collection The SNMP based data collection is the default data collection method used by SAN Visibility. SMI-Agent based data collection (for Brocade switch) If you want to use the SMI-Agent based data collection method, then provide the CIMOM server details as discussed below.
To enter CIMOM server setting details, complete the following steps: 1. Select View > CIMOM Server Settings... The CIMOM server settings window is displayed, as shown in Figure 22. 2. Enter the CIMOM server IP address in the CIMOM Server IP Address box. 3. Enter the user name in the User Name box. 4. Enter the password in the Password box. 5. Enter the server port number in the Server Port box (default: 5988 for http and 5989 for https). 6. Click Ok.
5. Attach the .hp file located at: \reports\ to your email, where is the name of your SAN. 6. Email this raw data file to: “SAN_Visibility@hp.com” with the following subject line: "HP StorageWorks Essentials SAN Visibility 5.0 Report Request". NOTE: If the mail client is not configured on the system on which SAN Visibility is installed, then after the data collection is complete, transfer the raw data file (.
Figure 23 SMTP Server details . Viewing raw data SAN Visibility provides an option to view the contents of the raw data before sending it to HP for processing. To view the raw data before sending it to HP for processing, select View > Raw Data — . The Raw Data window is displayed, as shown in Figure 24. Figure 24 Raw Data window .
1. Select Start > Run, and enter cmd in the box. 2. Click OK to open the MS-DOS command prompt. 3. Enter the nslookup command, where is your domain name, and press Enter. The primary DNS server address is displayed. 4. Enter the nslookup command, and press Enter to go to the shell prompt. 5. Enter the server command, and press Enter. 6. Enter the , where is your domain name, and press Enter.
NOTE: Some versions of the Internet Explorer does not allow ActiveX contents, and a message is displayed on these browsers informing that the ActiveX contents have been blocked. In order to view the complete SAN Visibility report with the topology diagrams, select the Allow Blocked Contents option on the browser. • .xls — if you have selected to receive the processed report in Microsoft Excel format in the Data Collection window.
• NPIV Details (Switch)— Provides details of all the SAN components seen by an NPIV enabled ports. The report contains the port numbers on which the NPIV device is connected, the real and virtual WWPNs as seen by each port, and the zone names that are part of the NPIV enabled ports and WWPNs. • NPIV Details (HBA) — Provides the details of all the NPIV configured ports of the HBA. It contains virtual HBAs (VHBAs) and WWPNs of the associated physical HBAs. Figure 26 Processed report .
Figure 27 SAN comparison window . 2. Select File > Open > Dataset1. By default, it opens the ExtractedProcessedReports folder. 3. Select the SVReport.comp file for comparison. 4. Follow steps 1–3 to load Dataset 2. If you select any node in Dataset1 or Dataset 2, the corresponding details of the node will be displayed. 5. Select Highlight Changes > Dataset1 or Dataset2 to check the changes. The changes will be highlighted in red (see Figure 28), and the new devices are shown in blue.
Figure 28 SAN comparison details . A. Dataset1 B. Dataset2 C. Changes in Dataset1 when compared to Dataset2 D. Status message 6. Select Filter and choose the components for comparison. Select Highlight Changes > Dataset1 or Dataset2 to view the changes. You can filter SAN based on the following components: • Arrays • HBAs • Hosts • Switches • Zones 7. Select Generate Report > Compare Dataset1 with Dataset2 or Compare Dataset2 with Dataset1 to generate the compared report.
Figure 29 Compared report . By default, it opens the My Documents folder. Save the compared report by selecting the folder of your choice. 8. 9. Decrypt the report to view the compared report details. Select Remove > Dataset1 or Dataset2, to remove datasets, or select Remove > Remove All to remove both the datasets. 10. Select Exit to exit from the SAN comparison window. Saving the current configuration file SAN Visibility enables you to save the SAN configuration data for future use.
Opening an existing configuration file SAN Visibility enables you to open an existing configuration file [.xml extension] that is created and saved earlier by SAN Visibility. To open an existing configuration file, complete the following steps: 1. Select File > Open. 2. Locate and select the previously saved configuration file you want to open. NOTE: Previously saved configuration files from SAN Visibility 2.0 or earlier can be opened from SAN Visibility 5.0. 3. Click Open.
Using SAN Visibility
4 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
• • • • http://www.hp.com/support/manuals http://www.hp.com/sbso/serverstorage/index.html http://h18006.www1.hp.com/storage/networking/sansolutions.html http://h18006.www1.hp.com/products/storageworks/san/index.html 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.
CAUTION: Indicates that failure to follow directions could result in damage to equipment or data. IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts. HP StorageWorks Essentials SAN Visibility 5.
Support and other resources
A Troubleshooting This chapter discusses some common issues that you may encounter while using SAN Visibility software, including: • • • • Network connectivity issues SNMP access failures SMI-S Access failures Changing SNMP proxy settings for HP StorageWorks 8/20q and QLogic FC switches Network connectivity issues Data collection can fail because of any of the following network issues: • • • • • • No power. The LAN cable is unplugged. The device is not configured properly. The IP address is incorrect.
To set up the SNMP Read Community, complete the following steps: 1. Open a telnet session for the switch. 2. Enter the agtcfgset command. 3. Configure the Read only community string (Community (ro): ) for SNMP community and trap recipient configuration. The default value of the community string is public. 4. Enter the default IP address (0.0.0.0) or the IP address of the host where HP SAN Visibility v5.0 is installed for SNMP access list configuration. 5. Close the telnet session.
B Error codes This chapter discusses the error codes that may be displayed while using SAN Visibility software. Troubleshooting the error codes Table 5 discusses the error codes and troubleshooting information. Table 5 Error codes and troubleshooting Error Code 101 Description Data collector service (HPSanVisibilityDataCollector) is not running Possible Cause Troubleshooting SAN Visibility data collector component runs as Windows service. Error occurs if the service is not running.
Error Code 107 201 Description Possible Cause Troubleshooting Special character validation The acceptable characters for the Customer Details filed are: a-z A-Z _ - , . # ( ) and space character, and the maximum number of characters allowed in any editable field is 255. This error occurs if you enter anything other than the accepted characters for the Customer Details fields or you exceed the maximum allowed characters in any editable filed. Enter valid characters in the Customer Details fields.
Error Code Description Possible Cause Troubleshooting This error occurs when SAN Visibility software fails to send the packaged report to HP. There can be one or more reasons for this, such as: • SMTP server address mentioned in the Data Collection tab is not a valid SMTP server. 303 Error in emailing the packaged report • Security policy settings on the SMTP server allow only authenticated users to submit mail for subsequent delivery.
Error Code Description Possible Cause Troubleshooting Write a mail to: “SAN_Visibility@hp.com” with the following subject line: “HP SAN Visibility Query” with a detailed description of the occurrence of the error. 303:011 Unknown error occurred This error occurs when an inappropriate operation is performed by the SAN Visibility software. 401 Error in discovering host This error occurs if the login name provided during host discovery is incorrect. Enter the correct login name.
Glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. CIMOM Common Information Model Object Manager. Fabric A contiguous switched network composed of high-speed fiber connections. Each fabric is a single instantiation of the fabric services. A fabric is an active and intelligent non-shared interconnect scheme for nodes.
Glossary
