ovmd - Oracle virtual machine configuration and message daemon
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]
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.
The following options are supported by /usr/lib/ovmd:
Sets the parameter in key=value format.
Gets the parameter value.
Deletes the parameter by the key name.
Deletes all parameters.
Lists all parameters.
Injects event.
Runs script.
Sets the debug level to any one of the following:
0- DEBUG_OFF
1- DEBUG_STDERR
2- DEBUG_SYSLOG. The default level is 2.
Shows version number and exits.
Shows the help information.
The following example describes the turning on the ovmd command:
example% svcadm enable ovm-guestExample 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 ManagerThe 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"}
/dev/xen/ovmapi (x86)
/dev/ovmapi (SPARC)
See attributes(5) for descriptions of the following attributes:
|
Oracle VM Utilities Guide for Release 3 (https://docs.oracle.com/cd/E26996_01/E35591/E35591.pdf)