Server User Manual

Oracle VM Agent API
3-4 Oracle VM Server User’s Guide
■ Testing the Oracle VM Agent Connection
■ Remotely Starting a Guest with the Oracle VM Agent API
■ Remotely Stopping a Guest with the Oracle VM Agent API
3.7.1 Testing the Oracle VM Agent Connection
You can use the do_rpc.py utility to remotely test the connection to Oracle VM
Agent from another computer with Oracle VM Server installed. The following
command tests the connection to Oracle VM Agent:
# /opt/ovs-agent-2.2/utils/do_rpc.py https://username:password@hostname:8899 echo
hello
Where username and password refer to the Oracle VM Agent login credentials, and
hostname refers to the host name of the computer on which Oracle VM Agent is
installed. If the connection is successful, the following is displayed:
echo [’hello’]
=> success:echo=hello
If this command does not display any echo information, or displays an error, check
your network connection. The following error is displayed if the Secure Socket Layer
(SSL) facility is disabled.
socket error! code=1, msg=error:140770FC:SSL routines:SSL23_GET_SERVER_
HELLO:unknown protocol
To enable SSL, edit the /etc/ovs-agent/agent.ini file and set the ssl parameter
to enable.
ssl=enable
Restart the Oracle VM Agent for the changes to take effect:
# /sbin/service ovs-agent restart
3.7.2 Remotely Starting a Guest with the Oracle VM Agent API
You can use the do_rpc.py utility to remotely start a guest on an Oracle VM Server
from another computer with Oracle VM Server installed. The following command
remotely starts a guest on an Oracle VM Server:
# /opt/ovs-agent-2.2/utils/do_rpc.py https://username:password@hostname:8899
start_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 starts without error,
the following is displayed:
start_vm ['/OVS/running_pool/guest']
=>success=ip=10.1.1.1
Note: The following sections discuss commands that must be run
from a computer on which Oracle VM Server is installed. The
functionality discussed is to be used to communicate from one Oracle
VM Server to another Oracle VM Server.