Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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

See Also

Oracle VM Utilities Guide for Release 3 (https://docs.oracle.com/cd/E26996_01/E35591/E35591.pdf)