HP StorageWorks Essentials SAN Visibility 3.
Legal and notice information © Copyright 2006, 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 About this guide ................................................................................... 7 Intended audience ...................................................................................................................... Prerequisites ............................................................................................................................... Related documentation ...................................................................................................
Enabling auto emailing of raw data ............................................................................... 32 Viewing raw data ........................................................................................................ 33 Determining the SMTP server IP address ......................................................................... 33 Viewing reports ..................................................................................................................
Figures 1 SAN Visibility welcome screen .................................................................................. 15 2 SAN Visibility GUI .................................................................................................. 16 3 SAN Settings window .............................................................................................. 18 4 Switch Settings window ........................................................................................... 19 5 Removing switch .....
Tables 1 Document conventions ............................................................................................... 8 2 Hardware requirements ........................................................................................... 12 3 SAN Visibility file menus .......................................................................................... 16 4 Error codes and troubleshooting ...............................................................................
About this guide This guide discusses the HP StorageWorks Essentials SAN Visibility software and provides information to help you: • Understand HP StorageWorks Essentials SAN Visibility • Determine prerequisites for installing HP StorageWorks Essentials SAN Visibility • Install, configure, use, troubleshoot, and uninstall HP StorageWorks Essentials SAN Visibility Intended audience This guide is intended for customers and HP authorized service providers who use the HP StorageWorks Essentials SAN Visibility
NOTE: Brocade SMI-Agent installation is not mandatory for SAN Visibility data collection. If Brocade SMI-Agent is not installed, then the collection takes place through SNMP (and Brocade APIs). For more information, see the HP StorageWorks Essentials SAN Visibility 3.1 user guide. Related documentation In addition to this guide, see the following documents for this product: • HP StorageWorks Essentials SAN Visibility 3.1 release notes • HP StorageWorks Essentials SAN Visibility 3.
IMPORTANT: Provides clarifying information or specific instructions. HP technical support For any queries, send an email to: SAN_Visibility@hp.com Subscription service HP recommends that you register your product at the Subscriber's Choice for Business website: http://www.hp.com/go/e-updates After registering, you will receive e-mail notification of product enhancements, new driver versions, firmware updates, and other product resources.
About this guide
1 Overview HP StorageWorks Essentials SAN Visibility provides a quick and easy way to review the topology and inventory in complex Storage Area Network (SAN) environments. HP StorageWorks Essentials SAN Visibility offers the following features: • Provides an intuitive, simple, and easy to use graphical user interface (GUI). • Collects SAN information, such as Fibre Channel (FC) switch details, Host Bus Adaptor (HBA) details, and Storage Array Connectivity information, by logging in to the FC switches.
• Brocade SMI Agent (120.6.0 a) installed for SMI-S based data collection. For more information, see the SMI-Agent user guide. NOTE: Brocade SMI-Agent installation is not mandatory for SAN Visibility data collection. If Brocade SMI-Agent is not installed, then the collection takes place through SNMP (and Brocade APIs). For more information on data collection methods, see Data collection methods. Table 2 lists the hardware requirements.
2 Installing and removing SAN Visibility Installing SAN Visibility To install HP StorageWorks Essentials SAN Visibility, complete the following steps: 1. Download HP StorageWorks Essentials SAN Visibility package from the following website: http://h18006.www1.hp.com/storage/networking/sansolutions.html 2. Select a folder (for example, C:\temp) to save the HP StorageWorks Essentials SAN Visibility install package. 3. Run SANVisibility_Setup.
3. Click Change/Remove, and follow the steps to remove the program. A message is displayed confirming the successful removal of the SAN Visibility software. NOTE: Removal of SAN Visibility does not remove the existing SAN Visibility reports and profiles from the installation directory.
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 your contact information. 4. Run data collection. 5. Email the data collected (with .hp extension) to HP at: SAN_Visibility@hp.com for analysis.
• D — Message area Figure 2 SAN Visibility GUI SAN Visibility menus Table 3 lists the SAN Visibility menu items. Table 3 SAN Visibility file menus File menu: To... Select...
File menu: To... Select...
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. If you want to rename the SAN, then enter the name of the SAN that you want to scan in the SAN Name box. 2. Click Rename. The SAN name appears in the SAN explorer area.
2. Click Add. The switch group name appears in the SAN explorer area under the SAN name. NOTE: To add multiple switch groups under the SAN, repeat the steps 1-2. 3. Click Next to enter the switch details. Specifying switch details The Switch Settings window enables you to search, add, and modify all the connected switches. Figure 4 shows the Switch Settings window. Figure 4 Switch Settings window Adding a switch To add a switch, complete the following steps: 1. 2.
NOTE: The Brocade switch requires login and password. d. e. f. Select a switch group from the Select Switch Group drop-down list. Click Add. The switch becomes a part of the named group if it is a valid and supported switch. Repeat steps a-e if you want to add multiple switches. • Subnet: If you want to find all the valid switches in a given range of IP addresses. a. Enter the starting IP address in the Start at IP Address box. b. Enter the limiting IP address in the Stop at IP Address box. c.
Figure 5 Removing switch Removing a switch group To remove a switch group from the SAN, complete the following steps: 1. Select the switch 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 6. The switch group is removed from the SAN. CAUTION: Removing a switch group removes all the switches attached to that group. HP StorageWorks Essentials SAN Visibility 3.
Figure 6 Removing switch group Renaming a switch group To rename a switch group, complete the following steps: 1. Select the switch group name you want to rename from the SAN explorer area. 2. Right-click and select Rename from the pop-up menu, as shown in Figure 7. 3. Enter the switch group name in the Switch Group Name box in the main display area. 4. Click Rename. The switch group is renamed.
Figure 7 Renaming switch group Specifying customer details The Customer Details window enables you to enter your contact information, your SMTP server details, and your preferences for receiving additional HP product information. Figure 8 displays the Customer Details window. HP StorageWorks Essentials SAN Visibility 3.
Figure 8 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. In this release of SAN Visibility, you can enter multiple email address in the E-mail box.
4. Click Next to initiate the data collection. Specifying advanced settings (optional) The Advanced Settings window enables you to load and remove IOCP files. It also allows you to import, create and remove HBA-Host map files. NOTE: Specifying FICON switch details and HBA-Host map details is optional. Specifying FICON switch details HP StorageWorks Essentials SAN Visibility 3.0 and above supports data collection from FICON enabled switches in a SAN environment consisting of IBM mainframe servers.
1. Click Advanced Settings from the navigation area of the SAN Visibility GUI. Figure 9 displays the Advanced Settings window. Figure 9 Advanced settings window 2. Click Load to select an IOCP file. 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. Specifying HBA-Host map details HBA-Host map file is a .
Importing HBA-Host map files To import a HBA-Host map file, complete the following steps: 1. Click Advanced Settings from the navigation area of the SAN Visibility GUI. Figure 10 displays the HBA-Host map file details. Figure 10 Selecting HBA-Host map files 2. Click Import File to select a HBA-Host map file. You can also modify an imported host map file. Click Add Row to add content to the file and click Delete Row to delete a row. To save the modified file, click Save File.
4. 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. You can also manually create the HBA-Host map file in a text editor, save it as .csv file and then import it. For more information on importing HBA-Host map file, see Importing HBA-Host map files. The format of the .
7. Click Launch Default Mail Client to launch your default email client. NOTE: This button is enabled only if you have chosen not to automatically send the collected raw data to HP for processing. For more information on how to automatically send raw data collection to HP for processing, see Enabling auto emailing of raw data. 8. Attach the .hp file located at: \reports\ to your email, where is the name of your SAN. 9. Email this raw data file to: SAN_Visibility@hp.
Figure 11 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.
1. Select View > CIMOM Server Settings... The CIMOM server settings window is displayed, as shown in Figure 12. 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. Email this raw data file to: SAN_Visibility@hp.com with the following subject line: "HP StorageWorks Essentials SAN Visibility 3.1 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 (.hp extension) to a system where the mail client is configured, attach the raw data file, and send it to SAN_Visibility@hp.com.
Figure 13 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 14. Figure 14 Raw Data window Determining the SMTP server IP address To find the SMTP server IP address, complete the following steps: 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. 7.
NOTE: By default, some web browsers do 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.
Figure 16 Processed report Saving the current configuration file SAN Visibility enables you to save the SAN configuration data for future use. To save the SAN configuration file, complete the following steps: 1. Select File > Save to save the configuration. 2. Enter a file name in the File Name box. 3. Click Save to save the configuration for future reference. By default, the SAN configuration file is saved at the following location: \profiles.
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 3.1. 3. Click Open. The existing configuration is opened. The customer and configuration details (including SAN, switch group, and switch details) are populated and shown in the SAN Visibility GUI window. Exiting from SAN Visibility To exit from SAN Visibility software, select File > Exit.
Using SAN Visibility
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.
NOTE: Configure the SNMP access list to its default value (0.0.0.0) or with the IP address of the host on which HP SAN Visibility v3.1 is installed. 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 v3.
B Error codes This chapter discusses the error codes that may be displayed while using SAN Visibility software. Troubleshooting the error codes Table 4 discusses the error codes and troubleshooting information. Table 4 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: 303:011 Unknown error occurred 44 Error codes This error occurs when an inappropriate operation is performed by the SAN Visibility software. SAN_Visibility@hp.com with the following subject line: “HP SAN Visibility Query” with a detailed description of the occurrence of the error.
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.
