Skip Headers

Oracle® VM Server User's Guide Release 2.1 Part Number E10898-04 |
Home | Book List | Contents | Index | Contact Us

Previous | Next
| View PDF

# 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

## 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')