Modifying Settings of an Interface

Description

This command changes the settings of an interface that belongs to an existing Virtual Device object:

  • Virtual System

  • Virtual System in Bridge Mode

  • Virtual Switch

  • Virtual Router

Note - You cannot change or remove the IP address or netmask of an existing interface with this command. You can remove the interface and add a new interface with a different IP address, but not all the previous interface settings are kept.

Syntax

set interface vd <Name of Virtual Device Object> {name <Name of Interface> [new_name <Name of New Interface>] | leads_to <Name of VSW or VR Object> [new_leads_to <Name of New VSW or VR Object>]} [propagate {true | false}] [propagate6 {true | false}] [topology {external | internal_undefined | internal_this_network | internal_specific [specific_group <Network Group Object Name>]}] [mtu <MTU>]

Parameters

Parameter

Value

Notes

vd <Name of Virtual Device Object>

Object name

Specifies the name of the Virtual Device object.

Mandatory parameter, if this is the first command in a transaction.

name <Name of Interface>

Interface name

Specifies the name of the physical or VLAN interface.

Note - You must use the "name" or "leads_to" parameter, but not both.

new_name <Name of New Interface>

Interface name

You can change the name, but not the type of interface.

Note - You can change a VLAN or physical interface only to a VLAN or physical interface.

leads_to <Name of VSW or VR Object>

Object name

Specifies the name of the Virtual Switch or Virtual Router object, to which this interface connects.

This parameter is applicable only for a Virtual System.

Note - You must use the "name" or "leads_to" parameter, but not both.

new_leads_to <Name of New VSW or VR Object>

Object name

You can where the interface leads:

  • You can change an interface that leads to a Virtual Switch only to lead to a different Virtual Switch.

  • You can change an interface that leads to a Virtual Router only to lead to a different Virtual Router.

propagate {true | false}

  • true

  • false

Controls how to propagate the IPv4 routes to adjacent Virtual Devices:

  • true - Propagate the IPv4 routes

  • false - Do not propagate the IPv4 routes (default)

Note - This parameter is applicable only for a Virtual System with VLAN or physical interfaces.

propagate6 {true | false}

  • true

  • false

Controls how to propagate the IPv6 routes to adjacent Virtual Devices:

  • true - Propagate the IPv6 routes

  • false - Do not propagate the IPv6 routes (default)

Note - This parameter is applicable only for a Virtual System with VLAN or physical interfaces.

topology {external | internal_undefined | internal_this_network | internal_specific}

  • external

  • internal_undefined

  • internal_this_network

  • internal_specific

Specifies the Topology configuration of the interface:

  • external - External interface.

  • internal_undefined - Internal interface with undefined topology. This is the default for Virtual System in Bridge Mode.

  • internal_this_network - Internal interface. This is the default for Virtual System and Virtual Router. Virtual System in Bridge Mode does not support this topology.

  • internal_specific [specific_group <Network Group Object Name>] - Internal interface with topology defined by the specified Network Group object.

This parameter is applicable only for a:

  • Virtual System

  • Virtual System in Bridge Mode

  • Virtual Router

specific_group <Network Group Object Name>

Name of Network Group Object

If you specified the "topology internal_specific" parameter, then specify the name of the Network Group object that contains the applicable Network objects.

Note - This parameter is applicable only if you disable the automatic topology calculation with the "set vd ... calc_topo_auto false" command (see Modifying Settings of a Virtual Device).

mtu <MTU>

Integer

Specifies the MTU value for this interface.

Default is 1500 bytes.

This parameter is applicable only for:

  • Virtual System

  • Virtual Router

Example - On the Virtual System "VS1", change the VLAN interface eth4.10 to the physical interface eth5

vsx_provisioning_tool -s localhost -u admin -p mypassword -o set interface vd VS1 name eth4.100 new_name eth5 propagate true topology internal_specific specific_group NYGWs