A.80 edit Server

Edits an Oracle VM Server.

Syntax

edit Server instance [ ntpServers=value ] [ roles= { VM | UTILITY } ] [ inboundMigrationLocked= { Yes | No } ] [ name=value ] [ description=value ]

Where instance is:

{ id=value | name=value }

Description

This command edits the attributes of an Oracle VM Server. Use this command set the NTP servers, role, and whether to allow running of virtual machines.

To place an Oracle VM Server into or out of maintenance mode,use the setMaintenanceMode command.

Although none of the options are mandatory, you must supply at least one option.

Options

The following table shows the available options for this command.

Option

Description

ntpServers=value

The hostname or IP address of one or more NTP servers to set the time on the Oracle VM Server. Enter options separated by commas (,), for example:

ntpServers="ntp1.example.com,ntp2.example.com"

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

roles= { VM | UTILITY }

The role for the Oracle VM Server.

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

inboundMigrationLocked= { Yes | No }

Whether to allow additional virtual machines to run on the Oracle VM Server. Setting this option to Yes prevents new or migrated virtual machines from running on the Oracle VM Server. Setting this option to No allows new or migrated virtual machines to run on the Oracle VM Server. This option does not prevent virtual machines running on the Oracle VM Server from being migrated to another.

name=value

A name to identify the Oracle VM Server.

description=value

Optional description for the Oracle VM Server . 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.

Examples

Example A.102 Adding NTP servers to an Oracle VM Server

OVM> edit Server name=MyServer ntpServer="ntp1.example.com,ntp2.example.com"

Example A.103 Changing the role of an Oracle VM Server

OVM> edit Server name=MyServer role=UTILITY runVmsEnabled=No

See Also