This sections provides an example of a message exchange between Oracle VM Manager and a running Oracle Linux virtual machine with Oracle VM Guest Additions installed. More information about the messaging utility can be found in Section 2.5, “Using Oracle VM Virtual Machine Messaging”.
Sending a message from the guest to Oracle VM Manager.
Using ovmd
, you send information to your
Oracle VM Manager using the following syntax:
# ovmd -p key1=value1
The message shows up in the Oracle VM Manager user interface, as a Virtual 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.
The message from the guest can also be retrieved via the Oracle VM Managercommand line utility ovm_vmmessage. To do so, you query the key and the value is returned in the response:
# ./ovm_vmmessage -u admin -p password
-h localhost -v MyVM02 -q key1
Oracle VM VM Message utility 0.5.2.
Connected.
VM : 'MyVM02' has status : Running.
Querying for key 'key1.
Query successful.
Query for Key : 'key1' returned value 'value1'.
Key set 7 minutes ago.
Sending a message from Oracle VM Manager to a virtual machine.
Using ovm_vmmessage
, you send information to a virtual machine using
the following syntax:
# ./ovm_vmmessage -u admin -p password
-h localhost -v MyVM02 -k key2 -V value2
Oracle VM VM Message utility 0.5.2.
Connected.
VM : 'MyVM02' has status : Running.
Sending message.
Message sent successfully.
Using ovmd
from within the guest, you can
retrieve the message sent from Oracle VM Manager using the following
syntax:
# ovmd --list {"key1":"value1"} {"key2":"value2"}
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:
# ovmd -r key1 # ovmd --list {"key2":"value2"}