A.40 create Network

Creates an Ethernet-based network.

Syntax

create Network [ roles= { MANAGEMENT | LIVE_MIGRATE | CLUSTER_HEARTBEAT | VIRTUAL_MACHINE | STORAGE } ] name=value [ description=value ] [ on Server instance ]

Where instance is:

{ id=value | name=value }

Description

This command creates an Ethernet-based network. To create a local network on an Oracle VM Server, use the on Server instance option. You can only create a local network for virtual machine networks (using the roles=VIRTUAL_MACHINE option), as shown in Example A.54, “Creating a local network on an Oracle VM Server”. You cannot use a local network for traffic such as storage, or cluster heartbeat. If you attempt to create a local network and do not specify the role, its value is automatically set to VIRTUAL_MACHINE.

Options

The following table shows the available options for this command.

Option

Description

roles= { MANAGEMENT | LIVE_MIGRATE | CLUSTER_HEARTBEAT | VIRTUAL_MACHINE | STORAGE }

The network roles. Enter options separated by commas (,), for example:

roles='VIRTUAL_MACHINE,STORAGE'

To set an empty roles option, use roles="".

Note that this attribute is automatically assigned the value VIRTUAL_MACHINE if this option is not specified, since a local network may only support this role. An exception is returned if you attempt to specify multiple roles for this network type.

name=value

A name to identify the network.

description=value

Optional description for the network. value is a maximum of 4,000 characters.

To set an empty description, use description="".

{ id=value | name=value }

The instance of the object using either the id or name option, for example name=MyServer.

Note

Any create command only creates a single instance of an object, and therefore only accepts a single object instance as an attribute. Providing more than one object of the same attribute type as a parameter always results in the last attribute value taking precedence.

Examples

Example A.53 Creating a network

OVM> create Network name=MyVMNetwork roles=VIRTUAL_MACHINE 

Example A.54 Creating a local network on an Oracle VM Server

OVM> create Network name=MyLocalNetwork roles=VIRTUAL_MACHINE on Server name=MyServer

See Also