tunnel-endpoint

Required Command-Line Mode = Configure

Use the tunnel-endpoint command to configure a tunnel endpoint that is a destination for traffic from a L2GRE tunnel. Using stateless or stateful load balancing, GigaSMART can be configured to distribute the traffic from a tunnel to multiple tunnel endpoints.

There is no mapping of a tunnel endpoint to a GigaSMART group (gsgroup). A tunnel endpoint is only mapped when a GigaSMART operation (gsop) is configured for tunnel-encap type l2gre. Refer to gsop for details.

For information on L2GRE encapsulation, refer to the GigaSMART Layer 2 GRE Tunnel Encapsulation/Decapsulation” section in the GigaVUE Fabric Management Guide.

The tunnel-endpoint command has the following syntax:

tunnel-endpoint te-id <tunnel endpoint ID>
   alias <alias>
   type remote ip-address <IP address>

The following table describes the arguments for the tunnel-endpoint command:

Argument

Description

tunnel-endpoint te-id <tunnel endpoint ID>

Specifies the identifier of the tunnel endpoint. The tunnel endpoint ID has the format teN, where N is a value from 1 to 128, for example: te1 to te128.

A maximum of 128 tunnel endpoints can be configured.

alias <alias>

Specifies an optional alias for the tunnel endpoint. The alias must be unique and can contain up to 128 characters. Aliases are case-sensitive.

For example:

(config) # tunnel-endpoint te-id te1 alias Tunnel-endpoint1

Note:  The alias cannot use the same format as the tunnel endpoint identifier, te1 to te128.

type remote ip-address <IP address>

Specifies the type, which is remote, and specifies the IP address of the tunnel endpoint. Only one IP address can be configured for each tunnel endpoint.

The destinations must be reachable from the tunnel IP.

For example:

(config) # tunnel-endpoint te-id te1 type remote ip-address 1.1.1.1

Note:  Once a tunnel endpoint is associated with a port group, the IP address cannot be changed.

The following table summarizes other commands related to the tunnel-endpoint command:

Task

Command

Displays all tunnel endpoints.

# show tunnel-endpoint

Displays a specified tunnel endpoint by the alias.

# show tunnel-endpoint alias Tunnel-endpoint1

Displays tunnel endpoints status.

# show ip destination gsgroup <gsgroup-alias>

Displays tunnel endpoints statistics.

# show ip destination stats gsgroup <gsgroup-alias>

Displays a specified tunnel endpoint by the tunnel endpoint identifier.

# show tunnel-endpoint te-id te1

Displays all port groups and displays the associated tunnel endpoint.

# show port-group all

Displays load balancing statistics for a specified port group, including stats for tunnel endpoint.

# show load-balance port-group stats alias portgrp1

Displays load balancing statistics for all port groups, including stats for tunnel endpoint.

# show load-balance port-group stats all

Deletes a specified tunnel endpoint by the alias.

(config) # no tunnel-endpoint alias Tunnel-endpoint1

Deletes all tunnel endpoints. If the tunnel endpoint has been associated with a port group, it cannot be deleted.

(config) # no tunnel-endpoint all

Deletes a specified tunnel endpoint by its tunnel endpoint identifier. If the tunnel endpoint has been associated with a port group, it cannot be deleted.

(config) # no tunnel-endpoint te-id te1