Routing Configuration Guide, Cisco IOS XE Catalyst SD-WAN Release 17.x

PDF

Configure the transport gateway path preference

Updated: March 9, 2026

Want to summarize with AI?

Log in

Configure the transport gateway path preference using a CLI Template

Procedure

1.

Enter sdwan configuration mode.

sdwan
2.

Enter system OMP configuration mode.

omp
3.

Configure the transport gateway path preference, using one of the following options:

best-path transport-gateway {prefer | ecmp-with-direct-path}
Option Description
ecmp-with-direct path For devices that can connect through a transport gateway and through direct paths, apply equal-cost multi-path (ECMP) to all available paths.
prefer For devices that can connect through a transport gateway, use only the transport gateway paths, even if other paths are available.
4.

(Optional) Specify one or more site types to which to apply the transport gateway behavior. For information about how the Site Types parameter operates together with the Transport Gateway Path Behavior parameter, see OMP Best Path Logic and Transport Gateway Path Preference.

omp best-path transport-gateway-settings site-types site-types
Option Description
site-types Include one or more of the following site types, separated by spaces: cloud, branch, br, type-1, type-2, type-3
Note

To use this command, ensure that you use the omp best-path transport-gateway prefer command in the previous step.

The following example configures a device to prefer transport gateway routes.

sdwan
omp
  omp best-path transport-gateway prefer

The following example configures a device to prefer transport gateway routes only for traffic destined to sites with site type cloud.

sdwan
omp
  omp best-path transport-gateway prefer
  omp best-path transport-gateway-settings site-types cloud

Configure the transport gateway path preference using Cisco SD-WAN Manager

Procedure

1.

From the Cisco SD-WAN Manager menu, choose Configuration > Templates.
2.

Click Feature Templates.
3.

Do one of the following:

  • To create a new OMP template, click Add Template, choose a device type, and click Cisco OMP.

  • To edit an existing OMP template, locate a OMP template in the table of existing feature templates, click … adjacent to the template, and choose Edit.
4.

In the Best Path section, in the Transport Gateway Path Behavior field, choose Global mode and choose one of the following options:

Option Description
Do ECMP Between Direct and Transport Gateway Paths For devices that can connect through a transport gateway and through direct paths, apply equal-cost multi-path (ECMP) to all available paths.
Prefer Transport Gateway Path For devices that can connect through a transport gateway, use only the transport gateway paths, even if other paths are available.
Note

If you do not configure this field, by default, routers favor a direct path as the best path.
5.

(Optional) Click the Site Types field and choose one or more site types to which to apply the transport gateway behavior. For information about how the Site Types parameter operates together with the Transport Gateway Path Behavior parameter, see OMP Best Path Logic and Transport Gateway Path Preference.
6.

Click Save if creating a new template, or Update if editing an existing template.