Add an IP interface

Create an IP interface on the vRouter.

It is over this interface that inbound and outbound traffic can be filtered using access control lists.The interface links a lower-layer port or port representation to the IP instance on the switch. This command creates the link and configures the characteristics of the interface. You can configure an IP interface directly on an Ethernet port, on a LAG, or on a VLAN.

If you set a value for the packetTrace or eventFilter arguments on a layer, and then create an interface in the layer, the value is inherited. For example, if you set packet trace to enabled in vlan.10, and then add interface eth.1.5 to vlan.10, packet trace is enabled for interface eth.1.5. This allows you to begin debugging issues before an interface is fully configured.

Access mode

config

Syntax

vSwitch-name vRouter-name ip interface

Arguments

Field Name Description
ifName IfName The name of the interface to which you want to assign an IP address (the interface that connects to the IP instance). This could be either vlan.x, lag.x, eth.x.x, loopback, or ip.vSwitch:vRouter. If the interface does not already exist, the system returns an error.
adminState enumeration Optional: The administrative (manually configured) status of the interface.

The default setting is "enabled".

Valid values: enabled, disabled
eventFilter enumeration Optional: The event filter level set for the interface.

The default setting is "informational".

Valid values:
  • emergency : The system detected a serious problem; further operation can cause damage.
  • alert : The system detected a problem that requires operator attention.
  • critical : The system software detected a critical problem requiring a restart.
  • error : The system detected a significant problem, but continues operating.
  • warning : The system detected a problem, but was able to recover.
  • notice : The system detected normal activity, but event was generated for review.
  • informational : The system detected a normal operational activity.
  • debug : The system detected normal operational activities and unexpected events.
linkUpDownTrap enumeration Optional: Specifies if link up/down SNMP traps should be sent on the interface.

The default setting is "enabled".

Valid values:
  • enabled : Link up/down trap enabled.
  • disabled : Link up/down trap disabled.
mtu integer Optional: The Maximum Transmission Unit (MTU) of the interface. This is the maximum length, in number of bytes, of a packet transmitted over this interface. Packets are fragmented to this size. Can only be modified on IP interfaces.

Valid values are from 576 to 9000; the default setting is "1500".
packetTrace enumeration Optional: The setting for the packet trace capability. When enabled, the system sends debug messages relating to packets moving through the system. Because of the large amount of data generated by setting this variable, you should only enable it when you want to debug your network by verifying where packets are going in the system.

The default setting is "disabled".

Valid values: enabled, disabled
description text Optional: The text string you assigned to the interface. You can use this value to identify a interface name (for example, vlan.10) with a meaningful description.

The default setting is "".