virtual

Use this command to configure an IPv4 or IPv6 virtual server IP address and port.

Syntax

virtual ip-address {tcp | udp} port [service service-name] [all-vrfs]

Parameters

ip-address Specifies an IPv4 or IPv6 IP address for the virtual server.
tcp | udp Specifies TCP or UDP as the protocol used by the virtual server.
port Specifies a TCP or UDP port number (0 through 65535) or port name to be used by this virtual server. Specifying 0 indicates all ports can be used by this virtual server. When port 0 is specified and a sticky type session persistence is applied that sticky type must be SIP.

The following port name keywords may be used:

ftp — File Transfer Protocol, port 21 (IPv4 only)

telnet — Telnet, port 23

www — World Wide Web, port 80

all — All protocol ports

service service-name (Optional) Specifies the service to be accessed through this virtual server IP address. When TCP has been specified as the protocol, service-name should be ftp. When UDP has been specified as the protocol, service name should be tftp.
all-vrfs (Optional) Specifies that this VRF will handle SLB services for all VRFs for this router.

Defaults

  • If service service-name is not specified, ftp is the service when TCP is the specified protocol; tftp is the service when UDP is the specified protocol.
  • If all-vrfs is not specified, SLB services are only handled for this VRF router.

Mode

Configuration command, SLB Virtual Server Configuration mode.

Usage

The virtual server IP address type must be the same as the client IP address type.

Use this command to configure an IPv4 or IPv6 virtual IP address, IP protocol, and UDP/TCP Port. Optionally specify a service type if the configured port is not the services default.

Use the all-vrfs parameter to configure this VRF router to handle SLB services for all VRFs on this system.

Examples

This example shows how to set the IPv4 address and TCP port for the “virtual-http” virtual server:

System(rw-config)->ip slb vserver virtual-http
System(rw-config-slb-vserver)->serverfarm myproductHTTP
System(rw-config-slb-vserver)->virtual 10.1.4.5 tcp www

This example shows how to set the IPv6 address and UDP port for the “virtual-http66” virtual server:

System(rw-config)->ipv6 slb vserver virtual-http66
System(rw-config-slb-vserver)->serverfarm myproductHTTP66
System(rw-config-slb-vserver)->virtual 2001:11ac:fd34::5 udp tftp

This example shows how to set the IP address and TCP port for the “WWW” virtual server and for this virtual server to to handle SLB services for all VRFs on this router:

System(su)->router Services
System(su-Services)->configure
System(su-Services-config)->ip slb vserver WWW
System(su-Services-config-slb-vserver)->virtual 10.21.141.100 tcp www all-vrfs