Oracle Audio Technologies E10898-02 manual Oracle VM Agent Utilities

Oracle VM Agent Utilities

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.

Oracle VM Agent 3-5