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