Adding an Interface to a Virtual Device

Description

This command adds an interface to an existing Virtual Device object:

  • Virtual System

  • Virtual System in Bridge Mode

  • Virtual Switch

  • Virtual Router

Syntax

add interface vd <Name of Virtual Device Object> {name <Name of Interface> | leads_to <Name of VSW or VR Object>} ip <IPv4 Address>{/<IPv4 Prefix Length> | netmask <IPv4 Netmask> | prefix <IPv4 Prefix>} ip6 <IPv6 Address>{/<IPv6 Prefix Length> | netmask6 <IPv6 Netmask> | prefix6 <IPv6 Prefix>} [propagate {true | false}] [propagate6 {true | false}] [topology {external | internal_undefined | internal_this_network | internal_specific [specific_group <Name of Network Group Object>]}] [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.

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.

ip <IPv4 Address>{/<IPv4 Prefix> | netmask <IPv4 Netmask> | prefix <IPv4 Prefix>}

IPv4 configuration

Specifies the IPv4 settings:

  • <IPv4 Address> - IPv4 address

  • <IPv4 Prefix> - Integer between 1 and 32

  • <IPv4 Netmask> - Number in a format X.X.X.X

This parameter is applicable only for a:

  • Virtual System

  • Virtual Router

For interfaces on a Virtual System that connect to a Virtual Router, you must use the possible maximum for the IPv4 address family:

  • Netmask 255.255.255.255

  • Prefix 32

ip6 <IPv6 Address>{/<IPv6 Prefix> | netmask6 <IPv6 Netmask> | prefix6 <IPv6 Prefix>}

IPv6 configuration

Specifies the IPv6 settings:

  • <IPv6 Address> - IPv6 address

  • <IPv6 Prefix> - Integer between 64 and 128

  • <IPv6 Netmask> - Number in a format XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX

This parameter is applicable only for a:

  • Virtual System

  • Virtual Router

For interfaces on a Virtual System that connect to a Virtual Router, you must use the possible maximum for the IPv6 address family:

  • Netmask FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF

  • Prefix 128

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 a Virtual System in Bridge Mode.

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

  • internal_specific [specific_group <Name of Network Group Object>] - 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 a:

  • Virtual System

  • Virtual Router

Example - Add VLAN interface eth4.100 with IPv4 1.1.1.1/24 to the Virtual System 'VirtSystem1'

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add interface vd VirtSystem1 name eth4.100 ip 1.1.1.1/24