vrouter-interface-add

This command is used to add interfaces to virtual router (vRouter) services on a fabric, cluster, standalone switch, or virtual network (VNET).

Syntax   vrouter-interface-add

vrouter-name name-string

Specify the name for the vRouter interface.

Specify any of the following options:

vlan vlan-id

Specify the VLAN identifier. This is a value between 1 and 4094.

ip ip-address

Specify the IP address of the interface.

netmask netmask

Specify the netmask.

assignment none|dhcp|dhcpv6

Specify the DHCP method for IP address assignment. Note that if you specify hardware as the router type, you cannot assign IP addresses using DHCP. You must specify a static IP address.

ip2 ip-address

Specify the IP address of the interface.

netmask2 netmask

Specify the netmask.

assignment2 none|dhcp|dhcpv6

Specify the DHCP method for IP address assignment. Note that if you specify hardware as the router type, you cannot assign IP addresses using DHCP. You must specify a static IP address.

linklocal ip-address

Specify an IPv6 linklocal address.

vnet vnet-name

Specify the VNET assigned to the vRouter.

vlan-type public|private

Specify the type of VLAN for the interface.

if mgmt|data|span

Specify if the interface is a management, data or span interface.

alias-on alias-on-string

Specify an alias for the interface.

exclusive|no-exclusive

Specify if the interface is exclusive to the configuration. Exclusive means that other configurations cannot use the interface. Exclusive is specified when you configure the interface as a span interface and allows higher throughput through the interface.

nic-enable|nic-disable

Specify if the NIC is enabled or disabled.

pim|no-pim

Specify if the vRouter interface is a PIM interface.

pim-dr-priority integer

Specify the direct router (DR) priority as an integer between 1 and 4294967295. Netvisor selects the vRouter interface with higher DR priority as the designated router.

By default, all interfaces are priority 1. In case of same priority, Netvisor selects the vRouter interface with highest network address as DR.

pim-cluster|no-pim-cluster

Specify if you want to provide alternative routing for Layer 3 attached sources for leaf cluster routing configuration. It allows traffic to failover not black-hole when the unicast path to the Spine fails.

fabric-nic|no-fabric-nic

Specify if VNIC is on a VLAN used for fabric setup.

vrrp-id id-number

Specify the ID for the VRRP interface. The IDs on both vRouters must be the same ID number.

vrrp-primary string

Specifies the primary interface for VRRP failover.

vrrp-priority number

Speicfies the priority for the VRRP interface. This is a value between 1 (lowest) and 255 (highest).

vrrp-adv-int mseconds

Specify a VRRP advertisement interval in milliseconds. The range is from 30 to 40950 with a default value of 1000.

l3-port l3port-usable-port name

Specify a Layer 3 port for the interface.

secondary-macs secondary-macs-string

Specify a secondary MAC address for the interface.

mtu bytes

Specify a MTU value in bytes between 68 and 9216.

if-nat-realm internal|external

Specify a NAT realm for the interface.

priority-tag|
no-priority-tag

Specify if you want to add a VLAN 0 priority tag on forwarded traffic.

Defaults   None.

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameters, exclusive and nic, added.

Version 2.2

The parameters vrrp-id, vrrp-priority, and vrrp-primary added.

Version 2.2.5

The parameters, l3-port, and secondary-macs, added.

Version 2.3

The parameter, vrrp-adv-int, added.

Version 2.4.1

The parameter, vlan-type, added.

Version 2.5

The parameter, mtu, added.

Version 2.6.0

The parameter, if-nat-realm internal|external, and vnet, added.

Version 2.6.2

The parameter, vxlan, deprecated.

Version 3.0.0

The parameter, ip2 and netmask2 added. The parameters, pim, pim-dr-priority, and pim-cluster, added. The parameter, linklocal, added. The option, autov6, deprecated for the parameter, assignment.

Version 3.1.0

The parameter, fabric-nic and priority-tag, added.

Usage   You can add interfaces to the vRouter services on a fabric, cluster, standalone switch, or virtual network (VNET). This command adds an interface to a vRouter service.

Examples  To add an interface with the IP address, 192.168.10.11/32, VLAN 25, and data to vRouter service, MyvService, use the following command:

CLI network-admin@switch > vrouter-interface-add vrouter-name MyvService ip 192.168.10.11/32 assigment none vlan 25 if data

