Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP Integrity Virtual Machines Version 4.0 Installation, Configuration, and Administration > Integrity VM Manpages

hpvmnet(1M)

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

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.

EXAMPLES

Create the vswitch switch2 on lan0:

# hpvmnet -c -S switch2 -n 0

Display all the vswitches on this VM Host:

# hpvmnet Name Number State Mode NamePPA MAC Address IP Address ======== ====== ======= ========= ======== ============== =============== localnet 1 Up Shared N/A N/A hostnet 296 Up Shared lan1 0x00306e4a92ef 16.116.8.99 vmvlan 13 Up Shared lan900 0x00306e4bc7bf myswitch 241 Up Shared lan0 0x00306e4a93e6

Display the verbose attributes of vswitch hostnet:

# hpvmnet -S hostnet -V Name : hostnet number : 296 PID : 1672 State : Up Mode : Shared NamePPA : lan1 Host MAC Address : 0x00306e4a92ef Host IPv4 Address : 16.116.8.99 Host IPv6 Address : fe80::230:6eff:fe4a:92ef Number of guests : 5 Guest's Name : armyvm1 MAC Address : 0xEE8D40584D28 IPv4 Address : Guest halted Vswitch Port : 4 Guest's Name : armyvm1 MAC Address : 0x8A0F12DD5B48 IPv4 Address : Guest halted Vswitch Port : 3 Guest's Name : armyvm2 MAC Address : 0x42F86E004C5D IPv4 Address : Guest halted Vswitch Port : 5 Guest's Name : armyvm4 MAC Address : 0x762704ACBC4D IPv4 Address : 106.16.5.24 IPv6 Address : fe80::ee8d:40ff:fe58:4d28 Vswitch Port : 1 Guest's Name : armyvm3 MAC Address : 0xD2E856A02638 IPv4 Address : armyvm3.mycom.com Vswitch Port : 2 Packets in : 37934 Packets out to stream : 967 Packets out to guest : 31381 Packets dropped : 4686 Broadcasts : 31029 Counter 0 : 0 Counter 1 : 0 Counter 2 : 0 Counter 3 : 0 Cycles in : 7728 Cycles out to stream : 27387 Cycles out to guest : 5509 Cycles switch packet : 2345

Delete the vswitch named switch2:

# hpvmnet -d -S switch2 hpvmnet: Remove the vswitch 'switch2'? [n/y]: y

Delete the vswitch with the vswitch ID of 6, and omit the confirmation dialog:

# hpvmnet -d -s 6 -F

Start the vswitch named switch1:

# hpvmnet -b -S switch1

Stop the vswitch named switch1:

 y
# hpvmnet -h -S switch1
hpvmnet: Halt the vswitch 'switch1'? [n/y]:

Configure port 2 on vswitch switch1 with VLAN identifier 100:

# hpvmnet -S switch1 -u portid:2:vlanid:100

Display information about VLAN ports configured for the vswitch named myswitch:

# hpvmnet -S myswitch Name Number State Mode NumberPPA MAC Address IPv4 Address ======== ====== ======= ========= ====== ============== =============== myswitch 2 Up Shared lan1 0x00306ef3120c 1.2.3.4 [Port Configuration Details] Port Port Port Untagged Number of Active VM Number state Adaptor VLANID Reserved VMs ======= ============ ======== ======== ============ ============ 1 Reserved lan none 1 2 Active lan none 1 config2 3 Reserved avio_lan none 1 4 Active lan none 1 winguest2 [Configured IP Address(es)] 106.16.4.12 fe80::230:6eff:fe4a:92ef # hpvmnet -S myswitch -p 4 Vswitch Name : myswitch Max Number of Ports : 100 Port Number : 4 Port State : Active Active VM : winguest2 Untagged VlanId : none Reserved VMs : winguest2 Adaptor : avio_lan

To switch over the lan1 from lan0:

# hpvmnet -C -S hostnet -n 0 # hpvmnet -S hostnet Name Number State Mode NamePPA MAC Address IPv4 Address ======== ====== ======= ========= ======== ============== =============== hostnet 296 Up Shared lan0 0x00306e4a93e6

To clone the vswitch, enter the following command:

# hpvmnet -C -n 1 -S vmvlan -N clone # hpvmnet -S clone Name Number State Mode NamePPA MAC Address IPv4 Address ======== ====== ======= ========= ======== ============== =============== clone 297 Down Shared lan1 [Port Configuration Details] Port Port Port Untagged Number of Active VM Number state Adaptor VLANID Reserved VMs ======= ============ ======== ======== ============ ============ 2 Available avio_lan 20 0

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
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2008 Hewlett-Packard Development Company, L.P.