HP VMA SAN Gateway User’s Guide For Release G5.5.
LEGAL NOTICES Copyright 2011, 2012 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Copyright © 2010-2012 Violin Memory, Inc. All rights reserved.
OTHERWISE), FOR ANY DIRECT, INDIRECT, PUNITIVE, INCIDENTAL, RELIANCE, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES, INCLUDING WITHOUT LIMITATION, ANY LOSS OF DATA, LOSS OR INTERRUPTION OF USE, COST OF PROCURING SUBSTITUTE TECHNOLOGIES, GOODS OR SERVICES, OR LOSS OF BUSINESS, REVENUES, PROFITS OR GOODWILL, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Violin Memory, Inc. 685 Clyde Avenue Mountain View, CA 94043USA Compliance notices and information can be found in Compliance Information on page 12.
HP VMA SAN Gateway User’s Guide AM456-9026A
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 CHAPTER 1: HP VMA SAN Memory Gateway Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 New in this Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Software Features. . . . . . . . . . . . . . . . . . . . . . . .
Cluster Admin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tools. . . . . . . . . . . . .
CLI Shorthand Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142 Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 Tab Completion of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 Command Modes . . . . . . . . . . . . . . . . .
List Statically-Configured ARP Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Security Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Authentication Method and Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RADIUS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . .
vzero . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227 APPENDIX C: SNMP Traps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 About SNMP MIB Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Benefits of Using a MIB Browser . . . . . . . . . . . . .
HP VMA SAN Gateway User’s Guide AM456-9026A
Preface This document describes how to manage, monitor, and administer the VMA SAN Gateway.
Document Organization This document is organized as follows: Chapters CHAPTER 1, “HP VMA SAN Memory Gateway Overview” on page 17 CHAPTER 2, “Manage, Monitor, and Administer with the HP VMA Web Interface” on page 23 CHAPTER 3, “vSHARE Configuration” on page 93 CHAPTER 4, “vSHARE Management” on page 109 CHAPTER 5, “VMA SAN Gateway Management” on page 127 Reference APPENDIX A, “VMA SAN Gateway Command Line Interface Reference” on page 141 APPENDIX B, “Utilities Reference” on page 211 APPENDIX C, “SNMP Traps
Safety Icons (continued) Icon Sample Text Caution: Caution: Follow the listed safety precautions when working on the HP VMA Array. Note: Note: Read through this entire chapter and plan your installation according to your location before installing the equipment. The following procedures and the order in which they appear are general installation guidelines only. Typographical Conventions The following typographic conventions are used in this guide: Format Meaning Bold User Interface text.
Reference Documents In addition to this guide, the following HP documents comprise the documentation suite for the HP VMA Array. These guides are available for download from the HP VMA manual site at http:// hp.com/go/vma-docs This document... Provides this information... Release Notes Describes the new features, resolved issues, known limitations and software upgrade instructions for the current release. HP VMA SAN Gateway User’s Guide.
• In other locations, see the Contact HP worldwide (in English) webpage (http:// welcome.hp.com/country/us/en/contact_us.html). For HP technical support: • In the United States, for contact options see the Contact HP United States webpage (http:// welcome.hp.com/country/us/en/contact_us.html). To contact HP by phone, call 1-800-HP-INVENT (1-800-474-6836). This service is available 24 hours a day, 7 days a week. For continuous quality improvement, calls may be recorded or monitored.
HP VMA SAN Gateway User’s Guide AM456-9026A
CHAPTER 1 HP VMA SAN Memory Gateway Overview This chapter introduces the HP VMA SAN Gateway, and covers the following topics.
CLI LUN Statistics The CLI is extended to provide basic LUN statistics, including the use of select shell wildcard patterns when searching for LUN names. More extensive LUN statistics are available through the Web UI and .csv files containing historical LUN statistics. For more information, see LUN Statistics Command on page 124. SES Support for LUN 0 SES (SCSI Enclosure Services) provides the device discovery function of LUN 0 with a device type that is more useful than No Device Type.
VMA vSHARE Architecture A VMA SAN Gateway system is built for performance and high Reliability, Availability and Serviceability (RAS). The system fits with standard 19-inch racks in hot/cold aisles and can coexist with other data infrastructure without special facilities. A system is built with the following primary components: • HP VMA Array: Up to 4 HP VMA Arrays can be configured in each cluster. The VMAs contain up to 10TB of raw flash memory per array and 30TB of usable space.
vSHARE Feature Summary vSHARE (VMA gateway software) manages SAN block storage on the HP VMA SAN Gateway, providing high performance processing, high bandwidth DRAM, and high bandwidth access to HP VMA Arrays. Each HP VMA SAN Gateway operates as a SAN (Fibre Channel) target and provides access to LUNs that are stored on its attached VMA memory arrays.
VMA System Architecture A typical HP VMA SAN Gateway system consists of one or two HP VMA SAN Memory Gateways (nodes), one of which is designated as the master node, the other is designated as the secondary node. The VMA SAN Gateways provide connectivity to the network and allow multiple servers to share the high performance flash memory VMA arrays. VMA 3200 Series Memory Arrays provide high capacity flash storage with RAID protection.
This guide only documents commands that are needed for the HP VMA SAN Gateway, along with other general-purpose commands. See Quick Reference to Commands on page 206 for a list of the commands that are documented in this chapter.
CHAPTER 2 Manage, Monitor, and Administer with the HP VMA Web Interface This chapter introduces the HP VMA Web Interface and covers the following topics: • • • • • • • Introduction to the HP VMA Web Interface on page 23 Logging In and Out of the Web Interface on page 26 Web Interface Task Map on page 29 Home Dashboard on page 31 Manage on page 41 Monitor on page 55 Administration on page 62 Introduction to the HP VMA Web Interface The HP VMA Web Interface is a Web-based graphical user interface (GUI) th
User Interface Overview The streamlined HP VMA Web Interface includes the following interactive components, as shown in Figure 2.1: • Main Menu Bar—Displays clickable icons for the major functional categories: Home, Manage, Monitor, and Administration. • Function Menu Bar—Changes to display the options for the currently active category. Click an icon to display the associated page and submenu options. • Online Help—Brings up context-sensitive help for the currently active page.
System and Browser Requirements This section provides information on the HP VMA Web Interface requirements for browsers, display resolution, Adobe Flash Player, JavaScript, and cookies. Supported Web Browsers The following table lists the supported browsers and versions for the HP VMA Web Interface.
Abbreviations for Large Numbers The following abbreviations are used for large numbers throughout the HP VMA Web Interface: Abbreviation Meaning B bytes KB kilobytes MB megabytes GB gigabytes TB terabytes PB petabytes Table 2.3 Large Number Abbreviations For E (exabytes), Z (zettabytes), and Y (yottabytes), a single letter omitting the “B” is used for units other than bytes, or to save space in a display.
Logging In to the Web Interface You access the HP VMA Web Interface through a Web browser. For more information, see Supported Web Browsers on page 25. To access the HP VMA Web Interface and log in, do the following: 1. Open a Web browser, as described in Supported Web Browsers on page 25. 2.
Logging Out of the Web Interface You can log out of the SAN Gateway from any page in the HP VMA Web Interface. To log out of your Web Interface session, do the following: 1. From any page in the Web Interface, go to the upper right hand corner. 2. Click the session icon, as shown in the following example. The Logout page appears acknowledging that you successfully logged out. 3. 28 To log back in, click Login Again and re-enter your credentials.
Web Interface Task Map The following table provides an overview of the functional pages available within each category, and the tasks you can perform from each page: Main Menu Home Function Dashboard Cluster LUN Status Manage Manage LUNs Manage Initiators Manage Targets Monitor Overview Monitor LUNs Monitor Targets Tasks • Customizing the Dashboard on page 32 • Customizing Gadgets on page 34 • Viewing Cluster Status on page 36 • Viewing VIMM Status on page 37 • Viewing VIMMs by RAID Grou
Main Menu Administration Function Cluster Admin Tasks • Viewing Software Version and Boot Images on page 64 • Rebooting or Shutting Down a Node on page 64 • Changing and Saving Configuration Files on page 65 • Viewing Gateway Node Details on page 66 • Viewing Alerts on page 66 • Searching for and Viewing Logs on page 67 • Viewing Node Versions on page 68 • Viewing Current Network Settings on page 69 • Changing the Gateway Management Virtual IP Address on page 70 • Modifying Global De
Home Dashboard The Home dashboard is a landing page that provides a selection of metrics that track system health and performance. The customizable dashboard allows you to easily add, change, and rearrange the gadgets for at-a-glance system assessment. Likewise, the Cluster Status page provides a visual overview of cluster health and performance. The LUN Status page provides an easy access list of all LUNs and their statistics. Note: The dashboard supports Internet Explorer 9 (IE 9) and higher.
• Live Stats—Shows real-time values for bandwidth, IOPS and latency on a LUN level or container level. Click the settings icon in the upper right corner to customize the display. • Indicators—Shows the LED, temperature and fan status for a container on an array. Click the settings icon in the upper right corner to customize the display. • Flash/VIMM Status—Shows the VIMM status (number active, down, etc.) and the remaining length of flash life for a container on an array.
The toolbar appears at the bottom of the window, as shown in the following example. 3. AM456-9026A Click an icon on the toolbar to add it to the dashboard, then select and drag icons to rearrange. Click the X icon in the upper right corner of the gadget to remove it from the dashboard display.
4. To display detailed data for a gadget, move your cursor over an area in the graph. A pop-up window appears, as shown in the following example. 5. To hide the toolbar, click the X icon in the lower right corner of the window. Customizing Gadgets Each dashboard gadgets allows you to customize the display. To customize the information shown on a gadget, do the following: 34 1. Open the gadget on the dashboard, as described in Customizing the Dashboard on page 32. 2.
The gadget flips over to show a back panel with options appropriate for that gadget. 3. Make the desired selections and click Save to apply, or Cancel to revert to the previous settings. The gadget flips back to the front panel display. Cluster The Cluster Status page displays information depicting the health and performance of the gateway nodes in the management group. Easy to read graphics allow you to easily tell f there is a problem with the system.
The Cluster Status page provides the following information: • Master SAN Gateway Statistics — — — — — — — — • Memory Array Statistics — — — — — — • DRAM and flash allocation Port ID Total flash memory Performance data: read and write rates, DMA active, and pending Activity graph (reads and writes) for this SAN Gateway Network data: rates of client and server activity System drive read and write rates Additional SAN Gateway statistics: same data as for master Number of VIMMs in each state (active, spare
5. Check the VIMM, Controller, and ambient temperatures. Green is healthy, yellow a caution, and red a warning. 6. View a high-level synopsis of the flash VIMM statistics in the far left panel. Viewing VIMM Status The HP VMA Cluster Status page can be expanded to view board-level information about a connected VMA Memory Array. The Board Status page shows a color-coded array of VIMMs with indicator boxes for alarm status, temperature, and remaining lifetime.
Selecting a RAID Group highlights the VIMMs belonging to that RAID Group in the Board Status panel, as shown in the following example. 4. To view failed VIMMs, select the Failed link in the Show area of the Board Status panel. A failed VIMM appears orange, as shown in the following example. 5. To view booting VIMMs, select the Booting link in the Show area of the Board Status panel. 6. To view admin down VIMMs, select the Admin Down link in the Show area of the Board Status panel. 7.
Viewing Container Status The LUN Status page provides easy access to information about the container in an array. At-aglance information includes the container name, its address, and the number of LUNs within the container. The following task demonstrates how to view more detailed information. To view LUN and container status, do the following: 1. Select Home > LUN Status. The LUN Status page appears. 2. Select the Container icon to view real-time statistics about the container. 3.
To view LUN and container status, do the following: 1. Select Home > LUN Status. The LUN Status page appears. 2. Select a LUN icon to view real-time statistics about the container. 3. Select the LUN icon next to the name to view real-time statistics about that LUN. 4. Click a LUN name to view detailed information about that LUN. The LUN Management page appears, with the selected LUN highlighted in the LUN panel on the left. In the top right panel, details of the selected LUN are shown.
Manage The Manage function provides easy access to the tools you need to manage LUNs, LUN groups, initiators, and targets.
Searching, Sorting, and Performing LUN Operations A search (filter) operation is performed across all columns simultaneously to return the desired results. Sorting applies to the selected column. However, the sorting changes the order of all the records (rows/columns). Note: You can select multiple LUNs and perform an operation on them simultaneously. A check mark in the box next to the LUN name shows that a LUN is selected. To search for a LUN and customize the display, do the following: 42 1.
5. To change the number of entries shown, choose one of the following from the Show entries drop-down list: 10, 25, 50, or 100. The default is 25. To perform operations on one or more LUNs, do the following: 1. Select Manage > Manage LUNs. The LUN Management page appears. 2. In the LUNs panel, select the check boxes next to the desired LUNs. A check mark appears in the box next to the name. Note: A highlighted LUN that is not selected is not included in an operation.
Prerequisites Verify the block size that is acceptable for the clients (initiators) on your network. Disk storage systems previously assumed a 512-byte sector or block size as the unit to store data. Newer devices, such as HP VMA Memory Arrays, have a native storage unit sized at 4096 bytes but can also emulate 512 bytes. Not all client operating systems are able to understand accessing anything other than a 512-byte based disk drive.
5. Define the size of a LUN, in one of the following ways: • To define the size of the LUN based on the space available, select Use all available space equally. • To manually define the size of each LUN, select Specific size per LUN and enter the size in GB. Note: The 6. size of the LUNs may be restricted by the space available in the container. Select one of the following block sizes for the LUN: • 512 bytes. • 4096 bytes. Caution: Not all systems can handle 4096-byte blocks.
4. Select the LUN so that it highlights, then remove the LUN exports in the following way: a. b. In the Exports panel on the right, click the check boxes for each of the exports associated with the LUN. Click the Delete icon. Then click OK in the pop-up dialog that appears to confirm the action. Note: All 5. exports must be removed before the LUN can be deleted. Click the check box of the LUN you want to delete, if you haven’t already done so. A check mark appears. Note: The 6.
4. In the LUN information panel make the following selections, as necessary: — Block Size—Shows the block size of the highlighted LUN. — Read Only—Activating read-only access on an existing LUN can cause data loss for connected clients with cached data. — Online Ports—Unchecking these options takes the LUN offline for the respective SAN Gateway nodes. To change the name of an existing LUN, do the following: 1. Select Manage > Manage LUNs. The LUN Management page appears. 2.
The new name is applied and appears in the LUNs panel. To increase the size of an existing LUN, do the following: 1. Select Manage > Manage LUNs. The LUN Management page appears. 2. In the Container panel, select a container from the Container drop-down list. This is the container in which the LUN resides. 3. Select the LUN so that it highlights, then click the Edit LUN icon. 4. In the Edit LUN dialog, click Resize LUN. 5. Enter the New LUN size (GB) in the text box, and then click OK.
in the export. 4. Click Export Checked LUNs. The Add Export dialog box appears. 5. Do one of the following to select the initiators to which the LUNs will be exported. • To export to all initiators, select the All Initiators option button. • To export to select initiator groups or initiators, select Specific Initiator Groups and/or Initiators. Select one or more Initiator Groups from the list, and enter and select initiator names (each on their own line) in the Individual Initiator panel. 6. 7.
operating systems (for example, Windows) only discover LUN IDs between 0 and 254. This section is automatically disabled when you create multiple LUNs at one time. • 8. Select Auto to automatically assign an ID to the exported LUNs. This option is mandatory when you export multiple LUNs at once. Click OK. Initiator and target information for the exported LUNs appears in the Exports panel on the right side of the window.
To delete an initiator group, complete the following steps: 1. Select Manage > Manage Initiators. 2. Select one or more initiator groups from the Initiator Groups list. A check mark appears next to the name of a selected igroup. Only igroups with a check mark next to the name will be deleted. 3. Click Remove Checked groups. A dialog appears prompting you to confirm the action. 4. Click OK.
Adding or Deleting Initiators from a Group You can select initiator hosts to add to an existing initiator group from the panel on the right. Or from the Advanced panel, you can add initiator types that do not appear in the list, or that may not yet be on the network. This section demonstrates how to add initiator hosts to an igroup by selecting them from the list, and then add initiators using the Advanced panel.
Note: Each 7. address must be on its own line. Click Save. The newly added initiators appear in the Manage Initiators panel and are associated with the selected (highlighted) initiator group. Note: Initiator hosts added in the Advanced panel appear in the group even if the host has not yet been added to the network. Check with your network administrator for status on the availability of these hosts.
Viewing Target Status On the Target Management page, the details for the highlighted port appear in the panel on the right. The node, target name, hostname, speed, and address of each type of target port. To view status information for a target, do the following: 1. Select Manage > Manage Targets. The Target Management page appears, showing information for all available target ports in one table. 2.
Monitor The Monitor function provides an at-a-glance view of the health and performance of cluster nodes, and the ability to analyze historical data and real time trends. LUN monitoring provides container level statistics both on a per-node basis, as well as aggregated. Target monitoring provides port level statistics.
You can also choose to view the aggregate data (A+B) from both SAN Gateway nodes, or view data for the nodes separately (A, B). If you select the A only or B only option, only the data for that particular node is shown. To customize the data output display, do the following: 1. Select Monitor > Overview. The Monitoring page appears. 2. Click Settings & Download. The panel expands to show the following options. 3. Select a Container name from the drop-down list to display its data. 4.
7. To specify the real-time performance trend, at the top of the left-most panel choose one of the following options: • Last 1 H: Shows data averaged every one minute. • Last 24 H: Shows data averaged over the last 24 hours. 8. To view detailed information for a point in time, move the cursor over a point on the graph. A pop-up dialog appears, as shown in the following example. 9. Click Settings & Download again to hide the panel.
a. Click the Download check box. b. Choose a Time Interval from the drop-down list. c. Click Download as CSV. Data for the specified time interval is saved as a CSV file. 6. (Optional) View detailed information on the container by clicking the blue information (i) icon in the Current Value panel or next to the Container drop-down list. 7. (Optional) Modify the output display, as described in Customizing the Output Display on page 55. To monitor a specific LUN, do the following: 1.
7. (Optional) Modify the output data display, as described in Customizing the Output Display on page 55. To monitor a port, do the following: 1. Select Monitor > Overview. The Monitoring page appears. 2. Click Settings & Download to expand the panel. 3. Choose a container name from the Container drop-down list. The display changes to show the real-time data for the selected container. 4.
To search for a specific LUN, do the following: 1. Select Monitor > Monitor LUNs. The LUN Monitoring page appears. 2. Choose a container name from the Container drop-down list. The display changes to show the LUNs in the selected container. 3. Enter a string in the search field and press Enter. LUN names that match the search string appear in the list on the left. 4. Select the LUN so that it highlights.
5. Choose a graph type from the drop-down list. The following example shows a Stacked Area graph. 6. Move your mouse cursor over a point on a graph to display detailed information for that specific point in time. Monitor Targets You can analyze performance data for target ports in time statistics, as well as using historical trends. Note: Fibre Channel data is shown in frames per second.
Analyzing Data for a Target You can analyze target data in real-time or as historical trends, and choose from a variety of display formats. To analyze data for a selected target port, do the following: 1. Select Monitor > Monitor Targets. The Target Port Monitoring page appears. 2. Choose a target port, as described in Selecting a Target Port on page 61. 3.
: Function Page Cluster Admin Tasks • Viewing Software Version and Boot Images on page 64 • Rebooting or Shutting Down a Node on page 64 • Changing and Saving Configuration Files on page 65 • Viewing Gateway Node Details on page 66 • Viewing Alerts on page 66 • Searching for and Viewing Logs on page 67 • Viewing Node Versions on page 68 • Viewing Current Network Settings on page 69 • Changing the Gateway Management Virtual IP Address on page 70 • Modifying Global Default Gateway Settin
In the case of failure of both the master node and the standby node, the cluster continues to operate by electing a new master from the list of available nodes. Viewing Software Version and Boot Images The Software section of the Cluster Admin page shows the current software version running on the SAN Gateways, as well as the boot images. Two boot images are installed for each SAN Gateway, each in a separate partition. To view the software version and choose a boot image, do the following: 1.
2. Do one of the following: — To reboot the system, click Reboot. In a cluster configuration, the standby SAN Gateway takes over while the master reboots. — To shut down the system, click Shutdown. In a cluster configuration, the standby SAN Gateway takes over when the master is shut down. A pop-up dialog appears. 3. Click OK to continue with the reboot process, or Cancel to quit without rebooting or shutting down the system.
Viewing Gateway Node Details The Gateways page lists all the SAN Gateways (nodes) in the management cluster, their status (online/offline), their role (master node, standby node, normal node), and notification of unsaved changes To view SAN Gateway node details, do the following: 1. Select Administration > Cluster Admin > Gateways. The Gateways page displays a list of active nodes. If the management cluster has too many nodes to display on one page, click the Next to page forward and Prev to go back. 2.
2. To change the types of alerts that appear in the list, deselect or select the check box next to the Show icon: Info, Warning, Error. A check mark indicates that the alert type is selected to appear in the list. 3. Click the Next to page forward through the list and Prev to go back. 4. To change the number of alerts displayed on a page, choose a number from the Display dropdown list and then click Apply. 5. To sort based on the values in a column, click the column heading.
3. To go to the most recent log entries, click the double arrow icon (>>) last available page in the log and scroll to the bottom. 4. To view a historical log, or to return to the current log after viewing another one, click the Log File field, select a file from the drop-down list, then click Apply. Note: The Log File field displays the top file in the drop-down list (“Current log”). It does not display the name of the log file that you are viewing, which appears directly below the Log File field.
— HP VMA Cluster ID String: Current boot image 2. View more details on a node, click the Gateway ID link on the left. The View Gateway page appears, as described in Viewing Gateway Node Details on page 66. Network The Network Web Interface pages provide network configuration information for the SAN Gateway, and allows you to manage the cluster IP address and global default gateway. The tasks you can perform on these pages are intended for network administrators, and require Admin user access privileges.
This is the routing information for the SAN Gateway, including destination, mask, gateway, whether the node is active or static, and the interface. Changing the Gateway Management Virtual IP Address You can change the gateway management virtual address (also known at the virtual IP address or VIP) from the Network Settings page. In most cases, it is recommended that you change the cluster management address through a serial console using the CLI.
Note: If one or more IP addresses for DNS servers were set up as part of the initial out-of-the-box setup, they are listed on this page. To view configured DNS settings, do the following: 1. Select Administration > Network > DNS Settings. 2. Go to the DNS Servers panel at the top of the window to view information on the DNS servers that were configured as part of the initial out-of-the-box setup. To add and modify name servers, do the following: 1. Select Administration > Network > DNS Settings. 2.
3. Click Remove Selected. Viewing and Modifying NTP Settings The Network Time Protocol (NTP) is a networking protocol for synchronizing the clocks of computer systems over data networks. You can enable or disable NTP synchronization and add or remove an NTP server through the NTP Settings page. When you initially go to the NTP Settings page, information for the NTP server that was configured in the out-of-box setup is shown. To enable or disable NTP time synchronization, do the following: 1.
3. To disable an NTP server, click the check box next server name in the NTP Servers panel. Then, click Disable Server. 4. To remove an NTP server, click the check box next server name in the NTP Servers panel. Then click Remove Selected Server. To add an NTP server, do the following: 1. Select Administration > Network > NTP Settings. 2. Go to the Add New NTP Server panel and enter the new NTP Server IP address in the text box. 3.
To disable Web management, do the following: 1. Select Administration > Network > Web Admin. The Network Settings page appears. Note: Web Management must be enabled by default, or you wouldn’t be able to access the HP VMA SAN Gateway cluster through the Web Interface. 2. To disable Web Management, click the Enable Web Management check box to deselect this feature. The check mark disappears, turning off the function. 3. Click OK to disable Web Management.
2. Go to the Web Configurations panel, and specify the following options: • Auto Logout Timeout (secs)—Enables automatic logout and disconnect of the Web Interface connection to the HP SAN Gateway cluster after a specified period of inactivity. The default auto logout timeout is 9000 seconds (15 minutes). • Enable HTTP—Enables (or disables) HTTP on the specified port. • HTTP Port—Port 80 is the default.
Specifying Call Home Settings The Email (Call Home) Settings page allows you to enable email alerts in the following ways: • Auto Support—Enables the HP VMA SAN Gateway cluster to report alerts and critical events to a specified email address. Auto Support requires an SMTP server and email domain name. • Fault Reporting—Specifies the SMTP server and mail domain name used for call-home messages. These settings are also used for alerts. To enable auto support and fault reporting, do the following: 1.
Understanding User Roles and Privileges A user’s assigned role determines the level of privileges they have in accessing and administering the HP VMA SAN Gateway cluster. Some of parameters are only visible or configurable by users with certain roles (privileges). The available roles and their privileges are as follows: User Role Privileges admin A user who can perform all administration and configuration tasks.
• • • 4. User Name: Enter the user name for the login credential. Password: Enter the new password. Confirm: Re-enter the new password. Click OK to accept the change, Cancel to abort the action, or Reset to clear the fields and start over. Editing a User Account An Admin user can change an existing user account, modifying personal and contact information. To edit an existing user account, do the following: 1. Select Administration > Notification > Users. 2. Click Edit for the desired user.
5. Click OK in the confirmation dialog to save the changes. The results appear in the User Management panel. Deleting a User Account An Admin user can delete the accounts of other users. To delete a user account, do the following: 1. Select Administration > Users. 2. Click Delete next to the account name you want to remove. A confirmation dialog appears . 3. Click Yes to confirm you choice, or No to cancel the action. If you click Yes, the user account is deleted from the list.
Enabling Email Alerts You can specify whether or not to receive alerts from the vSHARE cluster. Call Home Settings entries are used to send the alerts. For information on how to enable Call Home settings, see Specifying Call Home Settings on page 76. To enable email alerts, do the following: 1. Complete the task as described in To enable auto support and fault reporting, do the following: on page 76. 2. Select Administration > Notification > Email Settings. 3.
• Include Host Name to Return Address: Clear this check box to remove the host name from the return email address. 3. Click Apply to accept the Current Return Email Address, or Cancel to modify the return email address using the previously described fields. 4. Go on to complete Configuring SMTP Authentication on page 81. Configuring SMTP Authentication SMTP Authentication (SMTP AUTH) is an extension of the Simple Mail Transfer Protocol (SMTP).
Managing Alert Recipients The Alert Recipient Management section shows information about the current e-mail notification recipient, if one is configured. You can edit the account for an existing alert recipient, add new recipients, delete recipients, and send test e-mails to recipients. To edit, delete, add and verify alert recipients, do the following: 1. Select Administration > Notification > Email Settings, and go to the Alert Recipient Management panel. 2.
• • Get Failures? Select this check box to receive notifications on failure events (such as file system errors, process crashes, and unexpected shutdowns), or deselect the check box to turn off this option. Click OK to activate the request, Cancel to abort the request, or Reset to clear the fields and start again. 4. To delete an alert recipient click Delete next to the recipient’s name, then in the dialog that appears click OK to confirm or No to cancel the action. 5.
• 3. • Select individual events in a category by clicking the check box next to the name. A check mark appears when the event is selected. Select the event again to deselect the event and remove the check mark. Select all the events in a category by clicking the check mark icon on the right side of the header. • Deselect all selected events in a category by clicking the X icon on the right side of the header.
3. To disable SNMP Management, select the check box again. The check mark disappears. 4. Click Apply to activated your selection, or Cancel to return to the previous state. Configuring SNMP You can configure SNMP, including settings for the Read-only Community and SNMP Traps Community. • An SNMP TRAP is a message that is sent out when a significant system event is detected. A trap sink community defines a host and a community string pair. The community string is the most basic form of SNMP security.
Setting SNMP Trap Sinks A trap sink defines a host and a community string pair. When a trap event occurs the SNMP agent sends out a trap to each host in the trap sink list using the community string. This section shows you how to configure a trap sink list, by removing, enabling, disabling, and adding SNMP servers (hosts) to be included in the list.
6. Click Add SNMP Server. Managing SNMP Traps You can individually select from all available SNMP notification events. For information on using MIB Browsers to help manage SNMP, see Benefits of Using a MIB Browser on page 230. Note: The notifications are sent to the email address specified on Administration > Notification > Email Settings page. For more information, see Configuring SNMP on page 85.
Select None: Deselects all events Reset Defaults: Returns to system default selections • 3. • Select individual events in a category by clicking the check box next to the name. A check mark appears when the event is selected. Select the event again to deselect the event and remove the check mark. Select all the events in a category by clicking the check mark icon on the right side of the header. • Deselect all selected events in a category by clicking the X icon on the right side of the header.
3. Click Add Licenses. The new feature license appears in the Installed Licenses panel at the top of the window. Removing a Feature License You can easily remove installed feature licenses, either individually or all at once, using the following procedure. To remove a license, complete the following steps: 1. Select Administration > Feature Licenses. 2. In the Installed Licenses panel at the top of the window, select the check box of the licenses you want to remove, as shown in the following example.
Accessing Context-Sensitive Help The SAN Gateway provides context-sensitive online help for each page in the Web Interface. To access context-sensitive Help, do the following: 1. Open the Web Interface as described in Logging In to the Web Interface on page 27. 2. On the Web Interface for which you want Help, click the Page Help button in the upper right corner of the window. The help for that page appears, as shown in the following example. 3.
2. To view information on your HP VMA End User License, select Administration > Information > HP VMA License. 3. To view applicable legal notices and acknowledgements for this release, select Administration > Information > Acknowledgements.
HP VMA SAN Gateway User’s Guide AM456-9026A
CHAPTER 3 vSHARE Configuration This chapter describes vSHARE features and functions, and the steps required to configure a HP VMA SAN Gateway running vSHARE to manage block storage.
• Storage Containers: A HP VMA-series Memory Array contains a storage container; currently there is a one-to-one (1:1) mapping between an array and a container (one container per array). Every LUN created and managed by vSHARE is created within a storage container. You can create many LUNS within a container. • Initiators and Initiator groups: An initiator is a host or client that requires access to the LUNs stored in a container.
Target Ports You can view information for target ports using the show targets command. For more information, see show targets Command on page 100. . vSHARE Configuration Overview The steps to configure a vSHARE HP VMA SAN Gateway using Fibre Channel are outlined in the following flowchart. Figure 3.2 vSHARE Deployment Flowchart 1. Configuring Storage Containers on page 96.
4. Creating LUNs on page 102. LUNs are created within a storage container that comprises a particular HP VMA-series Memory Array. A LUN inherits the attributes of the container (HP VMA-series Memory Array) in which it is created. Note: As 5. of this release, one container comprises a HP VMA-series Memory Array. Exporting LUNs on page 106. This required step exports the LUNs to the initiator groups or initiators via target ports.
Syntax media init device type [block] [force][name] WARNING! Using the force option of the media init command (media init force) destroys the existing data on an array. You should not use this command on a previously initialized array without first backing up the data on the array.
4. (Optional) Use the name parameter to create a more intuitive name for the container ID. In the following example, the generated container ID is changed to FASTBOX1: (config) # media init device ata-VIOLIN_MEMORY_ARRAY_23108R00000043 type block name FASTBOX1 5. Confirm that you want to initialize the HP VMA-series Memory Array. Really initialize ata-VIOLIN_MEMORY_ARRAY_FASTBOX1 (all data will be lost)? [no] y A message confirms that the HP VMA-series Memory Array was successfully initialized.
4. To verify the containers were created, enter the show containers command. Information about the containers displays. # show containers Container LUNs Total Free Ports HostnameA HostnameB Status ---------------------------------------------------------------------C-1 0 199G 199G A,B Single C-2 150 199G 50176M A,B Single Configuring Target Ports The second step in configuring a vSHARE SAN Gateway is to configure the target ports.
show targets Command The show targets command lists all of the target ports and their addresses (wwn), filtered by various options. Syntax show targets [node ] [hostname ] [protocol fc] [id ] [sessions] [detail] Parameters [node ] Displays targets on node ID. [hostname ] Displays targets on hostname. [protocol fc] Displays targets using protocols FC. [id ] Displays a specific target.
3. Add one or more initiators to the igroup, using the igroup addto command. The initiator_name must be a valid wwn (Fibre Channel). An igroup can contains Fibre Channel initiators. In the following example, two Fibre Channel initiators are added to the igroup. (config) # igroup addto name initiators wwn.21:00:00:1b:32:9a:18:65 wwn.21:01:00:1b:32:ba:18:65 Fibre Channel initiator identifiers (WWN) are fixed by the HBA port.
Examples The following examples demonstrates using the igroup create command to manage initiator groups and initiators. The following command creates an initiator group named FINANCE: igroup create name FINANCE The Cisco-style no prefix may be used to delete initiator groups or initiators. In the following example, the command deletes the igroup FINANCE. no igroup create name FINANCE igroup addto Command The igroup addto command adds one or more initiators to a group.
Note: As of this release, one container comprises a HP VMA-series Memory Array. On the host system (initiator), the LUN appears as a local SCSI disk. The host may format and partition the LUN. The target, or storage system, sees the contents of the LUN as a set of blocks of arbitrary data. Every LUN is created within a container, and each container comprises a HP VMA-series Memory Array. vSHARE implements LUNs at a minimum of 1GB increments with the ability to configure up to 1024 LUNs per SAN Gateway.
lun create Command The lun create command enables you to create a LUN within a specified storage container. Syntax [no] lun create container name size [ | equal] [quantity ] [nozero] [readonly] [startnum ] [blksize 512 | 4096] [offline] Syntax Description The table shows syntax for LUN commands. name Defines the name of LUN to be created; used as a prefix if the quantity of LUNs created is greater than one.
Syntax [no] lun set container name readonly show luns Command The show luns command allows you to view various types of information about a LUN or LUNs. Syntax show luns [container] [name] [count] [reserved] [serial] [sessions] Syntax Description container Displays only the LUNs within a specific container. name Displays a specific LUN. count Displays LUNs with active sessions and their count. reserved Displays LUNs with SCSI reservations.
Exporting LUNs The fifth step in configuring the vSHARE SAN Gateway is to export the LUNs to an initiator. The LUN must be exported before it may be accessed over block protocols. Note: vSHARE LUNs are defined and saved within the Arrays themselves. vSHARE LUN export records are, however, managed and stored within the vCLUSTER configuration database owned by the master node.
Syntax Description lun_name The lun_name could be wildcard specified, such as FINANCE* container name lunid Designates the LUN ID assigned to an exported LUN. By default, LUN IDs are automatically assigned by vSHARE. User-defined LUN IDs may be specified to track specific LUNs. igroup The name of the igroup. If no igroup or initiator is specified, all initiators will have access to the LUN. initiator The WWN (Fibre Channel) name of the initiator.
HP VMA SAN Gateway User’s Guide AM456-9026A
CHAPTER 4 vSHARE Management This chapter describes the management of a HP VMA SAN Gateway configured for vSHARE block storage using the command line interface (CLI) and HP VMA Web Interface in four sections: • • • • Verifying Connections and Performance on page 109 Block Storage Media Management on page 112 vSHARE Block Storage Management Commands on page 121 Managing Block Storage in the HP VMA Web Interface on page 125 Verifying Connections and Performance This section describes procedures and techniq
The show targets command lists all of the target ports and their addresses (wwn), filtered by various options. The session and detail options are particularly useful for understanding target port activity and status. The sessions option displays the number of SCSI sessions active on a target and the initiator and the assigned LUN ID for each session.
For detailed information about this command, see Show Targets Command on page 124. Viewing Interface Status show interfaces [] [configured | brief] The show interfaces command may be used to view information about a specific interface or, if one is not named, all interfaces. By default, detailed information about the interface and its runtime state is given.
Block Storage Media Management This section describes commands for managing and monitoring block storage (vSHARE) media devices.
Note: For AM456-9026A more information, see Command Modes on page 145.
show media The show media command returns all media devices that can be used as block storage on the current San Gateway (node or module). This command shows a summary line for each device location, giving the size and status of that device. Location Media ID Model Size Status --------------------------------------------------------------------unknown-00 Fender1002 Violin Memory Array 6895.75G online unknown-01 Strad130 Violin Memory Array 432.
---------------------------------------------------------------------unknown-00 Fender1002 Violin Memory Array 6895.75G online unknown-01 Strad130 Violin Memory Array 432.00G online ---------------------------------------------------------------------Module 3: SM076 (10.10.0.143) Location Media ID Model Size Status ---------------------------------------------------------------------PCI 2 Strad134 Violin Memory Array 399.
show media block detail The detail option of the show media command returns detailed information about storage media. The detail option may be combined with any other show media command option in any order. SM076 [MY-vSHARE00: standby] (config) # show media block id all detail Location PCI 2: Status: online Size: 429226196992 Type: block device Firmware version: 3.7.
media block id enable The media block id enable command enables a specified block storage media device. The block option specifies a vSHARE block media device.
In the following example, the media block id all enable command enables all storage media devices on the local San Gateway: SM076 [MY-vSHARE00: standby] (config) # media block id all enable Enabling 23108R00000043 Enabling Strad134 no media block id all enable To disable the use of all media devices in the San Gateway, use the no form of the above command in Configure mode.
Understanding Media Health Status The status of the media device is defined by one of four values: ok The device is running correctly and has plenty of expected life remaining. unknown The status cannot be determined. warning A S.M.A.R.T attribute of the device is within 5% of the usage threshold specified by the manufacturer. critical A S.M.A.R.T attribute is equal to or below its usage threshold. (This indicates a high likelihood of impending failure.) Status is determined for each individual S.M.
show media health detail The show media health detail command returns detailed information about block storage devices on the local San Gateway including all of the S.M.A.R.T attributes and provides the status of each attribute. In the following example, the block id option is used to identify a specific media device. SM075 [MY-vSHARE00: master] # show media health block id Strad130 detail Location unknown-01: Model: Violin Memory Array Est. life remaining: 96.
show stats media The structure of the show stats media commands is identical to the show media commands described above, except that these commands also support a continuous option to display a continually updating view of the statistics. SM075 [MY-vSHARE00: master] # show stats media Media Stats Summary (sampled @10 secs) Read (bytes/s) Write (bytes/s) Location Media ID Current Last 5m Current Last 5m ---------------------------------------------------------------------unknown-00 Fender1002 36.81M 34.
Managing Initiator Groups Each initiator is a Fibre Channel WWN. • Fibre Channel initiator identifier format: wwn Fibre Channel initiators are fixed by the appropriate HBA port, for example wwn.01:02:03:04:05:06:07:08 igroup Create Command [no] igroup create name initiators [initiator_name ...] The igroup create command creates an initiator group and, optionally, one or more Fibre Channel initiators. Fibre Channel initiator identifiers (WWNs) are generated automatically by an HBA.
The show luns session command returns information about the sessions connected to LUNs including the target port and the session ID. Use the name option to identify a specific LUN.
The lun set command enables you to set a LUN as read-only. The lun set command is the only command usable after a LUN has been created except the no lun create … readonly command. LUN Statistics Command LUN statistics are accessed via the CLI with the following command: show stats lun [container ] [name ] [on global|on host ] [continuous] [detail] Use the container option to restrict statistics display to a single container.
Managing Block Storage in the HP VMA Web Interface The HP VMA Web Interface provides you with tools for managing LUNs, initiator groups, and targets.
HP VMA SAN Gateway User’s Guide AM456-9026A
CHAPTER 5 VMA SAN Gateway Management This chapter covers gateway management tasks and includes the following topics: • • • • • • HP VMA Gateway Management Overview on page 127 SAN Gateway Cluster Management on page 128 Monitoring the Gateway on page 130 Managing Configuration Files on page 132 Managing Users on page 137 VMA SAN Gateway Upgrade Options on page 138 HP VMA Gateway Management Overview The VMA SAN gateway management software provides for the redundant pairing of two HP VMA SAN Gateway nodes
For information on how to set up and configure a redundant VMA SAN Gateway pair, see the Configuring a Redundant Pair of VMA SAN Gateways - Process Guide. Note: The roles of master and secondary refer to nodes for cluster configuration management. The pairing of SAN Gateway nodes for a High Availability (HA) configuration is achieved through physical cabling. SAN Gateway Cluster Management Management tasks can be performed either in the HP VMA Web Interface or in the CLI.
Admin password Setting a password is highly recommended. Timezone Set the clock timezone by specifying the zone and subzones. Use "?" to interactively display zone names from which to choose. NTP server Optional, however specifying a NTP server is recommended. Email notification recipients, mail hub, & port Set recipients to callhome-hp@vmem.com for HP Customer Support and at least one email alias for your company, in a comma-separated list.
• Master Node: The master node is the primary node for managing the HP VMA SAN Gateway pair. The cluster management VIP is assigned to the master node. • Secondary Node: The second node configured in the cluster is automatically designated as the secondary node. The secondary node is an active node that performs services. If the master node fails, the secondary node replaces it and becomes the master node, and cluster management traffic is automatically redirected to the new master node.
The following is an example of show cluster global brief on the standby node: SM076 [NJ-Lab-vSHARE00: standby] # show cluster global brief Global cluster state summary ============================== Cluster ID: 99999-9999-1023 Cluster name: NJ-Lab-vSHARE00 Management IP: 10.10.0.38/24 Cluster master IF: eth1 Cluster node count: 2 ID Role State Host External Addr Internal Addr ---------------------------------------------------------------------2 master online SM075 10.10.0.37 10.10.0.
Hostname: vmg-vc1-n2 Node Role: master Node State: online Node internal address: 169.254.70.242, port: 60102 Node external address: 10.3.19.102 Recv. Heartbeats from: 2 Send Heartbeats to: 2 Node Status: Node ID: 2 Host ID: e12080d777e6 Hostname: vmg-vc1-n1 Node Role: standby Node State: online Node internal address: Node external address: Recv. Heartbeats from: Send Heartbeats to: 1 gateway02 [cluster1: master] # 169.254.151.82, port: 56345 10.3.19.
Note that an asterisk (*) appears before the command prompt to remind you that changes have been made to the HP VMA SAN Gateway, which have not yet been saved.
Saving the Configuration File to a Remote Server You can create a copy of the active SAN Gateway configuration file and store it on a remote server for recovery purposes. The system backs up the active configuration file automatically. However, storing a copy of the configuration file on a remote server ensures that you can restore the system configuration to its current settings in case of a disaster. Perform the following steps on all SAN Gateway nodes in the redundant pair (Master and Secondary): 1.
Show Configuration Files To view a list of all of the configuration files associated with this VMA SAN Gateway, use the show configuration files command. The command identifies the active file, the back up of the current active file (called .bak), and backups of previously active configuration files. In the following example, the show configuration files command returns five configuration files: gateway02 [cluster1: master] (config) # show configuration files initial initial.bak cf1 (active) cf1.
With the exception of the show configuration full and show configuration running full commands, output omits commands that are not required because they set parameters to their default values. show configuration The show configuration command displays commands to reproduce the state saved in the active configuration file.
Reverting to Saved Configuration Files If you do not want to keep the current changes, you can revert to the last saved configuration or apply an inactive configuration file to the VMA SAN Gateway using the configuration revert saved command.
The CLI command modes configure, enable, and standard correspond to the admin, monitor, and crypto roles. You can add user accounts and set their privileges and passwords in the Administration section of the HP VMA Web Interface or by using the CLI. • For information on managing users in the CLI, see User Accounts and Local Authentication on page 158. • For information on managing users in the HP VMA Web Interfaces, see Managing User Accounts on page 76.
REFERENCE APPENDIX A, “VMA SAN Gateway Command Line Interface Reference” on page 141 APPENDIX B, “Utilities Reference” on page 211 APPENDIX C, “SNMP Traps” on page 229 AM456-9026A HP VMA SAN Gateway User’s Guide 139
HP VMA SAN Gateway User’s Guide AM456-9026A
VMA SAN Gateway Command Line Interface Reference APPENDIX A This chapter provides reference information and guidance about how to use the command line interface (CLI) of the HP VMA SAN Gateway, in the following sections.
Using the Command Line Interface The CLI can be used to perform the functions provided in the HP VMA Web Interface, as well as other functions that are not available in the HP VMA Web Interface. Depending on the user’s current access mode (described in Command Modes on page 145), a subset of CLI commands is available for configuring, managing, and viewing information about the HP VMA SAN Gateway.
Note: When scripting CLI commands, the shorthand versions should not be used, since commands that appear in a future release could potentially change the acceptable shorthand version of a given command. Getting Help In any mode of the CLI you can query for help by using the help command or a question mark. Enter help at the prompt for a summary of how to use question marks to obtain context-sensitive help, as described here.
For example: > cli session ? auto-logout paging prefix-modes progress terminal x-display Configure keyboard inactivity timeout for automatic logout Configure the ability to view text one screen at a time Configure the CLI's prefix modes feature for this session Configure progress updates for long operations Set terminal parameters Set the display to use for X Windows applications > cli session paging ? enable Enable paging > cli session paging enable ? > cli session terminal ? length Set the number o
show Lists options of the show command that can immediately follow the show keyword. sh Completes the show keyword and lists options of the show command. s Lists all available commands that begin with the letter "s". For a list of all commands currently available, press the Tab key twice at the prompt.
Configure Mode The configure terminal command moves the CLI from Enable mode to Configure mode. • On the cluster’s master node, Configure mode has a full unrestricted set of commands to view anything, take any action, or change any configuration. Its commands are a superset of those in Enable mode. • On nodes other than the master, Configure mode only includes commands that operate on the local node.
For example, when changes need to be saved the command prompt for Configure mode changes to this: Config (unsaved): * gate1 [vmgCluster: master] (config) # Most configuration commands that succeed in doing what was asked do not print any response, so the next thing you see after pressing is another command prompt. You can verify the effect of a configuration command by using its corresponding show command to display current settings.
Key to Command Parameters This section is a key to the meaning and format of parameter values and other attributes of the CLI commands. Parameter values are shown in angle brackets, and listed alphabetically below. A string specifying the cluster id sequence. A domain name, such as hp.com. A hostname, such as hexagon.hp.com. An interface name, such as "eth0", "eth1", "lo" (loopback), and so on. An IPv4 address, such as 192.168.0.1.
If you omit the :password part, you may be prompted for the password in a follow up prompt, where you can type it securely (without the characters being echoed). This prompt will occur only if the "cli default prompt empty-password" setting is true; otherwise, the CLI assumes you do not want any password. If you include the :S character, this is taken as an explicit declaration that the password is empty, and you will not be prompted in any case.
Control Paging of CLI Output [no] cli default paging enable [no] cli session paging enable Enable or disable paging of CLI output. If paging is enabled, all command output, as well as all help text printed when the ? key is pressed, will be displayed one screen at a time, using the same pager as the 'show log' command uses. If the text to be displayed fits on a single screen, it will be printed normally and the pager will not be used.
terminal width terminal length Override the auto-detected size of the terminal. This is useful mostly when the size could not be auto-detected and the CLI is using the default 80x24. These settings are persistent only for the current CLI session. They are also lost if the terminal is resized and the CLI is able to auto-detect its new size.
Display current terminal width and length, whether auto-detected or overridden, as well as the current terminal type. This is a subset of the information displayed by show cli, and is only present for Cisco compatibility.
Set Local Log Severity logging local no logging local Set the minimum severity of log messages to be saved in log files on local persistent storage, disable local logging altogether. The logging local none and no logging local commands have the same effect. This limitation also applies to log messages originating from other hosts and logged to us over the network.
Set Log Severity for All Syslog Servers logging trap Set the minimum severity of log messages sent to all syslog servers. Note that the Cisco command set does not provide for setting different severity levels on a per-server basis. Set, clear, enable, or disable class-specific log level overrides for all syslog servers. Semantics are the same as for the logging local ... variants above.
Specify Log Format logging format standard logging format welf no logging format welf Sets the format in which log messages should be set. The choices are standard and welf. The default is standard, and the no variant resets the format to this. Specify the Log Firewall logging format welf fw-name no logging format welf fw-name Specifies the firewall name that should be associated with each message logged in WELF format. If no firewall name is set, the hostname is used by default.
Force Log File Rotation logging files rotation force Force an immediate rotation of the log files. This does not affect the schedule of auto-rotation if it was done based on time: the next automatic rotation will still occur at the same time it was previously scheduled for. Naturally, if the auto-rotation was based on size, this will delay it somewhat as it reduces the size of the active log file to zero.
interval Set how often to gather logs, in hours. max-size Set the maximum uploadable file size, in MB. remote-dir Set the remote directory for uploading logs. remote-site Set the remote site for uploading logs, in URL format. user Change the user/password used with the remote server. Note: Files are uploaded from all gateways simultaneously.
View a List of Local Log Files show log files View a list of local log files. User Accounts and Local Authentication This section provides the syntax for commands used for creating and managing user accounts and local authentication. An explanation of the functionality of each command is also provided. Note: There are two defined system accounts: one with full privileges (admin), and one with privileges for reading all data and performing all actions, but not for changing any configuration (monitor).
Specify User Login Credentials User login credentials include a username and password. Note: Two types of password encryption are supported, SHA-1 and MD5. Secure Hash Algorithms (SHA) are cryptographic has functions structured differently and are distinguished by the appended number, such as -1. Message-Digest Algorithm is a cryptographic has function that produces a 128 bit (16 byte) hash value.
Display All User Accounts show usernames Display a list of all user accounts and the capabilities of each. NTP, Clock, and Time Zones This section provides the syntax for date and time commands, along with an explanation of the functionality of each command. Set the System Clock clock set [] Set the system clock. The time must be specified. The date is optional; if not specified, the date will be left the same.
Display Current Date, Time, and Timezone show clock Display the current system time, date, and timezone. Use the NTP Server to Set the System Clock ntpdate Set the system clock using the specified NTP server. This is a one-time operation and does not cause the clock to be kept in sync on an ongoing basis. It will generate an error if NTP is enabled, as the socket it requires will already be in use.
Enable or disable NTP overall. Note that the latter is the Cisco command; the former is just a pair of aliases added to increase usability, as otherwise it may be hard for a user to figure out how to enable NTP if they are not aware of no commands and only see a way to disable it. Display NTP Settings show ntp Display current NTP settings. Event Notification This section provides the syntax for event notification commands, along with an explanation of the functionality of each command.
Set the domain name to be used as the source for email notifications. The specified domain name is used in conjunction with the system hostname to form the source email address. The rules are as follows: • If an email domain is specified using this command, it is always used. If the hostname has any dots in it, everything to the right of the first dot is stripped and the email domain is appended. • Otherwise, if the hostname has dots in it, it is used as is.
For example: (config) # email notify event ? process-crash A process in the system has crashed process-exit A process in the system unexpectedly exited liveness-failure A process in the system was detected as hung cpu-util-high CPU utilization has risen too high cpu-util-ok CPU utilization has fallen back to normal levels paging-high Paging activity has risen too high paging-ok Paging activity has fallen back to normal levels disk-space-low Filesystem free space has fallen too low disk-space-ok Filesystem f
unexpected-cluster-join A node has unexpectedly joined the cluster unexpected-cluster-leave A node has unexpectedly left the cluster unexpected-cluster-size The number of nodes in the cluster is unexpected unexpected-shutdown Unexpected system shutdown interface-up An interface's link state has changed to up interface-down An interface's link state has changed to down user-login A user has logged into the system user-logout A user has logged out of the system hwmon-file-sys-error A file system error has occ
Add or remove an email address from the list of addresses to send email notifications of events. Specify Failure Event Notification Recipients [no] email notify recipient class info [no] email notify recipient class failure Enable or disable the sending of informational or failure events to the specified recipient. Each event type is classified as either informational or failure.
Display notification settings. This does not include SNMP traps, which are under the snmp-server command tree. Diagnostic Tools This section provides the syntax for a variety of diagnostic tool commands, along with an explanation of the functionality. ping and traceroute ping [] traceroute [] Network diagnostic tools ping and traceroute. Invokes standard binary, passing command line parameters straight through.
show files system show files system Display information regarding bytes and inodes usage of the file systems on the system. show memory show memory Display information about system memory utilization. reload reload [halt] [noconfirm] Reboot the system if reload, shut down the system if reload halt. If there are unsaved changes to the configuration, the user may be prompted as to whether they want to save these changes (that is, do a write memory) first before rebooting.
Generate a debugging dump. The dump can then be manipulated using the file debug-dump ... family of commands. Statistics This section provides the syntax for system statistics commands, along with an explanation of the functionality of each command. stats clear stats stats stats stats clear-all sample clear chd clear alarm clear Clear all memory of the specified sample, computed historical data-point (CHD), or alarm, or of all of those together.
stats alarm rate-limit window short stats alarm rate-limit window medium stats alarm rate-limit window long Configure the alarm event rate-limit duration windows for the three types of durations for alarms.
Shows media statistics, including read/write latencies as follows: all Displays media statistics for all devices. block Displays media statistics for block devices. continuous Displays media statistics continuously. detail Displays media statistics with detail. global Displays media statistics globally. stats export stats export [filename ] [after
show files stats Display the contents of a particular statistics report file. file stats delete Delete a stats report file. file stats move Rename a stats report file. file stats upload Upload a stats report file. For formats, see Key to Command Parameters on page 148.
configuration revert configuration revert saved Revert the running configuration to the latest saved version of the active configuration file. configuration revert factory [keep-basic | keep-connect] Revert both running and saved configurations to factory defaults. If keep-basic is specified, preserve local network configuration. If keep-connect is specified, preserve active licenses. These two options are mutually exclusive.
configuration delete, move, copy configuration delete configuration move configuration copy Delete, move (rename), or copy a configuration file. These do not affect the current running configuration. The active configuration file may not be deleted or renamed, nor may it be the target of a move or copy. It may be the source of a copy, in which case the original remains active.
write terminal write terminal Same as show running-config, provided for Cisco compatibility. configuration jump-start configuration jump-start Run the initial-configuration wizard. The wizard is automatically invoked whenever the CLI is launched when the active configuration file is fresh (that is, not modified from its initial contents). This command invokes the wizard on demand.
Image Management This section provides the syntax for image management commands, along with an explanation of the functionality of each command. Specify Boot Location boot system location boot system next Specify which location the system should boot from by default. If next is used, set the boot location to be the next one after the one currently booted from.
Enable Mode enable Enter enable mode, if the user account was set up with the privileges to do so. disable Leave enable mode. Configure Mode configure terminal conf t Enter Configure mode, if the current user account has the privileges to do so. Note: There is no mechanism to prevent multiple users from being in Configure mode simultaneously. no configure Exit Configure mode and return to Enable mode. exit Current Mode exit Exit the current mode. From Configure mode, go to Enable mode.
If desired on a http or ftp download, a proxy can be specified. If no port is specified, the default is 1080. Xinetd Server Settings This section provides the syntax for xinetd server setting commands, along with an explanation of the functionality of each command. Enable and Disable a Telnet Server [no] telnet-server enable Enable/disable the telnet server. Show Telnet Server Settings show telnet-server Show telnet server settings.
Delete a tcpdump File file tcpdump delete Delete the specified tcpdump output file. Upload a tcpdump File file tcpdump upload Upload the specified tcpdump output file to the specified URL. Only scp pseudo-URLs are supported for the destination. See Key to Command Parameters on page 148 for the scp:// URL format. Debug Dumps This section provides the syntax for debug dump commands, along with an explanation of the functionality of each command.
file debug-dump upload-usb Save a specified debug dump file to a USB drive. Email a Debug Dump File file debug-dump email Send the specified debug dump in email to the list of configured recipients for informational events regardless of whether they have requested to receive detailed notifications. Cluster Configuration and Show Commands This section provides the syntax for cluster configuration and show commands, along with an explanation of the functionality of each command.
Display run state information about standby node. Cluster Action Commands [no] cluster heartbeat enable Enable/disable heartbeat checking between nodes of cluster. This is used to detect communication failures between cluster nodes. cluster shutdown Shutdown cluster (master only). Cluster Configuration Commands cluster master address vip Set the cluster master virtual ip address and netmask. no cluster master address vip Reset cluster master virtual address to default.
Network Interface Commands Network interface commands enable you to configure network interfaces for the HP VMA SAN Gateway cluster. The default public interface—the Ethernet port used for cluster management—is eth1, which may be configured manually (recommended) or automatically using DHCP or zeroconf. For redundant gateway pair configuration eth0 (bonded interfaces) should be used as the public interface.
Set the interface speed. Note that setting it to auto also sets duplex to auto. Setting it to one of the manual settings (generally 10, 100, or 1000) also sets the duplex to a manual setting which is determined by querying the interface to find out its current auto-detected state. [no] interface dhcp Enable or disable use of DHCP on the specified interface. The command gets the IP address and netmask via DHCP so those settings are ignored.
Ten network bonding modes are supported: balance-rr Round robin balancing backup Backup fault-tolerant mode link-agg Link Aggregation mode link-agglayer2+3 Link Aggregation Layer 2 + 3 mode link-agglayer3+4 Link Aggregation Layer 3 + 4 mode VLAN Commands A VLAN, or virtual LAN, is a set of nodes that are grouped together into a single logical network, regardless of their physical location. Multiple VLANs may share the same physical Ethernet links.
Name Resolution Commands hostname no hostname Set or clear the system hostname. [no] ip name-server [no] ip domain-list [no] ip host The commands configure DNS servers, specifies which domain(s) to try unqualified hostnames in, and defines hostname/IP mappings for /ETC/HOSTS. show hosts Show all values configured by the group of commands above: hostname, name servers, domain name list, and static host mappings.
Initialize a Device The media init command initializes a device, such as an array. WARNING! Using the force option of the media init command (media init force) destroys the existing data on an array. You should not use this command on a previously initialized array without first backing up the data on the array.
The show media command is an alias for show media [block] id all command. Show LUNs Reserved show luns reserved Displays list of reserved LUNs Display All Media Devices show media all Display all media devices installed in a HP VMA SAN Gateway. This command shows a summary line for each device location, giving the size and status of the installed media device.
Display System Health show show show show media media media media health [block] id all health all health [block] id health Display information about the status and expected lifetime of media devices. The show media health command is an alias for show media health id all. To include non-block storage, use show media all health (or show media health all). The global and detail options can also be used in combination with the health option, in any order.
The statistics are read and write rates (in MB per second) for these intervals: • The current ten-second sample. • The last five minutes. If the continuous option is specified, the display of statistics is updated continually. Press CTRL+C to exit the display. > enable # show stats media Media Stats Summary (sampled @10 secs) Read (bytes/s) Write (bytes/s) Location Media ID Current Last 5m Current Last 5m ---------------------------------------------------------------------PCI 1 HA-3 8.00k 8.00k 4.
Enable or Disable HTTPS [no] web https enable Enable or disable HTTPS (HTTP over SSL) access to the Web Interface. This setting is only meaningful if the Web Interface as a whole is enabled. Specify the HTTPS Port web https port no web https port Set the port number for HTTPS. The default is 443. The no command resets it to the default, but does not disable HTTPS.
Control the length of time before web session cookies are automatically regenerated. Control Web Session Timeout web session timeout no web session timeout Control the maximum lifetime of a web session cookie. Display Web Interface Details show web Display Web Interface configuration settings. Address Resolution Protocol Commands The following commands allow you to configure ARP, a protocol used for resolution of network layer addresses into link layer addresses.
List Statically-Configured ARP Entries show arp static Display a list of all statically-configured ARP entries. Security Commands This section covers the following commands: • Authentication Method and Order on page 192 • RADIUS Configuration on page 193 • TACACS+ Configuration on page 194 • SSH Configuration on page 195 • Banner Commands on page 198 Authentication Method and Order aaa authentication login default ...
• remote-only: Only try to map a remote authenticated user if the authentication server sends a local-user mapping attribute. If the attribute does not specify a valid local user, no further mapping is tried. • local-only: All remote users will be mapped to the user specified by the aaa authorization map default-user command. Any vendor attributes received by an authentication server are ignored. show aaa Shows the current authentication and authorization settings.
auth-port may be specified to refine which host is deleted, as the previous command will delete all RADIUS servers with the specified ip-address. RADIUS servers are tried in the order they are configured. show radius Show the RADIUS configuration. Note: We do not have CLI commands to specify the acct-port (accounting port) or retransmit on a per server basis. Also, there is no radius-server deadtime command as there is in the Cisco command set.
Sets (or clears) a global communication value for all TACACS+ servers. Can be overridden in a tacacs-server host command. Sets the shared secret text string used to communicate with any TACACS+ server. Add a TACACS+ Authentication Server [no] tacacs-server host {hostname , ip-address} [auth-port ][auth-type {ascii, pap}] [timeout ] [retransmit ][key ] Add a TACACS+ server to the set of servers used for authentication.
SSH Server Commands Enable or Disable the SSH Server [no] ssh server enable Enable or disable the ssh server. If the ssh server is disabled, the CLI is accessible over the serial console, or the local console using the keyboard. Note that this does not terminate existing ssh sessions; it will only prevent new ones from being established. Regenerate New Host Keys ssh server host-key generate Regenerate new host keys for the ssh server.
SSH Client Commands Generate Public/Private Keys ssh client user identity generate [passphrase ] Generate a new identity (private and public keys) for the specified user name. The given user name must correspond to a valid local user account. When the keys are generated, the private key is written to the user’s ssh directory in an appropriately named file (id_dsa). This identity can be used when the user uses the slogin command to connect from the system to another host.
Remove a public key from the specified user’s authorized key list. The key identifier can be found by using show ssh client. Display SSH Client Identities show ssh client Display information about SSH client identities (public/private keys) and the per user list of authorized keys for the users. Banner Commands This section provides the syntax for banner commands, along with an explanation of the functionality of each command. At various login points, some legal and welcome text can be displayed.
Enable or Disable the SNMP Server [no] snmp-server enable Enable or disable the SNMP server. Note that this not only stops serving of SNMP variables, but also the sending of SNMP traps. Enable or Disable SNMP Traps [no] snmp-server enable traps Enable or disable sending of SNMP traps from this system. Traps may only be enabled if the SNMP server overall is enabled.
Set the SNMP Community Name snmp-server community no snmp-server community Set the community name required to be supplied with SNMP requests to the system. Set the Contact and Location Variables snmp-server contact no snmp-server contact snmp-server location no snmp-server location Set the syscontact and syslocation variable served from the System MIB in MIB-II.
Scheduling Commands This section provides the syntax for sequences commands, along with an explanation of the functionality of each command. A job command is most commonly used to schedule jobs (commands or shell scripts) so they run at certain times or dates. A job is similar to a cron in a UNIX-like environment, and is often used to automate system administration.
An hour and minute must be specified; optionally, seconds and/or a date may be specified. The date must be in either yyyy/mm/dd or yyyy-mm-dd format. The date if not specified defaults to the epoch (1/1/70). Clear Scheduled Date and Time no job date-time Clears the scheduled date-time for the job. Enable the Job State job enable Set the job state to enable. If the specified time is in the future, schedule the job for execution and place the job in the “pending” state.
When job failure-continue is specified, a job will execute all the commands in the job regardless of any single command failure or error. Otherwise, the first command to fail will cause the job to cease executing commands. Display All Jobs show jobs List all jobs that currently exist in the system. show jobs Lists the following information about the specified job: Job Status Name Comment Absolute range Commands
The command returns the node, hostname, target port, status (enabled or not), and address (WWN). The detail parameter returns the network bindings for each target. > enable # show targets Node Hostname Proto Target Enab Address ----------------------------------------------------------------------------1 lab-n1 fc hba-a1 yes wwn.21:00:00:1b:32:9b:83:3b 1 lab-n1 fc hba-a2 yes wwn.21:01:00:1b:32:bb:83:3b n1:targ2 2 lab-n2 fc hba-a1 yes wwn.21:00:00:1b:32:9f:f3:ce 2 lab-n2 fc hba-a2 yes wwn.
The show luns command enables you to view LUNs. LUNs may be filtered by container, name, and session parameters. To view a list of containers, enter show luns container ?. The name parameter enables you to view only those LUNs which are prefixed by a particular name.
Use the container option to restrict statistics display to a single container. If it is omitted, statistics are shown for all the containers accessible to the hosts. Use the name option to get statistics for a single LUN. If it is committed, statistics for all LUNs are specified. Note: Select shell wildcard patterns can be used in the field to match a set of LUNs. For example, you can use the asterisk (*) to match all characters that follow.
S: Standard Mode E: Enable Mode C: Configure mode no Variant Command See section starting on page # configure page 176 E, C debug page 167 E disable page 176 email page 162 S enable page 176 S, E, C exit page 176 E, C file debug-dump page 179 E, C file stats page 171 E, C file tcpdump page 178 ftp-server page 178 help page 176 E E, C C [no] [no] [no] S, E, C C [no] hostname page 185 C [no] igroup page 204 C [no] interface page 182 C [no] ip host page 185
S: Standard Mode E: Enable Mode C: Configure mode no Variant Command See section starting on page # S, E, C show bootvar page 176 S, E, C show clock page 160 E, C show cluster page 180 E, C show configuration page 172 E, C show containers page 203 E, C show email page 162 E, C show files debug-dump page 179 E, C show files stats page 171 S, E, C show files system page 167 E, C show files tcpdump page 178 E, C show ftp-server page 178 S, E, C show hosts page 185 E, C
S: Standard Mode E: Enable Mode C: Configure mode no Variant Command See section starting on page # S, E, C show terminal page 198 E, C show usernames page 158 S, E, C show users page 158 S, E, C show version page 167 E, C show vlans page 184 E, C show web page 177 E, C slogin page 167 E, C [no] snmp-server page 198 E, C [no] ssh client page 197 C [no] ssh server page 196 E, C [no] stats page 169 C [no] tacacs-server page 194 E, C tcpdump page 167 S, E, C tel
HP VMA SAN Gateway User’s Guide AM456-9026A
Utilities Reference APPENDIX B This appendix describes the Utilities used for configuring and performance testing the HP VMA system. These commands are common to the Linux and Windows drivers and to the HP VMA SAN Gateway. • About HP VMA Utilities on page 211 • Running the HP VMA Utilities on page 211 • HP VMA Utilities Reference on page 212 About HP VMA Utilities The HP VMA Utilities are tools designed to enable you to monitor the performance of HP VMA Arrays connected to HP VMA SAN Gateway.
HP VMA Utilities Reference This section documents the syntax and usage of the following HP VMA Utilities. • varray on page 212 • vcounts on page 213 • veeprom on page 216 • vincident -a on page 218 • vinfo on page 218 • vmesg on page 220 • vpartial on page 221 • vring on page 222 • vspeedtest on page 223 • vstat on page 224 • vvimms on page 226 • vzero on page 227 varray The varray returns information about an array.
Example The varray utility returns information similar to the following example: my-srv1 [my-cluster1: master] # varray Violin Memory, Inc.
Example The vcounts utility returns information similar to the following example: my-srv1 [my-cluster1: master] # vcounts Violin Memory, Inc.
Returns The vcounts utility returns the following counters: AM456-9026A IRQ calls The total interrupt request handler calls to the HP VMA Array device driver. IRQ calls for V1010 The total calls to the HP VMA Array device driver where work was done. IRQ calls for errors The total of DMA errors returned as well as PCIe link loss errors. Completed I/O bytes The total bytes read/written from/to a HP VMA Array. Completed read bytes The total bytes read from the HP VMA Array.
Unaligned host buf writes The total I/O write requests to a HP VMA Array, but only incremented when an unaligned host address required special buffer byte copying to service the DMA request. For more information, see Unaligned Bounce Buffers for Reads and Writes on page 216. Requested DMA reads Incremented for each read DMA descriptor added to the descriptor ring. A single I/O may result in multiple DMA descriptors to complete a single I/O request.
Syntax veeprom [ ] Windows Example The veeprom utility returns information similar to the following example: my-srv1 [my-cluster1: master] # veeprom Violin Memory, Inc. Device: Proc device: Index: /dev/vtmsa /proc/driver/vtms/strad0 0 -- EEPROM info -ee_version: 1 ee_partnum: 1000206S-C-01 ee_serialnum: 21109R00000440 ee_boardver: 3 ee_mfgdate: 20120909 ee_mgmtmac: 00:1b:97:00:01:b8 The example returns the following information. Part # Displays the part number of the main board.
vincident -a The vincident script collects useful information from the HP VMA SAN Gateway and HP VMA Array, such as version/timestamp of the current kernel, CPU information, partition information, HP VMA Array configuration, and HP VMA Array logs. Once collected, this information can be sent to Customer Support for analysis to determine the source of performance issues, such as ECC errors. The vincident script is installed on the host server as part of the HP VMA Utilities package.
Example The vinfo utility returns information similar to the following example: my-srv1 [my-cluster1: master] # vinfo Violin Memory, Inc. Device: Index: /dev/vtmsa 0 -- Target Info -Host Driver: v5.2.0.2a Driver Date: Target S/W: Target Port: Serial #: Memory: Memory Type: RAID groups: Granularity: ring_size: iotimeout: LBA sector: nomsi: nomsix: debug: Mgmt.
Target S/W Displays the software / firmware version running on HP VMA Array. Memory Displays the size in bytes of usable system capacity. For flash VIMMs, this value changes based on formatted capacity. Memory Type Displays the size and type of populated VIMMs. RAID groups Displays the number of 5-VIMM RAID groups. Spare VIMMs are not counted. Granularity Displays the smallest access granularity for I/O request in bytes. RingSize Displays the size of driver DMA descriptor ring per HP VMA Array.
vpartial The vpartial utility displays the number of read/write I/O requests processed and the number of partial 4kB flash pages. Syntax vpartial [ ] Example The vpartial utility returns information similar to the following example: my-srv1 [my-cluster1: master] # vpartial Violin Memory, Inc.
Completed write I/O's Displays the total I/O write requests to a HP VMA Array. This is not the individual DMA descriptors completed, but for each of the user requested I/Os. Unaligned host buf writes Displays the total I/O write requests to a HP VMA Array, but only incremented when an unaligned host address required special buffer byte copying to service the DMA request.
Parameters Parameter Description -p Specifies that a partition is to be selected. Specifies the name of the partition. Table B.2 vring Utility Parameters Example The vring utility returns information similar to the following example when run on a Linux host: my-srv1 [my-cluster1: master] # vring Violin Memory, Inc.
Example # vspeedtest Checking speed on array device id ata-VIOLIN_MEMORY_ARRAY_6C067CWX00132 1555.131 Read MB/s, 379670 IOPS vstat The vstat utility displays the status of the connection and the ready status of a HP VMA Array.
Example The vstat utility returns information similar to the following example: my-srv1 [my-cluster1: master] # vstat Violin Memory, Inc.
PWR_A LED Indicates whether the Power A LED is on or not. PWR_B LED Indicates whether the Power B LED is on or not. ready Indicates whether the data plane is online and ready or offline. formatting Indicates if formatting of the VIMMs is in progress or not. This is only applicable to flash VIMM systems. format_done Indicates the progress percentage done during formatting of the VIMMs. paused Indicates the pause interval for I/Os. link Indicates whether the PCIe connection is online or offline.
Example myvmem [Cluster-mycluster1: master] # vvimms Violin Memory, Inc. Device: Index: VIMM VCM 7 11 12 13 14 15 16 17 18 39 40 41 42 43 44 60 64 66 67 68 69 ...
Example The vzero utility returns information similar to the following example: my-srv1 [Cluster-mycluster1: master] # vzero Violin Memory, Inc.
SNMP Traps APPENDIX C This chapter focuses on SNMP use with the HP VMA SAN Gateway, and covers the following topics: • About SNMP MIB Files on page 229 • Benefits of Using a MIB Browser on page 230 • SNMP Configuration on the HP VMA SAN Gateway on page 231 • Trap/Notify Event E-mail and Logged Events on page 231 • Available Traps on page 234 • Configuring and Testing Traps on page 244 • New Trap MIB Objects on page 249 About SNMP MIB Files Management Information Base (MIB) files are availabl
• VIOLIN-MEMORY-TRAP-MIB.txt—OIDs for SNMP traps sent from the VMA Memory Array to configured destination points to alert when events occur, such as the lid is ajar, state changes to license keys, fans, and more. • TallMaple-MIB.txt—Basic system information about CPU load, process failures, mounted file systems, and more. Note: You must use the MIB supported by the version running on your SAN Gateway. MIBs are not guaranteed to be backwards/forwards compatible from version to version at this time.
SNMP Configuration on the HP VMA SAN Gateway Use the snmp and snmp-server commands to configure SNMP. It defaults to on. *ib-srv1 [ib-srv1: master] (config) # show snmp SNMP enabled: yes SNMP port: 161 System location: System contact: Read-only community: public Traps enabled: yes Trap community: public Interface listen enabled: yes No Listen Interfaces. Trap sinks: 10.1.1.1 Enabled: yes Type: traps version 2c Community: public (default) 10.1.1.
memusage-high Memory utilization too high memusage-ok Memory utilization OK netusage-high Network utilization too high netusage-ok Network utilization OK disk-io-high Disk I/O too high disk-io-ok Disk I/O OK unexpected-cluster-join A node joined the cluster unexpectedly unexpected-cluster-leave A node left the cluster unexpectedly unexpected-cluster-size Unexpected cluster size event on %s — Disk failure warning: device %s hwmon-file-sys-error File system malfunction unexpected-shutdown Unexpected shutdown
chassis-temperature-high Chassis temperature alarm detected chassis-temperature-ok Chassis temperature alarm clearing lid-ajar-time-high Excessive lid ajar time detected lid-ajar-time-ok Lid ajar alarm clearing lid-ajar Array lid ajar state change detected array-pcie-link-up Array PCIE link up detected array-pcie-link-down Array PCIE link down detected array-data-plane-ready Array data plane ready state change detected array-raid-rebuild Array RAID rebuild state change detected vimm-state-change Array VIMM
Available Traps The following section covers the available traps. The first table lists the traps that are enabled by default. The second table lists the traps that are disabled by default, and that you can enable as needed. Default Disabled Traps An additional 16 SNMP traps are available that are disabled by default. Trap Description array-fan-change: Array FAN state changed. disk-io-high: Disk I/O per second has risen too high. fc-port-state-change: vSHARE FC port state changed.
Default Enabled Traps New Traps in HP VMA SAN Gateway Release G5.5.1 Traps Description lid-ajar Lid ajar alarm vmg-boot-raid-change HP VMA SAN Gateway only. Boot disk status changed. vmg-fan-change HP VMA SAN Gateway only. Fan state changed. vmg-psu-change HP VMA SAN Gateway only. Power supply status changed. New Traps in HP VMA SAN Gateway Release G5.1.x Traps Description array-data-plane-ready: Array data plane state changed. array-led-change: Array LED state changed.
process-exit: A process in the system unexpectedly exited. unexpected-shutdown: Unexpected system shutdown. Trap Information Table Trap Name Threshold Value Unit Description Solution Sev. array-data-planeready State Change 0 or 1 An Array data plane available state change has occurred. The old value and new values are supplied. A value of 0 = not ready, 1 = ready. If the new value is 0, then check the Array alarms for more information.
Trap Name Threshold Value Unit Description Solution Sev. array-psu-state State Change State An Array has changed Check the power state regarding one or source to the Array both of the Power power supplies. Supply Units. A true or false value for psuA and psuB specifies whether the old / new values are different. The PSU state can be: Absent, ON, or OFF. High / Low array-raid-rebuild State Change 0 or 1 An Array has changed state regarding VIMM RAID group rebuild.
Trap Name Threshold Value Unit Description Solution Sev. Verify that OM-3 Medium rate Fibres are used in your config for 8 Gb. Check that the Fibres and SFP ports were properly cleaned and that the cables and SFP’s are fully inserted. Verify that the Fibre does not exceed bend radius specifications. fc-port-state-change State Change State One or more Fibre Channel ports have changed state on a HP VMA SAN Gateway.
Trap Name liveness-failure Threshold Description Solution An internal process on a HP VMA SAN Gateway has been detected as hung. media-device-health- 10 warn Percent Check the Array for High A HP VMA SAN Gateway media device any alarms. (Array) has one or more health attributes in a warning or critical state. Normalized S.M.A.R.T attributes are used. The key attributes for Arrays are Avail Reserved Space and Media Wearout Indicator. S.M.A.R.
Trap Name Threshold Value Unit Description Solution Sev. media-device-statechange State Change State A HP VMA SAN Gateway media device (Array) has changed state. The possible states are: unknown, online, offline, error, removed, disabled, or onlining. Verify that the connected Array is in the proper online state. media-deviceunknown-type Event A HP VMA SAN Gateway has detected a media device connected of an unknown type. The Model, Serial #, and size are provided.
Trap Name Threshold Value Unit Description Solution Sev. process-crash Event Triggered An internal process on a HP VMA SAN Gateway has crashed. A callhome event is generated with the details of the event. Please contact HP customer support. High process-exit Event Triggered An internal process on Please contact HP a HP VMA SAN customer support. Gateway has unexpectedly exited. A callhome event is generated with the details of the event.
Trap Name Threshold Value Unit Description Solution Sev. unexpectedshutdown Event Triggered A HP VMA SAN Please contact HP Gateway has customer support. unexpectedly shutdown. This may happen during a software upgrade when the upgrade did not cleanly apply and the system reverted back to the previous version prior to upgrade. A callhome event is generated. High user-login Event Triggered A login to a HP VMA SAN Gateway via either the CLI or Web UI has occurred.
Trap Name vmg-boot-raidchange Threshold NA Value Unit Description Active, Degraded, Resyncing, Unknown There was a state change in the book disk. The states are as follows: • Active is a normal state. • Resyncing means the RAID group is rebuilding, which is also normal. • Degraded means the RAID disk is down. • Unknown means the RAID disk is unavailable and could be down. Solution Sev. Degraded and High Unknown status mean that the RAID disk is likely down and needs to be replaced.
Configuring and Testing Traps Use the snmp command to configure traps, which can be sent to multiple hosts: gateway-a [hw-vmga: master] > enable gateway-a [hw-vmga: master] # conf terminal gateway-a [hw-vmga: master] (config) # snmp ? community contact Set the read-only community string Set a value for the syscontact variable in MIB-II enable Enable SNMP-related functionality host Configure hosts to which to send SNMP traps listen Configure SNMP server interface access restrictions location Set a v
Testing Traps Use the snmp-server traps send-test command to test traps: gateway-a [hw-vmga: master] (config) # snmp-server traps ? community Set the default community for traps sent to hosts which do not have a custom community string set event send-test Specify which events will be sent as traps Send a test trap gateway-a [hw-vmga: master] (config) # snmp-server traps send-test█ This will send a test trap to all configured trap sinks. This will be the 'testTrap' notification from the TMS-MIB.
PSU States To query the state of the power supplies in the system: snmpwalk -Ou -M +. -m +./VIOLIN-MEMORY-MIB.txt -v 2c -c public ib-srv1 violin-memory | grep -i psu enterprises.violinmemory.products.memoryGateway.appliance.media.chassisSystemArrayTable. chassisSystemArrayEntry.chassisSystemPowerPSUA."vmem-array-098" = STRING: "ON" enterprises.violinmemory.products.memoryGateway.appliance.media.chassisSystemArrayTable. chassisSystemArrayEntry.chassisSystemPowerPSUB.
Performance Stats To query performance statistics for the system: [myvmem@host1 mibs]$ snmpwalk -Ou -M +. -m +./VIOLIN-MEMORY-MIB.txt -v 2c -c public vs3-n2 violin-memory | grep ata-VIOLIN enterprises.violinmemory.products.memoryGateway.appliance.media.mediaDevTable.mediaDevEn try.mediaDevIdx."ata-VIOLIN_MEMORY_ARRAY_2110CR00000304" = STRING: ata-VIOLIN_MEMORY_ARRAY_2110CR00000304 enterprises.violinmemory.products.memoryGateway.appliance.media.mediaDevTable.mediaDevEn try.devId.
Fibre Channel (vSHARE) Information Results of a query for Fibre Channel information on a SAN Gateway: enterprises.violinmemory.products.memoryGateway.vShare.globalTargetFcTable.globalTargetF cEntry.wwn.1."hba-a1" = STRING: wwn.00:00:00:00:ff:00:0a:0c enterprises.violinmemory.products.memoryGateway.vShare.globalTargetFcTable.globalTargetF cEntry.wwn.1."hba-a2" = STRING: wwn.00:00:00:00:ff:00:0a:0d enterprises.violinmemory.products.memoryGateway.vShare.globalTargetFcTable.globalTargetF cEntry.wwn.5.
Fibre Channel Performance Statistics (vSHARE) Example The following is an example of querying Fibre Channel performance statistics for a VMA SAN Gateway vSHARE software configuration. $ snmpwalk -c public -v 2c 10.1.10.137 VIOLIN-MEMORYMIB::statsTargetFcTable.statsTargetFcEntry -m VIOLIN-MEMORY-MIB.txt VIOLIN-MEMORY-MIB::statsTargetFcIdx."hba-a1" = STRING: hba-a1 VIOLIN-MEMORY-MIB::statsTargetFcIdx."hba-a2" = STRING: hba-a2 VIOLIN-MEMORY-MIB::txFrames."hba-a1" = STRING: 1222433 VIOLIN-MEMORY-MIB::txFrames.
Event: unexpected-cluster-join: A node has unexpectedly joined the cluster.
Event: media-device-health-warn: A media device has a health status warning. vmemHealthWarning NOTIFICATION-TYPE OBJECTS { id, location, type, vmemModel, vmemSerialNo, output } STATUS current DESCRIPTION "vmemHealthWarning" ::= { vmemNotifTrapsPrefix 11 } Event: media-device-lifetime-warn: A media device has a low estimated life remaining.
Event: media-device-state-change: Unexpected change in media device state. vmemStateChange NOTIFICATION-TYPE OBJECTS { id, oldTypeString, newTypeString, devPath, blockSz, numBlocks, offset, vmemModel, devId, expected } STATUS current DESCRIPTION "vmemStateChange" ::= { vmemNotifTrapsPrefix 13 } Event: media-device-unknown-type: Detected a media device of unknown type.
Event: vimm-temperature-high: High VIMM temperature detected. vmemVimmTempRisingError NOTIFICATION-TYPE OBJECTS { id, value, node } STATUS current DESCRIPTION "vmemVimmTempRisingError" ::= { vmemNotifTrapsPrefix 16 } Event: vimm-temperature-ok: VIMM temperature returned to normal levels.
Event: chassis-temperature-ok: Chassis temperature returned to normal levels. vmemChassisTempRisingClear NOTIFICATION-TYPE OBJECTS { id, value, node } STATUS current DESCRIPTION "vmemChassisTempRisingClear" ::= { vmemNotifTrapsPrefix 21 } Event: lid-ajar-time-rising-error: Chassis lid ajar time has exceeded a configured threshold.
Event: array-pcie-link-up: Array PCIE link up. vmemArrayPcieLinkUp NOTIFICATION-TYPE OBJECTS { id, container } STATUS current DESCRIPTION "vmemArrayPcieLinkUp" ::= { vmemNotifTrapsPrefix 31 } Event: array-pcie-link-down: Array PCIE link down. vmemArrayPcieLinkDown NOTIFICATION-TYPE OBJECTS { id, container } STATUS current DESCRIPTION "vmemArrayPcieLinkDown" ::= { vmemNotifTrapsPrefix 32 } Event: array-data-plane-ready: Array data plane state changed.
Event: array-raid-rebuild: Array RAID rebuild state changed. vmemArrayRaidRebuild NOTIFICATION-TYPE OBJECTS { id, container, state } STATUS current DESCRIPTION "vmemArrayRaidRebuild" ::= { vmemNotifTrapsPrefix 34 } Event: vimm-state-change: Array VIMM state changed. vmemArrayVimmStateChange NOTIFICATION-TYPE OBJECTS { id, container, vimms, set, stateTypeString } STATUS current DESCRIPTION "vmemArrayVimmStateChange" ::= { vmemNotifTrapsPrefix 35 } Event: array-psu-state: Array PSU state changed.
Event: array-led-change: Array LED state changed. vmemArrayLedChange NOTIFICATION-TYPE OBJECTS { id, container, alarmLedChanged, alarmLedOld, alarmLedNew, powerALedChanged, powerALedOld, powerALedNew, powerBLedChanged, powerBLedOld, powerBLedNew, statusLedChanged, statusLedOld, statusLedNew } STATUS current DESCRIPTION "vmemArrayLedChange" ::= { vmemNotifTrapsPrefix 37 } Event: fc-port-state-change: Fibre channel port state changed.
Event: array-fan-state-change: Array fan state changed. vmemArrayFanChange NOTIFICATION-TYPE OBJECTS { id, container, fan1Changed, fan1Old, fan1New, fan2Changed, fan2Old, fan2New, fan3Changed, fan3Old, fan3New, fan4Changed, fan4Old, fan4New, fan5Changed, fan5Old, fan5New, fan6Changed, fan6Old, fan6New } STATUS current DESCRIPTION "vmemArrayFanChange" ::= { vmemNotifTrapsPrefix 39 } Event: events-login: A user has logged in event.
Event: events-logout: A user has logged out event.
HP VMA SAN Gateway User’s Guide AM456-9026A
Index A abbreviations, large numbers 147 active-active 20 admin role 137 access privileges 26, 77, 137 commands in Config mode 146 Admin user 26 ARP configuration 191 asterisk, after module ID 131 authentication local 158 method 192 order 192 SMTP configuration 81 B banner commands 198 block size, of LUNs 45, 104 block storage media devices enabling or disabling 116–118 initializing Memory Arrays 96–98 Board Status page 37 boot images 64 C call home auto support 76 fault reporting 76 notification 75 sett
Cluster Status page 35 configuration commands 180 global brief 131 management address, change 70 monitoring 132 show cluster show cluster global 131 show cluster global brief 131 show commands 180 show global 131 cluster management VIP 129–130 Cluster Status page 35, 36 command line interface 21, 141 ambiguous command 142 asterisk, unsaved changes 133 command completion 143, 144 command list 145 command parameters 148 command prompts 146 command-line help 143 descriptions 147 INTERACTIVE commands 149 modes
LUN Status page 39 LUN status page 38 LUNs create, delete 43 creation of 45, 102–104 exporting of 106–107 LUN IDs 49, 106, 107, 110 Manage, Web Interface 41 Monitor LUNs page 59 monitoring, Web Interface 59 Read/Write Bandwidth 60 Read/Write IOPs 60 Read/Write Latency 60 resizing 17, 105 search and sort 42 statistics, CLI 18, 124 H HA, active-active 20 help command-line help 143 question mark in CLI 143 hidden commands, show 150 High Availability 20 hostname CLI parameter 148 setting or clearing 185 I igr
N S name resolution 185 netmask CLI parameter 148 network bond 183 configuration 181 interface 182 VLAN 184 network interfaces See interfaces Network Time Protocol 160 nodes, cluster cluster node id CLI parameter 148 local node identified in CLI 131 monitoring 132 node roles 21, 127, 129, 131 normal nodes 130 notifications email 162 email recipients 165 email types 163 enable, disable email 162 notifications, email autosupport 166 NTP add, remove peer 161 add, remove server 161 display settings 162 enable
vring utility command 222–223 vSHARE architecture 19, 94 configuration 20–95 show containers 203 show targets 203 vstat command 224–226 vzero command 227–228 TB (terabyte) 147 TCP port value 148 tcpdump, commands 178 tools, diagnostic 167 trap sinks, SNMP 86 U upgrade immediate 138 Memory Gateway 138 rolling 138 staged 138 URL CLI parameter 148 pseudo-URL format 148 user change password 77 control inactivity 149 edit account 78 management 137 password 136, 137 privileges 145 admin role 26, 77, 137, 146 mo
