HP Load Balancing Module High Availability Command Reference Part number: 5998-2694 Document version: 6PW101-20120217
Legal and notice information © Copyright 2012 Hewlett-Packard Development Company, L.P. No part of this documentation may be reproduced or transmitted in any form or by any means without prior written consent of Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice.
Contents VRRP configuration commands ··································································································································· 1 vrrp mode ·································································································································································· 1 display vrrp ·························································································································································
resolve-target ·························································································································································· 48 route-option bypass-route······································································································································ 48 source interface ····················································································································································· 49 source
VRRP configuration commands NOTE: The term router in this document refers to a LB module that runs the VRRP protocol. vrrp mode Syntax vrrp mode load-balance undo vrrp mode View System view Default level 2: System level Parameters load-balance: Specifies VRRP to work in the load balancing mode. Description Use the vrrp mode command to configure the working mode of VRRP. Use the undo vrrp mode command to restore the default. By default, VRRP works in the standard protocol mode.
View Any view Default level 1: Monitor level Parameters verbose: Displays detailed state information of VRRP group(s). interface interface-type interface-number: Displays VRRP group state information of the specified interface. interface-type interface-number specifies an interface by its type and number. vrid virtual-router-id: Displays state information of the specified VRRP group. virtual-router-id specifies a VRRP group by its group number, which ranges from 1 to 255.
Master IP : 1.1.1.2 VRRP Track Information: Track Interface: XGE0/0.2 State : Down Pri Reduced : 10 Track Object State : Positive Pri Reduced : 50 : 1 # When VRRP works the in load balancing mode, display brief information about all VRRP groups on the LB module.
Table 1 Output description (standard protocol mode) Field Description Current VRRP working mode, including Run Mode • Standard: Standard protocol mode • Load Balance: Load balancing mode Current VRRP running mode, including Run Method • Real MAC: real MAC mode, that is, the virtual IP address of the VRRP group is associated with the real MAC address of the interface. • Virtual MAC: virtual MAC mode, that is, the virtual IP address of the VRRP group is associated with the virtual MAC address.
Field Description VRRP Track Information Information of the tracked interface or object. It is displayed only after the execution of the vrrp vrid track command or the vrrp vrid track interface command. Track Interface The interface to be tracked. It is displayed only after the execution of the vrrp vrid track interface command. Track Object The object to be tracked. It is displayed only after the execution of the vrrp vrid track command. State of the tracked interface or object.
Field Description In the brief information, • If VRID is number, this field indicates the status of the router in the VRRP group, including Master, Backup, and Initialize. • If VRID is VF number, this field indicates the status of the VF in the VRRP State group, including Active, Listening, and Initialize.
Field Description Key Authentication key Virtual IP Virtual IP address of the VRRP group Master IP Primary IP address of the interface where the router in the state of master resides VRRP Track Information Information of the tracked interface or object. Track Interface The interface to be tracked. It is displayed only after the execution of the vrrp vrid track interface command. Track Object The object to be tracked. It is displayed only after the execution of the vrrp vrid track command.
Field Description Forwarder Weight Track Configuration The weight track configuration of the VF. It is displayed only after the execution of the vrrp vrid weight track command. Track Object Weight track entry. It is displayed only after the execution of the vrrp vrid weight track command. The state of a track entry includes State Weight Reduced • • • • Invalid Negative Positive Not existing The weight value that is reduced when the status of the monitored track entry turns to negative.
IP TTL Errors : 0 Auth Failures : 0 Invalid Auth Type : 0 Auth Type Mismatch : 0 Packet Length Errors : 0 Address List Errors : 0 Become Master : 1 Priority Zero Pkts Rcvd : 0 Adver Rcvd : 0 Priority Zero Pkts Sent : 0 Adver Sent : 807 Global statistics CheckSum Errors : 0 Version Errors : 0 VRID Errors : 0 # When VRRP works in load balancing mode, display the statistics about all VRRP groups. display vrrp statistics Interface : Ten-GigabitEthernet0/0.
Field Description Invalid Auth Type Number of packets with authentication failures due to invalid authentication types Auth Type Mismatch Number of packets with authentication failures due to mismatching authentication types Packet Length Errors Number of packets with VRRP packet length errors Address List Errors Number of packets with virtual IP address list errors Become Master Number of times that the router worked as the master Priority Zero Pkts Rcvd Number of received advertisements with
Field Description Request Rcvd Number of received requests Advertise Sent Number of advertisements sent Request Sent Number of requests sent Reply Rcvd Number of received replies Release Rcvd Number of received releases Reply Sent Number of replies sent Release Sent Number of releases sent Priority Zero Pkts Rcvd Number of received advertisements with the priority of 0 VF Priority Zero Pkts Rcvd Number of received advertisements with the VF priority of 0 Priority Zero Pkts Sent Number o
Related commands: display vrrp statistics. Examples # Clear the statistics about all the VRRP groups on the router. reset vrrp statistics vrrp dot1q Syntax vrrp dot1q vid vlan-id [ secondary-dot1q secondary-vlan-id ] undo vrrp dot1q View Interface view Default level 2: System level Parameters vid vlan-id: Outer VLAN ID, ranging from 1 to 4094. secondary-dot1q secondary-vlan-id: Inner VLAN ID. The secondary-vlan-id argument is in the range 1 to 4094.
Parameters real-mac: Associates the real MAC address of the interface with the virtual IP addresses of the VRRP groups. virtual-mac: Associates the virtual MAC address with the virtual IP address of the VRRP group. Description Use the vrrp method command to set the association between the virtual IP addresses and the MAC addresses of the VRRP groups. Use the undo vrrp method command to restore the default association.
As devices of different vendors may achieve VRRP in a different way, when the LB module is interoperating with devices of other vendors, VRRP packet TTL check may result in dropping packets that should not be dropped. In this case, you can use the command to disable TTL check on VRRP packets. Examples # Disable TTL check on VRRP packets. system-view [Sysname] interface Ten-GigabitEthernet 0/0.1 [Sysname-Ten-GigabitEthernet0/0.
Examples # Set the authentication mode to simple and authentication key to Sysname for VRRP group 1 on interface Ten-GigabitEthernet 0/0.1 to send and receive VRRP packets. system-view [Sysname] interface Ten-GigabitEthernet 0/0.1 [Sysname-Ten-GigabitEthernet0/0.1] vrrp vrid 1 virtual-ip 10.1.1.1 [Sysname-Ten-GigabitEthernet0/0.
[Sysname-Ten-GigabitEthernet0/0.1] vrrp vrid 1 preempt-mode timer delay 5 vrrp vrid priority Syntax vrrp vrid virtual-router-id priority priority-value undo vrrp vrid virtual-router-id priority View Interface view Default level 2: System level Parameters virtual-router-id: VRRP group number, which ranges from 1 to 255. priority-value: Priority value of the router in the specified VRRP group, which ranges from 1 to 254, A higher number indicates a higher priority.
Default level 2: System level Parameters virtual-router-id: VRRP group number, which ranges from 1 to 255. adver-interval: Interval at which the master in the specified VRRP group sends VRRP advertisements. It ranges from 1 to 255 seconds. Description Use the vrrp vrid timer advertise command to configure the Adver_Timer of the specified VRRP group. Use the undo vrrp vrid timer advertise command to restore the default. By default the Adver_Timer is 1 second.
Description Use the vrrp vrid track command to specify the track entry to be monitored, that is, if the status of the monitored track entry changes to negative, the priority of the router decreases by a specified value or the router immediately switches to the master. Use the undo vrrp vrid track command to cancel the specified track entry. By default, no track entry is specified to be monitored.
If the uplink interface of a router in a VRRP group fails, normally the VRRP group cannot be aware of the uplink failure. If the router is the master of the VRRP group, hosts on the LAN will not be able to access the external network because of the uplink failure. You can solve the problem through the function of tracing a specified interface. In this case, it is the uplink interface.
The system removes a VRRP group after you delete all the virtual IP addresses in it. The virtual IP address of the VRRP group cannot be 0.0.0.0, 255.255.255.255, loopback address, non A/B/C address and other illegal IP addresses such as 0.0.0.1. Only when the configured virtual IP address and the interface IP address belong to the same segment and are legal host addresses can the VRRP group operate normally.
When the status of the monitored track entry turns from negative to positive or invalid, the corresponding VFs restore their weights automatically. The track entry specified in this command can be nonexistent. You can use the vrrp vrid weight track command to specify a track entry, and then create the track entry using the track command. By default, the weight of a VF is 255, and its lower limit of failure is 10.
NQA configuration commands NQA client configuration commands data-fill Syntax data-fill string undo data-fill View ICMP echo, UDP echo, UDP jitter test type view Default level 2: System level Parameters string: A case sensitive string of 1 to 200 characters. Description Use the data-fill command to configure the string to be filled in the data field of a probe packet. Use the undo data-fill command to restore the default. By default, the string is the hexadecimal number 00010203040506070809.
data-size Syntax data-size size undo data-size View ICMP echo, UDP echo, UDP jitter test type view Default level 2: System level Parameters size: Size of the data field in a probe packet in bytes. It ranges from 20 to 8100 for probe packets of ICMP echo or UDP echo tests, and from 68 to 8100 for probe packets of UDP jitter tests.
Description Use the description command to give a brief description of a test group, usually, the test type or test purpose of a test group. Use the undo description command to remove the configured description information. By default, no descriptive string is available for a test group. Examples # Configure the descriptive string for a test group as icmp-probe.
Default level 2: System level Parameters port-number: Destination port number of a test operation, which ranges from 1 to 65535. Description Use the destination port command to configure a destination port number for a test operation. Use the undo destination port command to remove the configured destination port number. By default, no destination port number is configured for a test operation. Do not perform a UDP jitter test on ports from 1 to 1023 (known ports).
10 329 Succeeded 2007-04-29 20:54:26.5 9 344 Succeeded 2007-04-29 20:54:26.2 8 328 Succeeded 2007-04-29 20:54:25.8 7 328 Succeeded 2007-04-29 20:54:25.5 6 328 Succeeded 2007-04-29 20:54:25.1 5 328 Succeeded 2007-04-29 20:54:24.8 4 328 Succeeded 2007-04-29 20:54:24.5 3 328 Succeeded 2007-04-29 20:54:24.1 2 328 Succeeded 2007-04-29 20:54:23.8 1 328 Succeeded 2007-04-29 20:54:23.
Destination IP address: 192.168.1.42 Send operation times: 10 Receive response times: 10 Min/Max/Average round trip time: 15/46/26 Square-Sum of round trip time: 8103 Last succeeded probe time: 2008-05-29 10:56:38.
Field Description Failures due to timeout Number of timeout occurrences in a test Failures due to disconnect Number of disconnections by the peer Failures due to no connection Number of failures to connect with the peer Failures due to sequence error Number of failures owing to out-of-sequence packets Failures due to internal error Number of failures owing to internal errors Failures due to other errors Failures due to other errors Packet(s) arrived late Number of packets that arrived late U
Field Description Negative DS square sum Square sum of negative delay jitters from destination to source One way results Uni-direction delay test result, displayed in a UDP jitter test Max SD delay Maximum delay from source to destination Max DS delay Maximum delay from destination to source Min SD delay Minimum delay from source to destination Min DS delay Minimum delay from destination to source Number of SD delay Number of delays from source to destination Number of DS delay Number of de
Related commands: statistics interval. Examples # Display statistics of UDP jitter tests. display nqa statistics admin test NQA entry (admin admin, tag test) test statistics: NO. : 1 Destination IP address: 1.1.1.2 Start time: 2007-01-01 09:33:22.
4 OWD-SD - 100 13 5 packet-loss accumulate 0 0 6 RTT accumulate 100 52 Table 8 Output description Field Description No.
Field Description Min negative DS Minimum absolute value among negative delay jitters from destination to source Max negative SD Maximum absolute value among negative delay jitters from source to destination Max negative DS Maximum absolute value among negative delay jitters from destination to source Negative SD number Number of negative delay jitters from source to destination Negative DS number Number of negative delay jitters from destination to source Negative SD sum Sum of absolute values
Table 9 Description on the threshold monitoring fields of the display nqa statistics command Monitored element Threshold type Collect data in Checked Num Over-threshold Num accumulate Probes in the counting interval Number of finished probes in the counting interval Number of probes of which the duration exceeds the threshold in the counting interval average — — — consecutive Probes in the counting interval Number of finished probes in the counting interval Number of probes of which the dura
Default level 2: System level Parameters filename: Name of the file transferred between the FTP server and the FTP client. The file name is a case sensitive string of 1 to 200 characters. Description Use the filename command to specify a file to be transferred between the FTP server and the FTP client. Use the undo filename command to restore the default. By default, no file is specified. Examples # Specify the file to be transferred between the FTP server and the FTP client as config.txt.
history-record enable Syntax history-record enable undo history-record enable View Any NQA test type view Default level 2: System level Parameters None Description Use the history-record enable command to enable the saving of history records of an NQA test group. Use the undo history-record enable command to disable the history records saving function. By default, history records of an NQA test group are not saved. If the history records saving function is enabled, the system saves the history records.
Parameters keep-time: Specifies how long the history records can be saved. The time ranges from 1 to 1440 minutes. Description Use the history-record keep-time command to set the lifetime of the history records in an NQA test group. Use the undo history-record keep-time command to restore the default. By default, the history records in an NQA test group are kept for 120 minutes. When an NQA test completes, the timing starts. All the records are removed when the lifetime is reached.
http-version Syntax http-version v1.0 undo http-version View HTTP test type view Default level 2: System level Parameters v1.0: The HTTP version is 1.0 in an HTTP test. Description Use the http-version command to configure the HTTP version used in an HTTP test. Use the undo http-version command to restore the default. By default, HTTP 1.0 is used in an HTTP test. Examples # Configure the HTTP version as 1.0 in an HTTP test.
system-view [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type icmp-echo [Sysname-nqa-admin-test-icmp-echo] next-hop 10.1.1.1 nqa Syntax nqa entry admin-name operation-tag undo nqa { all | entry admin-name operation-tag } View System view Default level 2: System level Parameters admin-name: Specifies the name of the NQA test group administrator who creates the NQA test operation, a case-insensitive string of 1 to 32 characters, with “-” excluded.
Parameters None Description Use the nqa agent enable command to enable the NQA client. Use the undo nqa agent enable command to disable the NQA client and stop all the tests being performed. By default, the NQA client is enabled. Related commands: nqa server enable. Examples # Enable the NQA client.
nqa schedule Syntax nqa schedule admin-name operation-tag start-time { hh:mm:ss [ yyyy/mm/dd ] | now } lifetime { lifetime | forever } undo nqa schedule admin-name operation-tag View System view Default level 2: System level Parameters admin-name: Specifies the name of the NQA test group administrator who creates the NQA test operation, which is a case-insensitive string of 1 to 32 characters. operation-tag: Specifies the test operation tag, which is a case-insensitive string of 1 to 32 characters.
operation (FTP test type view) Syntax operation { get | put } undo operation View FTP test type view Default level 2: System level Parameters get: Obtains a file from the FTP server. put: Transfers a file to the FTP server. Description Use the operation command to configure the FTP operation type. Use the undo operation command to restore the default. By default, the FTP operation type is get. Examples # Configure the FTP operation type as put.
Examples # Configure the HTTP operation type as post. system-view [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type http [Sysname-nqa-admin-test-http] operation post operation interface Syntax operation interface interface-type interface-number undo operation interface View DHCP test type view Default level 2: System level Parameters interface-type interface-number: Specifies an interface by its type and number.
Description Use the password command to configure a password used to log onto the FTP server. Use the undo password command to remove the configured password. By default, no password is configured for logging onto the FTP server. Related commands: username and operation. Examples # Configure the password used for logging in to the FTP server as ftpuser.
If more than one probe operation is to be performed in a test, the system starts a second probe operation when it receives responses to packets sent in the first probe operation, or when the probe timeout time expires. Examples # Configure the ICMP test group to perform 10 probe operations per test.
Default level 2: System level Parameters packet-number: Number of packets to be sent per probe operation. It ranges from 10 to 1000 for each probe operation in one UDP jitter test. Description Use the probe packet-number command to configure the number of packets to be sent per probe during one UDP jitter test. Use the undo probe packet-number command to restore the default. By default, the number of packets to be sent per probe is 10 in one UDP jitter test.
probe timeout Syntax probe timeout timeout undo probe timeout View DHCP, DNS, DLSw, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo test type view Default level 2: System level Parameters timeout: Timeout time for a probe operation, in milliseconds. The value ranges from 10 to 86400000 for an FTP or HTTP probe operation, and from 10 to 3600000 for a DHCP, DNS, DLSw, ICMP echo, SNMP, TCP or UDP echo probe operation. Description Use the probe timeout command to configure the timeout time for a probe operation.
consecutive consecutive-occurrences: Number of consecutive probe failures since the NQA test group starts. It ranges from 1 to 16. action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none. none: No actions. trigger-only: Triggers collaboration between other modules only. Description Use the reaction checked-element probe-fail command to configure a reaction entry for monitoring the probe failures. You cannot edit a reaction entry.
Description Use the reaction trap command to configure to send traps to network management server under specified conditions. Use the undo reaction trap command to restore the default. By default, no traps are sent to the network management server. Examples # Configure the system to send a trap if consecutive probe failures in an ICMP echo test is greater than or equal to 5.
View DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter test type view Default level 2: System level Parameters None Description Use the route-option bypass-route command to enable the routing table bypass function to test the direct connectivity to the direct destination. Use the undo route-option bypass-route command to disable the routing table bypass function. By default, the routing table bypass function is disabled.
Examples # Specify the IP address of interface Ten-GigabitEthernet 0/0.1 as the source IP address of ICMP echo request packets. system-view [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type icmp-echo [Sysname-nqa-admin-test-icmp-echo] source interface Ten-GigabitEthernet0/0.
View SNMP, UDP echo, UDP jitter test type view Default level 2: System level Parameters port-number: Source port number of probe packets, which ranges from 1 to 50000. Description Use the source port command to configure the source port of probe packets. Use the undo source port command to remove the configured port number. By default, no source port number is configured. Examples # Configure port 8000 as the source port of probe packets in the UDP echo test group.
statistics max-group Syntax statistics max-group number undo statistics max-group View DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter test type view Default level 2: System level Parameters number: Maximum number of statistics groups that can be kept, which ranges from 0 to 100. To disable collecting statistics, specify number 0. Description Use the statistics max-group command to configure the maximum number of statistics groups that can be kept.
Description Use the statistics interval command to configure the interval for collecting test result statistics for a test group. Use the undo statistics interval command to restore the default. By default, the interval is 60 minutes. NQA groups tests completed in the specified interval, and calculates the test result statistics. The statistics form a statistics group. To view information about the statistics groups, use the display nqa statistics command. This command is not supported by DHCP tests.
ttl Syntax ttl value undo ttl View DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter test type view Default level 2: System level Parameters value: Maximum number of hops a probe packet traverses in the network, which ranges from 1 to 255. Description Use the ttl command to configure the maximum number of hops a probe packet traverses in the network. Use the undo ttl command to restore the default. By default, the maximum number of hops that a probe packet can traverse in a network is 20.
snmp: SNMP test. tcp: TCP test. udp-echo: UDP echo test. udp-jitter: UDP jitter test. Description Use the type command to configure the test type of the current test group and enter test type view. By default, no test type is configured. Examples # Configure the test type of a test group as FTP and enter test type view.
undo username View FTP test type view Default level 2: System level Parameters username: Username used to log in to the FTP server. The username takes a case sensitive string of 1 to 32 characters. Description Use the username command to configure a username used to log onto the FTP server. Use the undo username command to remove the configured username. By default, no username is configured for logging onto the FTP server. Related commands: password and operation.
display nqa server status nqa server is: enabled tcp-connect: IP Address Port Status 2.2.2.2 2000 active udp-echo: IP Address Port Status 3.3.3.3 3000 inactive Table 10 Output description Field Description tcp-connect NQA server status in the NQA TCP test udp-echo NQA server status in the NQA UDP test IP Address IP address specified for the TCP/UDP listening service on the NQA server Port Port number of the TCP/UDP listening service on the NQA server Listening service status.
nqa server tcp-connect Syntax nqa server tcp-connect ip-address port-number undo nqa server tcp-connect ip-address port-number View System view Default level 2: System level Parameters ip-address: IP address specified for the TCP listening service on the NQA server. port-number: Port number specified for the TCP listening service on the NQA server, which ranges from 1 to 50000. Description Use the nqa server tcp-connect command to create a TCP listening service on the NQA server.
port-number: Port number specified for the UDP listening service on the NQA server, which ranges from 1 to 50000. Description Use the nqa server udp-echo command to create a UDP listening service on the NQA server. Use the undo nqa server udp-echo command to remove the UDP listening service created. Configure the command on the NQA server for UDP jitter, and UDP echo tests only.
Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
Conventions This section describes the conventions used in this documentation set. Command conventions Convention Description Boldface Bold text represents commands and keywords that you enter literally as shown. Italic Italic text represents arguments that you replace with actual values. [] Square brackets enclose syntax choices (keywords or arguments) that are optional. { x | y | ... } Braces enclose a set of required syntax choices separated by vertical bars, from which you select one.
Network topology icons Represents a generic network device, such as a router, switch, or firewall. Represents a routing-capable device, such as a router or Layer 3 switch. Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that supports Layer 2 forwarding and other Layer 2 features. Represents a LB module. Port numbering in examples The port numbers in this document are for illustration only and might be unavailable on your device.
Index DFHNOPRSTUVW password (FTP test type view),42 D probe count,43 data-fill,22 probe packet-interval,44 data-size,23 probe packet-number,44 description (any NQA test type view),23 probe packet-timeout,45 destination ip,24 probe timeout,46 destination port,24 display nqa history,25 R display nqa result,26 reaction checked-element probe-fail,46 display nqa server status,56 reaction trap,47 display nqa statistics,29 reset vrrp statistics,11 display vrrp,1 resolve-target,48 display vrrp
vrrp vrid track,17 W vrrp vrid track interface,18 Websites,60 vrrp vrid virtual-ip,19 vrrp vrid weight track,20 64
