Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


virtual-service (Traffic Load Balancer)



Hierarchy Level

Release Information

Statement introduced in Junos OS Release 16.1 on MX Series.

Support added in Junos OS Release 19.3R2 for Next Gen Services on MX Series routers MX240, MX480 and MX960 with the MX-SPC3 services card.


Configure a TLB virtual service.


address virtual-ip-addressAddress of the virtual service.
group group-nameServer group for the virtual service.
load-balance method hash hash-key methodUse a combination of these hash-key methods for the session distribution API:
dest-ipHash on destination IP address.
protoHash on protocol.
source-ipHash on source IP address.
load-balance-method randomUse randomizing algorithm for session distribution.
mode ( layer2-direct-server-return | direct-server-return | translated )Traffic load balancer mode of operation:
direct-server-returnTransparent mode Layer 3 direct server return.
layer2-direct-server-returnTransparent mode Layer 2 direct server return. Load balancing works by changing the Layer 2 MAC of packets; Layer 3 and higher level headers are not modified.
translatedThe Packet Forwarding Engine performs stateless load balancing.
route-metric(Optional) Route metric

Range: 1 through 255

routing-instance-name(Optional) Routing instance for the virtual service. Default is inet.0.
server-interface server-interface(Optional) The server-interface specified under the virtual-service, will be used instead of the values provided under the instance level.
service service-nameTranslated mode details. Packets destined to this virtual ip-address + virtual-port + protocol will be load balanced to the appropriate server. The destination IP address and port are replaced by the real services IP address and the server-listening-port (configured here).
protocol (udp | tcp)Protocol.
server-listening-port portPort number.
virtual-port virtual-portVirtual port number.
virtual-ip–addressLocal address for the virtual service.
virtual-service-nameIdentifier for the virtual service.

Required Privilege Level

interface—To view this statement in the configuration.

interface-control—To add this statement to the configuration.