3 Oracle VM Agent

Oracle VM Manager communicates with Oracle VM Agent to create and manage guests on an Oracle VM Server. Oracle VM Agent is installed and configured during the installation of Oracle VM Server. You do not need to install Oracle VM Agent separately. Oracle VM Agent is installed into:

/opt/ovs-agent-2.2

Oracle VM Agent logs are located in:

/var/log/ovs-agent/

This Chapter discusses the configuration and control of Oracle VM Agent. It contains:

Oracle VM Agent Command-Line Tool
Configuring Oracle VM Agent
Starting Oracle VM Agent
Stopping Oracle VM Agent
Monitoring Oracle VM Agent

See Appendix D, "Oracle VM Agent Architecture" for more detailed information.

3.1 Oracle VM Agent Command-Line Tool

The ovs-agent command-line tool enables you to configure and control Oracle VM Agent. The following sections discuss using the ovs-agent command-line tool. See "ovs-agent" in Appendix A, "Command-Line Tools" for more details on the ovs-agent command-line tool options.

3.2 Configuring Oracle VM Agent

Oracle VM Agent is configured during installation. A default user is created with the username admin, and the password you set during installation.

You can change the default configuration with the Oracle VM Agent configuration script, ovs-agent. To configure Oracle VM Agent:

As root, run the Oracle VM Agent configuration script:
```
# service ovs-agent configure
```
You are prompted to enter the IP addresses that are allowed to access to the computer.
```
;network access control by ip --
;rules := if addr.match(allow) and not addr.match(deny): return True
;pattern items delimited by comma and could be
;10.1.1.1   #single ip
;10.1.1.*    #range
;10.1.1.1/24 #range
;default to allow all, deny none
allow=*
allow=
```
Enter * (asterisk) to allow all IP addresses access to the computer. Alternatively, enter a list of IP addresses for computers for which you want to allow access, while restricting all others. The default is to allow all computers to access the computer (*). For example, to allow all computers in the domain example.com, enter
```
*.example.com
```
Press Enter.
You are prompted to enter the IP addresses that are denied access to the computer.
```
now allow=*.example.com
 
deny=
deny=
```
Leave this field empty (does not deny any IP addresses), or enter * to deny all IP addresses access to the computer. Alternatively, enter a list of IP addresses for which you want to deny access to the computer, while allowing all others. The default is to deny no computers access to the computer.

Press Enter.
You are prompted whether you want to change the Oracle VM Agent password.
```
now deny=

would you like to modify password to communicate with agent?[y/N]
```
Enter y to change the Oracle VM Agent password, or N to continue without changing the password. Press Enter.
Restart Oracle VM Agent for the configuration changes to take effect.
```
# service ovs-agent restart
```

3.3 Starting Oracle VM Agent

Oracle VM Agent is started automatically when the computer starts. To manually start Oracle VM Agent, enter

# service ovs-agent start

Oracle VM Agent is started.

Alternatively, if Oracle VM Agent is already running, you can stop and restart it with the command

# service ovs-agent restart

Oracle VM Agent is stopped, and restarted.

3.4 Stopping Oracle VM Agent

To stop Oracle VM Agent, enter

# service ovs-agent stop

Oracle VM Agent is stopped.

Note:

When Oracle VM Agent is stopped, Oracle VM Manager cannot manage the Oracle VM Server or the guests running on it.

If you shut down or restart the Oracle VM Agent on an HA-enabled Oracle VM Server on which guests are running you are prompted to:

Migrate or Power Off the guest(s) using Oracle VM Manager. When the guests have been migrated or Powered Off, the Oracle VM Agent shuts down.
Shut down the guest(s) and shut down Oracle VM Agent.
Cancel the shutdown operation.

3.5 Monitoring Oracle VM Agent

To get information on the Oracle VM Agent daemon, enter

# service ovs-agent status

Information on the Oracle VM Agent daemon is displayed.