NAME
hpvmnet — Create and control an Integrity Virtual
Machines virtual network switch (vswitch).
SYNOPSIS
hpvmnet [ -S vswitch-name -s vswitch-number ] [ -X -M -V ] [-v]
hpvmnet -c -S vswitch-name [-n nic-id]
hpvmnet -C [ -S vswitch-name -s vswitch-number ] -n nic-id [-N new-vswitch-name]
hpvmnet -d [ -S vswitch-name -s vswitch-number ] [-F] [-Q]
hpvmnet -b [ -S vswitch-name -s vswitch_number ]
hpvmnet -h [ -S vswitch-name -s vswitch_number ] [-F] [-Q]
hpvmnet -r [ -S vswitch-name -s vswitch-number ] [-F] [-Q]
hpvmnet { -S vswitch_name -s vswitch-number } -u portid:portid[,...]:vlanid: {vlanid| none }
hpvmnet { -S vswitch-name -s vswitch-number } [ -p {all | portid} ] [-A] [ -M | -X ] [-Z] [-v]
DESCRIPTION
A virtual machine accesses its network through
a virtual network interface (vNIC) connected to a virtual network
switch (vswitch). The virtual network switch is connected in turn
to a single physical network interface (pNIC) on the VM Host. Use
the hpvmnet command to create and manage vswitches.
A vswitch works like an actual network switch.
It accepts outbound network traffic from all guests configured to
use it and transmits the traffic over the physical interface. It accepts
inbound network traffic for all guests configured to use it and directs
the traffic to the appropriate guest.
A virtual switch can be associated with at most
one physical network interface. The VM Host's physical network
interface must be attached to a network with connectivity to the desired
subnets. The network interface can be configured on the VM Host with
an IP address or multiple IP alias addresses, but this is only necessary
if the VM Host shares the interface with the vswitch and directs its
own network traffic over the card. If you alter any characteristics
of a network interface associated with a running vswitch, for instance,
through the ifconfig commands on the VM Host, you
must stop and restart the vswitch. Otherwise, any guests using that
vswitch experience intermittent network failures. Stopping and restarting
a vswitch can occur while its guests are running; guest shutdown is
not required.
You must reboot the vswitch (using the -r option) when:
You replace the physical
network card associated with the vswitch.
You change a VM Host IP
address associated with the vswitch's network interface card.
You change network interface
characteristics, for example, by using the lanadmin command to change checksum offloading (CKO).
You
notice that there is no communication from an avio_lan interface to a lan interface after booting the
guests while the vswitch is down.
You do not need to restart the guests that are
using the vswitch. After you restart the vswitch, restart communication
from the guest side. For example, on the guest, ping the VM Host.
By default, Integrity VM creates a vswitch named localnet that is not associated with a physical interface.
It is used only for communication between the guests running on the
same VM Host; the VM Host itself does not participate in a localnet. There is no nameserver or router configured
on a localnet, unless one of the guests performs
this function.
Only superusers can execute the hpvmnet command.
Two classes of virtual network
interface are supported in Integrity VM: lan and avio_lan. The lan interface is supported
on all underlying HP-UX network interface cards. The avio_lan interface is supported on selected HP-UX network interface cards
and provides accelerated performance. For examples of using the lan and avio_lan keywords, see hpvmcreate and hpvmmodify.
Options
The following options can be specified only once.
The hpvmnet command without
options displays summary information about all vswitches configured
on the VM host.
The hpvmnet command recognizes
the following command-line options and arguments:
- -S vswitch-name
Specifies the unique name
of the virtual switch. The name of the vswitch is limited to eight
characters.
The -S and -s options are mutually exclusive.
- -s vswitch-number
Specifies the unique number
of the virtual switch. The vswitch number is reported using the hpvmnet command.
The -S and -s options are mutually exclusive.
- -v
Displays the version number
of the hpvmnet output format. The version number
is displayed first, followed by the display specified by the other
options.
- -V
Displays information about
vswitches in verbose mode. If you specify the vswitch using either
the -S or -s options, network counters
are included in the display. Network counters are cleared each time
statistics are reported; the display reports the counts since the
previous display. Use the -S or -s option to specify the vswitch for which to display network counters.
The -V, -M ,
and -X options are mutually exclusive.
- -A
Displays statistics for
the avio_lan virtual network interfaces in the following
format:
Vswitch Name : hostnet
Max Number of Ports : 100
Port Number : 3
Port State : Reserved
Active VM :
Untagged VlanId : none
Reserved VMs : aviotest
Adaptor : avio_lan
Inbound Octets : 961698882
Inbound Unicast Pkts (wire) : 20000
Inbound Unicast Pkts (local) : 40000
Inbound Non-Unicast Pkts (wire) : 10000
Inbound Non-Unicast Pkts (local) : 30000
Inbound Discards : 36
Outbound Octets : 3557451342b
Outbound Unicast Pkts (wire) : 20000
Outbound Unicast Pkts (local) : 300000
Outbound Non-Unicast Pkts : 400000
Outbound Discards : 0
|
- -M
Displays verbose resource
information in a machine-readable format.
Individual fields are separated by one of the following delimiters:
The colon (:) separates each field and resource type.
The semicolon (;) separates subfields of a resource type.
The comma (,) separates individual items in a list of similar items.
The -V, -M and -X options are mutually exclusive.
- -X
Displays verbose resource
information in the XML format.
The -V, -M, and -X options
are mutually exclusive.
- -Z
Used with to the -A option, clears statistics after retrieving them.
- -F
Omits the confirmation
dialog before halting, deleting, or rebooting the vswitch. This option
is intended for use by scripts and other noninteractive applications
(Force mode).
- -Q
Quietly performs the command.
The default is to prompt for confirmation of the command before performing
it.
- -c
Creates a new vswitch.
- -d
Deletes an existing vswitch.
- -b
Starts an existing vswitch.
Vswitches must be started before they accept guest traffic. Note that
Integrity VM attempts to automatically start all existing vswitches
when Integrity VM is started.
- -h
Stops a vswitch.
- -r
Stops and restarts a vswitch.
- -n nic-id
Designates the network
interface on the VM Host that this vswitch uses. Network interfaces
are displayed by the lanscan command. If -n is not specified when creating a vswitch, a local vswitch
is created.
- -u portid:portnumber:vlanid:{vlanid | none}
Specifies the VLAN identifier
for the specific vswitch and port. Configure VLANs by specifying the
number of the port on the vswitch (portnumber) to use for VLAN communication, and the VLAN identifier (vlanid). Virtual machines that are configured to use the
VLAN can communicate with one another. To disable a VLAN, specify none for the VLAN identifier.
Only virtual machines that are configured with the same VLAN identifier
on their ports can communicate with one another. To disable VLANs
on a port , specify none for the VLAN identifier.
Virtual machines that do not have any VLANs configured on their vswitch
port (which is the default) cannot communicate over that port with
virtual machines that have a VLAN configured on their vswitch port.
The port number is used to reserve a specific
port for a particular virtual machine's network resource. This
port number can be used later in the hpvmnet command
to configure VLAN rules on the port. You can also first set up VLAN
rules on the virtual switch and later create virtual machines referencing
the specific port numbers.
- -p {all | portid}
Specifies the port number
on the vswitch. To specify all the ports on the vswitch, enter all. This command displays information about VLAN ports
configured for the specified vswitch. Do not use the -p option with the -V option.
- -C
Changes the specified
vswitch. If used with the -N option, the changes
are made to the cloned vswitch. You must include either the -S or the -s option.
Only those ports with tagged VLAN are cloned.
- -N new-vswitch-name
Creates a new vswitch
based on the existing vswitch. For new-vswitch-name, specify the unique name of the new virtual switch. The name of
the vswitch is limited to eight characters. You must include either
the -S or the -s option.
RETURN VALUES
The hpvmnet command exits with
one of the following values:
- 0: Successful completion.
- 1: One or more error
conditions occurred.
DIAGNOSTICS
The hpvmnet command displays
error messages for any of the following conditions:
An invalid option is specified.
An invalid value is specified
for an option.
The vswitch-name or vswitch-number argument does not exist,
cannot be accessed, is not a vswitch, or is corrupt.
A value was omitted for
an argument that requires one, or a value was supplied for an argument
that does not take one.
The hpvmnet command and Integrity Virtual Machines are at different revision
levels.
AUTHORS
The hpvmnet command was developed
by HP.
SEE ALSO
On the VM Host:
hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M)hpvminfo(1M), hpvmmigrate(1M), hpvmmodify(1M), hpvmpubapi(3), hpvmremove(1M), hpvmresources(5), hpvmsar(1M)hpvmstart(1M), hpvmstatus(1M), hpvmstop(1M), hpvmupgrade(1M)p2vassist(1M)
On the Integrity VM guest:
hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
Printable version