vrouter-interface-modify

This command is used to modify interfaces on the virtual router (vRouter) service on a fabric, cluster, standalone switch, or virtual network (VNET).

Syntax   vrouter-interface-modify

vrouter-name name-string

Specify the name for the vRouter interface.

Specify any of the following options:

vlan vlan-id

Specify the VLAN identifier. This is a value between 1 and 4094.

ip ip-address

Specify the IP address of the interface.

netmask netmask

Specify the netmask.

assignment none|dhcp|dhcpv6

Specify the DHCP method for IP address assignment. Note that if you specify hardware as the router type, you cannot assign IP addresses using DHCP. You must specify a static IP address.

ip2 ip-address

Specify the IP address of the interface.

netmask2 netmask

Specify the netmask.

assignment2 none|dhcp|dhcpv6

Specify the DHCP method for IP address assignment. Note that if you specify hardware as the router type, you cannot assign IP addresses using DHCP. You must specify a static IP address.

linklocal ip-address

Specify an IPv6 linklocal address.

vnet vnet-name

Specify the VNET assigned to the vRouter.

vlan-type public|private

Specify the type of VLAN for the interface.

if mgmt|data|span

Specify if the interface is a management, data or span interface.

alias-on alias-on-string

Specify an alias for the interface.

exclusive|no-exclusive

Specify if the interface is exclusive to the configuration. Exclusive means that other configurations cannot use the interface. Exclusive is specified when you configure the interface as a span interface and allows higher throughput through the interface.

nic-enable|nic-disable

Specify if the NIC is enabled or disabled.

pim|no-pim

Specify if the vRouter interface is a PIM interface.

pim-dr-priority integer

Specify the direct router (DR) priority as an integer between 1 and 4294967295. Netvisor selects the vRouter interface with higher DR priority as the designated router.

By default, all interfaces are priority 1. In case of same priority, Netvisor selects the vRouter interface with highest network address as DR.

pim-cluster|no-pim-cluster

Specify if you want to provide alternative routing for Layer 3 attached sources for leaf cluster routing configuration. It allows traffic to failover not black-hole when the unicast path to the Spine fails.

fabric-nic|no-fabric-nic

Specify if VNIC is on a VLAN used for fabric setup.

vrrp-id id-number

Specify the ID for the VRRP interface. The IDs on both vRouters must be the same ID number.

vrrp-primary string

Specifies the primary interface for VRRP failover.

vrrp-priority number

Speicfies the priority for the VRRP interface. This is a value between 1 (lowest) and 255 (highest).

vrrp-adv-int mseconds

Specify a VRRP advertisement interval in milliseconds. The range is from 30 to 40950 with a default value of 1000.

l3-port l3port-usable-port name

Specify a Layer 3 port for the interface.

secondary-macs secondary-macs-string

Specify a secondary MAC address for the interface.

mtu bytes

Specify a MTU value in bytes between 68 and 9216.

if-nat-realm internal|external

Specify a NAT realm for the interface.

priority-tag|
no-priority-tag

Specify if you want to add a VLAN 0 priority tag on forwarded traffic.

Defaults   None.

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameters, exclusive and nic, added.

Version 2.2

The parameters vrrp-id, vrrp-priority, and vrrp-primary added.

Version 2.2.5

The parameters, l3-port, and secondary-macs, added.

Version 2.3

The parameter, vrrp-adv-int, added.

Version 2.4.1

The parameter, vlan-type, added.

Version 2.5.0

The parameter, mtu, added.

Version 2.6.0

The parameter, if-nat-realm internal|external, added.

Version 2.6.2

The parameter, vxlan, deprecated.

Version 3.0.0

The parameter, ip2 and netmask2 added. The parameters, pim, pim-dr-priority, and pim-cluster, added. The parameter, linklocal, added. The option, autov6, deprecated for the parameter, assignment.

Version 3.1.0

The parameter, fabric-nic and priority-tag, added.

Usage   You can modify the interfaces on the vRouter service on a fabric, cluster, standalone switch, or virtual network (VNET). This command modifies an interface to a vRouter service.

Examples  To modify an interface with the IP address, 192.168.10.11/32, VLAN 25, and data to vRouter service, MyvService and change the VLAN to 21, use the following command:

