Configuration Mode Commands : SteelHead Configuration Commands : WCCP Support Commands : wccp interface service-group
  
wccp interface service-group
Defines a new WCCP service group.
Syntax
wccp interface <interface> service-group service group <service-id> {routers <routers> | protocol <protocol> | flags <flags> | priority <priority> | ports <ports> | password <password> | weight <weight> | encap-scheme <scheme> | assign-scheme <scheme> | src-ip-mask <mask> | dst-ip-mask <mask> | src-port-mask <mask> | dst-port-mask <mask>}
Parameters
<interface>
SteelHead interface to participate in a WCCP service group. RiOS v6.1 allows multiple SteelHead interfaces to participate in WCCP on one or more routers for redundancy (RiOS v6.0 and earlier allows a single SteelHead interface). If one of the links goes down, the router can still send traffic to the other active links for optimization. You must include an interface with the service group ID. More than one SteelHead in-path interface can participate in the same service group. For WCCP configuration examples, see the SteelHead Deployment Guide. If multiple SteelHeads are used in the topology, they must be configured as neighbors.
<service-id>
Number from 0 to 255 to identify the service group on the router. A value of 0 specifies the standard HTTP service group. Riverbed recommends that you use WCCP service groups 61 and 62.
The service group ID is local to the site where WCCP is used. The service group number is not sent across the WAN.
Enables WCCP v2 support on all groups added to the Service Group list.
routers <routers>
Specifies a comma-separated list of IP addresses for routers.
You can specify up to 32 routers.
protocol <protocol>
Specifies one of the following traffic protocols: tcp, udp, or icmp.
The default value is tcp.
flags <flags>
Specifies a comma-separated list of the following service group flags, as needed:
•  src-ip-hash - Uses the source IP address as a hash key.
•  dst-ip-hash - Uses the destination IP address as a hash key.
•  src-port-hash - Uses the source port as a hash key.
•  dst-port-hash - Uses the destination port as a hash key.
•  ports-dest - Specifies the destination ports for redirection.
•  ports-source - Specifies the source ports for redirection.
priority
<priority>
Specifies the WCCP priority for traffic redirection. If a connection matches multiple service groups on a router, the router chooses the service group with the highest priority.
The range is 0-255. The default value is 200.
The priority value must be consistent across all SteelHeads within a particular service group.
ports <ports>
Specifies a comma-separated list of up to seven ports that the router will redirect.
Set this parameter only if the flags parameter specifies either ports-dest or ports-source.
password <password>
Assigns a password to the SteelHead.
This password must be the same password that is on the router. WCCP requires that all routers in a service group have the same password.
Passwords are limited to eight characters.
weight <weight>
Specifies a weight value in the range of 0 to 65535.
You specify the percentage of connections that are redirected to a particular SteelHead interface, which is useful for traffic load balancing and failover support. The number of TCP, UDP, or ICMP connections a SteelHead supports determines its weight. The more connections a SteelHead model supports, the heavier the weight of that model. In RiOS v6.1 you can modify the weight for each in-path interface to manually tune the proportion of traffic a SteelHead interface receives.
A higher weight redirects more traffic to that SteelHead interface. The ratio of traffic redirected to a SteelHead interface is equal to its weight divided by the sum of the weights of all the SteelHead interfaces in the same service group. For example, if there are two SteelHeads in a service group and one has a weight of 100 and the other has a weight of 200, the one with the weight 100 receives 1/3 of the traffic and the other receives 2/3 of the traffic.
However, since it is generally undesirable for a SteelHead with two WCCP in-path interfaces to receive twice the proportion of traffic, for SteelHeads with multiple in-paths connected, each of the in-path weights is divided by the number of that SteelHead interfaces participating in the service group.
For example, if there are two SteelHeads in a service group and one has a single interface with weight 100 and the other has two interfaces each with weight 200, the total weight will still equal 300 (100 + 200/2 + 200/2). The one with the weight 100 receives 1/3 of the traffic and each of the other's in-path interfaces receives 1/3 of the traffic.
The default value corresponds to the number of TCP connections your SteelHead supports.
Failover Support
To enable single in-path failover support with WCCP groups, define the service group weight to be 0 on the backup SteelHead. If one SteelHead has a weight 0, but another one has a non-zero weight, the SteelHead with weight 0 does not receive any redirected traffic. If all the SteelHeads have a weight 0, the traffic is redirected equally among them.
The best way to achieve multiple in-path failover support with WCCP groups in RiOS v6.1 is to use the same weight on all interfaces from a given SteelHead for a given service group. For example, suppose you have SteelHead A and SteelHead B with two in-path interfaces each. When you configure SteelHead A with weight 100 from both inpath0_0 and inpath0_1 and SteelHead B with weight 200 from both inpath0_0 and inpath0_1, RiOS distributes traffic to SteelHead A and SteelHead B in the ratio of 1:2 as long as at least one interface is up on both SteelHeads.
In a service group, if an interface with a non-zero weight fails, its weight transfers over to the weight 0 interface of the same service group.
For details on using the weight parameter to balance traffic loads and provide failover support in WCCP, see the SteelHead Deployment Guide.
encap-scheme
Specifies one of the following methods for transmitting packets between a router or a switch and a SteelHead interface:
•  either - Uses layer-2 first; if Layer-2 is not supported, GRE is used. This is the default value.
•  gre - Generic Routing Encapsulation. The GRE encapsulation method appends a GRE header to a packet before it is forwarded. This can cause fragmentation and imposes a performance penalty on the router and switch, especially during the GRE packet de-encapsulation process. This performance penalty can be too great for production deployments.
•  l2 -Layer-2 redirection. The L2 method is generally preferred from a performance standpoint because it requires fewer resources from the router or switch than the GRE does. The L2 method modifies only the destination Ethernet address. However, not all combinations of Cisco hardware and IOS revisions support the L2 method. Also, the L2 method requires the absence of L3 hops between the router or switch and the SteelHead.
assign-scheme
Determines which SteelHead interface in a WCCP service group the router or switch selects to redirect traffic to for each connection. The assignment scheme also determines whether the SteelHead interface or the router processes the first traffic packet. The optimal assignment scheme achieves both load balancing and failover support. Specify one of the following schemes:
•  either - Uses Hash assignment unless the router does not support it. When the router does not support Hash, it uses Mask. This is the default setting.
•  hash - Redirects traffic based on a hashing scheme and the Weight of the SteelHead interface, providing load balancing and failover support. This scheme uses the CPU to process the first packet of each connection, resulting in slightly lower performance. However, this method generally achieves better load distribution. Riverbed recommends Hash assignment for most SteelHead appliances if the router supports it. The Cisco switches that do not support Hash assignment are the 3750, 4000, and 4500-series, among others.
Your hashing scheme can be a combination of the source IP address, destination IP address, source port, or destination port.
•  mask - Redirects traffic operations to the SteelHeads, significantly reducing the load on the redirecting router. Mask assignment processes the first packet in the router hardware, using less CPU cycles and resulting in better performance.
Mask assignment in RiOS 5.0.1 and earlier is limited to one SteelHead per service group. The SteelHead with the lowest in-path IP address receives all the traffic. This scheme provides high availability. You can have multiple SteelHeads in a service group but only the SteelHead with the lowest in-path IP address receives all the traffic. If the SteelHead with the lowest in-path IP address fails, the SteelHead with the next lowest in-path IP address receives all of the traffic. When the SteelHead with the lowest in-path IP address recovers, it again receives all of the traffic.
Mask assignment in RiOS 5.0.2 and later supports load-balancing across multiple active SteelHeads. This scheme bases load-balancing decisions (for example, which SteelHead in a service group optimizes a given new connection) on bits pulled out, or masked, from the IP address and the TCP port packet header fields.
Mask assignment in RiOS v6.1 supports load-balancing across multiple active SteelHead interfaces in the same service group.
The default mask scheme uses an IP address mask of 0x1741, which is applicable in most situations. However, you can change the IP mask by clicking the service group ID and changing the service group settings and flags.
In multiple SteelHead environments, it is often desirable to send all users in subnet range to the same SteelHead. Using mask provides a basic ability to leverage a branch subnet and SteelHead to the same SteelHead in a WCCP cluster.
Important: If you use mask assignment you must ensure that packets on every connection and in both directions (client-to-server and server-to-client), are redirected to the same SteelHead.
For detailed information and best practices for using assignment schemes, see the SteelHead Deployment Guide.
src-ip-mask <mask>
Specifies the service group source IP mask in hexadecimal format. The default value is 0x1741.
dst-ip-mask <mask>
Specifies the service group destination IP mask in hexadecimal format.
src-port-mask <mask>
Specifies the service group source port mask in hexadecimal format.
dst-port-mask <mask>
Specifies the service group destination port mask in hexadecimal format.
Usage
WCCP must be enabled before configuring any WCCP service groups.
Follow these guidelines when configuring the weight parameter and failover support:
•  To enable failover support for WCCP groups, set the weight parameter to 0 on the backup SteelHead.
•  If one SteelHead has a weight 0, but another one has a nonzero weight, the SteelHead with weight 0 does not receive any redirected traffic.
•  To enable failover support with multi-inpath WCCP groups in RiOS v6.1, set the weight parameter to 0 on the backup SteelHead interface.
If one SteelHead interface has a weight 0, but another one has a nonzero weight, the SteelHead interface with weight 0 does not receive any redirected traffic.
Note: If all the SteelHead interfaces have a weight 0, the traffic is redirected equally among them.
Example
amnesiac (config) # wccp interface inpath0_0 service-group 61 routers 10.1.1.1,10.2.2.2
Product
SteelHead CX, SteelHead EX, Interceptor, SteelHead-v, SteelHead-c
Related Commands
show wccp, show wccp interface service-group