Print Download PDF Send Feedback

Previous

Next

Adding an Interface to a Virtual Device

Description

This command lets you add an interface to an existing Virtual Device object:

Syntax

add interface vd <Device Object Name> {name <Interface> | leads_to <VSW or VR Object Name>} 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 <Network Group Object Name>}] [mtu <MTU>]

Parameters

Parameter

Value

Notes

vd <Device Object Name>

Object name

Specifies the name of the Virtual Device object.

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

name <Interface>

Interface name

Specifies the name of the physical or VLAN interface.

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

leads_to <VSW or VR Object Name>

Object name

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

Applicable only for Virtual System.

Note - You must use 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

Applicable only for:

  • 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

Applicable only for:

  • 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 - Applicable only for 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 - Applicable only for 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 - Internal interface with topology defined by the specified Network Group object.

Applicable only for:

  • Virtual System
  • Virtual System in Bridge Mode
  • Virtual Router

specific_group <Network Group Object Name>

Name of Network Group Object

If you used topology internal_specific, then specify the name of the Network Group object that contains the applicable Network objects

Applicable only if you disable the automatic topology calculation.

mtu <MTU>

Integer

Specifies the MTU value for this interface.

Default is 1500 bytes.

Applicable only for:

  • 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