CLI network-admin@switch > vrouter-interface-add vrouter-name MyvService ip 192.168.10.11/32 assigment none vlan 21 if data

vrouter-interface-remove

This command is used to remove interfaces on the virtual router (vRouter) service in a fabric, cluster, standalone switch, or virtual network (VNET).

Syntax   vrouter-interface-remove vrouter-name name-string [nic nic-string]

vrouter-name name-string

Specify the name for the vRouter interface.

Specify the following interface arguments:

nic nic-string

Specify the name of the NIC.

Defaults   None.

Access   CLI

History   Command introduced in nvOS Version 1.2.1.

Usage   You can remove the interfaces on the vRouter service from a fabric, cluster, standalone switch, or virtual network (VNET). This command removes an interface to a vRouter service.

Examples  To remove eth1 NIC from the vRouter service, MyvService, use the following command:

CLI network-admin@switch > vrouter-interface-remove vrouter-name MyvService nic eth1

vrouter-interface-show

This command is used to display the interfaces on the virtual router (vRouter) service on a fabric, cluster, standalone switch, or virtual network (VNET).

Syntax   vrouter-interface-show

vrouter-name name-string

Specify the name for the vRouter interface.

Specify any of the following options:

vlan vlan-id

Specify the VLAN identifier. This is a value between 1 and 4094.

ip ip-address

Specify the IP address of the interface.

netmask netmask

Specify the netmask.

assignment none|dhcp|dhcpv6

Specify the DHCP method for IP address assignment. Note that if you specify hardware as the router type, you cannot assign IP addresses using DHCP. You must specify a static IP address.

ip2 ip-address

Specify the IP address of the interface.

netmask2 netmask

Specify the netmask.

assignment2 none|dhcp|dhcpv6

Specify the DHCP method for IP address assignment. Note that if you specify hardware as the router type, you cannot assign IP addresses using DHCP. You must specify a static IP address.

linklocal ip-address

Specify an IPv6 linklocal address.

vnet vnet-name

Specify the VNET assigned to the vRouter.

vlan-type public|private

Specify the type of VLAN for the interface.

if mgmt|data|span

Specify if the interface is a management, data or span interface.

alias-on alias-on-string

Specify an alias for the interface.

exclusive|no-exclusive

Specify if the interface is exclusive to the configuration. Exclusive means that other configurations cannot use the interface. Exclusive is specified when you configure the interface as a span interface and allows higher throughput through the interface.

nic-enable|nic-disable

Specify if the NIC is enabled or disabled.

pim|no-pim

Specify if the vRouter interface is a PIM interface.

pim-dr-priority integer

Specify the direct router (DR) priority as an integer between 1 and 4294967295. Netvisor selects the vRouter interface with higher DR priority as the designated router.

By default, all interfaces are priority 1. In case of same priority, Netvisor selects the vRouter interface with highest network address as DR.

pim-cluster|no-pim-cluster

Specify if you want to provide alternative routing for Layer 3 attached sources for leaf cluster routing configuration. It allows traffic to failover not black-hole when the unicast path to the Spine fails.

fabric-nic|no-fabric-nic

Specify if VNIC is on a VLAN used for fabric setup.

vrrp-id id-number

Specify the ID for the VRRP interface. The IDs on both vRouters must be the same ID number.

vrrp-primary string

Specifies the primary interface for VRRP failover.

vrrp-priority number

Speicfies the priority for the VRRP interface. This is a value between 1 (lowest) and 255 (highest).

vrrp-adv-int mseconds

Specify a VRRP advertisement interval in milliseconds. The range is from 30 to 40950 with a default value of 1000.

l3-port l3port-usable-port name

Specify a Layer 3 port for the interface.

secondary-macs secondary-macs-string

Specify a secondary MAC address for the interface.

mtu bytes

Specify a MTU value in bytes between 68 and 9216.

if-nat-realm internal|external

Specify a NAT realm for the interface.

priority-tag|
no-priority-tag

Specify if you want to add a VLAN 0 priority tag on forwarded traffic.

Defaults   None.

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameters, exclusive and nic, added.

Version 2.2

The parameters vrrp-id, vrrp-priority, and vrrp-primary added.

Version 2.2.5

The parameters, l3-port, and secondary-macs, added.

Version 2.3

The parameter, vrrp-adv-int, added.

Version 2.4.1

The parameter, vlan-type, added.

Version 2.5.0

