Skip Headers
Oracle® VM Server User's Guide
Release 2.2

Part Number E15444-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

B Oracle VM Server Configuration File

This Appendix contains information on the entries in the Oracle VM Server configuration file. It contains:


Oracle VM Server Configuration File

This section contains information on configuring Oracle VM Server using the configuration file. The configuration file options are available in the /etc/xen/xend-config.sxp file. When you make changes to this file, you must restart Oracle VM Server for the changes to take effect.

Logfile Options

logfile {location}

Specifies the location of the Oracle VM Server log which contains detailed information on guest start up, shut down, configuration, and error conditions. The default location is /var/log/xen/xend.log.

(logfile /var/log/xen/xend.log)
loglevel {CRITICAL or FATAL | ERROR | WARN or WARNING | INFO | DEBUG}

Sets the level of verbosity for the logfile parameter. The default is DEBUG.

(loglevel DEBUG)

Oracle VM Server API Options

xen-api-server {(access-method) ...}
access-method {(for local access): [(unix [authtype])]}
access-method {(for remote access): ([ipaddress]:port [authtype [host-access [ssl-key [ssl-cert]]]])}

Sets the configuration of the Oracle VM Server API which uses an XML-RPC interface to control and monitor guests and the dom0 host.

A list of access method entries should be provided, each entry in the list enclosed in parentheses, and the list itself enclosed in its own parentheses.

If dom0 local access is required, the access method entry should begin with the unix parameter. This creates a unix socket in a directory on the dom0 file system. An authtype parameter may also be supplied as a second argument.

If remote access is required, the access method entry should take a TCP port number as its first argument, or an ipaddress:port number pair. This TCP port is used to listen for incoming Oracle VM Server API requests on all dom0 network interfaces, or only on one specific interface if an IP address of a dom0 interface is given.

The optional authtype parameter can be set to none or pam (Pluggable Authentication Model).

The optional host-access parameter can be a list of space separated regular expressions to list the host IP addresses or host names to allow access. This parameter is only enabled for remote access.

The optional ssl-key is the private key for SSL communication. This parameter is only enabled for remote access.The optional ssl-cert is the SSL certificate for SSL communication. This parameter is only enabled for remote access.

The default is unix.

(xen-api-server ((10.1.1.1:9363 none)(unix none)))
(xen-api-server ((9363 pam '^localhost$ example\\.com$')(unix none)))
(xen-api-server ((9367 pam '' /etc/xen/xen-api.key /etc/xen/xen-api.crt)))
(xen-api-server ((unix)))

Oracle VM Server Options

xend-http-server {yes | no}

Sets the original Xen remote interface. This setting may be needed for some legacy applications that use HTTP. The default is no.

(xend-http-server yes)
xend-unix-server {yes | no}

Sets the original Xen remote interface. This setting may be needed for some legacy applications that use a local unix socket. The default is no.

(xend-unix-server yes)
xend-tcp-xmlrpc-server {yes | no}

Sets the legacy XML-RPC interface. This setting may be needed for some applications that use XML-RPC over TCP. The default is no.

(xend-tcp-xmlrpc-server no)
xend-unix-xmlrpc-server {yes | no}

Sets the legacy XML-RPC interface. This setting may be needed for some applications that use XML-RPC over unix sockets. The default is yes.

(xend-unix-xmlrpc-server yes)
xend-relocation-server {yes | no}

Sets the Oracle VM Server used for the live migration of domains. The default is no.

(xend-relocation-server no)
xend-unix-path {path}

Sets the path for the xend-unix-server socket parameter. The default is /var/lib/xend/xend-socket.

(xend-unix-path /var/lib/xend/xend-socket)
xen-tcp-xmlrpc-server-address {IPAddress}

Sets the IP address Oracle VM Server should use for the legacy TCP XMLRPC interface. This setting is used if xen-tcp-xmlrpc-server is set. The default is localhost.

(xen-tcp-xmlrpc-server-address 'localhost')
xen-tcp-xmlrpc-server-port {port}

