ovmd - man pages section 8: System Administration Commands

Language:

ovmd (8)

Name

ovmd - Oracle virtual machine configuration and message daemon

Synopsis

Daemon:
    /usr/lib/ovmd [-d LEVEL]

    svc:/system/ovm-guest:default

Command line:
    /usr/lib/ovmd [-p key=value] [-g key] [-r key] [-e events]
       [-s scripts] [-d LEVEL] [-xlvh]

Description

Ovmd, a bi-directional messaging channel between Oracle VM Manager and the guest, allows first-boot installation configuration, and is capable of sending and receiving messages consisting of key-value pairs. The ovmd command operates as both an Oracle VM Manager guest daemon and a command line tool for sending and receiving messages to the VM host.

As a daemon, it is controlled through the service management facility (SMF) service instance:

svc:/system/ovm-guest:default

At the command line, only users with sufficient privilege (PRIV_SYS_DEVICES) may run ovmd.

Options

The following options are supported by /usr/lib/ovmd:

–p, –-set-param=PARAM

Sets the parameter in key=value format.

–g, –-get-param=KEY

Gets the parameter value.

–r, –-delete-param=KEY

Deletes the parameter by the key name.

–x, –-delete-params

Deletes all parameters.

–l, –-list-params

Lists all parameters.

–e, –-event=EVENT

Injects event.

–s, –-script=SCRIPT

Runs script.

–d, –-debug=LEVEL

Sets the debug level to any one of the following:

0: DEBUG_OFF
1: DEBUG_STDERR
2: DEBUG_SYSLOG

The default level is 2.

–v, –-version

Shows version number and exits.

–h, –-help

Shows the help information.

Examples

Example 1 Enabling ovmd

The following example describes the turning on the ovmd command:

example% svcadm enable ovm-guest

Example 2 Sending a Message From the Guest to Oracle VM Manager

The following example displays the syntax to send information to Oracle VM Manager by using the ovmd command:

example% ovmd -p key1=value1
example% ovmd -p key2=value2

The message shows up in the Oracle VM Manager user interface, as a Virtual 90 Machine API Incoming Message event for the virtual machine in question. When you expand the event, the description shows the key-value pair and the date and time when the information exchange took place.

Example 3 Retrieving the Message Sent From Oracle VM Manager

The following example displays the syntax to retrieve the message sent from Oracle VM Manager by using the ovmd command:

example% ovmd --list
{"key1":"value1"}
{"key2":"value2"}

Example 4 Retrieving all messages

The ovmd –-list command retrieves all messages, both sent and received. You can identify the specific message you are looking for by its key. To remove obsolete messages, use the following syntax:

example% ovmd -r key1
example% ovmd --list
{"key2":"value2"}

Files

/dev/xen/ovmapi (x86)
/dev/ovmapi (SPARC)

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	system/management/ovm-guest-additions
Interface Stability	Committed

man pages section 8: System Administration Commands