Server User Manual

Oracle VM Agent Utilities
Oracle VM Agent 3-5
3.7.3 Remotely Stopping a Guest with the Oracle VM Agent API
You can use the do_rpc.py utility to remotely stop a guest on an Oracle VM Server
from another computer with Oracle VM Server installed. The following command
remotely stops a guest on an Oracle VM Server:
# /opt/ovs-agent-2.2/utils/do_rpc.py https://username:password@hostname:8899 stop_
vm /OVS/running_pool/guest
Where username and password refer to the Oracle VM Agent login credentials,
hostname refers to the host name of the computer on which Oracle VM Agent is
installed, and guest refers to the name of the guest. If the guest stops without error,
the following is displayed:
stop_vm ['/OVS/running_pool/guest']
=>success
3.8 Oracle VM Agent Utilities
A number of utility scripts are included with Oracle VM Agent, and you can use these
to monitor and manage guests. The utility scripts discussed in this section enable you
to perform actions such as:
■ Monitoring a Guest with the Oracle VM Agent
■ Deleting a Guest with the Oracle VM Agent
3.8.1 Monitoring a Guest with the Oracle VM Agent
You can use the db_kfv.py utility to monitor a guest. To check the status of a guest,
enter:
# /opt/ovs-agent-2.2/db/db_kfv.py vm guest status
The status of the guest is displayed. For example, if the guest is not running, the
following is displayed:
/OVS/running_pool/guest status(now)=>DOWN
3.8.2 Deleting a Guest with the Oracle VM Agent
You can use the db_del.py utility to delete a guest. To delete a guest, enter:
# /opt/ovs-agent-2.2/db/db_del.py database guest
For example, to delete a guest named myguest, enter:
# /opt/ovs-agent-2.2/db/db_del.py vm myguest
The entries in /OVS/running_pool/myguest are removed and the guest deleted.