test

Logical Domains 1.3 Administration Guide

Managing a Virtual Network Device

This section describes adding a virtual network device to a domain, setting options for an existing virtual network device, and removing a virtual network device.

ProcedureAdd a Virtual Network Device

  1. Use the following command syntax to add a virtual network device.


    # ldm add-vnet [mac-addr=num] [mode=hybrid] [pvid=[port-vlan-id]] 
  [linkprop=phys-state] [vid=vlan-id1,vlan-id2,...] [mtu=size] [id=network-id]
  if-name vswitch-name ldom

    Where:

    • mac-addr=num is the MAC address for this network device. The number must be in standard octet notation; for example, 80:00:33:55:22:66. See Assigning MAC Addresses Automatically or Manually for more information.

    • mode=hybrid to request the system to use NIU Hybrid I/O on this vnet if possible. If it is not possible, the system reverts to virtual I/O. This hybrid mode is considered a delayed reconfiguration if set on an active vnet. See Using NIU Hybrid I/O for more information.

    • pvid=port-vlan-id specifies the VLAN to which the virtual network device needs to be a member, in untagged mode. See Using VLAN Tagging With Logical Domains Software for more information.

    • linkprop=phys-state specifies whether the virtual network device reports its link status based on the underlying physical network device. When linkprop=phys-state is specified on the command line, the virtual network device link status reflects the physical link state. By default, the virtual network device link status does not reflect the physical link state.

      Specify this option to use link-based IPMP. See Using Link-Based IPMP in Logical Domains Virtual Networking.

    • vid=vlan-id specifies one or more VLANs to which a virtual network device needs to be a member, in tagged mode. See Using VLAN Tagging With Logical Domains Software for more information.

    • mtu=size specifies the maximum transmission unit (MTU) of a virtual network device. Valid values are in the range of 1500-16000.

    • id=network-id is the ID of a new virtual network device. By default, ID values are generated automatically, so set this property if you need to match an existing device name in the OS. See Virtual Device Identifier and Network Interface Name.

    • if-name, interface name, is a unique name to the logical domain, assigned to this virtual network device instance for reference on subsequent ldm set-vnet or ldm rm-vnet commands.

    • vswitch-name is the name of an existing network service (virtual switch) to which to connect.

    • ldom specifies the logical domain to which to add the virtual network device.

ProcedureSet Options for an Existing Virtual Network Device

  1. Use the following command syntax to set options for a virtual network device that already exists.


    # ldm set-vnet [mac-addr=num] [vswitch=vswitch-name] [mode=[hybrid]] 
  [pvid=[port-vlan-id]] [linkprop=[phys-state]] [vid=[vlan-id1,vlan-id2,...]]
  [mtu=[size]] if-name ldom

    Where:

    • mode= (left blank) disables NIU Hybrid I/O.

    • if-name, interface name, is the unique name assigned to the virtual network device you want to set.

    • ldom specifies the logical domain from which to remove the virtual network device.

    • Otherwise, the command arguments are the same as described in Add a Virtual Network Device.

ProcedureRemove a Virtual Network Device

  1. Use the following command syntax to remove a virtual network device.


    # ldm rm-vnet [-f] if-name ldom

    Where:

    • -f attempts to force the removal of a virtual network device from a logical domain. The removal might fail.

    • if-name, interface name, is the unique name assigned to the virtual network device you want to remove.

    • ldom specifies the logical domain from which to remove the virtual network device.