Sets the port Oracle VM Server should use for the legacy TCP XMLRPC interface. This setting is used if xen-tcp-xmlrpc-server is set. The default is 8006.

(xen-tcp-xmlrpc-server-port 8006)
xend-tcp-xmlrpc-server-ssl-key-file {key}

Sets the SSL key file for the legacy XML-RPC interface if SSL is to be used. The default is none.

(xend-tcp-xmlrpc-server-ssl-key-file /etc/xen/xmlrpc.key)
xend-tcp-xmlrpc-server-ssl-cert-file {file}

Sets the SSL certificate file for the legacy XML-RPC interface if SSL is to be used. The default is none.

(xend-tcp-xmlrpc-server-ssl-cert-file /etc/xen/xmlrpc.crt)
xend-port {port}

Sets the port Oracle VM Server should use for the HTTP interface if xend-http-server is set. The default is 8000.

(xend-port 8000)
xend-relocation-port {port}

Sets the port Oracle VM Server should use for the relocation interface if xend-relocation-server is set. The default is 8002.

(xend-relocation-port 8002}
xend-address {IPAddress}

Sets the IP address Oracle VM Server should listen on for HTTP connections if xend-http-server is set. Setting to localhost prevents remote connections. Setting to an empty string allows all connections. The default is an empty string.

(xend-address "localhost")
xend-relocation-address {IPAddress}

Sets the IP address Oracle VM Server should listen on for relocation-socket connections if xend-relocation-server is set. Setting to localhost prevents remote connections. Setting to an empty string allows all connections. The default is an empty string.

(xend-relocation-address "localhost"}
xend-relocation-hosts-allow {[IPAddress | regular_expression] ...}

Sets the hosts allowed to talk to the relocation port. Setting to an empty string allows all connections. Setting to a space separated series of regular expressions allows any host with the domain name or IP address that matches any of the regular expressions. The default is an empty string.

(xend-relocation-hosts-allow '^localhost$ ^.*\.example\.org$')
(xend-relocation-hosts-allow '')
(xend-relocation-hosts-allow '^localhost$')
console-limit {size}

Sets the limit in kilobytes of the console buffer. The default is 1024.

(console-limit 2048)
network-script 'network-bridge {[netdev={name}] | [bridge={name}]}'

Sets the network bridge to use. The default is to use the default Ethernet device as the outgoing interface.

(network-script 'network-bridge netdev=eth1')
(network-script 'network-bridge bridge=xenbr0')
(network-script 'network-bridge netdev=eth1 bridge=xenbr0')
(network-script my-network-bridge)
(network-script network-bridge)
vif-script {vif-bridge | vif-route | vif-nat}

Sets the script used to control virtual interfaces. The default is to use the value of vif-bridge.

(vif-script vif-bridge)
(vif-script vif-route)
(vif-script vif-nat)
dom0-min-mem {memory}

Sets the minimum memory level in Megabytes that dom0 can use. The default is 196.

(dom0-min-mem 256)
dom0-cpus {CPUs}

Sets the number of CPUs that dom0 can use. Setting it to 0 allows dom0 to use all CPUs on the computer. The default is 0.

(dom0-cpus 0)
enable-dump {yes | no}

Sets whether to core dump when a domain crashes. The default is no.

(enable-dump no)
external-migration-tool {tool}

Sets the tool to be used for initiating virtual TPM (Trusted Platform Module) migration. The default is an empty string.

(external-migration-tool '')

VNC Server Options

vnc-listen {port}

The port on which to listen for the hardware virtualized VNC Server. Setting the port to 0.0.0.0 allows access from all hosts. Setting the port to localhost restricts access to only the local host. The default is 127.0.0.1.

(vnc-listen '0.0.0.0')
vncpasswd {passwd}

Sets the password to use for hardware virtualized VNC Server connections. The password is the global default for all hardware virtualized guests. You can set to use no password with an empty string as the value. The default is an empty string (no password).

(vncpasswd 'mypassword')