The ovm_vmmessage utility lets you send a
message to
a running virtual machine, or to query the value of a message
sent from within a virtual machine to Oracle VM Manager using the
Oracle VM API messaging interface. These values are basic
key/value pairs such as foo=bar
.
New Oracle VM templates released by Oracle contain a configuration utility called ovmd. This utility is used to perform first-boot installation configuration either locally from the virtual machine console or remotely through the messaging interface provided by this utility. The ovmd utility also allows the owner of the virtual machine to send messages back to Oracle VM Manager. For more information about ovmd, and the Oracle VM Guest Additions in general, see Chapter 3, Oracle VM Guest Additions.
To send messages you combine -k
and key
-V
. To retrieve messages,
use value
-q
.
key
Syntax
ovm_vmmessage
{
-u
} {
username
-p
|
password
-E
} {
-h
} [
hostname
-v
] [
vm_name
-k
] [
key
-V
] [
value
-q
]key
Options
The following table shows the available options for this command.
Option | Description |
---|---|
| The username of an Oracle VM Manager admin user. This option is required. |
{
|
The # export OVMUTIL_PASS=
This option is required. |
| The hostname of the server running Oracle VM Manager. This option is required. |
| The virtual machine name. The virtual machine name is the name you assign during the creation of the virtual machine. |
| The key to send. |
| The value to send with the key. This command must be used in combination with:
|
| The key to query. |
Examples
Example 2.5 Sending a message to a virtual machine
# ./ovm_vmmessage -u admin -ppassword
-h localhost -v MyVM02 -k foo -V bar Oracle VM VM Message utilityversion
. Connected. VM : 'MyVM02' has status : Running. Sending message. Message sent successfully.
Example 2.6 Retrieving a message from a virtual machine
# ./ovm_vmmessage -u admin -ppassword
-h localhost -v MyVM02 -q foo Oracle VM VM Message utilityversion
. Connected. VM : 'MyVM02' has status : Running. Querying for key 'foo'. Query successful. Query for Key : 'foo' returned value 'bar'. Key set 27 minutes ago.