ExtremeWarePxTM Software Command Reference Guide Software Version 1.2 Extreme Networks, Inc. 3585 Monroe Street Santa Clara, California 95051 (888) 257-3000 http://www.extremenetworks.
©2002 Extreme Networks, Inc. All rights reserved. Extreme Networks and BlackDiamond are registered trademarks of Extreme Networks, Inc. in the United States and certain other jurisdictions.
Contents Preface Chapter 1 Command Reference Overview Chapter 2 Commands for Managing the Switch build 18 clear log 20 clear session 21 clear stats 22 cls 23 conÞgure account 24 conÞgure banner 26 conÞgure dns-client add 27 conÞgure dns-client default-domain 28 conÞgure dns-client delete 29 conÞgure gslb 30 conÞgure iparp delete 32 conÞgure log display 33 conÞgure mgmt ipaddress 34 conÞgure mgmt iproute 35 conÞgure port gigabit auto 37 conÞgure snmp add community 38 con
- Contents conÞgure snmp syscontact 43 conÞgure snmp syslocation 44 conÞgure snmp sysname 45 conÞgure ssh2 key 46 conÞgure ssh2 key pregenerated 48 conÞgure syslog 50 conÞgure system-ip 51 create account 53 delete account 55 disable clipaging 56 disable gslb 57 disable log display 58 disable port gigabit 59 disable self-audit 60 disable snmp access 61 disable snmp traps 62 disable ssh2 63 disable syslog 64 disable telnet 65 disable vlan 66 download conÞguration 67
Chapter 3 history 84 load conÞguration 85 logout 86 nslookup 87 ping 88 quit 90 reboot 91 save conÞguration 92 scp2 94 ssh2 96 telnet 98 traceroute 100 unconÞgure gslb 101 unconÞgure mgmt iproute 102 unconÞgure switch 103 upload conÞguration 104 use conÞguration 106 use image 107 Commands for Configuring Servers and Services conÞgure domain 111 conÞgure domain default 113 conÞgure pattern-rule 115 conÞgure pattern-rule default 117 conÞgure pattern-rule default co
Chapter 4 Chapter 5 6 - Contents unconÞgure server 142 unconÞgure server-group 143 unconÞgure service 144 Commands for Persistence Modes, and NAT Modes conÞgure gateway-mode add ipaddress 146 conÞgure gateway-mode delete ipaddress 148 conÞgure nat-mode full 149 conÞgure nat-mode server-only 151 conÞgure proxy-ip 153 conÞgure sticky client-ip timeout 155 conÞgure sticky cookie-id timeout 156 conÞgure sticky session-id timeout 157 conÞgure timeout established-connection 158 conÞgure
Chapter 6 conÞgure vrrp delete track-vrid 185 conÞgure vrrp delete vrid 187 conÞgure vrrp force-slave 188 conÞgure vrrp preempt|dont-preempt 189 conÞgure vrrp priority 190 conÞgure vrrp serial-failover interval 191 disable vrrp 192 disable vrrp auto-sync 193 disable vrrp serial-failover 194 enable vrrp 195 enable vrrp auto-sync 196 enable vrrp serial-failover 197 unconÞgure vrrp auto-sync backup 198 unconÞgure vrrp auto-sync master 199 Health-Check Commands conÞgure health-check
Chapter 7 8 - Contents enable health-check 223 enable health-check server-group-name 224 enable server 225 enable server slow-start 226 Commands for Monitoring the Switch pxtop 228 show accounts 230 show banner 231 show build 232 show conÞguration 234 show connections details 236 show connections summary 238 show cookie 239 show critical-resources 240 show default-gateway 241 show dns-client 242 show errors 243 show gateway-mode 244 show gateway-mode conÞguration 245 sh
show port details 263 show port gigabit utilization 265 show proxy-ip conÞguration 266 show self-audit 267 show server conÞguration 268 show server details 269 show server down 271 show server summary 272 show server-group 273 show server-group conÞguration 275 show server-group details 276 show server-group summary 278 show service conÞguration 279 show service details 280 show service summary 283 show session 284 show snmp conÞguration 285 show sticky conÞguration 286 s
Index of Commands 10 - Contents ExtremeWarePx1 1.
Preface This preface provides an overview of this guide, describes guide conventions, and lists other publications that may be useful. Introduction This guide provides the complete syntax for all the commands available in the currently-supported versions of the ExtremeWarePx software running on Px-series application switches from Extreme Networks. This guide does not provide feature descriptions, explanations of the technologies, or conÞguration examples.
Preface Conventions Table 1 and Table 2 list conventions that are used throughout this guide. Table 1: Notice Icons Icon Notice Type Alerts you to... Note Important features or instructions. Caution Risk of personal injury, system damage, or loss of data. Warning Risk of severe personal injury. Table 2: Text Conventions Convention Description Screen displays This typeface indicates command syntax, or represents information as it appears on the screen.
1 Command Reference Overview Structure of this Guide This guide documents each ExtremeWarePx command. Related commands are grouped together and organized into chapters based on their most common usage. The chapters reßect the organization of the Px Series Application Switch Installation and ConÞguration Guide. If a speciÞc command is relevant to a wide variety of functions and could be included in a number of different chapters, we have attempted to place the command in the most logical chapter.
Command Reference Overview Understanding Command Syntax In describing command syntax, this manual uses symbols as described in Table 3. These symbols explain how to enter the command, and you do not type them as part of the command itself. Table 3: Command Syntax Symbols Symbol Description angle brackets < > Enclose a variable or value. You must specify the variable or value. Do not type the angle brackets.
Using the Command-Line Interface When entering a command at the prompt, ensure that you have the appropriate privilege level. Most conÞguration commands require you to have the administrator privilege level. NOTE Most commands are not executed immediately, but are deferred until you issue the build command. Exceptions are noted when the commands are described in this manual. Prompt Text The text of the command prompt includes the SNMP sysname setting. Initially, this text is the name of the switch.
Command Reference Overview Specifying Text Values When specifying a text values, such as health-check objects, return strings, and URL patterns, it is recommended that you always use double quotes to delimit the text value. You must use quotes if the text value includes any non-alphanumeric characters, such as spaces, dashes, or dots. Abbreviated Syntax Abbreviated syntax is the shortest unambiguous allowable abbreviation of a command or parameter. Typically, this is the Þrst three letters of the command.
2 Commands for Managing the Switch This chapter describes the following commands: ¥ Commands for creating and managing accounts ¥ Commands for conÞguring VLANs, SNMP, and DNS client servers ¥ Commands for using Secure Shell 2 (SSH2) ¥ Miscellaneous utility command for: Ñ Checking basic connectivity Ñ Logging Ñ ConÞguring a startup banner Ñ Using the GlobalPx Content Director ExtremeWarePx1 1.
Commands for Managing the Switch build build Description Executes all pending commands issued since the last build. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines Most commands are not executed immediately, but are deferred until you issue a build command. After making any conÞguration changes, you must issue the build command to commit those changes. Example In this example, the Þrst three commands (numbered 11 through 13) change the SNMP conÞguration.
build Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch clear log clear log {static} Description Clears the application-switch internal log. Syntax Description static If static is specified, the critical log messages are also cleared. Default N/A. Usage Guidelines The application-switch log tracks all conÞguration and fault information pertaining to the device. The switch maintains 200 messages in its internal log. By default, log entries that are assigned a critical or warning level remain in the log after a switch reboot.
clear session clear session clear session Description Forces a speciÞc Telnet or ssh session to close. Syntax Description number The number of the session to be closed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You can issue the show session command to see what sessions are active and Þnd the session number of the session to close.
Commands for Managing the Switch clear stats clear stats Description Clears all the statistics counters Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command clears all the statistics counters: clear stats History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 22 ExtremeWarePx1 1.
cls cls cls Description Clear the console screen. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command clears the console screen. cls History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch configure account configure account {encrypted} {} Description ConÞgures a user account password. Syntax Description user account An existing user account name. encrypted Specifies that the password should be encrypted when the configuration is uploaded to a file. Should not be used through the command-line interface. This option is for use only by the switch when generating an ASCII configuration file.
configure account History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch configure banner configure banner Description ConÞgures the banner string that is displayed display after each reboot. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You will be prompted for the banner; at the prompt, type the banner message. You can enter up to 24 lines of up to 79 characters each.
configure dns-client add configure dns-client add configure dns-client add Description Adds a DNS name server to the available server list for the DNS client. Syntax Description IP address The IP address of the DNS name server to be added. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
Commands for Managing the Switch configure dns-client default-domain configure dns-client default-domain Description ConÞgures the domain that the DNS client uses if a fully qualiÞed domain name is not entered. Syntax Description domain_name A default domain name. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. Sets the DNS client default domain name to the speciÞed domain name.
configure dns-client delete configure dns-client delete configure dns-client delete Description Removes a DNS name server from the available server list for the DNS client. Syntax Description IP address The IP address of the DNS name server to be removed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
Commands for Managing the Switch configure gslb configure gslb ipaddress service Description ConÞgures a virtual service to be used by the GlobalPx Content Director scheduler. Syntax Description IP address The VIP of the virtual service to be used by the GlobalPx Content Director scheduler. string The virtual host name used for this VIP; this virtual host name must also be set the scheduler. Default N/A.
configure gslb Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch configure iparp delete configure iparp delete Description Updates a serverÕs entry in the IP Address Resolution Protocol (ARP) table. Syntax Description IP address The IP address of the server. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. This command: 1 Removes the MAC address of the speciÞed server from the ARP table. 2 Forces an ARP to the server to Þnd the serverÕs current MAC address.
configure log display configure log display configure log display {fatal | errors | warning | info} Description ConÞgures the severity level of log messages that are recorded in the internal log and logged by the remote syslog host. Syntax Description fatal Log fatal messages only.
Commands for Managing the Switch configure mgmt ipaddress configure mgmt ipaddress [(/ ) | (network-mask )} Description Assigns an IP address to the switchÕs 10/100BT Ethernet management port. Syntax Description IP address IP address for the management port. mask length The number of bits set in the subnetwork mask. netmask The subnetwork mask. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
configure mgmt iproute configure mgmt iproute configure mgmt iproute dest-ip gateway Description Installs a host route in the routing table for the switchÕs 10/100BT port. Syntax Description destination IP address The destination IP address. gateway IP address The gateway IP address. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. The 10/100BT port has a separate routing table.
Commands for Managing the Switch Platform Availability This command is available on the Px-series application switch. 36 ExtremeWarePx1 1.
configure port gigabit auto configure port gigabit auto configure port gigabit auto [on | off] Description ConÞgures auto-negotiation on the Gigabit port. Syntax Description on Specifies that auto-negotiation should be enabled. off Specifies that auto-negotiation should be disabled. Default Auto-negotiation on the Gigabit port is disabled by default. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Managing the Switch configure snmp add community configure snmp add community [readonly | readwrite] Description Adds an SNMP read or read/write community string. Syntax Description readonly Specifies read-only access to the system. readwrite Specifies read and write access to the system. alphanumeric string The SNMP community string to be added. An SNMP community string can contain up to 127 characters. Default The default read-only community string is public.
configure snmp add community Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch configure snmp add trapreceiver configure snmp add trapreceiver {community } {port } Description Adds a trap receiver to the trap receiver list. Syntax Description IP address The IP address of the SNMP trap receiver to add. The IP address can be unicast, multicast, or broadcast. community string The community string of the trap receiver. udp_port A UDP port to which the trap should be sent. Default is 162. Default N/A.
configure snmp delete community configure snmp delete community configure snmp delete community [readonly | readwrite] Description Deletes an SNMP read or read/write community string. Syntax Description readonly Specifies read-only access to the system. readwrite Specifies read and write access to the system. alphanumeric string The SNMP community string to be deleted. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Managing the Switch configure snmp delete trapreceiver configure snmp delete trapreceiver Description Deletes a trap receiver from the trap receiver list. Syntax Description IP address The IP address of the SNMP trap receiver to delete. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You can use this command to remove a trap receiver that was added with the configure snmp add trapreceiver command.
configure snmp syscontact configure snmp syscontact configure snmp syscontact Description ConÞgures the name of the system contact. Syntax Description alphanumeric string A system contact name. A maximum of 255 characters is allowed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. The system contact is a text Þeld that enables you to enter the name of the person(s) responsible for managing the application switch.
Commands for Managing the Switch configure snmp syslocation configure snmp syslocation Description ConÞgures the location of the switch. Syntax Description alphanumeric string The switch location. A maximum of 255 characters is allowed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. Use this command to indicate the location of the switch. Changes made by this command are executed immediately and do not require the build command.
configure snmp sysname configure snmp sysname configure snmp sysname Description ConÞgures the system name of the application switch. Syntax Description alphanumeric string A device name. A maximum of 32 characters is allowed. Default The default system name is the model name of the application switch (for example, SummitPx1). Usage Guidelines You must have administrator privileges to issue this command. You can use this command to change the name of the switch.
Commands for Managing the Switch configure ssh2 key configure ssh2 key Description Generates an authentication key for SSH2 sessions from character that you enter interactively. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. Before the switch can accept incoming SSH2 sessions, it must have an authentication key.
configure ssh2 key Example This example generates an authentication key. SummitPx1::3 # config ssh2 key WARNING: Generating new server host key This will take from 10-40 minutes and cannot be canceled. Enter some random characters.
Commands for Managing the Switch configure ssh2 key pregenerated configure ssh2 key pregenerated Description Sets the sessionÕs authentication key for SSH2 sessions to a pregenerated key. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. Before the switch can accept incoming SSH2 sessions, it must have an authentication key.
configure ssh2 key pregenerated enable ssh2 History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch configure syslog configure syslog ipaddress Description ConÞgures the syslog host address. Syntax Description IP address The IP address of the syslog host. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. A log maintained remotely on a syslog host can preserve log messages that would be lost from the internal log, which contains only the 200 most recent messages.
configure system-ip configure system-ip configure system-ip [(/ ) | (network-mask )] {vlan } Description ConÞgures the system IP address. Syntax Description IP address IP address for the switch mask length The number of bits set in the network mask. netmask The network mask. vlan tag number The VLAN tag for the switch. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Managing the Switch Example This example enables VLANs on the application switch then conÞgures the IP address, network mask, and system VLAN. SummitPx1:1 # enable vlan * SummitPx1:2 # config system-ip 64.1.1.10 / 24 vlan 100 * SummitPx1:3 # build History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 52 ExtremeWarePx1 1.
create account create account create account [admin | user] {encrypted} {} Description Creates a new user account. Syntax Description admin user Specifies administrator-level privileges for the account. An administrator-level account can: • View and change all switch parameters • Add and delete users • Change the password associated with any account Specifies user-level privileges for the account.
Commands for Managing the Switch If you do not specify the password on the command line, the switch will prompt you to enter the password, and will then prompt you to reenter the password to verify that you have entered it correctly. Your keystrokes are not echoed as you enter and reenter the new password. Assuming you enter the same password in response to both prompts, the password is changed. You must use the build command to commit the conÞguration changes made by this command.
delete account delete account delete account Description Deletes a user account. Syntax Description username The user account to be deleted. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You may not delete the admin account. You must use the build command to commit the conÞguration changes made by this command. Example The following command deletes account john2: delete account john2 History This command was available in ExtremeWarePx 1.1.
Commands for Managing the Switch disable clipaging disable clipaging Description Disables pausing at the end of each show screen. Syntax Description This command has no parameters or options. Default Command-line interface (CLI) paging is enabled by default. Usage Guidelines The command-line interface is designed for use in a VT100 environment. Most show command output will pause when the display reaches the end of a page.
disable gslb disable gslb disable gslb Description Stops the GlobalPx Content Director agent on the Px series application switch. Syntax Description This command has no parameters or options. Default By default, the GlobalPx Content Director agent does not run. Usage Guidelines You must have administrator privileges to issue this command. Extreme Networks GlobalPx Content Directorª is a DNS-based Internet trafÞc-management system.
Commands for Managing the Switch disable log display disable log display Description Disables display of log message to the console. Syntax Description This command has no parameters or options. Default Display of log messages is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. Although log messages are not displayed, they are still recorded in the internal log of the application switch.
disable port gigabit disable port gigabit disable port gigabit Description Disables the Gigabit port. Syntax Description This command has no parameters or options. Default The Gigabit port is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command. Example The following command disables the Gigabit port.
Commands for Managing the Switch disable self-audit disable self-audit Description Disables the internal self-audit. Syntax Description This command has no parameters or options. Default Internal self-audit is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. Internal self-audit is the internal hardware-check mechanism. To see whether internal self-audit is enabled, use the show self-audit command.
disable snmp access disable snmp access disable snmp access Description Disables SNMP on the switch. Syntax Description This command has no parameters or options. Default SNMP access is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. Disabling SNMP access does not affect the SNMP conÞguration (for example, community strings). However, if you disable SNMP access, you will be unable to access the switch using SNMP.
Commands for Managing the Switch disable snmp traps disable snmp traps Description Prevents SNMP traps from being sent from the switch. Syntax Description This command has no parameters or options. Default SNMP trap support is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. This command does not clear the SNMP trap receivers that have been conÞgured. The command prevents SNMP traps from being sent from the switch even if trap receivers are conÞgured.
disable ssh2 disable ssh2 disable ssh2 Description Disables incoming SSH2 Telnet sessions. Syntax Description This command has no parameters or options. Default The SSH2 feature is disabled until you obtain a valid security license. If a valid security license is in effect, SSH2 is enabled with no access proÞle and uses TCP port number 22. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Managing the Switch disable syslog disable syslog Description Disables logging to a remote logging by way of the UNIX syslog host facility. Syntax Description This command has no parameters or options. Default Remote logging is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
disable telnet disable telnet disable telnet Description Disables Telnet services on the switch. Syntax Description This command has no parameters or options. Default Telnet services are enabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
Commands for Managing the Switch disable vlan disable vlan Description Disables VLANs on the application switch. Syntax Description This command has no parameters or options. Default On SummitPx1, VLANs are disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
download configuration download configuration download configuration [ | ] {primary | secondary} Description Downloads a previously saved ASCII conÞguration Þle from a speciÞc TFTP server host. Syntax Description IP address The IP address of the TFTP server from which the configuration should be obtained. hostname The host name of the TFTP server from which the configuration should be obtained. filename The path and filename of a saved ASCII configuration.
Commands for Managing the Switch Example The following command clears the current switch conÞguration, and downloads a new full conÞguration from the tftp server tftphost. It uses the conÞguration from the Þle stdconfigs.txt residing in the subdirectory configs\archive of the TFTP server base directory on the server: download configuration tftphost configs\archive\stdconfig.txt primary History This command was available in ExtremeWarePx 1.1.
download image download image download image [ | ] {primary | secondary} Description Downloads a new version of the ExtremeWarePx software image. Syntax Description IP address The IP address of TFTP server from which the image should be obtained. hostname The host name of the TFTP server from which the image should be obtained. filename The filename of the new image. primary Specifies that the new image should be stored as the primary image.
Commands for Managing the Switch Platform Availability This command is available on the Px-series application switch. 70 ExtremeWarePx1 1.
enable clipaging enable clipaging enable clipaging Description Enables the pause mechanism and does not allow the display to print continuously to the screen. Syntax Description This command has no parameters or options. Default Command-line interface (CLI) paging is enabled by default. Usage Guidelines The command-line interface is designed for use in a VT100 environment. Most show command output will pause when the display reaches the end of a page.
Commands for Managing the Switch enable gslb enable gslb {port } Description Starts the GlobalPx Content Director agent on the Px series application switch. Syntax Description port number The port to be used by the GlobalPx Content Director agent. If no port is specified, the agent listens on the default port, which is 2103. Default By default, the GlobalPx Content Director agent does not run. Usage Guidelines You must have administrator privileges to issue this command.
enable log display enable log display enable log display Description Enables display of log message to the console. Syntax Description This command has no parameters or options. Default Display of log messages is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. By default, warnings and more serious messages are logged. To log messages of a different severity level, use the configure log display command.
Commands for Managing the Switch enable port gigabit enable port gigabit Description Enables the Gigabit port. Syntax Description This command has no parameters or options. Default The Gigabit port is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You will be warned if you attempt to issue the build command when the Gigabit port is disabled. You must use the build command to commit the conÞguration changes made by this command.
enable self-audit enable self-audit enable self-audit Description Enables the internal self-audit. Syntax Description This command has no parameters or options. Default Internal self-audit is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. Internal self-audit is the internal hardware-check mechanism. To see whether internal self-audit is enabled, use the show self-audit command.
Commands for Managing the Switch enable snmp access enable snmp access Description Turns on SNMP support for the switch. Syntax Description This command has no parameters or options. Default SNMP access is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. To have access to the SNMP agent residing in the switch, at least one VLAN must have an IP address assigned to it.
enable snmp traps enable snmp traps enable snmp traps Description Turns on SNMP trap support. Syntax Description This command has no parameters or options. Default SNMP trap support is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. An authorized trap receiver can be one or more network management stations on your network. The switch sends SNMP traps to all trap receivers.
Commands for Managing the Switch enable ssh2 enable ssh2 {port } Description Enables incoming SSH2 Telnet sessions. Syntax Description port The TCP port number to be used for SSH2 communication. The default is port 22. Default The SSH2 feature is disabled until you obtain a valid security license. If a valid security license is in effect, SSH2 is enabled with no access proÞle and uses TCP port number 22.
enable ssh2 History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch enable syslog enable syslog Description Enables logging to a remote logging by way of the UNIX syslog host facility. Syntax Description This command has no parameters or options. Default Remote logging is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. In order to enable remote logging, you must do the following: ¥ ConÞgure the syslog host to accept and log messages.
enable telnet enable telnet enable telnet Description Enables Telnet access to the switch. Syntax Description This command has no parameters or options. Default Telnet services are enabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command. Example The following command enables Telnet services on the switch: enable telnet History This command was available in ExtremeWarePx 1.
Commands for Managing the Switch enable vlan enable vlan Description Enables VLANs on the application switch. Syntax Description This command has no parameters or options. Default On SummitPx1, VLANs are disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
exit exit exit Description Logs out of the console. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You can also log out with the logout and quit commands. Example The following command logs out: exit History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch history history Description Displays a list of the previous 49 commands entered on the switch. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines ExtremeWarePx ÒremembersÓ the last 49 commands you entered on the switch. Use the history command to display a list of these commands. Example The following command displays the previous 49 commands entered on the switch: history History This command was available in ExtremeWarePx 1.
load configuration load configuration load configuration [ | ] Description Loads a previously saved ASCII conÞguration Þle from a speciÞc TFTP server host into the switch's runtime memory. Syntax Description IP address The IP address of the TFTP server from which the configuration should be obtained. hostname The host name of the TFTP server from which the configuration should be obtained. filename The path and filename of a saved ASCII configuration. Default N/A.
Commands for Managing the Switch logout logout Description Logs out of the console. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You can also log out with the exit and quit commands. Example The following command logs out: logout History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 86 ExtremeWarePx1 1.
nslookup nslookup nslookup Description Displays the IP address of the requested host. Syntax Description hostname A host name. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. Example The following command looks up the IP address of a computer with the name of bigserver.xyz_inc.com: nslookup bigserver.xyz_inc.com History This command was available in ExtremeWarePx 1.1.
Commands for Managing the Switch ping ping {continuous} [ | ] Description Enables you to send Internet Control Message Protocol (ICMP) echo messages or to a remote IP device. Syntax Description continuous Specifies that ICMP echo messages are to be sent continuously. This option can be interrupted by pressing any key. IP address The IP address of the host. hostname The name of the host. Default N/A.
ping This example identiÞes the remote device by its IP address; the ping fails. SummitPx1:14 # ping 1.1.1.1 no answer from 1.1.1.1 History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch quit quit Description Logs out of the console. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You can also log out with the exit and logout commands. Example The following command logs out: quit History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 90 ExtremeWarePx1 1.
reboot reboot reboot Description Reboots the switch. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines After downloading a conÞguration with the download configuration command, you need to reboot the switch for the new conÞguration to take effect. Example The following command reboots the switch: reboot History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch.
Commands for Managing the Switch save configuration save configuration [primary | secondary] Description Saves the current conÞguration from the switchÕs runtime memory to non-volatile memory. Syntax Description primary Specifies that the configuration should be stored as the primary configuration. secondary Specifies that the configuration should be stored as the secondary configuration. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
save configuration ** Updating Health List tables ** Updating self audit parameters. ** Updating Snmp Parameters. ** Gigabit port enabled ** Updating VRRP parameters. ** Updating autosync parameters. Writing data to Flash... Saved 16151 bytes to flash. History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch scp2 scp2 {cipher [3des | blowfish]} {port } {debug } @ [ | ] : [(configuration {incremental} | image [primary | secondary]] Description Copies a Þle from a remote system to the switch using SCP2. Syntax Description 3des Specifies that the 3des cipher should be used for encryption. This is the default. blowfish Specifies that the blowfish cipher should be used for encryption.
scp2 Example The following command copies a conÞguration Þle from the Þle configpart1.save on host system1 to the switch, replacing the current switch conÞguration: scp2 admin@system1:configpart1.save configuration History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch ssh2 ssh2 {cipher [3des | blowfish]} {port } {compression [on | off]} {user } {debug } {@} [ | ] {} Description Transmits a command to a remote system using an SSH2 connection. Syntax Description 3des Specifies that the 3des cipher should be used for encryption. This is the default. blowfish Specifies that the blowfish cipher should be used for encryption.
ssh2 executed on the remote switch. When you terminate the remote session, commands will then resume being executed on the original switch. The remote command option cannot be used with Extreme Networks switches. If you include a remote command, you will receive an error message.
Commands for Managing the Switch telnet telnet [ | ] {} Description Allows you to Telnet from the current command-line interface session to another host. Syntax Description IP address The IP address of the host. hostname The name of the host. port number A TCP port number. The default port is 23. Default N/A. Usage Guidelines Only VT100 emulation is supported.
telnet History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch traceroute traceroute [ | ] Description Enables you to trace the routed path between the switch and a destination endstation. Syntax Description IP address The IP address of the destination endstation. hostname The host name of the destination endstation. Default N/A. Usage Guidelines To use the hostname parameter, you must Þrst conÞgure DNS. Each router along the path is displayed.
unconfigure gslb unconfigure gslb unconfigure gslb ipaddress service Description Removes a virtual service from use by the GlobalPx Content Director scheduler. Syntax Description IP address The VIP of the virtual service to be removed from use by the GlobalPx Content Director scheduler. string The virtual host name used for the specified VIP; this virtual host name must also be set the scheduler. Default N/A.
Commands for Managing the Switch unconfigure mgmt iproute unconfigure mgmt iproute dest-ip gateway Description Removes a route from the routing table for the switchÕs 10/100BT port. Syntax Description destination IP address The destination IP address. gateway IP address The gateway IP address. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. The 10/100BT port has a separate routing table.
unconfigure switch unconfigure switch unconfigure switch {all} Description Removes the switch conÞguration, restoring factory defaults. Syntax Description all Specifies that user accounts should be removed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. This command removes the current conÞguration and restores the servers, services and system conÞguration to factory defaults. If you specify the all keyword, conÞguration of user accounts is also removed.
Commands for Managing the Switch upload configuration upload configuration [ | ] {primary | secondary} Description Uploads the current conÞguration to a TFTP server on your network. Syntax Description IP address The IP address of the TFTP server. hostname The host name of the TFTP server. filename A name for the file where the configuration is to be saved.
upload configuration Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Managing the Switch use configuration use configuration [primary | secondary] Description ConÞgures the switch to use a previously saved conÞguration on the next reboot. Syntax Description primary Specifies the primary saved configuration. secondary Specifies the secondary saved configuration. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You can issue the show switch command to see which conÞguration is currently being used.
use image use image use image [primary | secondary] Description ConÞgures the switch to use a saved image on the next reboot. Syntax Description primary Specifies the primary saved software image. secondary Specifies the secondary saved software image. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You can issue the show switch command to see which image is currently being used.
Commands for Managing the Switch 108 ExtremeWarePx1 1.
3 Commands for Configuring Servers and Services This chapter describes the following commands: ¥ Commands for conÞguring servers ¥ Commands for creating and conÞguring server groups ¥ Commands for creating and conÞguring virtual services Servers The real servers are the actual web or application servers that fulÞll the client requests. Typically, one or more identical real servers run the same application and contain the exact same content.
Commands for Configuring Servers and Services Server Groups After servers are conÞgured, they must be organized into server groups. The ExtremeWarePx software selects a server to handle each connection to a particular server group. The following commands create and conÞgure server groups. configure server-group Creates a server group with the specified name and scheduling policy. configure server-group add-server Adds one or more servers to a server group.
configure domain configure domain configure domain name Description Creates a domain for the current layer 7 service. Syntax Description name string The domain name as specified in a client request, or the special domain name "*" if the server uses only the URL (and not the domain name) to select a server group. The name string "*" matches any request with an unspecified domain name, that is, any request in which the domain name is not present in the HTTP header. Default N/A.
Commands for Configuring Servers and Services If a layer 7 service was conÞgured with its class parameter set to https, you use the configure domain default command instead of this command. You must use the build command to commit the conÞguration changes made by this command. Example This example conÞgures domains for a service. Note that the service is conÞgured to recognizes domain names that begin with or omit the initial Òwww.Ó (for example, www.buystuff.com and buystuff.com).
configure domain default configure domain default configure domain default Description ConÞgures the default domain for the current layer 7 service. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. This command applies to the service that was speciÞed in the most recently issued configure service L7 command. That service is called the current service.
Commands for Configuring Servers and Services History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 114 ExtremeWarePx1 1.
configure pattern-rule configure pattern-rule configure pattern-rule server-group-name [noqos | (dot1p-to-svr dot1p-to-net diffserv-to-svr diffserv-to-net )] Description Creates a pattern rule for the current domain of the current layer 7 service. Syntax Description pattern string The pattern to be matched against the URL in the client request.
Commands for Configuring Servers and Services Usage Guidelines You must have administrator privileges to issue this command. This command applies to the current domain of the current service. The current service is the service that was speciÞed in the most recently issued configure service L7 command. The current domain is the domain that was speciÞed in the most recently issued configure domain or configure domain default command.
configure pattern-rule default configure pattern-rule default configure pattern-rule default server-group-name [noqos | (dot1p-to-svr dot1p-to-net diffserv-to-svr diffserv-to-net )] Description ConÞgures the default pattern rule for the current domain of a current layer 7 service.
Commands for Configuring Servers and Services domain that was speciÞed in the most recently issued configure domain or configure domain default command. The conÞgured pattern rule speciÞes the server group to be used when no other pattern rule in the current domain is applicable. If you end the command with the noqos keyword, the headers are left unchanged in the incoming trafÞc that matches the conÞgured pattern rule. If you do not specify this keyword, you can specify tags for incoming trafÞc.
configure pattern-rule default cookie-name configure pattern-rule default cookie-name configure pattern-rule default server-group-name cookie-name cookie-type [self | hash | learning]} [noqos | (dot1p-to-svr dot1p-to-net diffserv-to-svr diffserv-to-net )] Description ConÞgures the cookie persistence mode for the current layer 7 service.
Commands for Configuring Servers and Services diffserv-to-net tag Specifies whether to apply a tag to the DiffServ code point for packets directed to the network; one of the following values: • The keyword preserve indicates that no tag is applied to this type of traffic. • A hexadecimal number from 0x00 to 0x3F, inclusive, is the tag to be applied to this type of traffic. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
configure pattern-rule default cookie-name Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Configuring Servers and Services configure server configure server index ipaddress port {max-connections } {weight } {cookie } configure server index ipaddress - port {max-connections } {weight } Description ConÞgures one or more servers, establishing a correspondence between each serverÕs index and the IP address and port number
configure server You can conÞgure a number of servers at contiguous IP addresses, all of which use the same port. When you specify a range of IP addresses, the speciÞed index is used for the Þrst server and incremented for each conÞgured server. You must use the build command to commit the conÞguration changes made by this command. Adding a Server. The Þrst time you conÞgure a particular combination of index, IP address, and port number, you add the speciÞed server to the system.
Commands for Configuring Servers and Services Example This example creates servers with indexes 3 through 10, all using port 80, with a maximum of 4000 connections, and all with equal weight: SummitPx1:11 # configure server index 3 ipaddress 10.2.2.2 - 10.2.2.9 port 80 max-connections 4000 weight 1 * SummitPx1:12 # build History This form of this command was available in ExtremeWarePx 1.2. A form of the command without the cookie parameter was available in ExtremeWarePx 1.1.
configure server default configure server default configure server default [(max-connections ) | (weight )] Description ConÞgures the global default values for server properties. Syntax Description max number The global default value for the maximum number of concurrent connections a server can handle. When a server has its maximum number of connections, no more connections are sent to that particular server until some of its open connections have been closed.
Commands for Configuring Servers and Services Platform Availability This command is available on the Px-series application switch. 126 ExtremeWarePx1 1.
configure server-group configure server-group configure server-group name policy [rr | round-robin |wrr | weighted-round-robin | lc | least-connections | wlc | weighted-least-connections | hash] {server-last-resort index } Description Creates a server group with the speciÞed name and scheduling policy. Syntax Description name string A unique name for the new server group. rr round-robin Specifies the round-robin scheduling policy.
Commands for Configuring Servers and Services The Px-series application switch supports the following scheduling policies: Policy Description round robin Distributes clients evenly across the web server group by passing each new connection request to the next server in line. The first client connection is sent to the first server, the second to the second server, and so on, until each server has a connection.
configure server-group History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Configuring Servers and Services configure server-group add-server configure server-group name add-server [(index {- }) | (ipaddress {- } port )] Description Adds one or more servers to a server group. Syntax Description name string The name of the server group to which the servers should be added. index number The unique index number of a server to be added.
configure server-group add-server Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Configuring Servers and Services configure server-group delete-server configure server-group name delete-server [(index {- }) | (ipaddress {- } port )] Description Deletes one or more servers from a server group. Syntax Description name string The name of the server group from which the servers should be deleted. index number The unique index number of a server to be deleted.
configure server-group delete-server Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Configuring Servers and Services configure service L4 configure service vip {vrid } {vlan } port protocol [tcp | udp] L4 server-group-name [noqos | (dot1p-to-svr dot1p-to-net diffserv-to-svr diffserv-to-net )] Description Creates a layer 4 virtual service. Syntax Description IP address The virtual IP address of the service.
configure service L4 Default N/A. Usage Guidelines You must have administrator privileges to issue this command. To create any virtual service, you must specify the IP address and port to which Internet clients connect and the protocol (TCP or UDP) to be used. For a layer 4 service, you also specify the server group to be used for this service.
Commands for Configuring Servers and Services History This form of this command was available in ExtremeWarePx 1.2. Platform Availability This command is available on the Px-series application switch. 136 ExtremeWarePx1 1.
configure service L7 configure service L7 configure service vip {vrid } {vlan } port protocol [tcp | udp] L7 class [http | https] Description Creates a layer 7 virtual service. Syntax Description IP address The virtual IP address of the service. VRID number The VRID of the VRRP class for the service; a number between 1 and 255. vlan tag number The VLAN tag for the service. port number The port the service uses to answer requests.
Commands for Configuring Servers and Services For more information about VRRP, see Chapter 5; for a description of the commands to gateway mode, see Chapter 4. You must use the build command to commit the conÞguration changes made by this command. After you create a layer 7 virtual service, you must conÞgure domains for the service. Configuring an HTTP Service.
configure service L7 Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Configuring Servers and Services unconfigure domain unconfigure domain name Description Removes a domain from the current layer 7 service. Syntax Description name string The domain name to be removed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. This command applies to the service that was speciÞed in the most recently issued configure service L7 command. That service is called the current service.
unconfigure pattern-rule unconfigure pattern-rule unconfigure pattern-rule Description Removes a pattern rule from the current domain of the current layer 7 service. Syntax Description pattern string The pattern string of the patter rule to be removed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. This command applies to the current domain of the current service.
Commands for Configuring Servers and Services unconfigure server unconfigure server [(index {- }) | (ipaddress {- } port )] Description Removes one or more servers from the system. Syntax Description index number The unique index number of a server to be removed. IP address The IP address of a server to be removed. The IP address plus the port number uniquely identify a server.
unconfigure server-group unconfigure server-group unconfigure server-group name Description Removes a server group from the system. Syntax Description name string The name of the server group to be deleted. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
Commands for Configuring Servers and Services unconfigure service unconfigure service vip port protocol [tcp | udp] Description Removes a service from the system. Syntax Description IP address The virtual IP address of the service to be removed. port number The port for the service to be removed. tcp Specifies the TCP protocol. udp Specifies the UDP protocol. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
4 Commands for Persistence Modes, and NAT Modes This chapter describes commands for setting: ¥ Persistence modes ¥ NAT modes ExtremeWarePx1 1.
Commands for Persistence Modes, and NAT Modes configure gateway-mode add ipaddress configure gateway-mode add ipaddress {vrid } {vlan } Description Adds an IP address to be used in gateway mode on the application switch. Syntax Description IP address The IP address of the gateway. VRID number The VRID of the VRRP class for the gateway; a number between 1 and 255. vlan tag number The VLAN tag for the gateway. Default N/A.
configure gateway-mode add ipaddress Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Persistence Modes, and NAT Modes configure gateway-mode delete ipaddress configure gateway-mode delete ipaddress {vlan } Description Removes an IP address from used in gateway mode on the application switch. Syntax Description IP address The IP address of the gateway. vlan tag number The VLAN tag for the gateway. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Persistence Modes, and NAT Modes configure nat-mode full configure nat-mode full Description ConÞgures full-NAT mode (full Network Address Translation) on the application switch. Syntax Description This command has no parameters. Default Full-NAT mode is the default behavior of the application switch. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Persistence Modes, and NAT Modes Platform Availability This command is available on the Px-series application switch. 150 ExtremeWarePx1 1.
Commands for Persistence Modes, and NAT Modes configure nat-mode server-only configure nat-mode server-only Description ConÞgures half-NAT mode (server-only Network Address Translation) on the application switch. Syntax Description This command has no parameters. Default Full-NAT mode is the default behavior of the application switch. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Persistence Modes, and NAT Modes Example The following command conÞgures half-NAT mode on the application switch configure nat-mode server-only History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 152 ExtremeWarePx1 1.
Commands for Persistence Modes, and NAT Modes configure proxy-ip configure proxy-ip {- } Description Sets a proxy IP address or a range of proxy addresses. Syntax Description IP address A proxy IP address. Two IP addresses separated by a hyphen indicate a range of addresses; the command configures all addresses in the specified range as proxy IPs. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Persistence Modes, and NAT Modes Platform Availability This command is available on the Px-series application switch. 154 ExtremeWarePx1 1.
Commands for Persistence Modes, and NAT Modes configure sticky client-ip timeout configure sticky client-ip timeout [( : : ) | infinity}] Description Sets the time after which client-IP entries are deleted from the stickiness table. Syntax Description hours The number of hours in the timeout period; a two-digit number between 00 and 97. minutes The number of minutes in the timeout period; a two digit number between 00 and 59.
Commands for Persistence Modes, and NAT Modes configure sticky cookie-id timeout configure sticky cookie-id timeout [( : : ) | infinity}] Description Sets the time after which cookie-ID entries are deleted from the stickiness table. Syntax Description hours The number of hours in the timeout period; a two-digit number between 00 and 97. minutes The number of minutes in the timeout period; a two digit number between 00 and 59.
Commands for Persistence Modes, and NAT Modes configure sticky session-id timeout configure sticky session-id timeout [( : : ) | infinity}] Description Sets the time after which session-ID entries are deleted from the stickiness table. Syntax Description hours The number of hours in the timeout period; a two-digit number between 00 and 97. minutes The number of minutes in the timeout period; a two digit number between 00 and 59.
Commands for Persistence Modes, and NAT Modes configure timeout established-connection configure timeout established-connection Description Sets the established-connection timeout period. Syntax Description seconds The number of seconds in the established-connection timeout period; a number between 1 and 8000, inclusive. Default The default established-connection timeout is 30 seconds. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Persistence Modes, and NAT Modes configure timeout udp-flow-persistence configure timeout udp-flow-persistence Description Sets the UDP-ßow-persistence timer. Syntax Description seconds The number of seconds after which an idle UDP flow should be recycled; a number between 1 and 8000, inclusive. Default The default value for this timer is 40 seconds. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Persistence Modes, and NAT Modes disable gateway-mode disable gateway-mode Description Disables gateway mode on the application switch. Syntax Description This command has no parameters or options. Default Gateway mode is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command. Example This example disables gateway mode.
disable sticky disable sticky disable sticky [L4 client-ip | L7 [all | client-ip | cookie-id | session-id]] Description Disables the speciÞed persistence (stickiness) mode. Syntax Description L4 Specifies layer 4. L7 Specifies layer 7. all Specifies all persistence modes (client-IP, cookie-ID, and session-ID). client-ip Specifies client-IP persistence mode. cookie-id Specifies cookie-ID persistence mode. session-id Specifies session-ID persistence mode.
Commands for Persistence Modes, and NAT Modes enable gateway-mode enable gateway-mode Description Enables gateway mode on the application switch. Syntax Description This command has no parameters or options. Default Gateway mode is disabled by default. Usage Guidelines You must have administrator privileges to issue this command.
enable sticky enable sticky enable sticky [L4 client-ip | L7 [all | client-ip | cookie-id | session-id]] Description Enables the speciÞed persistence (stickiness) mode. Syntax Description L4 Specifies layer 4. L7 Specifies layer 7. all Specifies all persistence modes (client-IP, cookie-ID, and session-ID). client-ip Specifies client-IP persistence mode. cookie-id Specifies cookie-ID persistence mode. session-id Specifies session-ID persistence mode.
Commands for Persistence Modes, and NAT Modes unconfigure proxy-ip unconfigure proxy-ip {- } Description Removes a proxy IP address or a range of proxy addresses. Syntax Description IP address A proxy IP address. Two IP addresses separated by a hyphen indicate a range of addresses; the command removes all addresses in the specified range. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
5 Commands for Configuring Redundancy This chapter describes the following commands: ¥ Commands for using VRRP ¥ Commands for conÞguring a default gateway VRRP To reduce downtime, you can deploy two Px-series application switches that provide redundancy using Virtual Router Redundancy Protocol (VRRP), an industry standard failover mechanism (RFC 2338). VRRP classes are used to classify virtual services into groups for fail-over. Up to 16 VRRP classes are allowed.
Commands for Configuring Redundancy VRRP Properties Each application switch maintains three properties for each conÞgured VRRP class. ¥ The switchÕs priority for that VRRP class The switch with the higher priority for a given VRRP class is the primary device for that class; the switch with the lower priority is the secondary device for the class. The primary device will initially be active for the VRRP class (handling the virtual services in that class); the secondary device will initially be the backup.
Serial-Cable Failover from the master to the backup, replacing the corresponding commands on the backup. After all the commands have been replaced, the conÞguration is saved and the backup switch is rebooted. ¥ Whenever a relevant conÞguration command is issued on the master switch, the command is automatically send to the backup switch, where it is stored in local memory.
Commands for Configuring Redundancy For example, suppose that: ¥ VRRP class 201 contains a total of 100 servers. ¥ Switches A and B are VRRP peers. ¥ Both switches sets the track-servers-delta limit for class 201 to 10. ¥ Switch B is active for class 201. ¥ Switch A sees 90 healthy servers As long as machine B see 81 or more healthy servers, it remains active. If switch B sees 80 or fewer healthy servers, then the switch A will attempt to preempt switch B and become active for VRRP class 201.
configure default-gateway configure default-gateway configure default-gateway {add} Description Adds the speciÞed IP address as a default gateway. Syntax Description IP address The IP address of the default gateway to be added. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You can have only two default gateways at a time. The Þrst default gateway you conÞgure is used by default.
Commands for Configuring Redundancy configure default-gateway delete configure default-gateway delete Description Removes the speciÞed IP address as a default gateway. Syntax Description IP address The IP address of the default gateway to be removed. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
configure default-gateway switch configure default-gateway switch configure default-gateway switch Description Switches from the default gateway currently being used to the other default gateway (assuming that two default gateways have been conÞgured). Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command.
Commands for Configuring Redundancy configure vrrp add master vrid configure vrrp add master vrid Description Adds a VRRP class to the application switch, giving the switch master priority for this class. Syntax Description VRID number The VRID of the VRRP class to be added; a number between 1 and 255. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. A switch can have a total of 16 different VRRP classes.
configure vrrp add track-servers-delta configure vrrp add track-servers-delta configure vrrp vrid [ | all] add track-servers-delta Description Enables server-health failover for the speciÞed VRRP class(es). Syntax Description VRID number The VRID of the VRRP class; a number between 1 and 255. all Specifies all VRRP classes.
Commands for Configuring Redundancy History This command was available in ExtremeWarePx 1.2. Platform Availability This command is available on the Px-series application switch. 174 ExtremeWarePx1 1.
configure vrrp add track-vrid configure vrrp add track-vrid configure vrrp vrid [ | all] add track-vrid [ | all] Description Adds failure tracking between the speciÞed VRRP classes. Syntax Description tracking VRID number The VRID of the VRRP class that tracks failure; a number between 1 and 255. tracked VRID number The VRID of the VRRP class whose failure is tracked; a number between 1 and 255. all Specifies all VRRP classes.
Commands for Configuring Redundancy The following command causes every class to track every other class; if any class fails, all other classes should also failover: configure vrrp vrid all add track-vrid all History This command was available in ExtremeWarePx 1.2. Platform Availability This command is available on the Px-series application switch. 176 ExtremeWarePx1 1.
configure vrrp add vrid configure vrrp add vrid configure vrrp add {backup} vrid Description Adds a VRRP class to the application switch. Syntax Description VRID number The VRID of the VRRP class to be added; a number between 1 and 255. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. A switch can have a total of 16 different VRRP classes. The new VRRP class is conÞgured to have a priority of 100. It does not preempt.
Commands for Configuring Redundancy configure vrrp advertisement-interval configure vrrp vrid [ | all] advertisement-interval Description Sets this switchÕs advertisement interval for the speciÞed VRRP class(es). Syntax Description VRID number The VRID of the VRRP class to be configured; a number between 1 and 255. all Specifies all VRRP classes. seconds The number of seconds in the interval between sending VRRP advertisements to the other switch.
configure vrrp auto-sync backup configure vrrp auto-sync backup configure vrrp auto-sync backup partner-ip Description Sets the IP address for the backup switch for automatic synchronization. Syntax Description IP address The IP address of the other switch. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You issue this command on the master switch for automatic synchronization.
Commands for Configuring Redundancy configure vrrp auto-sync forcesync configure vrrp auto-sync forcesync Description Forces automatic synchronization from the master switch to the backup switch. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. When automatic synchronization is enabled, you can issue this command on the master switch.
configure vrrp auto-sync master configure vrrp auto-sync master configure vrrp auto-sync master partner-ip Description Sets the IP address for the master switch for automatic synchronization. Syntax Description IP address The IP address of the other switch. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You issue this command on the backup switch for automatic synchronization.
Commands for Configuring Redundancy configure vrrp change vrid configure vrrp change vrid [ | all] to Description Changes the VRRP class for services. Syntax Description source VRID number The VRID of the VRRP class containing the services to be moved; a number between 1 and 255. all Specifies that all services should be moved to the destination VRRP class.
configure vrrp change vrid Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Configuring Redundancy configure vrrp delete track-servers-delta configure vrrp vrid [ | all] delete track-servers-delta Description Disables server-health failover for the speciÞed VRRP class(es). Syntax Description VRID number The VRID of the VRRP class; a number between 1 and 255. all Specifies all VRRP classes. Default Server-health failover is disabled by default. Usage Guidelines You must have administrator privileges to issue this command.
configure vrrp delete track-vrid configure vrrp delete track-vrid configure vrrp vrid [ | all] delete track-vrid [ | all] Description Removes failure tracking between the speciÞed VRRP classes. Syntax Description tracking VRID number The VRID of the VRRP class that tracks failure; a number between 1 and 255. tracked VRID number The VRID of the VRRP class whose failure is tracked; a number between 1 and 255. all Specifies all VRRP classes.
Commands for Configuring Redundancy Platform Availability This command is available on the Px-series application switch. 186 ExtremeWarePx1 1.
configure vrrp delete vrid configure vrrp delete vrid configure vrrp delete vrid [ | all] Description Deletes VRRP classes from the application switch. Syntax Description VRID number The VRID of the VRRP class to be deleted; a number between 1 and 255. all Specifies that all VRRP classes should be deleted. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
Commands for Configuring Redundancy configure vrrp force-slave configure vrrp vrid [ | all] force-slave Description Forces the application switch to attempt to become the backup device for the speciÞed VRRP class(es). Syntax Description VRID number The VRID of the VRRP class; a number between 1 and 255. all Specifies all VRRP classes. Default N/A. Usage Guidelines You must have administrator privileges to issue this command.
configure vrrp preempt|dont-preempt configure vrrp preempt|dont-preempt configure vrrp vrid [ | all] [preempt | dont-preempt] Description ConÞgures the switchÕs preemption behavior for the speciÞed VRRP class(es). Syntax Description VRID number The VRID of the VRRP class to be configured; a number between 1 and 255. all Specifies all VRRP classes. preempt Specifies that this switch should preempt the secondary switch.
Commands for Configuring Redundancy configure vrrp priority configure vrrp vrid [ | all] priority Description Sets this switchÕs priority for the speciÞed VRRP class(es). Syntax Description VRID number The VRID of the VRRP class whose priority is to be set; a number between 1 and 255. all Specifies all VRRP classes. priority number The switch’s priority for the specified VRRP class(es); a number in between 1 and 255, inclusive. Default The default priority is 100.
configure vrrp serial-failover interval configure vrrp serial-failover interval configure vrrp serial-failover interval Description ConÞgures the heartbeat interval for VRRP serial-cable failover. Syntax Description milliseconds The number of milliseconds in the interval between sending heartbeat messages to other switch; a number between 100 and 1000, inclusive. Default By default, the heartbeat interval is 500 ms.
Commands for Configuring Redundancy disable vrrp disable vrrp Description Disables VRRP on the application switch. Syntax Description This command has no parameters or options. Default VRRP is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. If VRRP is enabled on two Px-series application switches and you need to disable VRRP on one switch, you should Þrst make sure that the other switch is either powered down or off the network.
disable vrrp auto-sync disable vrrp auto-sync disable vrrp auto-sync Description Disables VRRP automatic synchronization on the application switch. Syntax Description This command has no parameters or options. Default VRRP automatic synchronization is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command. Example This command disables VRRP automatic synchronization.
Commands for Configuring Redundancy disable vrrp serial-failover disable vrrp serial-failover Description Disables VRRP serial failover on the application switch. Syntax Description This command has no parameters or options. Default VRRP serial failover is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command. Example This command disables VRRP serial failover.
enable vrrp enable vrrp enable vrrp Description Enables VRRP on the application switch. Syntax Description This command has no parameters or options. Default VRRP is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. Before you enable VRRP on a switch, you must ensure that each conÞgured service has been assigned a VRID number. You can assign a VRID number to a service when you create it (with the configure service L4 or configure service L7 command).
Commands for Configuring Redundancy enable vrrp auto-sync enable vrrp auto-sync Description Enables VRRP automatic synchronization on the application switch. Syntax Description This command has no parameters or options. Default VRRP automatic synchronization is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. If this switch is to be the master switch, you must issue to configure vrrp auto-sync backup to identify the corresponding backup switch.
enable vrrp serial-failover enable vrrp serial-failover enable vrrp serial-failover Description Enables VRRP serial failover on the application switch. Syntax Description This command has no parameters or options. Default VRRP serial failover is disabled by default. Usage Guidelines You must have administrator privileges to issue this command. You must use the build command to commit the conÞguration changes made by this command. Example This command enables VRRP serial failover.
Commands for Configuring Redundancy unconfigure vrrp auto-sync backup unconfigure vrrp auto-sync backup partner-ip Description UnconÞgures the backup switch for automatic synchronization. Syntax Description IP address The system IP address of the current backup switch, as set by the configure vrrp auto-sync backup command Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You issue this command on the master switch for automatic synchronization.
unconfigure vrrp auto-sync master unconfigure vrrp auto-sync master unconfigure vrrp auto-sync master partner-ip Description UnconÞgures the master switch for automatic synchronization. Syntax Description IP address The system IP address of the current master switch, as set by the configure vrrp auto-sync master command Default N/A. Usage Guidelines You must have administrator privileges to issue this command. You issue this command on the backup switch for automatic synchronization.
Commands for Configuring Redundancy 200 ExtremeWarePx1 1.
6 Health-Check Commands This chapter describes commands for conÞguring health checks. Types of Health Checks The application switch supports the following types of health checks: ¥ ICMP PingÑUses ICMP Òecho requestÓ to ensures that the host is reachable. In general, this does not provide any information about application health, but provides the simplest check. ¥ TCP Open ÑOpens a connection to a speciÞed TCP/IP port.
Health-Check Commands You can change the global default values for these properties. In addition, you conÞgure these properties for each server group. The same property values are used for all servers in a given server group. If health checks are enabled, and you do not speciÞcally conÞgure a particular property for a particular server group, that group uses the propertyÕs global default value.
configure health-check arp-interval configure health-check arp-interval configure health-check arp-interval Description Sets the global arp-interval property. Syntax Description minutes The number of minutes between ARP checks for servers in the same network as the application switch system IP; a number between 1 and 1000, inclusive. Default Initially, the value for the arp-interval property is 5 minutes. Usage Guidelines You must have administrator privileges to issue this command.
Health-Check Commands configure health-check fail-after configure health-check fail-after Description ConÞgures the global default value for the fail-after property. Syntax Description number The global default value for the number of consecutive failed health checks after which a server is removed from service. Default Initially, the global default value for the fail-after property is 2. Usage Guidelines You must have administrator privileges to issue this command.
configure health-check interval configure health-check interval configure health-check interval Description ConÞgures the global default value for the interval property. Syntax Description seconds The global default value for the time interval between successful health checks; a number between 2 and 255, inclusive. Default Initially, the global default value for the interval property is 30 seconds. Usage Guidelines You must have administrator privileges to issue this command.
Health-Check Commands configure health-check restore-after configure health-check restore-after Description ConÞgures the global default value for the restore-after property. Syntax Description number The global default value for the number of consecutive successful health checks after which a server is returned to service Default Initially, the global default value for the restore-after property is 2. Usage Guidelines You must have administrator privileges to issue this command.
configure health-check retry-interval configure health-check retry-interval configure health-check retry-interval Description ConÞgures the global default value for the retry-interval property. Syntax Description seconds The global default value for the time interval between rechecks after a failed health check. Default Initially, the global default value for the retry-interval property is 10 seconds. Usage Guidelines You must have administrator privileges to issue this command.
Health-Check Commands configure server slow-start initial-connections configure server slow-start initial-connections Description Sets the global initial maximum number of connections to a server. Syntax Description number The initial maximum number of connections to a server; a number between 1 and 100, inclusive. Default The initial maximum defaults to 5 connections. Usage Guidelines You must have administrator privileges to issue this command.
configure server slow-start interval configure server slow-start interval configure server slow-start interval Description Sets the global interval used to adjust the limit for server connections. Syntax Description seconds The global interval between server connections. Default The interval defaults to 5 seconds. Usage Guidelines You must have administrator privileges to issue this command.
Health-Check Commands configure server-group health-check fail-after configure server-group name health-check fail-after Description ConÞgures the fail-after property for the speciÞed server group. Syntax Description name string The name of the server group for which to configure the property. number The number of consecutive failed health checks after which a server in the specified group is removed from service.
configure server-group health-check http configure server-group health-check http configure server-group name health-check http {object
Health-Check Commands Example The following command conÞgures the server group named sg1 to use HTTP GET health checks that request the object index.html: configure server-group name "sg1" health-check http object index.html The following command conÞgures the server group named sg1 to use HTTP GET health checks that request the object index.html and check for the string "Welcome": configure server-group name "sg1" health-check object index.
configure server-group health-check interval configure server-group health-check interval configure server-group name health-check interval Description ConÞgures the interval property for the speciÞed server group. Syntax Description name string The name of the server group for which to configure the property. seconds The time interval between successful health checks for servers in the specified group.
Health-Check Commands configure server-group health-check ping configure server-group name health-check ping Description ConÞgures ping health checks for the speciÞed server group. Syntax Description name string Name of the server group for which to configure the health-check type. Default If no health-check type is conÞgured for a server group, that group uses ping health checks by default. Usage Guidelines You must have administrator privileges to issue this command.
configure server-group health-check restore-after configure server-group health-check restore-after configure server-group name health-check restore-after Description ConÞgures the restore-after property for the speciÞed server group. Syntax Description name string The name of the server group for which to configure the property. number The number of consecutive successful health checks after which a server in the specified group is returned to service.
Health-Check Commands configure server-group health-check retry-interval configure server-group name health-check retry-interval Description ConÞgures the retry-interval property for the speciÞed server group. Syntax Description name string The name of the server group for which to configure the property. seconds The time interval between rechecks after a failed health check for servers in the specified group.
configure server-group health-check tcp-open configure server-group health-check tcp-open configure server-group name health-check tcp-open return Description ConÞgures TCP open health checks for the speciÞed server group. Syntax Description name string Name of the server group for which to configure the health-check type. return string String to be compared to the response.
Health-Check Commands disable health-check disable health-check Description Disables the health-check facility. Syntax Description This command has no parameters or options. Default The health-check facility is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. When health-check facility is disabled, no health checks are performed.
disable health-check server-group-name disable health-check server-group-name disable health-check server-group-name Description Disables health checks for a speciÞed server group. Syntax Description name string The name of the server group for which health checks are to be disabled. Default Health checks are enabled for all server groups by default. Usage Guidelines You must have administrator privileges to issue this command.
Health-Check Commands disable server disable server [(index ) | (ipaddress {port })] Description Disables a server, forcing the server to be down. Syntax Description index number The unique index number of the server to be disabled. IP address The IP address of the server(s) to be disabled. The IP address plus the port number uniquely identify a server. port number The port number of the server to be disabled.
disable server 20001 20002 5.5.5.5 5.5.5.5 91 92 ICMP ICMP FDOWN FDOWN IDLE IDLE 14 15 0 0 2 2 2 2 0 0 E E History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Health-Check Commands disable server slow-start disable server slow-start Description Disables server slow start. Syntax Description This command has no parameters or options. Default Slow start is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. In order not to overload a server that has just come up, server slow start restricts the number of connections that the server can process.
enable health-check enable health-check enable health-check Description Enables the health-check facility. Syntax Description This command has no parameters or options. Default The health-check facility is enabled by default. Usage Guidelines You must have administrator privileges to issue this command.
Health-Check Commands enable health-check server-group-name enable health-check server-group-name Description Enables health checks for a speciÞed server group. Syntax Description name string The name of the server group for which health checks are to be enabled. Default Health checks are enabled for all server groups by default. Usage Guidelines You must have administrator privileges to issue this command. Health checks are performed only if the health-check facility itself is enabled.
enable server enable server enable server [(index ) | (ipaddress {port })] Description Re-enables a server that has been disabled. Syntax Description index number The unique index number of the server to be enabled. IP address The IP address of the server(s) to be enabled. The IP address plus the port number uniquely identify a server. port number The port number of the server to be enabled. The port number plus the IP address uniquely identify a server.
Health-Check Commands enable server slow-start enable server slow-start Description Enables server slow start. Syntax Description This command has no parameters or options. Default Slow start is enabled by default. Usage Guidelines You must have administrator privileges to issue this command. In order not to overload a server that has just come up, server slow start restricts the number of connections that the server can process.
7 Commands for Monitoring the Switch This chapter describes the following commands: ¥ Commands that show trafÞc statistics ¥ Commands that show conÞguration details ¥ Commands for managing and troubleshooting operation ExtremeWarePx1 1.
Commands for Monitoring the Switch pxtop pxtop {vip {port }} Description Displays real-time information about connections to virtual services. Syntax Description IP address VIP for the service(s) of interest port number Port number for the service of interest Default N/A. Usage Guidelines The screen is updated dynamically to display an overview of the current, peak, and total connections to virtual services.
pxtop Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show accounts show accounts Description Displays user account information for all users on the switch. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You must have administrator privileges to issue this command. This command displays the following information in a tabular format: ¥ User NameÑThe name of the user. This list displays all of the users who have access to the switch. ¥ AccessÑThe SNMP community strings.
show banner show banner show banner Description Displays the user-conÞgured banner string. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines Use this command to view the banner that was set with the configure banner command. This banner is displayed before the login prompt. Example The following command displays the switch banner: show banner History This command was available in ExtremeWarePx 1.1.
Commands for Monitoring the Switch show build show build Description Displays the conÞguration that will become effective when the build command is issued. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You can use this command after making changes to the conÞguration and before issuing the build command. The output shows the conÞguration as set by commands that change conÞguration that have not yet been conÞrmed by the build command.
show build History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show configuration show configuration [primary | secondary] Description Shows the currently active conÞguration, which may be different from the saved conÞgurations. Syntax Description primary Shows the primary configuration saved in flash memory. secondary Shows the secondary configuration saved in flash memory. Default N/A.
show configuration config service vip 10.6.36.21 port 2000 protocol tcp l4 server-group-name web1_layer4 config config config config config service vip 10.6.36.22 port 3000 protocol tcp l7 class http domain name default pattern-rule "default" server-group-name web3_layer7 domain name mydomain.com pattern-rule "default" server-group-name web2_layer7 History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch.
Commands for Monitoring the Switch show connections details show connections {vip {port }} details Description Displays a list of the open connection. Syntax Description IP address VIP for the service of interest port number port number for the service of interest Default N/A. Usage Guidelines Parameters to this command allow you to limit the display to connections to the speciÞed IP address or the speciÞed IP address and port.
show connections details Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show connections summary show connections summary Description Displays the current and total number of connections processed by the application switch. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None.
show cookie show cookie show cookie Description Displays the conÞgured status of cookie processing. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows the status of cookie processing. show cookie History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show critical-resources show critical-resources Description Displays information about the conÞguration of critical resources. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines In full-NAT mode (full Network Address Translation), the Px-series application switch must have sufÞcient proxy IP addresses conÞgured to allow millions of connections going through the switch.
show default-gateway show default-gateway show default-gateway Description Displays the default gateway IP address for the Gigabit Ethernet interface. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows information about the default gateway. SummitPx1:36 # sh default-gateway Default Gateway 1: 10.6.12.1 Default Gateway 2: Not configured. Active Gateway : 10.6.12.
Commands for Monitoring the Switch show dns-client show dns-client Description Displays the DNS conÞguration. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example displays the DNS conÞguration: SummitPx1:5 # show dns-client Default domain: ExtremeNetworks.com Number of name servers: 1 Name Server 1: 10.0.0.1 History This command was available in ExtremeWarePx 1.1.
show errors show errors show errors Description Displays any system-level errors that have been detected. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows system-level errors: show errors History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show gateway-mode show gateway-mode Description Displays information about gateway-mode IP addresses. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows information about gateway-mode IP addresses. station2:69 # show gateway-mode gateway-mode is currently disabled Gateway-mode Vrid Ip Address Vlan -----------------------------0 10.6.2.
show gateway-mode configuration show gateway-mode configuration show gateway-mode configuration Description Displays current gateway-mode conÞguration. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows gateway-mode conÞguration.
Commands for Monitoring the Switch show gslb show gslb Description Shows activity of the GlobalPx Content Director agent. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines This command shows whether the GlobalPx Content Director agent is enabled.
show gslb configuration show gslb configuration show gslb configuration Description Shows the conÞguration of the GlobalPx Content Director agent. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines The output from this command shows any enable gslb, disable gslb, or configure gslb that are in effect. For more information about the agent, see the GlobalPx Content Director Installation and User Guide. Example This example shows the conÞguration of the agent.
Commands for Monitoring the Switch show health-check show health-check {(server [(index ) | (ipaddress )]) | (server-group name )} {details} Description Shows detailed information about health checks Syntax Description index number The unique index number of a server for which to display health-check information. IP address The IP address of a server for which to display health-check information. The IP address plus the port number uniquely identify a server.
show health-check 100 478 101 1738 1380 102 1926 677 1 2158 1742 2 478 173 1.1.1.1 90 ICMP *DOWN 14803 1.1.1.1 91 ICMP *DOWN 14803 10.6.2.1 ICMP DOWN 14803 S_errno_ETIMEDOUT 10.6.2.1 900 ICMP *DOWN 14803 10.6.3.4 ICMP UP 14803 S_errno_ETIMEDOUT 10.6.3.4 80 ICMP *UP 14803 10.6.3.5 ICMP UP 14803 S_errno_ETIMEDOUT 10.6.3.5 80 ICMP *UP 14803 10.6.3.
Commands for Monitoring the Switch show health-check configuration show health-check configuration Description Shows whether health checks are enabled and the current value for global health-check properties. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows the health-check conÞguration.
show health-check down show health-check down show health-check down Description Shows the servers that failed health check and that are marked down. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows which servers are down.
Commands for Monitoring the Switch show health-check summary show health-check summary Description Displays a brief summary showing whether health check is enabled, the values for global health-check properties, and how many servers and applications (on speciÞc ports) are up and down. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows a health-check summary.
show icmp show icmp show icmp Description Shows how many ICMP-type packets have been received. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows the number of ICMP packets.
Commands for Monitoring the Switch show iparp show iparp { | } Description Displays the IP Address Resolution Protocol (ARP) table. Syntax Description IP address An IP address to use for filtering the display. Only entries with the specified IP address are displayed. hostname A host name to use for filtering the display. Only entries with the specified host name are displayed. Default Show all entries.
show iparp show iparp History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show iproute show iproute Description Displays the contents of the IP routing table. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example displays detailed information about all IP routing: station2:157 # sh iproute ROUTE NET TABLE destination gateway flags Refcnt Use Interface ---------------------------------------------------------------------------0.0.0.0 10.6.12.1 3 3 617782 gig0 10.6.2.0 10.6.2.
show log show log show log {fatal | errors | warning | info} Description Displays the current snapshot of the switchÕs internal log. Syntax Description fatal Display fatal messages only.
Commands for Monitoring the Switch show log configuration show log configuration Description Shows the conÞguration for the logging facility. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command displays logging conÞguration: SummitPx1:10 # show log configuration config log display warning enable syslog config syslog ip 10.10.10.1 History This command was available in ExtremeWarePx 1.1.
show nat-mode configuration show nat-mode configuration show nat-mode configuration Description Displays the currently conÞgured NAT mode. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows the NAT mode. show nat-mode configuration History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show port show port [gigabit | mgmt] Description Displays summary information about the speciÞed port. Syntax Description gigabit Specifies the Gigabit Ethernet network interface port. mgmt Specifies the front panel 10/100 management port. Default N/A. Usage Guidelines None. Example This example shows summary information for the Gigabit port.
show port Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show port configuration show port [gigabit | mgmt] configuration Description Displays the conÞguration of the speciÞed port. Syntax Description gigabit Specifies the Gigabit Ethernet network interface port. mgmt Specifies the front panel 10/100 management port. Default N/A. Usage Guidelines None. Example This example shows the conÞguration of the Gigabit port. SummitPx1:40 # sh port gig conf config system-ip 10.6.2.
show port details show port details show port [gigabit | mgmt] details Description Displays packet-level counters and current status of the speciÞed port. Syntax Description gigabit Specifies the Gigabit Ethernet network interface port. mgmt Specifies the front panel 10/100 management port. Default N/A. Usage Guidelines None. Example This example shows details about the Gigabit port.
Commands for Monitoring the Switch This example shows details about the management port.
show port gigabit utilization show port gigabit utilization show port gigabit utilization Description Displays real-time port utilization information for the Gigabit Ethernet network interface port. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines The screen is updated dynamically to display packets received and bandwidth. Use the [Spacebar] to toggle between packet, byte, and bandwidth utilization information.
Commands for Monitoring the Switch show proxy-ip configuration show proxy-ip configuration Description Displays the currently conÞgured proxy IP addresses. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows the proxy IP addresses. show proxy-ip configuration History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch.
show self-audit show self-audit show self-audit Description Shows whether internal self-audit is enabled. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines Internal self-audit is the internal hardware-check mechanism. Example This example e shows whether internal self-audit is enabled. station2:68 # show self-audit Self Audit state: Enabled.
Commands for Monitoring the Switch show server configuration show server [(index {- }) | (ipaddress {- } port )] configuration Description Displays server conÞguration. Syntax Description index number The unique index number of a server to be displayed. IP address The IP address of a server to be displayed. The IP address plus the port number uniquely identify a server. port number The port number of the servers to be displayed.
show server details show server details show server [(index {- }) | (ipaddress {- })] details Description Displays details about servers including the current and maximum number of connections and status (up or down). Syntax Description index number The unique index number of a server to be displayed. IP address The IP address of a server to be displayed. The IP address plus the port number uniquely identify a server.
Commands for Monitoring the Switch 5 6 7 8 10.6.3.198 10.6.3.198 10.6.3.199 10.6.3.199 10.6.3.200 10.6.3.200 10.6.3.201 10.6.3.201 80 80 80 80 ICMP HTTP ICMP HTTP ICMP HTTP ICMP HTTP URE URE URE URE URE URE URE URE 5 10000 5 10000 5 10000 5 10000 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 This example shows details about the server with index number 3.
show server down show server down show server down Description Shows which servers are failing health check Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows which servers are down.
Commands for Monitoring the Switch show server summary show server summary Description Shows the number of conÞgured servers, how many are up, and how many are down. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows the status of servers. SummitPx1:22 # sh server summ Number of configured servers: 64, 1 DOWN 63 UP History This command was available in ExtremeWarePx 1.1.
show server-group show server-group show server-group Description Displays detailed information about all server groups, listing their servers, the current and maximum connections for each, and up/down status. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines To see details about a single server group, use the show server-group details command. Example This example shows details about all servers.
Commands for Monitoring the Switch Platform Availability This command is available on the Px-series application switch. 274 ExtremeWarePx1 1.
show server-group configuration show server-group configuration show server-group {name } configuration Description Displays conÞguration for server groups. Syntax Description name string The name of the server group for which configuration should be displayed. Default N/A. Usage Guidelines The parameter to this command allows you to display conÞguration for a single server group. Example This example displays the conÞguration for the server group named sg1.
Commands for Monitoring the Switch show server-group details show server-group name details Description Displays detailed information about a server groups, listing its servers, current and maximum connections, and up/down status. Syntax Description name string The name of the server group for which details should be displayed. Default N/A. Usage Guidelines To see details about all servers, use the show server-group command.
show server-group details Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show server-group summary show server-group summary Description Displays the total number of server groups. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This examples shows a summary of the server groups. SummitPx1:29 # sh server-group summ Total number of server groups: 3 History This command was available in ExtremeWarePx 1.1.
show service configuration show service configuration show service {vip {port {protocol [tcp | udp]}}} configuration Description Displays conÞguration for services. Syntax Description IP address VIP for the service of interest port number Port number for the service of interest tcp Specifies the TCP protocol. udp Specifies the UDP protocol. Default N/A.
Commands for Monitoring the Switch show service details show service {vip {port }} details Description Displays detailed information about virtual service and their server groups and servers. Syntax Description IP address VIP for the service of interest port number Port number for the service of interest Default N/A. Usage Guidelines This command can give dramatic insight into the distribution of trafÞc across a virtual service.
show service details Domain: 10.6.2.100 Pattern-rule: default Current connection: 0 Total connections: 0 Peak concurrent: 0 server-group sg2 policy wlc server of last resort not specified Pattern-rule: *.gif Current connection: 50 Total connections: 359 Peak concurrent: 309 server-group sg2 policy wlc server of last resort not specified Service 10.6.2.
Commands for Monitoring the Switch History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 282 ExtremeWarePx1 1.
show service summary show service summary show service summary Description Displays the number of conÞgured layer 4 and layer 7 services. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows a summary of the services. SummitPx1:48 # sh servi summ Total number of L4 services = 1. Total number of L7 services = 2. History This command was available in ExtremeWarePx 1.1.
Commands for Monitoring the Switch show session show session Description Show which console, Telnet, and ssh sessions are active. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines You can issue the clear session command to force a session to be closed. Example This example displays the active sessions.
show snmp configuration show snmp configuration show snmp configuration Description Displays the current SNMP conÞguration. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None.
Commands for Monitoring the Switch show sticky configuration show sticky configuration Description Displays which persistence (stickiness) modes have been conÞgured, and the conÞgured timer values. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows the conÞgured stickiness modes.
show sticky table show sticky table show sticky table {L4 | (L7 {client-ip}) | (client-ip {})} Description Shows entries in the persistence (stickiness) table. Syntax Description L4 Specifies layer 4 services. L7 Specifies layer 7 services. client-ip Specifies client-IP persistence. IP address A particular client IP address. Default N/A.
Commands for Monitoring the Switch Example This example shows the entire persistence table. SummitPx1:5 # show sticky table L4 Client-IP stickiness enabled L7 Client-IP stickiness disabled L7 Cookie-ID stickiness disabled L7 Session-ID stickiness disabled Note: Values for cookie (CKE) and session (SSL) entries will not be displayed. Count Type:Value Layer:VIP:VPORT Server IP:PORT Open Conn -------------------------------------------------------------------------------1 CIP:3.1.1.101 L4:3.2.20.11:80 3.4.20.
show switch show switch show switch Description Displays the current version of software loaded in primary and secondary ßash, which image and conÞguration are currently selected, and other useful information. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example displays information about the switch.
Commands for Monitoring the Switch Platform Availability This command is available on the Px-series application switch. 290 ExtremeWarePx1 1.
show system configuration show system configuration show system configuration Description Shows the current system conÞguration. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example shows the system conÞguration. SummitPx1:25 # sh system conf config system-ip 64.1.1.10 / 24 config default-gateway 64.1.1.1 disable vlan config mgmt ipaddress 10.10.10.10 / 24 enable syslog config syslog ip 10.10.10.
Commands for Monitoring the Switch show system-ip configuration show system-ip configuration Description Displays the IP address of the Gigabit Ethernet interface, along with its net mask. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows the IP address of the Gigabit Ethernet interface. show system-ip configuration History This command was available in ExtremeWarePx 1.1.
show tech-support show tech-support show tech-support Description Displays the output of various show commands to assist in monitoring and troubleshooting the switch. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines This command prints conÞguration and internal state registers on the console. This information can be useful for your technical support representative if you experience a problem.
Commands for Monitoring the Switch show timeout configuration show timeout configuration Description Displays the TCP/IP timer settings. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None.
show version show version show version Description Shows version and serial numbers of the Px-series application switch components and the ExtremeWarePx software version. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows versions and serial numbers. show version History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch.
Commands for Monitoring the Switch show vlan configuration show vlan configuration Description Displays whether VLAN support is enabled or not. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example The following command shows the VLAN conÞguration. show vlan configuration History This command was available in ExtremeWarePx 1.1. Platform Availability This command is available on the Px-series application switch. 296 ExtremeWarePx1 1.
show vrrp auto-sync show vrrp auto-sync show vrrp auto-sync Description Shows the conÞguration of VRRP automatic synchronization. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None.
Commands for Monitoring the Switch show vrrp configuration show vrrp {vrid [ | all]} configuration Description Shows the current VRRP conÞguration. Syntax Description VRID number The VRID of the VRRP class for which to show configuration; a number between 1 and 255. all Specifies all VRRP classes. Default N/A. Usage Guidelines The vrid parameter to this command allows you to limit the display to the conÞguration of the speciÞed VRRP class.
show vrrp configuration config config config config config config config config config config config vrrp vrrp vrrp vrrp vrrp vrrp vrrp vrrp vrrp vrrp vrrp vrid vrid vrid vrid vrid vrid vrid vrid vrid vrid vrid 104 106 107 108 109 110 111 112 113 114 115 add add add add add add add add add add add track-vrid track-vrid track-vrid track-vrid track-vrid track-vrid track-vrid track-vrid track-vrid track-vrid track-vrid 100 100 100 100 100 100 100 100 100 100 100 History This command was available in Ex
Commands for Monitoring the Switch show vrrp details show vrrp {vrid [ | all]} details Description Displays detailed status information for VRRP. Syntax Description VRID number The VRID of the VRRP class for which to show details; a number between 1 and 255. all Specifies all VRRP classes. Default N/A. Usage Guidelines The vrid parameter to this command allows you to limit the display to the details about the speciÞed VRRP class. Example This example shows the full VRRP details.
show vrrp details This example shows details for VRRP class 100: station2:40 # show vrrp vrid 100 config VRRP ENABLED VRID 100 Priority 100 State MASTER MAC Address 00:00:5e:00:01:64 Valid Advertisements Received: 0 Serial Heartbeats Transmitted: Serial Heartbeats Received: 0 0 VRRP Stats Checksum errors: Advertisements Received with Unknown vrid: Advertisement interval errors: IP TTL errors: Preempt Mode DISABLED Advertisement Interval 1 second 0 0 0 0 History This command was available in Ex
Commands for Monitoring the Switch show vrrp gateway-mode details show vrrp {vrid [ | all]} gateway-mode details Description Shows details about the gateway-mode IP addresses in VRRP classes. Syntax Description VRID number The VRID of the VRRP class for which to show gateway-mode details; a number between 1 and 255. all Specifies all VRRP classes. Default N/A.
show vrrp gateway-mode details Platform Availability This command is available on the Px-series application switch. ExtremeWarePx1 1.
Commands for Monitoring the Switch show vrrp serial-failover show vrrp serial-failover Description Displays information about VRRP automatic synchronization. Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines None. Example This example displays information about serial failover. SummitPx1:11 # show vrrp serial-failover Serial cable failover: Disabled Serial heartbeat interval: 500 milliseconds History This command was available in ExtremeWarePx 1.2.
show vrrp server details show vrrp server details show vrrp {vrid [ | all]} server details Description Shows details about servers in the VRRP classes. Syntax Description VRID number The VRID of the VRRP class for which to show server details; a number between 1 and 255. all Specifies all VRRP classes. Default N/A. Usage Guidelines The vrid parameter to this command allows you to limit the display to the details about the servers in the speciÞed VRRP class.
Commands for Monitoring the Switch Server Server Server Vrid Index Ip address Port State -----------------------------------------------115 1 10.6.3.195 80 UP This example shows details about the servers in VRRP class 100. SummitPx1:11 # show vrrp vrid 100 server details Total Total Up Vrid Servers Servers -------------------------100 2 2 Server Server Server Vrid Index Ip address Port State -----------------------------------------------100 2 10.6.3.196 80 UP 100 4 10.6.3.
show vrrp service details show vrrp service details show vrrp {vrid [ | all]} service details Description Shows details about services in the VRRP classes. Syntax Description VRID number The VRID of the VRRP class for which to show service details; a number between 1 and 255. all Specifies all VRRP classes. Default N/A. Usage Guidelines The vrid parameter to this command allows you to limit the display to the details about the services in the speciÞed VRRP class.
Commands for Monitoring the Switch VRRP ENABLED VRID 102 Priority 100 State MASTER MAC Address 00:00:5e:00:01:66 Preempt Mode DISABLED Advertisement Interval 1 second config service vip 10.5.6.67 vrid 102 port 80 protocol tcp l4 server-group-name sg2 config service vip 10.5.6.83 vrid 102 port 80 protocol tcp l4 server-group-name sg4 This example shows details about the services in VRRP class 100.
uptime uptime uptime Description Shows the amount of time the switch has been up Syntax Description This command has no parameters or options. Default N/A. Usage Guidelines This command displays the amount of time that has elapsed since system was last rebooted or powered on. Example This example shows how long the system has been up. * station2:5 # uptime Uptime: 0 days 02Hr 41Min 05sec History This command was available in ExtremeWarePx 1.1.
Commands for Monitoring the Switch 310 ExtremeWarePx1 1.
Index of Commands B build 18 C clear log clear session clear stats cls configure account configure banner configure default-gateway configure default-gateway delete configure default-gateway switch configure dns-client add configure dns-client default-domain configure dns-client delete configure domain configure domain default configure gateway-mode add ipaddress configure gateway-mode delete ipaddress configure gslb configure health-check arp-interval configure health-check fail-after configure health-c
configure vrrp delete track-servers-delta configure vrrp delete track-vrid configure vrrp delete vrid configure vrrp force-slave configure vrrp preempt|dont-preempt configure vrrp priority configure vrrp serial-failover interval create account 184 185 187 188 189 190 191 53 enable vrrp serial-failover exit 55 56 160 57 218 219 58 59 60 220 222 61 62 63 161 64 65 66 192 193 194 67 69 N D delete account disable clipaging disable gateway-mode disable gslb disable health-check disable health-check server-g
show port details show port gigabit utilization show proxy-ip configuration show self-audit show server configuration show server details show server down show server summary show server-group show server-group configuration show server-group details show server-group summary show service configuration show service details show service summary show session show snmp configuration show sticky configuration show sticky table show switch show system configuration show system-ip configuration show tech-support
- Index of Commands ExtremeWarePx1 1.