The parameter, mtu, added.

Version 2.6.0

The parameter, if-nat-realm internal|external, added.

Version 2.6.2

The parameter, vxlan, deprecated.

Version 3.0.0

The parameter, ip2 and netmask2 added. The parameters, pim, pim-dr-priority, and pim-cluster, added. The parameter, linklocal, added. The option, autov6, deprecated for the parameter, assignment.

Version 3.1.0

The parameter, fabric-nic and priority-tag, added.

Usage   You can display information about the interfaces on the vRouter service on a fabric, cluster, standalone switch, or virtual network (VNET).

Examples  To display information about all interfaces on vRouter services, use the following command:

CLI network-admin@switch > vrouter-interface-show interface layout

vrouter-interface-ip-add

This command is used to migrate a vRouter interface from a single stack (IPv4) to dual stack (IPv4 and IPv6) back to a single stack (IPv4).

Syntax   vrouter-interface-ip-add

vrouter-name name-string

Specify the name of the vRouter.

nic nic-string

Specify the virtual NIC assigned to the interface.

ip ip-address

Specify the IP address assigned to the interface.

netmask netmask

Specify the netmask of the IP address.

Specify any of the following options

vnet vnet-name

Specify the VNET assigned to the vRouter.

l2-net l2-net name

Specify the Layer 2 interface.

type primary|secondary

Specify the IP address as primary or secondary.

Defaults   None

Access   Network administrator

History   

Version 3.0.0

Command introduced.

Version 3.0.4

The parameter, type, added.

Usage   Use this command to migrate a vRouter interface from a single stack (IPv4) to dual stack (IPv4 and IPv6) back to a single stack (IPv4).

Examples  To migrate an interface to dual stack with the IPv6 address, 1000::4/92, use the following syntax:

CLI network-admin@switch > vrouter-interface-ip-add vrouter-name vr1 nic eth0.10 ip 1000::4/92 vnet 0:0 l2-net 10

vrouter-interface-ip-remove

This command is used to migrate a vRouter interface from a single stack (IPv4) to dual stack (IPv4 and IPv6) back to a single stack (IPv4).

Syntax   vrouter-interface-ip-remove

vrouter-name name-string

Specify the name of the vRouter.

nic nic-string

Specify the virtual NIC assigned to the interface.

ip ip-address

Specify the IP address assigned to the interface.

Defaults   None

Access   Network administrator

History   Command introduced in Version 3.0.0.

Usage   Use this command to migrate a vRouter interface from a dual stack (IPv4 and IPv6) to single stack (IPv4 and IPv6) back to a single stack (IPv4).

Examples  To migrate an interface to single stack  and remove the IPv6 address, 1000::4/92, use the following syntax:

CLI network-admin@switch > vrouter-interface-ip-remove vrouter-name vr1 nic eth0.10 ip 1000::4/92

vrouter-interface-ip-show

This command is used to migrate a vRouter interface from a single stack (IPv4) to dual stack (IPv4 and IPv6) back to a single stack (IPv4).

Syntax   vrouter-interface-ip-remove

vrouter-name name-string

Specify the name of the vRouter.

nic nic-string

Specify the virtual NIC assigned to the interface.

ip ip-address

Specify the IP address assigned to the interface.

netmask netmask

Specify the netmask of the IP address.

Specify any of the following options

vnet vnet-name

Specify the VNET assigned to the vRouter.

l2-net l2-net name

Specify the Layer 2 interface.

type primary|secondary

Specify the IP address as primary or secondary.

Defaults   None

Access   Network administrator

History   

Version 3.0.0

Command introduced.

Version 3.0.4

The parameter, type, added.

Usage   Use this command to display a vRouter interface with dual stack (IPv4 and IPv6) IP addresses.

Examples  To display an interface to dual stack with the IPv6 address, 1000::4/92, use the following syntax:

CLI network-admin@switch > vrouter-interface-ip-show

vrouter-name      nic   vnet   vlan vlan-type ip                             assignment nic-state

------------     -----  -----  ---- --------- -----------------------------  --------------------

vr1              eth0.10 0:0    10   public    10.2.3.4/24                   static     up

vr1              eth0.10 0:0    10   public    1000::4/92                    static     up

vr1              eth0.10 0:0    10   public    fe80::640e:94ff:fe17:4f99/64  static     up