Table Of Contents
show module csm vserver redirect
Command Reference
This appendix describes the Content Switching Module (CSM) commands that are unique to server load-balancing (SLB) and Layer 3 switching.
The following commands allow you to set up and monitor SLB on the CSM:
dfp
Use the dfp command to enter the DFP submode and configure DFP. Use the no form of this command to remove the DFP configuration.
dfp [password password [timeout]]
no dfp
Syntax Description
Defaults
The default timeout value is 180 seconds.
Command Modes
Module CSM configuration submode.
Command History
Usage Guidelines
The timeout option allows you to change the password without stopping messages between the DFP agent and its manager.
During a timeout, the agent sends packets with the old password (or null, if there is no old password), and receives packets with either the old or new password. After a timeout expires, the agent sends and receives packets with only the new password; received packets that use the old password are discarded.
If you are changing the password for an entire load-balanced environment, set a longer timeout. The extended timeout allows enough time for you to update the password on all agents and servers before the timeout expires. It also prevents mismatches between agents and servers that have the new password and agents and servers that have the old password.
Examples
This example shows how to initiate DFP agent configuration mode, configure DFP, set the password to flounder, and configure a 60-second timeout:
SLB-Switch(config-module-csm)# dfp password flounder 60Related Commands
agent
Use the agent command in the SLB DFP submode to configure the DFP agent to which the CSM is going to communicate. Use the no form of this command to remove the agent configuration.
agent ip-address port [keepalive-timeout [retry-count [retry-interval]]]
no agent ip-address port
Syntax Description
Defaults
The keepalive-timeout default is 0 (no keepalive message).
Retry count default is 0 seconds (the default allows infinite retries).
The retry-interval default is 180 seconds.
Command Modes
SLB DFP configuration submode.
Command History
Examples
This example shows how to initiate the DFP agent, configure a 350-second timeout, and configure the number of retries to 270:
SLB-Switch(config-slb-dfp)# agent 111.101.90.10 2 350 270Related Commands
manager
Use the manager command in SLB DFP submode to set the port where an external DFP can connect to the CSM. Use the no form of this command to remove the manager configuration.
manager port
no manager
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB DFP configuration submode.
Command History
Usage Guidelines
This command enables the CSM to listen to DFP connections from an external DFP manager.
Examples
This example shows how to set the DFP manager port:
SLB-Switch(config-slb-dfp)# manager 4Related Commands
ft group
Use the ft group command to enter the fault-tolerant configuration submode and configure fault tolerance. Use the no form of this command to remove the fault-tolerant configuration.
ft group group-id vlan vlan-id
no ft group
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Usage Guidelines
A fault-tolerant group is comprised of two Catalyst 6500 series switches each containing a CSM configured for fault-tolerant operation. Each fault-tolerant group appears to network devices as a single device. A network may have more than one fault-tolerant group.
Examples
This example shows how to configure a fault-tolerant group named 123 on VLAN 5:
SLB-Switch(config-module-csm)# ft group 123 vlan 5Related Commands
failover
heartbeat-time
preempt
priority
show module csm ftfailover
Use the failover command in the SLB fault-tolerant configuration submode to set the time for a standby CSM to wait before becoming an active CSM. Use the no form of this command to remove the failover configuration.
failover failover-time
no failover
Syntax Description
failover-time
Amount of time the CSM must wait after the last heartbeat message is received before assuming the other CSM is not operating; the range is from 1 to 65535.
Defaults
The default failover time is 3 seconds.
Command Modes
SLB fault-tolerant configuration submode.
Command History
Examples
This example shows how to set a failover period of 6 seconds:
SLB-Switch(config-slb-ft)# failover 6Related Commands
heartbeat-time
Use the heartbeat-time command in the SLB fault-tolerant configuration submode to set the time before heartbeat messages are transmitted by the CSM. Use the no form of this command to restore the default heartbeat interval.
heartbeat-time heartbeat-time
no heartbeat-time
Syntax Description
heartbeat-time
Time interval between heartbeat transmissions in seconds; the range is from 1 to 65535.
Defaults
The default heartbeat time is 1 second.
Command Modes
SLB fault-tolerant configuration submode.
Command History
Examples
This example shows how to set the heartbeat time to 2 seconds:
SLB-Switch(config-slb-ft)# heartbeat-time 2Related Commands
preempt
Use the preempt command in the SLB fault-tolerant configuration submode to allow a higher priority CSM to take control of a fault-tolerant group when it comes online. Use the no form of this command to restore the preempt default value.
preempt
no preempt
Syntax Description
This command has no arguments or keywords.
Defaults
The default value is that preempt is not specified.
Command Modes
SLB fault-tolerant configuration submode.
Command History
Usage Guidelines
When you enable preempt, the higher priority CSM preempts the other CSM in the fault-tolerant group when the higher priority CSM comes online. When you enable no preempt, the current primary CSM remains the primary CSM when the next CSM comes online.
Note
You must set both members of the fault-tolerant CSM pair to preempt for this feature to work.
Examples
This example shows how to set the fault-tolerance mode to preempt:
SLB-Switch(config-slb-ft)# preemptRelated Commands
ft group
priority
show module csm ftpriority
Use the priority command in the SLB fault-tolerant configuration submode to set the priority of the CSM. Use the no form of this command to restore the priority default value.
priority value
no priority
Syntax Description
Defaults
The default priority value is 10.
Command Modes
SLB fault-tolerant configuration submode.
Command History
Usage Guidelines
The CSM with the largest priority value is the primary CSM in the fault-tolerant pair when the modules are both operating.
Examples
This example shows how to set the priority value to 12:
SLB-Switch(config-slb-ft)# priority 12Related Commands
ft group
preempt
show module csm ftip slb mode
Use the ip slb mode command to configure the switch to operate as a CSM load-balancing device instead of a Cisco IOS SLB load-balancing device. Use the no form of this command to remove the mode configuration.
ip slb mode {csm | rp}
no ip slb mode
Note
Syntax Description
Defaults
The default is the rp mode.
Command Modes
Global configuration submode.
Command History
1.1(1)
This command was introduced.
2.1(1)
This command now enables module csm commands for the rp mode.
Usage Guidelines
This command allows you to change from the Cisco IOS SLB load-balancing mode to the CSM load-balancing mode.
Note
Examples
This example shows how to configure the switch mode:
SLB-Switch(config)# ip slb mode csmRelated Commands
module csm
show ip slb modemap cookie
Use the map cookie command to create a cookie map and enter the cookie map configuration submode for specifying cookie match rules. Use the no form of this command to remove the cookie maps from the configuration.
map cookie-map-name cookie
no map cookie-map-name
Syntax Description
cookie-map-name
Cookie map instance; the character string is limited to 15 characters.
cookie
Keyword to enter the cookie map submode.
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to create a cookie map:
SLB-Switch(config-module-csm)# map upnready cookieRelated Commands
cookie-map (SLB policy configuration submode)
match protocol http cookie
show module csm map
match protocol http cookie
Use the match protocol http cookie command in SLB cookie map configuration submode to add cookies to a cookie map. Multiple match rules can be added to a cookie map. Use the no form of this command to remove the cookie map name from the cookie map.
match protocol http cookie cookie-name cookie-value cookie-value-expression
Syntax Descriptionno match protocol http cookie cookie-name
Defaults
This command has no default settings.
Command Modes
SLB cookie map configuration submode.
Usage Guidelines
Cookie regular expressions are based on the UNIX filename specification. URL expressions are stored in a cookie map in the form cookie-name = cookie-value-expression. Cookie expressions allow spaces provided they are escaped or quoted. You must match all cookies in the cookie map.
"*" means zero or more characters
"?" means exactly one character—the [Ctrl + V] key combination must be entered
"\" means escaped character
Bracketed range (for example, [0-9]) means matching any single character from the range
A leading ^ in a range means do not match any in the range
".\a" means alert (ASCII 7)
".\b" means backspace (ASCII 8
".\f" means form-feed (ASCII 12)
".\n" means newline (ASCII 10)
".\r" means carriage return (ASCII 13)
".\t" means tab (ASCII 9)
".\v" means vertical tab (ASCII 11)
".\0" means null (ASCII 0)
".\\" means backslash
".\x##" means any ASCII character as specified in two-digit hexadecimal notation
Command History
Examples
This example shows how to add cookies to a cookie map:
SLB-Switch(config-slb-map-cookie)# match protocol http cookie albert cookie-value 4*Related Commands
cookie-map (SLB policy configuration submode)
map cookie
show module csm mapmap dns
Use the map dns command to enter the SLB DNS map mode and configure a DNS map. Use the no form of this command to remove the DNS map from the configuration.
map dns-map-name dns
no map dns-map-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB DNS map configuration submode.
Command History
Usage Guidelines
Any match of a DNS regular expression in the DNS map results in a successful match. A maximum of 1023 DNS domains can be configured to a map.
Examples
This example shows how to group DNS domains:
SLB-Switch(config-module-csm)# map m1 dnsSLB-Switch(config-slb-map-url)# exitSLB-Switch(config)Related Commands
match protocol dns domain
show module csm map
match protocol dns domain
Use the match protocol dns domain command in the SLB DNS map configuration submode to add a DNS domain to a DNS map. Use the no form of this command to remove the DNS domain from the URL map.
match protocol dns domain name
no match protocol dns domain name
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB DNS map configuration submode.
Command History
1.1(1)
This command was introduced.
3.1(1)
HTTP method parsing support was introduced.
Examples
This example shows how to adds URL expressions to a URL map:
SLB-Switch(config-slb-map-url)# match protocol http url Host header-value XYZRelated Commands
map header
Use the map header command to create a map group for specifying HTTP headers and enter the header map configuration submode. Use the no form of this command to remove the HTTP header group from the configuration.
map name header
no map name
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to group HTTP headers and associate them with a Content Switching policy:
SLB-Switch(config-module-csm)# map upnready headerSLB-Switch(config-slb-map-header)# match protocol http header Accept header-value *jpeg*SLB-Switch(config-slb-map-header)# match protocol http header User-Agent header-value *NT*SLB-Switch(config-slb-map-header)# match protocol http header Host header-value www.myhome.comSLB-Switch(config-slb-map-header)# exitRelated Commands
header-map (SLB policy configuration submode)
match protocol http header
show module csm map
match protocol http header
Use the match protocol http header command in SLB header map configuration submode to specify header fields and values for the CSM to search for when receiving a request. Multiple match rules can be added to a header map. Use the no form of this command to remove the header match rule from the header map.
match protocol http header field header-value expression
no match protocol http header field
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB header map configuration submode.
Usage Guidelines
There are predefined fields, for example Accept-Language, User-Agent, or Host.
Header regular expressions are based on the UNIX filename specification. URL expressions are stored in a header map in the form header-name = expression. Header expressions allow spaces provided that they are escaped or quoted. All headers in the header map must be matched.
"*" means zero or more characters
"?" means exactly one character—the [Ctrl + V] key combination must be entered
"\" means escaped character
Bracketed range (for example, [0-9]) means matching any single character from the range
A leading ^ in a range means don't match any in the range
".\a" means alert (ASCII 7)
".\b" means backspace (ASCII 8
".\f" means form-feed (ASCII 12)
".\n" means newline (ASCII 10)
".\r" means carriage return (ASCII 13)
".\t" means tab (ASCII 9)
".\v" means vertical tab (ASCII 11)
".\0" means null (ASCII 0)
".\\" means backslash
".\x##" means any ASCII character as specified in two-digit hexadecimal notation
Command History
Examples
This example shows how to specify header fields and values to search upon a request:
SLB-Switch(config-slb-map-header)# match protocol http header Host header-value XYZRelated Commands
header-map (SLB policy configuration submode)
map header
show module csm map
map retcode
Use the map retcode command to enable return error code checking and enter the return error code map submode. Use the no form of this command to remove the return code error checking from the configuration.
map name retcode
no map name
Syntax Description
name
Return error code map instance; the character string is limited to 15 characters.
retcode
Keyword to enter the return error code map submode.
Defaults
This command has no default settings.
Command Modes
Global configuration submode.
Command History
Examples
This example shows how to enable return error code checking:
SLB-Switch(config-module-csm)# map upnready retcodeRelated Commands
cookie-map (SLB policy configuration submode)
match protocol http cookie
show module csm map
match protocol http retcode
Use the match protocol http retcode command in SLB return code map configuration submode to specify return code thresholds, count and log return codes, and send syslog messages for return code events received from the servers. Use the no form of this command to remove the return code thresholds.
match protocol http retcode min max action {count | log | remove} threshold [reset seconds]
no match protocol http retcode min max
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB return code map configuration submode.
Usage Guidelines
The threshold and reset values are not configurable for the count action. These commands only are available for the log and remove actions.
Command History
Examples
This example shows how to specify return codes values to search for in an HTTP request:
SLB-Switch(config-slb-map-retcode)# match protocol http quigly retcode 30 50 action log 400 reset 30Related Commands
map retcode (SLB policy configuration submode
map url
Use the map url command to enter the SLB URL map mode and configure a URL map. Use the no form of this command to remove the URL map from the configuration.
map url-map-name url
no map url-map-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB URL map configuration submode.
Command History
Usage Guidelines
Any match of a URL regular expression in the URL map results in a successful match. A maximum of 1023 URLs can be configured to a map.
Examples
This example shows how to group URLs and associate them with a Content Switching policy:
SLB-Switch(config-module-csm)# map m1 urlSLB-Switch(config-slb-map-url)# match protocol http url /index.htmlSLB-Switch(config-slb-map-url)# match protocol http url /stocks/csco/SLB-Switch(config-slb-map-url)# match protocol http url *gifSLB-Switch(config-slb-map-url)# match protocol http url /st*SLB-Switch(config-slb-map-url)# exitSLB-Switch(config)Related Commands
match protocol http url
url-map (SLB policy configuration submode)
show module csm map
match protocol http url
Use the match protocol http url command in the SLB URL map configuration submode to add a URL regular expression to a URL map. Multiple match rules can be added to a URL map. Use the no form of this command to remove the URL regular expression from the URL map.
match protocol http [method method-expression] url url-expression
no match protocol http url [method method-expression] url url-expressionn
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB URL map configuration submode.
Usage Guidelines
URL regular expressions are based on the UNIX filename specification. URL expressions are stored in a cookie map in the form urln. URL expressions do not allow spaces and only one of the URLs in the map must be matched.
"*" means zero or more characters
"?" means exactly one character—the [Ctrl + V] key combination must be entered
"\" means escaped character
Bracketed range (for example, [0-9]) means matching any single character from the range
A leading ^ in a range means don't match any in the range
".\a" means alert (ASCII 7)
".\b" means backspace (ASCII 8
".\f" means form-feed (ASCII 12)
".\n" means newline (ASCII 10)
".\r" means carriage return (ASCII 13)
".\t" means tab (ASCII 9)
".\v" means vertical tab (ASCII 11)
".\0" means null (ASCII 0)
".\\" means backslash
".\x##" means any ASCII character as specified in two-digit hexadecimal notation
The method expression may be either one of the standard HTTP 1.1 method names (OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, or CONNECT) or a string you specify that must be matched exactly (PROTOPLASM).
Command History
1.1(1)
This command was introduced.
3.1(1)
HTTP method parsing support was introduced.
Examples
This example shows how to adds URL expressions to a URL map:
SLB-Switch(config-slb-map-url)# match protocol http url Host header-value XYZRelated Commands
map url
url-map (SLB policy configuration submode)
show module csm map
module csm
Use the module csm command to allow the association of load-balancing commands to a specific CSM module and enter the CSM module configuration submode for the specified slot. Use the no form of this command to remove the module csm configuration.
Note
module csm slot-number
no module csm slot-number
Syntax Description
Defaults
This command has no default settings.
Command Modes
Global configuration submode.
Command History
Usage Guidelines
If you want to use the new multiple module configuration, you must change the ip slb mode command to rp. An existing CSM configuration is migrated to the new configuration when you change the mode from csm to rp. A prompt appears requesting a slot number. Migrating from a multiple module configuration to a single module configuration is supported. Migrating the Cisco IOS SLB configuration to the CSM configuration is not supported.
Examples
This example shows how to configure a CSM:
SLB-Switch(config)# module csm 5SLB-Switch(config-module-csm)# vserver VS1Related Commands
natpool
Use the natpool command in module CSM configuration submode to configure NAT and create a client address pool. Use the no form of this command to remove a natpool configuration.
natpool pool-name start-ip end-ip {netmask netmask | prefix-length leading_1_bits}
no natpool pool-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Usage Guidelines
If you want to use client NAT, you must create at least one client address pool.
A maximum of 255 NAT pool addresses are available for any CSM.
Examples
This example shows how to configure a pool of addresses with the name web-clients, an IP address range from 128.3.0.1 through 128.3.0.254, and a subnet mask of 255.255.0.0:
SLB-Switch(config-module-csm)# natpool web-clients 128.3.0.1 128.3.0.254 netmask 255.255.0.0Related Commands
nat client (SLB serverfarm configuration submode)
show module csm natpoolowner
Use the owner command in module CSM configuration submode to configure an owner object. Use the no form of this command to remove an owner configuration.
owner name
no owner
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Usage Guidelines
You can define more than one virtual server with the same virtual IP address (VIP) and set the VIP connection watermark level to apply to a single VIP, which may correspond to multiple virtual servers. With the owner command, any virtual server has either zero or one owners. A particular owner can be associated with multiple virtual servers (typically, but not necessarily, with the same VIP). The VIP connection watermark applies to a specific owner. Once the sum of the number of open connections to all virtual servers in a particular owner reaches the VIP connection watermark level for that owner, new connections to any of these virtual servers are rejected by the CSM.
Examples
This example shows how to configure an owner object:
SLB-Switch(config-module-csm)# owner sequelRelated Commands
address
billing-info
contact-info
maxconnsaddress
Use the address command in the owner configuration submode to configure the address information for an owner object. Use the no form of this command to remove the address from the configuration.
address street-address-information
no address
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to configure an owner object:
SLB-Switch(config-owner)# address 125 marmalade streetRelated Commands
billing-info
Use the billing-info command in the owner configuration submode to configure billing information for an owner object. Use the no form of this command to remove an billing information from the configuration.
billing-info billing-address-information
no billing-info
Syntax Description
billing-info
Keyword to specify the owner's billing address.
billing-address-information
The owner's billing address.
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to configure an owner object:
SLB-Switch(config-owner)# billing-info 300 cordera avenueRelated Commands
contact-info
Use the contact-info command in owner configuration submode to configure an email address for an owner object. Use the no form of this command to remove the contact information from the owner configuration.
contact-info string
no contact-info
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to configure an owner object:
SLB-Switch(config-owner)# contact-info shaggy@angel.netRelated Commands
maxconns
Use the maxconns command in owner configuration submode to configure the maximum number of connections allowed for an owner object. Use the no form of this command to remove the maximum connections from the owner configuration.
maxconns number
no email-address
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to configure an owner object:
SLB-Switch(config-owner)# maxconns 300Related Commands
owner
address
billing-info
contact-infopolicy
Use the policy command to configure policies, associate attributes to a policy, and enter the policy configuration submode. In this submode, you can configure the policy attributes. The policy is associated with a virtual server in virtual server submode. Use the no form of this command to remove a policy.
policy policy-name
no policy policy-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Usage Guidelines
Policies establish rules for balancing connections to servers. They can contain URL maps, cookie maps, header maps, client groups, sticky groups, DSCP values, and server farms. The order in which policies are linked to a virtual server determines the precedence of the policy. When two or more policies match a requested URL, the policy with the highest precedence is selected.
You can create up to 12287 SLB policies for a given CSM module.
Note
Examples
This example shows how to configure a policy named policy_content:
SLB-Switch(config-module-csm)# policy policy_contentSLB-Switch(config-slb-policy)# serverfarm new_serverfarmSLB-Switch(config-slb-policy)# url-map url_map_1SLB-Switch(config-slb-policy)# exitRelated Commands
slb-policy (SLB virtual server configuration submode)
show module csm ownerclient-group
Use the client-group command in SLB policy configuration submode to associate an access list with the policy. Use the no form of this command to remove access list from the policy.
client-group {1-99 | std-access-list-name}
no client-group
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB policy configuration submode.
Command History
Usage Guidelines
Only client groups created with the ip access-list standard command can be associated with an SLB policy. Only one client-group can be associated with a given SLB policy.
Examples
This example shows how to configure a client group:
SLB-Switch(config-slb-policy)# client-group 44SLB-Switch(config-slb-policy)# exitRelated Commands
policy
ip access-list standard
show module csm ownercookie-map
Use the cookie-map command in SLB policy configuration submode to associate a list of cookies with a policy. Use the no form of this command to remove a cookie map.
cookie-map cookie-map-name
no cookie-map
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB policy configuration submode.
Command History
Usage Guidelines
Only one cookie map can be associated with a policy. Cookie maps are configured using the map cookie command. The cookie map name must match the name specified in the map cookie command.
Examples
This example shows how to configure a cookie-based SLB policy named policy_content:
SLB-Switch(config-module-csm)# policy policy_contentSLB-Switch(config-slb-policy)# serverfarm new_serverfarmSLB-Switch(config-slb-policy)# cookie-map cookie-map-1SLB-Switch(config-slb-policy)# exitSLB-Switch(config)Related Commands
policy
map cookie
show module csm ownerheader-map
Use the header-map command in SLB policy configuration submode to specify the HTTP header criteria to include in a policy. Use the no form of this command to remove a header map.
Note
header-map name
no header-map
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB policy configuration submode.
Command History
Usage Guidelines
Only one header map can be associated with a policy. The header map name must match the name specified in the map header command on page A-18.
Examples
This example shows how to configure a header-based policy named policy_content:
SLB-Switch(config-module-csm)# policy policy_contentSLB-Switch(config-slb-policy)# serverfarm new_serverfarmSLB-Switch(config-slb-policy)# header-map header-map-1SLB-Switch(config-slb-policy)# exitRelated Commands
policy
map header
show module csm ownerreverse-sticky
Use the reverse-sticky command to ensure that the CSM switches connections in the opposite direction back to the original source. Use the no form of this command to remove the reverse-sticky option from the policy or the default-policy of a virtual server.
reverse-sticky group-id
no reverse-sticky
Syntax Description
group-id
Number identifying the sticky group to which the virtual server belongs; the range is from 0 to 255.
Defaults
The default is no reverse-sticky. Sticky connections are not tracked.
The group ID default is 0. The sticky feature is not used for other virtual servers.
The network default is 255.255.255.255.Command Modes
SLB virtual server configuration submode.
Command History
1.1(1)
This command was introduced.
3.1(1)
The IP reverse-sticky command is introduced.
Examples
This example shows how to set the IP reverse-sticky feature:
SLB-Switch(config-module-csm)# vserver PUBLIC_HTTPSLB-Switch(config-slb-vserver)# reverse-sticky 60Related Commands
sticky
sticky-group (SLB policy submode)
show module csm sticky
show module csm vserver redirectserverfarm
Use the serverfarm command in the SLB policy configuration submode to associate a server farm with a policy. Use the no form of this command to remove the server farm from the policy.
serverfarm primary-serverfarm [backup sorry-serverfarm [sticky]]
no serverfarm
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB policy configuration submode.
Command History
1.1(1)
This command was introduced.
3.1(1)
The sorry server (backup server) option was added to this command.
Usage Guidelines
Use the serverfarm command to configure the server farm. Only one server farm can be configured per policy. The server farm name must match the name specified in the serverfarm module CSM configuration submode command. By default, the sticky option does not apply to the backup serverfarm. To remove the backup serverfarm, you can either use the serverfarm command without the backup option or use the no serverfarm command.
Examples
This example shows how to associate a server farm named central with a policy:
SLB-Switch(config-module-csm)# policy policySLB-Switch(config-slb-policy)# serverfarm central backup domino stickyRelated Commands
policy
reverse-sticky (module CSM configuration submode)
show module csm ownerset ip dscp
Use the set ip dscp command in the SLB policy configuration submode to mark packets that match the policy with a DSCP value. Use the no form of this command to stop marking packets.
set ip dscp dscp-value
no set ip dscp
Syntax Description
Defaults
The default is that the CSM does not store DSCP values.
Command Modes
SLB policy configuration submode.
Command History
Examples
This example shows how to mark packets to match a policy named policy_content:
SLB-Switch(config-module-csm)# policy policy_contentSLB-Switch(config-slb-policy)# set ip dscp 22Related Commands
sticky-group
Use the sticky-group command in the SLB policy configuration submode to associate a sticky group and the sticky group attributes to the policy. Use the no form of this command to remove the sticky group from the policy.
sticky-group group-id
no sticky-group
Syntax Description
Defaults
The default is 0, which means that no connections are sticky.
Command Modes
SLB policy configuration submode.
Command History
Usage Guidelines
The group-id must match the ID specified in the sticky command; the range is from 1 to 255.
Examples
This example shows how to configure a sticky group:
SLB-Switch(config-module-csm)# policy policy1SLB-Switch(config-slb-policy)# sticky-group 5Related Commands
policy
sticky
show module csm owner
show module csm stickyurl-map
Use the url-map command in SLB policy configuration submode to associate a list of URLs with the policy. Use the no form of this command to remove the URL map from the policy.
url-map url-map-name
no url-map
Syntax Description
Defaults
The default is no URL map.
Command Modes
SLB policy configuration submode.
Command History
Usage Guidelines
Only one URL map can be associated with a policy. URL maps are configured using the map url command.
Examples
This example shows how to associate a list of URLs with a policy named assembly:
SLB-Switch(config-module-csm)# policy policySLB-Switch(config-slb-policy)# url-map assemblyRelated Commands
policy
map url
show module csm ownerprobe
Use the probe command to configure a probe and probe type for health monitoring and to enter the probe configuration submode. Use the no form of this command to remove a probe from the configuration.
probe probe-name {http | icmp | telnet | tcp | ftp | smtp | dns | kal-ap-upd}
no probe probe-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Usage Guidelines
A probe can be assigned to a server farm in serverfarm submode.
When configuring kal-ap-udp type probes, the port submode command is not used to specify the destination UDP port to query. Use theCSM environment variable GSLB_KALAP_UDP_PORT instead. The default is port 5002.
Also, to specify probe frequency and the number of retries for KAL-AP, ICMP, HTTP and DNS probes when associated with a GSLB serverfarm environment, the following variables must be used instead of the probe submode commands:
GSLB_KALAP_PROBE_FREQ 10GSLB_KALAP_PROBE_RETRIES 3GSLB_ICMP_PROBE_FREQ 10GSLB_ICMP_PROBE_RETRIES 3GSLB_HTTP_PROBE_FREQ 10GSLB_HTTP_PROBE_RETRIES 2GSLB_DNS_PROBE_FREQ 10GSLB_DNS_PROBE_RETRIES 3Examples
This example shows how to configure an HTTP probe named TREADER:
SLB-Switch(config-module-csm)# probe TREADER httpRelated Commands
probe (SLB serverfarm configuration submode)
show module csm probeaddress (dns)
Use the address command in SLB DNS probe configuration submode to specify an IP address of the real server used by DNS to resolve requests. Use the no form of this command to remove the address.
address ip-address
no address ip-address
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB DNS probe configuration submode.
Command History
Usage Guidelines
Multiple addresses can be configured for a DNS probe.
Examples
This example shows how to configure an IP address of the DNS server:
SLB-Switch(config-slb-probe-dns)# address 101.23.45.36Related Commands
probe
address (icmp)
show module csm probeaddress (icmp)
Use the address command in SLB ICMP probe configuration submode to specify a destination IP address for health monitoring. Use the no form of this command to remove the address.
address ip-address
no address
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB ICMP probe configuration submode.
Command History
Usage Guidelines
One address can be configured for an ICMP probe.
Examples
This example shows how to configure an IP address of the real server:
SLB-Switch(config-slb-probe-icmp)# address 101.23.45.36Related Commands
probe
address (dns)
show module csm probecredentials
Use the credentials command in the SLB HTTP probe configuration submode to configure basic authentication values for an HTTP probe. Use the no form of this command to remove the credentials configuration.
credentials username [password]
no credentials
Syntax Description
username
Name that appears in the HTTP header.
password
(Optional) Password that appears in the HTTP header.
Defaults
This command has no default settings.
Command Modes
SLB HTTP probe configuration submode.
Command History
Usage Guidelines
This command is for HTTP probes.
Examples
This example shows how to configure authentication for an HTTP probe:
SLB-Switch(config-slb-probe-http)# credentials seamless abercrombieRelated Commands
expect status
Use the expect status command in the SLB HTTP/FTP/Telnet/SMTP probe configuration submode to configure a status code for the probe. Use the no form of this command to remove the status code from the configuration.
expect status min-number [max-number]
no expect status min-number [max-number]
Syntax Description
min-number
Single status code if max-number is not specified.
max-number
(Optional) Maximum status code in a range.
Defaults
The default range is 0 to 999 (any response from the server is valid). Both min-number and max-number can be any number between 0 and 999, as long as max-number is not lower than min-number.
For example:
expect status 5 is the same as expect status 5 5
expect status 0 specifies a range of 0 to 4
expect status 900 999 specifies a range of 900 to 999.
You can specify many expected status ranges.
Command Modes
SLB HTTP/FTP/Telnet/SMTP probe configuration submode.
Command History
Usage Guidelines
This command is for HTTP, FTP, Telnet, and SMTP probes. You can specify multiple status code ranges with this command by entering one command at a time. If you specify the max-number value, this number is used as the minimum status code of a range. If you specify no maximum number, this command uses a single number (min-number). If you specify both min-number and max-number values, this command uses the range between the numbers.
Note
Examples
This example shows how to configure an HTTP probe with multiple status code ranges:
SLB-Switch(config-slb-probe-http)# expect status 34 99SLB-Switch(config-slb-probe-http)# expect status 0 33SLB-Switch(config-slb-probe-http)#Related Commands
failed
Use the failed command in the SLB probe configuration submode to set the time to wait before probing a failed server. Use the no form of this command to reset the time to wait before probing a failed server to default.
failed failed-interval
no failed
Syntax Description
Defaults
The default value for the failed interval is 300 seconds.
Command Modes
SLB probe configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Examples
This example shows how to configure a failed server probe for 200 seconds:
SLB-Switch(config-slb-probe-http)# failed 200Related Commands
header
Use the header command in the SLB HTTP probe configuration submode to configure a header field for the HTTP probe. Use the no form of this command to remove the credentials configuration.
header field-name [field-value]
no header field-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB HTTP probe configuration submode.
Command History
Usage Guidelines
You can configure multiple headers for each HTTP probe. The length of the field-name value plus the length of the field-value value plus 4 (for ":", space, and CRLF) cannot exceed 255 characters. This command is for HTTP probes.
Examples
This example shows how to configure a header field for the HTTP probe:
SLB-Switch(config-slb-probe-http)# header abacadabraRelated Commands
interval
Use the interval command in the SLB probe configuration submode to set the time interval between probes. Use the no form of this command to reset the time interval between probes to default.
interval seconds
no interval
Syntax Description
seconds
Number of seconds to wait between probes from the end of the previous probe to the beginning of the next probe; the range is from 2 to 65535.
Defaults
The default value for the interval between probes is 120 seconds.
Command Modes
SLB probe configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Examples
This example shows how to configure a probe interval of 150 seconds:
SLB-Switch(config-slb-probe-http)# interval 150Related Commands
kal-ap-udp
Use the kal-ap-udp command in the SLB probe configuration submode to set a probe for a Global Server Load Balancing (GSLB) target for load information. Use the no form of this command to remove the GSLB probe.
kal-ap-udp seconds
no kal-ap-udp
Syntax Description
seconds
Number of seconds to wait between probes from the end of the previous probe to the beginning of the next probe; the range is from 2 to 65535.
Defaults
The default value for the interval between probes is 120 seconds.
Command Modes
SLB probe configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Examples
This example shows how to configure a probe interval of 150 seconds:
SLB-Switch(config-slb-probe-http)# interval 150Related Commands
name
Use the name command in the SLB DNS probe configuration submode to configure a domain name for the DNS probe. Use the no form of this command to remove the name from the configuration.
name domain-name
no name
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB DNS probe configuration submode.
Command History
Examples
This example shows how to specify the probe name that is resolved by the DNS server:
SLB-Switch(config-slb-probe-dns)# name astroRelated Commands
port
Use the port command in the SLB probe configuration submode to configure an optional port for the DNS probe. Use the no form of this command to remove the port from the configuration.
port port-number
no port
Syntax Description
Defaults
The default value for the port number is 0.
Command Modes
This command is available in all SLB probe configuration submodes except ICMP.
Command History
Usage Guidelines
When the port of a health probe is specified as 0, the health probe uses the configured port number from the real server (if a real server is configured) or the configured port number from the virtual server (if a virtual server is configured and no port is configured for the real server). The default port value is 0. For the ICMP probes, where there is no port number, the port value is ignored. The port command is available for all probe types except ICMP.
Examples
This example shows how to specify the port for the DNS server:
SLB-Switch(config-slb-probe-dns)# port 63Related Commands
open
Use the open command in the SLB HTTP/TCP/FTP/Telnet/SMTP probe configuration submode to set the time to wait for a TCP connection. Use the no form of this command to reset the time to wait for a TCP connection to default.
open open-timeout
no open
Syntax Description
open-timeout
Maximum number of seconds to wait for the TCP connection; the range is from 1 to 65535.
Defaults
The default value for the open timeout is 10 seconds.
Command Modes
SLB HTTP/TCP/FTP/Telnet/SMTP probe configuration submode.
Command History
Usage Guidelines
This command is not used for any non-TCP probes, for example, ICMP or DNS.
Note
Examples
This example shows how to configure a time to wait for a TCP connection of 5 seconds:
SLB-Switch(config-slb-probe-http)# open 5Related Commands
receive
Use the receive command in the SLB probe configuration submode to set the time to wait for a reply from a server. Use the no form of this command to reset the time to wait for a reply from a server to default.
receive receive-timeout
no receive
Syntax Description
Defaults
The default value for a receive timeout is 10 seconds.
Command Modes
SLB probe configuration submode.
Command History
Usage Guidelines
This command is available for all probe types, except TCP.
Note
Examples
This example shows how to configures a time to wait for a reply from a server to 5 seconds:
SLB-Switch(config-slb-probe-http)# receive 5Related Commands
request
Use the request command in the SLB HTTP probe configuration submode to configure the request method used by the HTTP probe. Use the no form of this command to remove the request method from the configuration.
request [method {get | head}]] [url path]
no request [method {get | head}] [url path]
Syntax Description
Defaults
The default path is /.
The default method is get.Command Modes
SLB HTTP probe configuration submode.
Command History
Usage Guidelines
The CSM supports only the get and head request methods. It does not support post and other methods. This command is for HTTP probes.
Examples
This example shows how to configure a request method for the probe configuration:
SLB-Switch(config-slb-probe-http)# request method headRelated Commands
retries
Use the retries command in the SLB probe configuration submode to set the number of failed probes that are allowed before marking the server failed. Use the no form of this command to reset the number of failed probes allowed before marking a server as failed to default.
retries retry-count
no retries
Syntax Description
retry-count
Number of probes to wait before marking a server as failed; the range is from 0 to 65535.
Defaults
The default value for retries is 3.
Command Modes
SLB probe configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Note
Examples
This example shows how to configure a retry count of 3:
SLB-Switch(config-slb-probe-http)# retries 3Related Commands
probe script
Use the probe probe-name script command to create a script probe and enter the probe script configuration submode. Use the no form of this command to remove the probe from the configuration.
probe probe_name script
no probe probe_name script
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB probe script configuration submode.
Usage Guidelines
This command enters a probe sub-mode that is similar to the existing CSM health probe sub-modes (such as HTTP, TCP, DNS, and SMTP). The script probe sub-mode contains the existing probe sub-mode commands failed, interval, open, receive, and retries.
Command History
Examples
This example shows how to create a script probe:
SLB-Switch(config-module-csm)# ip slb script file tftp://192.168.10.102/csmScriptsSLB-Switch(config-probe-script)# script echoProbe.tclSLB-Switch(config-probe-script)# interval 10SLB-Switch(config-probe-script)# retries 1SLB-Switch(config-probe-script)# failed 30Related Commands
probe
script
failed
interval
open
receive
retries
show module csm probescript
Use the script script-name [arg1 [arg2...]] command to create a script probe. Use the no form of this command to remove the probe from the configuration.
script script_name [arg1 [arg2...]]
no script script_name [arg1 [arg2...]]
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB probe script configuration submode.
Usage Guidelines
This command enters a probe sub-mode that is similar to the existing CSM health probe sub-modes (such as HTTP, TCP, DNS, and SMTP). The script probe sub-mode contains the existing probe sub-mode commands failed, interval, open, receive, and retries.
Command History
Examples
This example shows how to create a script probe:
SLB-Switch(config-module-csm)# ip slb script file tftp://192.168.10.102/csmScriptsSLB-Switch(config-probe-script# script echoProbe.tclSLB-Switch(config-probe-script# interal 10SLB-Switch(config-probe-script# retries 1SLB-Switch(config-probe-script# failed 30Related Commands
probe
failed
interval
open
receive
retries
show module csm probefailed
Use the failed command in the SLB probe scirpt configuration submode to set the time to wait before probing a failed server. Use the no form of this command to reset the time to wait before probing a failed server to default.
failed failed-interval
no failed
Syntax Description
Defaults
The default value for the failed interval is 300 seconds.
Command Modes
SLB probe script configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Examples
This example shows how to configure a failed server probe for 200 seconds:
SLB-Switch(config-slb-probe-http)# failed 200Related Commands
probe
script
interval
open
receive
retries
show module csm probeinterval
Use the interval command in the SLB probe script configuration submode to set the time interval between probes. Use the no form of this command to reset the time interval between probes to default.
interval seconds
no interval
Syntax Description
seconds
Number of seconds to wait between probes from the end of the previous probe to the beginning of the next probe; the range is from 2 to 65535.
Defaults
The default value for the interval between probes is 120 seconds.
Command Modes
SLB probe script configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Examples
This example shows how to configure a probe interval of 150 seconds:
SLB-Switch(config-slb-probe-http)# interval 150Related Commands
probe
script
failed
open
receive
retries
show module csm probeopen
Use the open command in the SLB probe script configuration submode to set the time to wait for a reply from a server. Use the no form of this command to reset the time to wait for a reply from a server to default.
open open-timeout
no open
Syntax Description
Defaults
The default value for a receive timeout is 10 seconds.
Command Modes
SLB probe script configuration submode.
Command History
Usage Guidelines
This command is available for all probe types, except TCP.
Note
Examples
This example shows how to configures a time to wait for a reply from a server to 5 seconds:
SLB-Switch(config-slb-probe-http)# open 5Related Commands
probe
script
failed
interval
receive
retries
show module csm probereceive
Use the receive command in the SLB probe configuration submode to set the time to wait for a reply from a server. Use the no form of this command to reset the time to wait for a reply from a server to default.
receive receive-timeout
no receive
Syntax Description
Defaults
The default value for a receive timeout is 10 seconds.
Command Modes
SLB probe configuration submode.
Command History
Usage Guidelines
This command is available for all probe types, except TCP.
Note
Examples
This example shows how to configures a time to wait for a reply from a server to 5 seconds:
SLB-Switch(config-slb-probe-http)# receive 5Related Commands
probe
script
failed
interval
open
retries
show module csm proberetries
Use the retries command in the SLB probe script configuration submode to set the number of failed probes that are allowed before marking the server failed. Use the no form of this command to reset the number of failed probes allowed before marking a server as failed to default.
retries retry-count
no retries
Syntax Description
retry-count
Number of probes to wait before marking a server as failed; the range is from 0 to 65535.
Defaults
The default value for retries is 3.
Command Modes
SLB probe script configuration submode.
Command History
Usage Guidelines
This command is used for all probe types.
Note
Examples
This example shows how to configure a retry count of 3:
SLB-Switch(config-slb-probe-script)# retries 3Related Commands
probe
script
failed
interval
open
receive
show module csm probereal
Use the real command in the SLB serverfarm configuration submode to identify a real server that is a member of the server farm and enter the real server configuration submode. Use the no form of this command to remove the real server from the configuration.
real ip-address [port]
no real ip-address [port]
Syntax Description
ip-address
Real server IP address.
port
(Optional) Port translation for the real server; the range is from 1 to 65535.
Defaults
The default is no port translation for the real server.
Command Modes
SLB serverfarm configuration submode.
Usage Guidelines
Use this command to identify a real server that is a member of the server farm and enter the real server configuration submode.
Note
Command History
Examples
This example shows how to identify a real server and enter the real server submode:
SLB-Switch(config-slb-sfarm)# real 102.43.55.60SLB-Switch(config-slb-real)#Related Commands
serverfarm
show module csm real
show module csm serverfarm
inservice
Use the inservice command in the SLB real server configuration submode to enable the real servers. Use the no form of this command to remove a real server from service.
inservice
no inservice
Syntax Description
This command has no arguments or keywords.
Defaults
The default for a real server is no inservice.
Command Modes
SLB real server configuration submode.
Command History
Examples
This example shows how to enable a real server:
SLB-Switch(config-slb-sfarm)# real 10.2.2.1SLB-Switch(config-slb-real)# inserviceRelated Commands
real (SLB serverfarm submode)
show module csm realmaxconns
Use the maxconns command in the SLB real server configuration submode to limit the number of active connections to the real server. Use the no form of this command to change the maximum number of connections to its default value.
maxconns max-conns
no maxconns
Syntax Description
max-conns
Maximum number of active connections on the real server at any one point in time; the range is from 1 to 4294967295.
Defaults
The default value is the maximum value or infinite (not monitored).
Command Modes
SLB real server configuration submode.
Command History
Usage Guidelines
When you specify minconns, you must also specify the maxconns command.
Examples
This example shows how to limit the connections to a real server:
SLB-Switch(config-slb-sfarm)# real 10.2.2.1SLB-Switch(config-slb-real)# maxconns 4000Related Commands
minconns (real server submode)
real (serverfarm submode)
show module csm realminconns
Use the minconns command in the SLB real server configuration submode to establish a minimum connection threshold for the real server. Use the no form of this command to change the minimum number of connections to the default value.
minconns min-cons
no minconns
Syntax Description
min-cons
Minimum number of connections allowed on the real server; the range is from 0 to 4294967295.
Defaults
The default value is no minconns.
Command Modes
SLB real server configuration submode.
Command History
Usage Guidelines
When the maxconns threshold is exceeded, the CSM stops sending connections until the number of connections falls below the minconns threshold. This value must be lower than the maximum number of connections configured by the maxconns command. When you specify minconns, you must also specify the maxconns command.
Examples
This example shows how to establish a minimum connection threshold for a server:
SLB-Switch(config-slb-sfarm)# real 102.2.2.1SLB-Switch(config-slb-real)# minconns 4000Related Commands
maxconns (real server submode)
real (serverfarm submode)
show module csm realprobe
Use the probe command in the SLB real server configuration submode to configure a probe for the real server. Use the no form of this command to remove the probe from the configuration.
probe probe-name tag string
no probe
Syntax Description
probe-name
Names the probe.
tag
Keyword to specify a tag for the probe.
string
Specifies a string to identify the probe.
Defaults
This command has no default values.
Command Modes
SLB real server configuration submode.
Command History
Examples
This example shows how to configurre a probe for a server:
SLB-Switch(config-slb-sfarm)# real 102.2.2.1SLB-Switch(config-slb-real)# probe mission tag 12345678Related Commands
real (serverfarm submode)
show module csm realredirect-vserver
Use the redirect-vserver command in the SLB real server configuration submode to configure a real server to receive traffic redirected by a redirect virtual server. Use the no form of this command to specify that traffic is not redirected to the real server.
redirect-vserver name
no redirect-vserver
Syntax Description
Defaults
The default is no redirect-vserver.
Command Modes
SLB real server configuration submode.
Command History
Usage Guidelines
Mapping real servers to redirect virtual servers provides persistence for clients to real servers across TCP sessions. Before using this command, you must create the redirect virtual server in serverfarm submode with the redirect-vserver command.
Examples
This example shows how to map a real server to a virtual server:
SLB-Switch(config-slb-sfarm)# real 10.2.2.1SLB-Switch(config-slb-real)# redirect-vserver timelyRelated Commands
real (SLB serverfarm configuration submode)
redirect-vserver (SLB serverfarm configuration submode)
show module csm real
show module csm vserver redirectweight
Use the weight command in the SLB real server configuration submode to configure the capacity of the real servers in relation to the other real servers in the server farm. Use the no form of this command to change the server's weight to its default capacity.
weight weighting-value
no weight
Syntax Description
Defaults
The weighting value default is 8.
Command Modes
SLB real server configuration submode.
Command History
Examples
This example shows how to configure the weight of a real server:
SLB-Switch(config-slb-sfarm)# real 10.2.2.1SLB-Switch(config-slb-real)# weight 8Related Commands
predictor (SLB serverfarm submode)
real (SLB serverfarm submode)
show module csm realredirect-vserver
Use the redirect-vserver command to specify the name of a virtual server to receive traffic redirected by the server farm and enter redirect virtual server configuration submode. Use the no form of this command to remove the redirect virtual server.
redirect-vserver name
no redirect-vserver name
Syntax Description
name
Name of the virtual server to receive traffic redirected by the server farm; the virtual server name can be no longer than 15 characters.
Defaults
This command has no default settings.
Command Modes
SLB serverfarm configuration submode.
Command History
Examples
This example shows how to name the virtual server:
SLB-Switch(config-slb-sfarm)# redirect-vserver quanticoRelated Commands
real (SLB serverfarm submode)
redirect-vserver (SLB real server submode)
serverfarm
show module csm serverfarm
show module csm vserver redirectadvertise
Use the advertise command in the SLB redirect virtual server configuration mode to allow the CSM to advertise the IP address of the virtual server as host-route. Use the no form of this command to stop advertising the host-route for this virtual server.
advertise [active]
no advertise
Syntax Description
active
(Optional) Keyword to allow the CSM to advertise the IP address of the virtual server as host-route.
Defaults
The default for network mask is 255.255.255.255 if the network mask is not specified.
Command Modes
SLB redirect virtual server configuration submode.
Usage Guidelines
Without the active option, the CSM always advertises the virtual server IP address whether or not there is any active real server attached to this virtual server.
Command History
Examples
This example shows how to restrict a client from using the redirect virtual server:
SLB-Switch(config-slb-redirect-vs)# advertise 10.5.2.1 excludeRelated Commands
vserver
show module csm vserver redirectclient
Use the client command in the SLB redirect virtual server configuration mode to restrict which clients are allowed to use the redirect virtual server. Use the no form of this command to remove the client definition from the configuration.
client ip-address [network-mask] [exclude]
no client ip-address [network-mask]
Syntax Description
ip-address
Client's IP address.
network-mask
(Optional) Client's IP mask.
exclude
(Optional) Keyword to specify that the IP address is disallowed.
Defaults
The default for network mask is 255.255.255.255 if the network mask is not specified.
Command Modes
SLB redirect virtual server configuration submode.
Usage Guidelines
The network mask is applied to the source IP address of incoming connections and the result must match the IP address before the client is allowed to use the virtual server. If you do not specify exclude, the IP address and network mask combination is allowed.
Command History
Examples
This example shows how to restrict a client from using the redirect virtual server:
SLB-Switch(config-slb-redirect-vs)# client 10.5.2.1 excludeRelated Commands
client-group (SLB policy submode)
vserver
show module csm vserver redirectidle
Use the idle command in the SLB redirect virtual server configuration submode to specify the connection idle timer duration. Use the no form of this command to disable the idle timer.
idle duration
no idle
Syntax Description
Defaults
The default is 3600.
Command Modes
SLB redirect virtual server configuration submode.
Command History
Examples
This example shows how to specify the connection idle timer duration:
SLB-Switch(config-slb-redirect-vs)# idle 7Related Commands
redirect-vserver (SLB serverfarm submode)
show module csm vserver redirectinservice
Use the inservice command in the SLB redirect virtual server configuration submode to enable the real server for use by the CSM. If this command is not specified, the virtual server is defined but not used. Use the no form of this command to disable the virtual server.
inservice
no inservice
Syntax Description
This command has no arguments or keywords.
Defaults
The default is no inservice.
Command Modes
SLB redirect virtual server configuration submode.
Command History
Examples
This example shows how to enable a redirect virtual server for use by the CSM:
SLB-Switch(config-slb-redirect-vs)# inserviceRelated Commands
redirect-vserver (SLB serverfarm submode)
show module csm vserver redirectreplicate csrp
Use the replicate csrp command in the SLB redirect virtual server configuration submode to enable connection redundancy. Use the no form of this command to remove connection redundancy.
replicate csrp
no replicate csrp
Syntax Description
This command has no keywords or arguments.
Defaults
The default is no replicate csrp.
Command Modes
SLB virtual server configuration submode.
Command History
Examples
This example shows how to enable connection redundancy:
SLB-Switch(config-slb-redirect-vs)# replicate csrpRelated Commands
vserver
show module csm vserver redirectssl
Use the ssl command in the SLB redirect virtual server configuration submode to redirect an HTTP request to either HTTPS (SSL)_ or the FTP service. Use the no form of this command to reset the redirect of an HTTP request to an HTTP service.
ssl {https | ftp | ssl-port-number}
no ssl
Syntax Description
Defaults
The default is no ssl forwarding.
Command Modes
SLB redirect virtual server configuration submode.
Command History
Examples
This example shows how to enable SSL forwarding:
SLB-Switch(config-slb-redirect-vs)# ssl 443Related Commands
redirect-vserver (SLB serverfarm submode)
show module csm vserver redirectvirtual
Use the virtual command in SLB redirect virtual server configuration submode to specify the virtual server's IP address, the protocol used for traffic, and the port the protocol is using. Use the no form of this command to reset the virtual server to its defaults.
virtual v_ipaddress tcp port
no virtual v_ipaddress
Syntax Description
v_ipaddress
Redirect virtual server's IP address.
tcp
Keyword to specify the protocol used for redirect virtual server traffic.
port
Port number used by the protocol.
Defaults
The default IP address is 0.0.0.0, which prevents packet forwarding.
Command Modes
SLB redirect virtual server configuration submode.
Command History
Examples
This example shows how to specify the virtual server's IP address, the protocol for redirect virtual server traffic, and the port number used by the protocol:
SLB-Switch(config-slb-redirect)# virtual 130.32.44.50 tcp 80Related Commands
redirect-vserver (SLB serverfarm submode)
show module csm vserver redirectvlan
Use the vlan command in the SLB redirect virtual server submode to define which source VLANs can be accessed on the redirect virtual server. Use the no form of this command to remove the VLAN.
vlan {vlan-number | all}
no vlan
Syntax Description
vlan-number
VLAN the virtual server may access.
all
(Optional) Keyword to specify all VLANs are accessed by the virtual server.
Defaults
The default is all VLANs.
Command Modes
SLB virtual server configuration submode.
Command History
Examples
This example shows how to specify a VLAN for redirect virtual server access:
SLB-Switch(config-slb-redirect-vs)# vlan 5Related Commands
sticky
sticky-group (SLB policy submode)
show module csm sticky
show module csm vserver redirectwebhost backup
Use the webhost backup command in SLB redirect virtual server configuration submode to specify a backup string sent in response to HTTP requests. Use the no form of this command to disable the backup string.
webhost backup backup-string [301 | 302]
webhost backup
Syntax Description
Defaults
The default status code is 302.
Command Modes
SLB redirect virtual server configuration submode.
Usage Guidelines
This command is used in situations where the redirect virtual server has no available real servers. 301 or 302 is used to specify the redirect code. The backup string may include a %p at the end to indicate inclusion of the path in the HTTP redirect location statement field.
Command History
Examples
This example shows how to specify a backup string that is sent in response to HTTP requests:
SLB-Switch(config-slb-redirect-vs)# webhost backup www.mybackup.com%p 301Related Commands
redirect-vserver (SLB serverfarm submode)
show module csm vserver redirectwebhost relocation
Use the webhost relocation command in the SLB redirect virtual server configuration submode to specify a relocation string sent in response to HTTP requests. Use the no form of this command to disable the relocation string.
webhost relocation relocation string [301 | 302]
no webhost relocation
Syntax Description
Defaults
The default status code is 302.
Command Modes
SLB redirect virtual server configuration submode.
Usage Guidelines
The backup string may include a %p at the end to indicate inclusion of the path in the HTTP redirect location statement field.
Command History
Examples
This example shows how to specify a relocation string that is sent in response to HTTP requests:
SLB-Switch(config-slb-redirect-vs)# webhost relocation www.myhome1.com%p 301Related Commands
redirect-vserver (SLB serverfarm submode)
show module csm vserver redirectscript file
Use the script file command to load scripts into a script file. Use the no form of this command to remove the script file command from the configuration.
script file file-url
no script file
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Usage Guidelines
The file-url is a standard Cisco IOS file name such as bootflash:webprobe.tcl.
Command History
Examples
This example shows how to load scripts into a script file:
SLB-Switch(config-module-csm)# script file file-urlRelated Commands
script task
Use the script task command to run a standalone task. Use the no form of this command to remove the standalone task from the configuration.
script task script-index script-name [arg1 [arg2...]]
no script task script-index
Syntax Description
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Command History
Examples
This example shows how to run a standalone script:
SLB-Switch(config-module-csm)# script task 30 filerunRelated Commands
serverfarm
Use the serverfarm command to identify a server farm and enter the serverfarm configuration submode. Use the no form of this command to remove the server farm from the configuration.
serverfarm serverfarm-name
no serverfarm serverfarm-name
Syntax Description
serverfarm-name
Character string used to identify the server farm; the character string is limited to 15 characters.
Defaults
This command has no default settings.
Command Modes
Module CSM configuration submode.
Usage Guidelines
Use this command to enter the server farm configuration submode to configure the load-balancing algorithm (predictor), a set of real servers, and the attributes (NAT, probe, and bindings) of the real servers.
Command History
Examples
This example shows how to identify a server farm named PUBLIC and change the CLI to server farm configuration mode:
SLB-Switch(config-module-csm)# serverfarm PUBLICRelated Commands
reverse-sticky (SLB policy configuration submode)
serverfarm (SLB virtual server configurations submode)
show module csm serverfarmbindid
Use the bindid command in the SLB serverfarm configuration submode to assign a unique ID to allow the DFP agent to differentiate a real server in one server farm versus another server farm. Use the no form of this command to disable the bindid.
bindid [bind-id]
no bindid
Syntax Description
Defaults
The default is 0.
Command Modes
SLB serverfarm configuration submode.
Usage Guidelines
The single real server is represented as multiple instances of itself, each having a different bind identification. DFP uses this identification to identify a given weight for each instance of the real server.
Command History
Examples
This example shows how to bind a server to multiple virtual servers:
SLB-Switch(config-slb-sfarm)# bindid 7Related Commands
dfp
serverfarm
show module csm serverfarmfailaction purge
Use the failaction purge command in the SLB serverfarm configuration submode to set the behavior of connections to real servers that have failed. Use the no form of this command to disable the behavior of connections to real servers that have failed.
failaction purge
no failaction purge
Syntax Description
This command has no arguments or keywords.
Defaults
The default is no failaction purge.
Command Modes
SLB serverfarm configuration submode.
Usage Guidelines
With this command enabled, connections to a real server in the server farm are purged when the real server goes down. This feature is required for VPN load balancing.
Command History
Examples
This example shows how to set the behavior of connections to real servers that have failed:
SLB-Switch(config-slb-sfarm)# failaction purgeRelated Commands
dfp
serverfarm
show module csm serverfarmhealth
Use the health command in the SLB serverfarm configuration submode to set the retry attempts to real servers that have failed. Use the no form of this command to disable the retries or the time to wait for connections to real servers that have failed.
health retries count failed seconds
no health
Syntax Description
Defaults
There are no default settings.
Command Modes
SLB serverfarm configuration submode.
Command History
Examples
This example shows how to set the behavior of connections to real servers that have failed:
SLB-Switch(config-slb-sfarm)# health retries 20 failed 200Related Commands
dfp
serverfarm
show module csm serverfarmnat client
Use the nat client command in SLB serverfarm configuration submode to specify a set of client NAT pool addresses that should be used to perform the NAT function on clients connecting to this server farm. Use the no form of this command to remove the NAT pool from the configuration.
nat client client-pool-name
no nat client
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB serverfarm configuration submode.
Usage Guidelines
Use this command to enable client NAT. If client NAT is configured, the client address and port number in load-balanced packets are replaced with an IP address and port number from the specified client NAT pool. This client pool name must match the pool name entered from a previous natpool command.
Command History
Examples
This example shows how to specify NAT on the client:
SLB-Switch(config-slb-sfarm)# nat client whishersRelated Commands
natpool
serverfarm
nat server
predictor
show module csm serverfarmnat server
Use the nat server command in SLB serverfarm configuration submode to specify NAT to servers in this server farm. Use the no form of this command to disable server NAT.
nat server
no nat server
Syntax Description
This command has no arguments or keywords.
Defaults
Server NAT is enabled by default.
Command Modes
SLB server farm configuration submode.
Usage Guidelines
Use this command to enable server NAT. If server NAT is configured, the server address and port number in load-balanced packets are replaced with an IP address and port number of one of the real servers in the server farm.
Note
Command History
Examples
This example shows how to specify NAT on the server:
SLB-Switch(config-slb-sfarm)# nat serverRelated Commands
serverfarm
nat client
predictor
show module csm serverfarmpredictor
Use the predictor command in the SLB serverfarm configuration submode to specify the load-balancing algorithm for the server farm. Use the no form of this command to remove the load-balancing algorithm.
predictor {roundrobin | leastconns | hash url | hash address [source | destination] [ip-netmask] | forward}]
no predictor
Syntax Description
Defaults
The default algorithm is round robin.
Command Modes
SLB serverfarm configuration submode.
Usage Guidelines
Use this command to define the load-balancing algorithm used in choosing a real server in the server farm. If you do not specify the predictor command, the default algorithm is roundrobin. Using the no form of this command changes the predictor algorithm to the default algorithm.
Note
The portion of the URL to hash is based on the expressions configured for the virtual server submode command url-hash.
No real servers are needed. The server farm is actually a route forwarding policy with no real servers associated with it.
Command History
Examples
This example shows how to specify the load-balancing algorithm for the server farm:
SLB-Switch(config-module-csm)# serverfarm PUBLICSLB-Switch(config-slb-sfarm)# predictor leastconnsRelated Commands
nat client
nat server
maxconns
minconns
serverfarm
show module csm serverfarm
serverfarm (SLB virtual server configuration submode)probe
Use the probe command in the SLB serverfarm configuration submode to associate a probe with a server farm. Use the no form of this command to disable a specific probe.
probe probe-name
no probe probe-name
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB serverfarm configuration submode.
Usage Guidelines
Each server farm can be associated with multiple probes of the same or different protocols. Protocols supported by the CSM include HTTP, ICMP, TCP, FTP, SMTP, Telnet, and DNS.
Command History
Examples
This example shows how to associate a probe with a server farm:
SLB-Switch(config-slb-sfarm)# probe generalRelated Commands
probe (Module CSM configuration submode)
serverfarm
show module csm probe
show module csm serverfarmretcode-map
Use the retcode-map command in the SLB serverfarm configuration submode to assign a return code map to a server farm. Use the no form of this command to disable a specific probe.
retcode-map retcodemap_name
no retcode-map
Syntax Description
Defaults
This command has no default settings.
Command Modes
SLB serverfarm configuration submode.
Command History
Examples
This example shows how to associate a probe with a server farm:
SLB-Switch(config-slb-sfarm)# retcode-map return_statsRelated Commands
map retcode (Module CSM configuration submode)
serverfarm
show module csm serverfarmshow module csm arp
Use the show module csm slot arp command to display the CSM ARP cache.
show module csm slot arp
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb arp.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display the CSM ARP cache:
SLB-Switch# show module csm 4 arpInternet Address Physical Interface VLAN Type Status--------------------------------------------------------------------10.10.3.100 00-01-64-F9-1A-02 0 VSERVER local10.10.3.1 00-D0-02-58-B0-00 11 GATEWAY up(0 misses)10.10.3.2 00-30-F2-71-6E-10 11/12 --SLB-- local10.10.3.10 00-D0-B7-82-38-97 12 REAL up(0 misses)10.10.3.20 00-D0-B7-82-38-97 12 REAL up(0 misses)10.10.3.30 00-D0-B7-82-38-97 12 REAL up(0 misses)10.10.3.40 00-00-00-00-00-00 12 REAL down(1 misses)show module csm conns
Use the show module csm slot conns command to display active connections.
show module csm slot conns [vserver virtserver-name] [client ip-address] [detail]
Syntax Description
Defaults
If no options are specified, the command displays output for all active connections.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb conns.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display active connection data:
SLB-Switch# show module csm 4 connsprot vlan source destination state----------------------------------------------------------------------In TCP 11 100.100.100.2:1754 10.10.3.100:80 ESTABOut TCP 12 100.100.100.2:1754 10.10.3.20:80 ESTABIn TCP 11 100.100.100.2:1755 10.10.3.100:80 ESTABOut TCP 12 100.100.100.2:1755 10.10.3.10:80 ESTABSLB-Switch# show module csm 4 conns detailprot vlan source destination state----------------------------------------------------------------------In TCP 11 100.100.100.2:1754 10.10.3.100:80 ESTABOut TCP 12 100.100.100.2:1754 10.10.3.20:80 ESTABvs = WEB_VIP, ftp = No, csrp = FalseIn TCP 11 100.100.100.2:1755 10.10.3.100:80 ESTABOut TCP 12 100.100.100.2:1755 10.10.3.10:80 ESTABvs = WEB_VIP, ftp = No, csrp = Falseshow module csm dfp
Use the show module csm slot dfp command to display DFP agent and manager information, such as passwords, timeouts, retry counts, and weights.
show module csm slot dfp [agent [detail | ip-address port] | manager [ip_addr] | detail | weights]
Syntax Description
Defaults
If no options are specified, the command displays summary information.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows all available DFP data:
SLB-Switch# show module csm 4 dfp detailThis example shows information about weights:
SLB-Switch# show module csm 4 dfp weightsThis example, with no options specified, shows summary information:
SLB-Switch# show module csm 4 dfpRelated Commands
dfp
agent (SLB DFP configuration submode)
manager (SLB DFP configuration submode)show module csm ft
Use the show module csm slot ft command to display statistics and counters for the CSM fault-tolerant pair.
show module csm slot ft [detail]
Syntax Description
Defaults
No values are displayed.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb ft.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display the statistics and counters for the CSM fault-tolerant pair:
SLB-Switch# show module csm 4 ftFT group 2, vlan 30This box is activepriority 10, heartbeat 1, failover 3, preemption is offRelated Commands
show module csm map
Use the show module csm slot map command to display information about URL maps.
show module csm slot map [url | cookie | header | retcode] [name map-name] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows how to display URL maps associated with a Content Switching policy:
SLB-Switch# show module csm 4 map urlURL map UHASH_UMAPCOOKIE map UHASH_CMAP1COOKIE map UHASH_CMAP26k#show ip slb map detailURL map UHASH_UMAP rules:*aabb*COOKIE map UHASH_CMAP1 rules:name:foo value:*asdgjasgdkjsdkgjsasdgsg*COOKIE map UHASH_CMAP2 rules:name:bar value:*asdgjasgdkjsdkgjsasdgsg*This example shows how to display return code maps:
SLB-Switch#show module csm 5 map retcode detailRETCODE map HTTPCODES rules:return codes:401 to 401 action:log threshold:5 reset:120return codes:402 to 415 action:count threshold:0 reset:0return codes:500 to 500 action:remove threshold:3 reset:0return codes:503 to 503 action:remove threshold:3 reset:0Related Commands
show module csm memory
Use the show module csm slot memory command to display information about memory use.
show module csm slot memory [vserver vserver-name] [detail]
Syntax Description
slot
Slot where the CSM resides.
vserver
(Optional) Keyword to specify the virtual server configuration.
vserver-name
(Optional) Option to restrict output to the named virtual server.
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows how to display the memory usage of virtual servers:
SLB-Switch# show module csm 4 memoryslb vserver total bytes memory by type-----------------------------------------------------------------------WEB_VIP 0 0 0FTP_VIP 0 0 0Total(s): 0 0Out of Maximum: 261424 261344Related Commands
parse-length (SLB virtual server configuration submode)
show module csm natpool
Use the show module csm slot natpool command to display NAT configurations.
show module csm slot natpool [name pool-name] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb natpool.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display results of the default show module csm slot natpool command:
SLB-Switch# show module csm 4 natpoolnat client B 1.1(1).6 1.1(1).8 Netmask 255.255.255.0nat client A 1.1(1).1 1.1(1).5 Netmask 255.255.255.0This example shows how to display results of the show module csm slot natpool command with the detail variable:
SLB-Switch# show module csm 4 natpool detailnat client A 1.1(1).1 1.1(1).5 Netmask 255.255.255.0Start NAT Last NAT Count ALLOC/FREE-------------------------------------------------------1.1(1).1:11001 1.1(1).1:16333 0005333 ALLOC1.1(1).1:16334 1.1(1).1:19000 0002667 ALLOC1.1(1).1:19001 1.1(1).5:65535 0264675 FREERelated Commands
show module csm owner
Use the show module csm slot owner command to display the current connections count for the specified owner objects.
show module csm slot owner [name owner-name] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
Usage Guidelines
Detailed information about an owner object lists the virtual servers in that group with each virtual server's state and current connections count.
The MAXCONNS state is displayed for a virtual server when the current connections counter is equal to the configured maxconns value. Counters for the number of connections dropped due to the virtual server being in this state are added. The show module csm slot stats and show module csm slot vserver detail command output displays these counters on a global and per-virtual server basis, respectively.
Examples
This example shows how to display results of the default show module csm slot owner command:
SLB-Switch# show module csm 4 ownerThis example shows how to display results of the show module csm slot owner command with the detail variable:
SLB-Switch# show module csm 4 owner detailRelated Commands
show module csm policy
Use the show module csm slot policy command to display a policy configuration.
show module csm slot policy [name policy-name]
Syntax Description
slot
Slot where the CSM resides.
name
(Optional) Keyword to display a specific policy.
policy-name
(Optional) Policy name string to display.
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb policy.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display a policy configuration:
SLB-Switch# show module csm 4 policypolicy: PC1_UHASH_T1sticky group: 20serverfarm: SF_UHASH_T1policy: PC1_UHASH_T2sticky group: 30serverfarm: SF_UHASH_T2policy: PC1_UHASH_T3url map: UHASH_UMAPserverfarm: SF_UHASH_T3policy: PC1_UHASH_T4cookie map: UHASH_CMAP1serverfarm: SF_UHASH_T4policy: PC2_UHASH_T4cookie map: UHASH_CMAP2serverfarm: SF_UHASH_T4SLB-Switch#Related Commands
show module csm probe
Use the show module csm slot probe command to display HTTP or ping probe data.
show module csm slot probe [http | icmp | telnet | tcp | ftp | smtp | dns] [name probe_name] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb probe.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display probe data:
SLB-Switch# show module csm 4 probeprobe type interval retries failed open receive--------------------------------------------------------------------PB_ICMP1 icmp 60 1 5 10PB_HTTP1 http 60 1 10 10 10PB_TCP1 tcp 60 1 10 10 10PB_FTP1 ftp 60 1 10 10 10PB_TELNET1 telnet 60 1 10 10 10PB_SMTP1 smtp 60 1 10 10 10Related Commands
show module csm probe script
Use the show module csm slot probe script [name probe -name] [detail] command to display probe script data.
show module csm slot probe script [name probe -name] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows how to display probe data:
SLB-Switch# show module csm 4 probe script detailRelated Commands
show module csm real
Use the show module csm slot real command to display information about real servers.
show module csm slot real [sfarm sfarm-name] [detail]
Syntax Description
Defaults
If no options are specified, the command displays information about all real servers.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb real.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows Cisco IOS SLB real server data:
SLB-Switch# show module csm 4 realreal server farm weight state conns-------------------------------------------------------------------10.10.3.10 FARM1 20 OPERATIONAL 010.10.3.20 FARM1 16 OUTOFSERVICE 010.10.3.30 FARM1 10 OPERATIONAL 010.10.3.40 FARM1 10 FAILED 0SLB-Switch# show mod csm 5 real detail10.1.0.102, FARM1, state = OPERATIONALInband health:remaining retries = 3conns = 0, maxconns = 4294967295, minconns = 0weight = 8, weight(admin) = 8, metric = 0, remainder = 0total conns established = 0, total conn failures = 010.1.0.101, FARM1, state = OPERATIONALInband health:remaining retries = 3conns = 0, maxconns = 4294967295, minconns = 0weight = 8, weight(admin) = 8, metric = 0, remainder = 0total conns established = 0, total conn failures = 010.1.0.101, FARM2, state = OPERATIONALconns = 2, maxconns = 4294967295, minconns = 0weight = 8, weight(admin) = 8, metric = 0, remainder = 2total conns established = 7, total conn failures = 0Table A-1 describes the fields in the display.
Related Commands
real (SLB serverfarm configuration submode)
show module csm real retcode
Use the show module csm slot real retcode command to display information about the return code configuration.
show module csm slot real retcode [sfarm sfarm-name] [detail]
Syntax Description
Defaults
If no options are specified, the command displays information about all real servers.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows Cisco IOS SLB real server return code data:
SLB-Switch# show module csm 5 real retcode10.1.0.101, FARM2, state = OPERATIONALretcode-map = HTTPCODESretcode action count reset-seconds reset-count------------------------------------------------------401 log 3 0 1404 count 62 0 0500 remove 1 0 0Related Commands
real (SLB serverfarm configuration submode)
show module csm script
Use the show module csm slot script command to display the contents of all loaded scripts.
show module csm slot script [name full_file_URL] [code]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows how to display script file contents:
SLB-Switch# show module csm slot script [name script-name] [code]Related Commands
show module csm script task
Use the show module csm slot script task command to display all loaded scripts.
show module csm slot script task [index script-index] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows how to display A running script:
SLB-Switch# show module csm slot scriptRelated Commands
script file
script task
show module csm scriptshow module csm serverfarm
Use the show module csm slot serverfarm command to display information about a server farm.
show module csm slot serverfarms [name serverfarm-name] [detail]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb serverfarm.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display server farm data:
SLB-Switch# show module csm 4 serverfarmserver farm predictor nat reals redirect bind id-------------------------------------------------------------FARM1 RoundRobin S 4 0 0VIDEO_FARM RoundRobin S 5 0 0AUDIO_FARM RoundRobin S 2 0 0FTP RoundRobin S 3 0 0Table A-2 describes the fields in the display.
This example shows how to display only the details for one server farm:
SLB-Switch# show mod csm 5 serverfarm detailFARM1, predictor = RoundRobin, nat = SERVER, CLIENT(CLNAT1)virtuals inservice:4, reals = 2, bind id = 0, fail action = noneinband health config:retries = 3, failed interval = 200retcode map = <none>Real servers:10.1.0.102, weight = 8, OPERATIONAL, conns = 010.1.0.101, weight = 8, OPERATIONAL, conns = 0Total connections = 0FARM2, predictor = RoundRobin, nat = SERVER, CLIENT(CLNAT1)virtuals inservice:2, reals = 1, bind id = 0, fail action = noneinband health config:<none>retcode map = HTTPCODESReal servers:10.1.0.101, weight = 8, OPERATIONAL, conns = 2Total connections = 2Related Commands
show module csm static
Use the show module csm slot static command to display information about server NAT configurations.
show module csm slot static [drop | nat {ip-address | virtual}]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb static.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display static data:
SLB-Switch# show module csm 4 static natRelated Commands
static
real (SLB static NAT configuration submode)show module csm static server
Use the show module csm slot static server command to display information about actual servers that are having NAT performed.
show module csm slot static server [ip-address] [drop | nat {ip-address | virtual} | pass-through]
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb static server.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display static server data:
SLB-Switch# show module csm 4 static serverServer NAT Type----------------------------------------------10.10.3.10 NAT to 100.100.100.10010.10.3.20 No NAT10.10.3.30 NAT to 100.100.100.10010.10.3.40 No NATCat6k-1#Related Commands
static
real (SLB static NAT configuration submode)show module csm stats
Use the show module csm slot stats command to display SLB statistics.
show module csm slot stats
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb stats.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display SLB statistics:
SLB-Switch# show module csm 4 statsConnections Created: 180Connections Destroyed: 180Connections Current: 0Connections Timed-Out: 0Connections Failed: 0L4 Load-Balanced Decisions:180L4 Rejected Connections: 0L7 Load-Balanced Decisions:0L7 Rejected Connections:Total:0, Parser:0,Reached max parse len:0, Cookie out of mem:0,Cfg version mismatch:0, Bad SSL2 format:0L4/L7 Rejected Connections:No policy:0, No policy match 0,No real:0, ACL denied 0,Server initiated:0Checksum Failures: IP:0, TCP:0Redirect Connections:0, Redirect Dropped:0FTP Connections: 0MAC Frames:Tx:Unicast:1506, Multicast:0, Broadcast:50898,Underflow Errors:0Rx:Unicast:2385, Multicast:6148349, Broadcast:53916,Overflow Errors:0, CRC Errors:0Table A-3 describes the fields in the display.
show module csm status
Use the show module csm slot status command to display if the CSM is online. If the CSM is online, this command shows the CSM chassis slot location and indicates if the configuration download is complete.
show module csm slot status
Syntax Description
Defaults
This command has no default settings.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb status.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display CSM status:
SLB-Switch# show module csm 4 statusSLB Module is online in slot 4.Configuration Download state:COMPLETE, SUCCESSshow module csm sticky
Use the show module csm slot sticky command to display the sticky database.
show module csm slot sticky [groups | client ip_address]
Syntax Description
Defaults
If no options are specified, the command displays information about all clients.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb sticky.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only.
Usage Guidelines
This command only displays the database of clients using IP stickiness; it does not show cookie or SSL.
Examples
This example shows how to display the sticky database:
SLB-Switch# show module csm 4 sticky groupsGroup Timeout Type------------------------------------------------------------20 100 netmask 255.255.255.25530 100 cookie fooRelated Commands
sticky
sticky (SLB virtual server configuration submode)show module csm tech-script
Use the show module csm slot tech-script command to display the status of a script.
show module csm slot tech-script
Syntax Description
Defaults
If no options are specified, the command displays all information.
Command Modes
Privileged EXEC.
Command History
Examples
This example shows how to display the technical support information for the CSM:
SLB-Switch# show module csm 4 tech-scriptshow module csm tech-support
Use the show module csm slot tech-support command to display technical support information for the CSM.
show module csm slot tech-support [all | processor num | redirect | slowpath | probe | fpga | core-dump]
Syntax Description
Defaults
If no options are specified, the command displays all information.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb tech-support.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display the technical support information for the CSM:
SLB-Switch# show module csm 4 tech-support ?all All tech outputcore-dump Most recent core dumpfpga FPGA info outputft Fault Tolerance info outputprobe Probe info outputprocessor Processor info outputredirect HTTP redirect info outputslowpath Slowpath info outputSLB-Switch# show module csm 4 tech-support processor 2------------------------------------------------------------------------------------- TCP Statistics -------------------------------------------------------------------------------------Aborted rx 3350436013 66840864New sessions rx 180 0Total Packets rx 16940 0Total Packets tx 0 0Packets Passthrough 697 0Packets Dropped 0 0Persistent OOO Packets Dropped 0 0Persistent Fastpath Tx 0 0Total Persistent Requests 0 0Persistent Same Real 0 0Persistent New Real 0 0Data Packets rx 877 0L4 Data Packets rx 877 0L7 Data Packets rx 0 0Slowpath Packets rx 7851 0Relinquish Requests rx 8031 0TCP xsum failures 0 0Session Mismatch 0 0Session Reused while valid 0 0Unexpected Opcode rx 0 0Unsupported Proto 0 0Session Queue Overflow 0 0Control->Term Queue Overflow 0 0t_fifo Overflow 0 0L7 Analysis Request Sent 0 0L7 Successful LB decisions 0 0L7 Need More Data decisions 0 0L7 Unsuccessful LB decisons 0 0L4 Analysis Request Sent 180 0L4 Successful LB decisions 180 0L4 Unsuccessful LB decisons 0 0Transmit:SYN 0 0SYN/ACK 0 0ACK 0 0RST/ACK 0 0data 0 0Retransmissions: 0 0Receive:SYN 180 0SYN/ACK 0 0ACK 340 0FIN 0 0FIN/ACK 340 0RST 17 0RST/ACK 0 0data 0 0Session Redundancy Standby:Rx Fake SYN 0 0Rx Repeat Fake SYN 0 0Rx Fake Reset 0 0Fake SYN Sent to NAT 0 0Tx Port Sync 0 0Encap Not Found 0 0Fake SYN, TCP State Invalid 0 0Session Redundancy Active:L4 Requests Sent 0 0L7 Requests Sent 0 0Persistent Requests Sent 0 0Rx Fake SYN 0 0Fake SYN Sent to NAT 0 0Session's torn down 180 0Rx Close session 1 0Slowpath(low pri) buffer allocs 7843 0Slowpath(high pri) buffer allocs 8 0Small buffer allocs 180 0Medium buffer allocs 0 0Large buffer allocs 0 0Session table allocs 180 0Slowpath(low pri) buffer alloc failures 0 0Slowpath(high pri) buffer alloc failures 0 0Small buffer allocs failures 0 0Medium buffer allocs failures 0 0Large buffer allocs failures 0 0Session table allocs failures 0 0Outstanding slowpath(low pri) buffers 0 0Outstanding slowpath(high pri) buffers 0 0Outstanding small buffers 0 0Outstanding medium buffers 0 0Outstanding large buffers 0 0Outstanding sessions 0 0show module csm vlan
Use the show module csm slot vlan command to display the list of VLANs.
show module csm slot vlan [client | server | ft] [id vlan-id] [detail]
Syntax Description
Defaults
If no options are specified, the command displays information about all VLANs.
Command Modes
Privileged EXEC.
Command History
1.1(1)
This command was introduced as show ip slb vlan.
2.1(1)
This command was changed to show module csm slot (for ip slb mode rp only).
Examples
This example shows how to display the VLAN configurations:
SLB-Switch#
