nic


The <nic> element specifies the virtual network adapter to be updated on the host by the host operating-system network adapter.

The following table contains the definitions of the child elements of <nic>:

Child elements of <nic>

Element

Definition

Required

<ip>

Contains the IP address elements of the virtual network adapter that must be updated

No

<dhcp>

Indicates whether dynamic host control protocol (DHCP) is enabled

If <dhcp> is set to true, you cannot explicitly set the <ip-address> and the <subnet-mask> elements.

Valid values: true, false

Yes

<ip-address>

Specifies the IP address used by the network adapter

All IP addresses are specified using the IPv4 dot notation.

Example: "192.168.0.1"

Subnet addresses and netmasks are specified using the same notation.

  • When <dhcp> is enabled, <ip-address> reflects the current IP configuration and cannot be set.
  • When <dhcp> is disabled, <ip-address> can be set explicitly.

No

<subnet-mask>

Specifies the subnet mask

  • When <dhcp> is enabled, <subnet-mask> reflects the current IP configuration and cannot be set.
  • When <dhcp> is disabled, <subnet-mask> can be set explicitly.

Conditional

<mac>

Specifies the media access control (MAC) address of the virtual network adapter

No

<portgroup>

Specifies the name of the port group to which the virtual NIC connects

No

<mtu>

Specifies the maximum transmission unit for the packet, in bytes, for the virtual NIC

This property is applicable to vmkernel virtual NICs and is ignored if specified for service console virtual NICs. If the <mtu> element is not specified, the default value is used.

Default value: 1500

No

The following figure shows the XML sample for <nic>:

XML sample for <nic>

<nic>
  <ip>
    <dhcp></dhcp>
    <ip-address></ip-address>
    <subnet-mask></subnet-mask>
  </ip>
  <mac></mac>
 <portgroup></portgroup>
 <mtu></mtu>
</nic>
Warning

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Atrium Orchestrator Content 20.15.02