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


Configure a TLB virtual service.


address virtual-ip-address

Address of the virtual service.

group group-name

Server group for the virtual service.

load-balance method hash hash-key method

Use a combination of these hash-key methods for the session distribution API:


Hash on destination IP address.


Hash on protocol.


Hash on source IP address.

load-balance-method random

Use randomizing algorithm for session distribution.

mode ( layer2-direct-server-return | direct-server-return | translated )

Traffic load balancer mode of operation:


Transparent mode Layer 3 direct server return.


Transparent 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.


The Packet Forwarding Engine performs stateless load balancing.


(Optional) Route metric

  • Range: 1 through 255


(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-name

Translated 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)


server-listening-port port

Port number.

virtual-port virtual-port

Virtual port number.


Local address for the virtual service.


Identifier for the virtual service.

Required Privilege Level

interface—To view this statement in the configuration.

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

Release Information

Statement introduced in Junos OS Release 16.1.

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.