Atom feed of this document
 

 List of configuration options

For a complete list of all available configuration options for each OpenStack Compute service, run bin/nova-<servicename> --help.

Table 5.1. Description of common nova.conf configuration options for the Compute API, RabbitMQ, EC2 API, S3 API, instance types

Configuration option=Default value

(Type) Description

allow_resize_to_same_host=false

(BoolOpt) Allow destination machine to match source for resize. Useful when testing in single-host environments. If you have separate configuration files for separate services, this flag is required on both nova-api and nova-compute.

api_paste_config=api-paste.ini

(StrOpt) File name for the paste.deploy config for nova-api

api_rate_limit=true

(BoolOpt) whether to rate limit the Compute API

api_url=

(StrOpt) URL for the Zone's Auth API

auth_blob=

(StrOpt) To be written, found in /nova/scheduler/filters/trusted_filter.py, related to FLAGS.trusted_computing.auth_blob.

aws_access_key_id=admin

(StrOpt) AWS Access ID

aws_secret_access_key=admin

(StrOpt) AWS Access Key

backdoor_port=<None>

(IntOpt) Port for eventlet backdoor to listen

bandwidth_poll_interval=600

(IntOpt) Interval to pull bandwidth usage info

bindir=$pybasedir/bin

(StrOpt) Directory where nova binaries are installed

cache_images=true

(BoolOpt) Cache glance images locally

cert_manager=nova.cert.manager.CertManager

(StrOpt) full class name for the Manager for cert

cert_topic=cert

(StrOpt) the topic cert nodes listen on

claim_timeout_seconds=600

(IntOpt) Found in /nova/compute/resource_tracker.py

compute_api_class=nova.compute.api.API

(StrOpt) The full class name of the Compute API class to use

compute_manager=nova.compute.manager.ComputeManager

(StrOpt) full class name for the Manager for compute

compute_topic=compute

(StrOpt) the topic compute nodes listen on

config_file=/etc/nova/nova.conf

(MultiStrOpt) Path to a config file to use. Multiple config files can be specified, with values in later files taking precedence. The default files used are: []

compute_driver='nova.virt.connection.get_connection' String value; Driver to use for controlling virtualization. For convenience if the driver exists under the nove.virt namespace, nova.virt can be removed. There are 5 drivers in core openstack: fake.FakeDriver, libvirt.LibvirtDriver, baremetal.BareMetalDriver, xenapi.XenAPIDriver, vmwareapi.VMwareESXDriver, vmwareapi.VMwareVCDriver.

console_manager=nova.console.manager.ConsoleProxyManager

(StrOpt) full class name for the Manager for console proxy

console_topic=console

(StrOpt) the topic console proxy nodes listen on

control_exchange=nova

(StrOpt) AMQP exchange to connect to if using RabbitMQ or Qpid for RPC (not Zeromq).

[Note]Note

Currently you cannot set different exchange values for volumes and networks, for example.

debug=false

(BoolOpt) Print debugging output

default_access_ip_network_name=<None>

(StrOpt) Name of network to use to set access ips for instances

default_ephemeral_format=<None>

(StrOpt) The default format an ephemeral_volume will be formatted with on creation.

default_image=ami-11111

(StrOpt) default image to use, testing only

default_instance_type=m1.small

(StrOpt) default instance type to use, testing only

default_project=openstack

(StrOpt) the default project to use for OpenStack

default_schedule_zone=<None>

(StrOpt) availability zone to use when user doesn't specify one

default_scheduler_driver=<None>

(StrOpt)

disable_process_locking=false

(BoolOpt) Whether to disable inter-process locks

ec2_dmz_host=$my_ip

(StrOpt) the internal IP address of the EC2 API server

ec2_host=$my_ip

(StrOpt) the IP of the ec2 api server

ec2_path=/services/Cloud

(StrOpt) the path prefix used to call the EC2 API server

ec2_port=8773

(IntOpt) the port of the EC2 API server

ec2_scheme=http

(StrOpt) the protocol to use when connecting to the EC2 API server (http, https)

ec2_strict_validation=true

(BoolOpt) Enables strict validation for EC2 API server requests

ec2_workers=<None>

(StrOpt) To be written; Found in /nova/service.py

enable_instance_password=true

(BoolOpt) When true, Compute creates a random password for the instance at create time. Users can get the password from the return value of API call for the instance creation (or through their Dashboard if the Dashboard returns the password visibly). Note that the password isn't stored anywhere, it is returned only once.

enabled_apis=ec2,osapi_compute,osapi_volume,metadata

(ListOpt) a list of APIs to enable by default

fake_network=false

(BoolOpt) If passed, use fake network devices and addresses

fake_rabbit=false

(BoolOpt) If passed, use a fake RabbitMQ provider

fatal_deprecations=false

(BoolOpt) To be written; Found in /nova/common/deprecated.py

firewall_driver=nova.virt.firewall.libvirt.IptablesFirewallDriver

(StrOpt) Firewall driver (defaults to iptables)

floating_ip_dns_manager=nova.network.dns_driver.DNSDriver

(StrOpt) full class name for the DNS Manager for floating IPs

glance_api_insecure=false

(BoolOpt) Allow to perform insecure SSL (https) requests to glance

glance_api_servers=$glance_host:$glance_port

(ListOpt) A list of the glance API servers available to nova ([hostname|ip]:port)

glance_host=$my_ip

(StrOpt) default glance hostname or IP

glance_num_retries=0

(IntOpt) Number retries when downloading an image from glance

glance_port=9292

(IntOpt) default glance port

host=MGG2WEDRJM

(StrOpt) Name of this node. This can be an opaque identifier. It is not necessarily a hostname, FQDN, or IP address.

image_info_filename_pattern=$instances_path/

(StrOpt) Used for image caching; found in /nova/virt/libvirt/utils.py

image_service=nova.image.glance.GlanceImageService

(StrOpt) The service to use for retrieving and searching images.

instance_build_timeout=0

(StrOpt) To be written; found in /nova/compute/manager.py

instance_dns_domain=

(StrOpt) full class name for the DNS Zone for instance IPs

instance_dns_manager=nova.network.dns_driver.DNSDriver

(StrOpt) full class name for the DNS Manager for instance IPs

instance_usage_audit_period=month

(StrOpt) time period to generate instance usages for. Time period must be hour, day, month or year

instance_uuid_format= [instance: %(uuid)s]

(StrOpt) To be written; found in /nova/openstack/common/log.py

iptables_bottom_regex=

(StrOpt) Regular expressions to match iptables rules that should always be on the bottom.

iptables_top_regex=

(StrOpt) Regular expressions to match iptables rules that should always be on the top.

isolated_hosts=

(ListOpt) Host reserved for specific images

isolated_images=

(ListOpt) Images to run on isolated host

lock_path=$pybasedir

(StrOpt) Directory to use for lock files

log_config=<None>

(StrOpt) If this option is specified, the logging configuration file specified is used and overrides any other logging options specified. Please see the Python logging module documentation for details on logging configuration files.

log_date_format=%Y-%m-%d %H:%M:%S

(StrOpt) Format string for %(asctime)s in log records. Default: %default

log_dir=<None>

(StrOpt) (Optional) The directory to keep log files in (will be prepended to --logfile)

log_file=<None>

(StrOpt) (Optional) Name of log file to output to. If not set, logging will go to stdout.

log_format= "%(asctime)s %(levelname)8s [%(name)s] %(message)s"

(StrOpt) A logging.Formatter log message format string which may use any of the available logging.LogRecord attributes. Default: %default

logdir=<None>

(StrOpt) Log output to a per-service log file in named directory

logfile=<None>

(StrOpt) Log output to a named file

logfile_mode=0644

(StrOpt) Default file mode used when creating log files

memcached_servers=<None>

(ListOpt) Memcached servers or None for in process cache.

metadata_host=$my_ip

(StrOpt) the IP address for the metadata API server

metadata_port=8775

(IntOpt) the port for the metadata API port

monkey_patch=false

(BoolOpt) Whether to log monkey patching

monkey_patch_modules=nova.api.ec2.cloud:nova.notifier.api.notify_decorator, nova.compute.api:nova.notifier.api.notify_decorator

(ListOpt) List of modules/decorators to monkey patch

multi_instance_display_name_template=%s(name)s-%(uuid)s

(StrOpt) When creating multiple instances with a single request using the os-multiple-create API extension, this template will be used to build the display name for each instance. The benefit is that the instances end up with different hostnames. To maintain the legacy behaviour of every instance having the same name, set this option to "%(name)s". Valid keys for the template are: name, uuid, count.

my_ip=192.168.1.82

(StrOpt) IP address of this host; change my_ip to match each host when copying nova.conf files to multiple hosts.

network_api_class=nova.network.api.API

(StrOpt) The full class name of the network API class to use

network_driver=nova.network.linux_net

(StrOpt) Driver to use for network creation

network_manager=nova.network.manager.VlanManager

(StrOpt) Full class name for the Manager for network

network_topic=network

(StrOpt) The topic network nodes listen on

node_availability_zone=nova

(StrOpt) Availability zone of this node

non_inheritable_image_properties=['cache_in_nova', 'instance_uuid', 'user_id', 'image_type', 'backup_type', 'min_ram', 'min_disk']

(ListOpt) These are image properties which a snapshot should not inherit from an instance

notification_driver=nova.notifier.no_op_notifier

(StrOpt) Default driver for sending notifications for RabbitMQ. By default, set to not send entries to the notifications.info queue. Set to nova.notifier.rabbit_notifier to send notifications.

null_kernel=nokernel

(StrOpt) kernel image that indicates not to use a kernel, but to use a raw disk image instead

osapi_compute_ext_list=

(ListOpt) Specify list of extensions to load when using osapi_compute_extension option with nova.api.openstack.compute.contrib.select_extensions

osapi_compute_extension=nova.api.openstack.compute.contrib.standard_extensions

(MultiStrOpt) Compute API extensions to load

osapi_compute_link_prefix=<None>

(StrOpt) Base URL that will be presented to users in links to the OpenStack Compute API

osapi_glance_link_prefix=<None>

(StrOpt) Base URL that will be presented to users in links to glance resources

osapi_max_limit=1000

(IntOpt) the maximum number of items returned in a single response from a collection resource

osapi_path=/v1.1/

(StrOpt) the path prefix used to call the OpenStack Compute API server

osapi_scheme=http

(StrOpt) the protocol to use when connecting to the OpenStack Compute API server (http, https)

osapi_volume_ext_list=

(ListOpt) Specify list of extensions to load when using osapi_volume_extension option with nova.api.openstack.volume.contrib.select_extensions

osapi_volume_extension=nova.api.openstack.volume.contrib.standard_extensions

(MultiStrOpt) osapi volume extension to load

password_length=12

(IntOpt) Length of generated instance admin passwords

pybasedir=/usr/lib/python/site-packages

(StrOpt) Directory where the nova python module is installed

rabbit_durable_queues=false

(BoolOpt) use durable queues in RabbitMQ

rabbit_host=localhost

(StrOpt) the RabbitMQ host

rabbit_max_retries=0

(IntOpt) maximum retries with trying to connect to RabbitMQ (the default of 0 implies an infinite retry count)

rabbit_password=guest

(StrOpt) the RabbitMQ password

rabbit_port=5672

(IntOpt) the RabbitMQ port

rabbit_retry_backoff=2

(IntOpt) how long to backoff for between retries when connecting to RabbitMQ

rabbit_retry_interval=1

(IntOpt) how frequently to retry connecting with RabbitMQ

rabbit_use_ssl=false

(BoolOpt) connect over SSL for RabbitMQ

rabbit_userid=guest

(StrOpt) the RabbitMQ userid

rabbit_virtual_host=/

(StrOpt) the RabbitMQ virtual host

reclaim_instance_interval=0

(IntOpt) Interval in seconds for reclaiming deleted instances

region_list=

(ListOpt) list of region=fqdn pairs separated by commas

resume_guests_state_on_host_boot=false

(BoolOpt) Whether to start guests that were running before the host rebooted. If enabled, this option causes guests assigned to the host to be restarted when nova-compute starts, if they had been active on the host while nova-compute last ran. If such a guest is already found to be running, it is left untouched.

rootwrap_config=sudo nova-rootwrap /etc/nova/rootwrap.conf

(StrOpt) Command prefix to use for running commands as root. Note that the configuration file (and executable) used here must match the one defined in the sudoers entry from packagers, otherwise the commands are rejected.

s3_dmz=$my_ip

(StrOpt) hostname or IP for the instances to use when accessing the S3 API

s3_host=$my_ip

(StrOpt) hostname or IP for OpenStack to use when accessing the S3 API

s3_port=3333

(IntOpt) port used when accessing the S3 API

scheduler_manager=nova.scheduler.manager.SchedulerManager

(StrOpt) full class name for the Manager for scheduler

scheduler_topic=scheduler

(StrOpt) the topic scheduler nodes listen on

security_group_api=nova

(StrOpt) If using nova security groups set to nova. If set to quantum all nova security group api requests will be proxied to quantum to handle.

service_down_time=60

(IntOpt) maximum time since last check-in for up service

state_path=$pybasedir

(StrOpt) Top-level directory for maintaining nova's state

stub_network=False

(StrOpt) Stub network related code

syslog-log-facility=LOG_USER

(StrOpt) syslog facility to receive log lines

tempdir=<None>

(StrOpt) Although the temporary directory used can be controlled via environment variables, this patch provides a way to define it explicitly via a config option. The default value is None, which behaves per this documentation.

use_cow_images=true

(BoolOpt) Whether to use cow images

use_stderr=true

(BoolOpt) Log output to standard error

use-syslog=false

(BoolOpt) Use syslog for logging.

verbose=false

(BoolOpt) Print more verbose output

volume_api_class=nova.volume.api.API

(StrOpt) The full class name of the volume API class to use

volume_manager=nova.volume.manager.VolumeManager

(StrOpt) full class name for the Manager for volume

volume_topic=volume

(StrOpt) the topic volume nodes listen on

vpn_image_id=0

(StrOpt) image id used when starting up a cloudpipe VPN server

vpn_key_suffix=-vpn

(StrOpt) Suffix to add to project name for vpn key and secgroups

zombie_instance_updated_at_window=172800

(IntOpt) Number of seconds zombie instances are cleaned up.

Table 5.2. Description of nova.conf configuration options for databases
Configuration option=Default value (Type) Description
db_backend=sqlalchemy (StrOpt) The backend to use for db
db_driver=nova.db (StrOpt) driver to use for database access
sql_connection=sqlite:///$state_path/$sqlite_db (StrOpt) The SQLAlchemy connection string used to connect to the database
sql_connection_debug=0 (IntOpt) Verbosity of SQL debugging information. 0=None, 100=Everything
sql_connection_trace=false (BoolOpt) Add python stack traces to SQL as comment strings
sql_idle_timeout=3600 (IntOpt) timeout before idle sql connections are reaped
sql_max_retries=10 (IntOpt) maximum db connection retries during startup. (setting -1 implies an infinite retry count)
sql_retry_interval=10 (IntOpt) interval between retries of opening a sql connection
sqlite_clean_db=clean.sqlite (StrOpt) File name of clean sqlite db
sqlite_db=nova.sqlite (StrOpt) the filename to use with sqlite
sqlite_synchronous=true (BoolOpt) If passed, use synchronous mode for sqlite
sql_max_pool_size=5 (IntOpt) Maximum number of SQL connections to keep open in a pool. If set, this value is used for pool_size within sqlalchemy.
sql_min_pool_size=1 (IntOpt) Minimum number of SQL connections to keep open in a pool.
sql_max_overflow=None (IntOpt) If set, this value is used as max_overflow within sqlalchemy.
dbapi_use_tpool=False (BoolOpt) Enable the experimental use of thread pooling for all DB API calls.

Table 5.3. Description of nova.conf configuration options for IPv6
Configuration option=Default value (Type) Description
fixed_range_v6=fd00::/48 (StrOpt) Fixed IPv6 address block
gateway_v6=<None> (StrOpt) Default IPv6 gateway
ipv6_backend=rfc2462 (StrOpt) Backend to use for IPv6 generation
use_ipv6=false (BoolOpt) use IPv6

Table 5.4. Description of nova.conf log file configuration options
Configuration option=Default value (Type) Description
default_log_levels="amqplib=WARN,sqlalchemy=WARN,boto=WARN,suds=INFO,eventlet.wsgi.server=WARN" (ListOpt) list of logger=LEVEL pairs
instance_format=[instance: %(uuid)s] (StrOpt) If an instance is passed with the log message, format it like this
instance_uuid_format=[instance: %(uuid)s] (StrOpt) If an instance UUID is passed with the log message, format it like this

log_config=<None>

(StrOpt) If this option is specified, the logging configuration file specified is used and overrides any other logging options specified. Please see the Python logging module documentation for details on logging configuration files.

log_date_format=%Y-%m-%d %H:%M:%S

(StrOpt) Format string for %(asctime)s in log records. Default: %default

log_dir=<None>

(StrOpt) (Optional) The directory to keep log files in (will be prepended to --logfile)

log_file=<None>

(StrOpt) (Optional) Name of log file to output to. If not set, logging will go to stdout.

log_format="%(asctime)s %(levelname)8s [%(name)s] %(message)s"

(StrOpt) A logging.Formatter log message format string which may use any of the available logging.LogRecord attributes. Default: %default

logdir=<None>

(StrOpt) Log output to a per-service log file in named directory

logfile=<None>

(StrOpt) Log output to a named file

logfile_mode=0644

(StrOpt) Default file mode used when creating log files

logging_context_format_string="%(asctime)s %(levelname)s %(name)s [%(request_id)s %(user_id)s %(project_id)s] %(instance)s%(message)s" (StrOpt) format string to use for log messages with context
logging_debug_format_suffix="from (pid=%(process)d) %(funcName)s %(pathname)s:%(lineno)d" (StrOpt) data to append to log format when level is DEBUG
logging_default_format_string="%(asctime)s %(levelname)s %(name)s [-] %(instance)s%(message)s" (StrOpt) format string to use for log messages without context
logging_exception_prefix="%(asctime)s TRACE %(name)s %(instance)s" (StrOpt) prefix each line of exception output with this format
publish_errors=false (BoolOpt) publish error events
publish_errors=false (BoolOpt) publish error events
use_syslog=false (BoolOpt) Use syslog for logging
syslog_log_facility=LOG_USER (StrOpt) syslog facility to receive log lines

Table 5.5. Description of nova.conf file configuration options for nova- services

Configuration option=Default value

(Type) Description

enable_new_services=true

(BoolOpt) Services to be added to the available pool on create

instance_name_template=instance-%08x

(StrOpt) Template string to be used to generate instance names

matchmaker_ringfile=/etc/nova/matchmaker_ring.json

(StrOpt) When using rpc_backend set to ZeroMQ (nova.rpc.impl_zmq), enables use of a static hash table from a JSON file, cycles hosts per bare topic to create a directed topic.

metadata_listen=0.0.0.0

(StrOpt) IP address for metadata api to listen

metadata_listen_port=8775

(IntOpt) port for metadata api to listen

metadata_manager=nova.api.manager.MetadataManager

(StrOpt) OpenStack metadata service manager

osapi_compute_listen=0.0.0.0

(StrOpt) IP address for OpenStack API to listen

osapi_compute_listen_port=8774

(IntOpt) list port for osapi compute

osapi_compute_unique_server_name_scope=''

(StrOpt) When set, the Compute API will consider duplicate hostnames (case insensitive) invalid within the specified scope. Valid scope settings are empty, "project" or "global".

osapi_volume_listen=0.0.0.0

(StrOpt) IP address for OpenStack Volume API to listen

osapi_volume_listen_port=8776

(IntOpt) port for os volume api to listen

periodic_fuzzy_delay=60

(IntOpt) range of seconds to randomly delay when starting the periodic task scheduler to reduce stampeding. (Disable by setting to 0)

periodic_interval=60

(IntOpt) seconds between running periodic tasks

report_interval=10

(IntOpt) seconds between nodes reporting state to datastore

rpc_backend=nova.rpc.impl_kombu

(StrOpt) The messaging module to use, defaults to kombu.

servicegroup_driver=db

(StrOpt) The driver for servicegroup service which maintains heartbeat information of Nova services/nodes is by default 'db' (Database). Could be 'mc' for using Memcached instead (more lightweight and better for large scale deployments).

snapshot_name_template=snapshot-%08x

(StrOpt) Template string to be used to generate snapshot names

volume_name_template=volume-%s

(StrOpt) Template string to be used to generate instance names

Table 5.6. Description of nova.conf file configuration options for credentials (crypto)
Configuration option=Default value (Type) Description
ca_file=cacert.pem (StrOpt) Filename of root CA (Certificate Authority)
ca_path=$state_path/CA (StrOpt) Where we keep our root CA
crl_file=crl.pem (StrOpt) Filename of root Certificate Revocation List
key_file=private/cakey.pem (StrOpt) Filename of private key
keys_path=$state_path/keys (StrOpt) Where we keep our keys
project_cert_subject="/C=US/ST=California/O=OpenStack/OU=NovaDev/CN=project-ca-%.16s-%s" (StrOpt) Subject for certificate for projects, %s for project, timestamp
use_project_ca=false (BoolOpt) Whether to use a CA for each project (tenant)
user_cert_subject="/C=US/ST=California/O=OpenStack/OU=NovaDev/CN=%.16s-%.16s-%s" (StrOpt) Subject for certificate for users, %s for project, user, timestamp

Table 5.7. Description of nova.conf file configuration options for policies (policy.json)

Configuration option=Default value

(Type) Description

policy_default_rule=default

(StrOpt) Rule checked when requested rule is not found

policy_file=policy.json

(StrOpt) JSON file representing policy

allow_instance_snapshots=true

(BoolOpt) Permit instance snapshot operations.

osapi_max_request_body_size=114688

(BoolOpt)

Table 5.8. Description of nova.conf file configuration options for quotas

Configuration option=Default value

(Type) Description

max_age=0

(IntOpt) number of seconds between subsequent usage refreshes

quota_cores=20

(IntOpt) number of instance cores allowed per project (tenant)

quota_driver=nova.quota.DbQuotaDriver

(StrOpt) Default driver to use for quota checks

quota_floating_ips=10

(IntOpt) number of floating ips allowed per project (tenant)

quota_fixed_ips=-1

(IntOpt) number of fixed ips allowed per project (this should be at least the number of instances allowed.) -1 is unlimited.

quota_gigabytes=1000

(IntOpt) number of volume gigabytes allowed per project (tenant)

quota_injected_file_content_bytes=10240

(IntOpt) number of bytes allowed per injected file

quota_injected_file_path_bytes=255

(IntOpt) number of bytes allowed per injected file path

quota_injected_files=5

(IntOpt) number of injected files allowed

quota_instances=10

(IntOpt) number of instances allowed per project (tenant)

quota_key_pairs=100

(IntOpt) number of key pairs allowed per user

quota_metadata_items=128

(IntOpt) number of metadata items allowed per instance

quota_ram=51200

(IntOpt) megabytes of instance ram allowed per project (tenant)

quota_security_group_rules=20

(IntOpt) number of security rules per security group

quota_security_groups=10

(IntOpt) number of security groups per project (tenant)

quota_volumes=10

(IntOpt) number of volumes allowed per project (tenant)

reservation_expire=86400

(IntOpt) number of seconds until a reservation expires

until_refresh=0

(IntOpt) count of reservations until usage is refreshed

Table 5.9. Description of nova.conf file configuration options for testing purposes

Configuration option=Default value

(Type) Description

allowed_rpc_exception_modules=['nova.exception']

(IntOpt) Modules of exceptions that are permitted to be recreated upon receiving exception data from an rpc call

consoleauth_topic=consoleauth

(StrOpt) the topic console auth proxy nodes listen on

fake_tests=true

(BoolOpt) should we use everything for testing

find_host_timeout=30

(StrOpt) Timeout after NN seconds when looking for a host

rpc_conn_pool_size=30

(IntOpt) Size of RPC connection pool

rpc_response_timeout=60

(IntOpt) Seconds to wait for a response from call or multicall

rpc_thread_pool_size=1024

(IntOpt) Size of RPC thread pool

storage_availability_zone=nova

(StrOpt) availability zone of this service

use_local_volumes=true

(BoolOpt) if True, will not discover local volumes

volume_driver=nova.volume.driver.ISCSIDriver

(StrOpt) Driver to use for volume creation

volume_force_update_capabilities=false

(BoolOpt) if True will force update capabilities on each check

Table 5.10. Description of nova.conf configuration options for authentication
Configuration option=Default value (Type) Description
auth_strategy=noauth (StrOpt) The strategy to use for authentication. Supports noauth or keystone.
auth_token_ttl=3600 (IntOpt) Seconds for auth tokens to linger
ldap_cloudadmin=cn=cloudadmins,ou=Groups,dc=example,dc=com (StrOpt) cn for Cloud Admins
ldap_developer=cn=developers,ou=Groups,dc=example,dc=com (StrOpt) cn for Developers
ldap_itsec=cn=itsec,ou=Groups,dc=example,dc=com (StrOpt) cn for ItSec
ldap_netadmin=cn=netadmins,ou=Groups,dc=example,dc=com (StrOpt) cn for NetAdmins
ldap_password=changeme (StrOpt) LDAP password
ldap_project_subtree=ou=Groups,dc=example,dc=com (StrOpt) OU for Projects
ldap_schema_version=2 (IntOpt) Current version of the LDAP schema
ldap_sysadmin=cn=sysadmins,ou=Groups,dc=example,dc=com (StrOpt) cn for Sysadmins
ldap_url=ldap://localhost (StrOpt) Point this at your ldap server
ldap_user_dn=cn=Manager,dc=example,dc=com (StrOpt) DN of admin user
ldap_user_id_attribute=uid (StrOpt) Attribute to use as id
ldap_user_modify_only=false (BoolOpt) Modify user attributes instead of creating/deleting
ldap_user_name_attribute=cn (StrOpt) Attribute to use as name
ldap_user_subtree=ou=Users,dc=example,dc=com (StrOpt) OU for Users
ldap_user_unit=Users (StrOpt) OID for Users
role_project_subtree=ou=Groups,dc=example,dc=com (StrOpt) OU for Roles
allowed_roles=cloudadmin,itsec,sysadmin,netadmin,developer (ListOpt) Allowed roles for project
auth_driver=nova.auth.dbdriver.DbDriver (StrOpt) Driver that auth manager uses
credential_cert_file=cert.pem (StrOpt) Filename of certificate in credentials zip
credential_key_file=pk.pem (StrOpt) Filename of private key in credentials zip
credential_rc_file=%src (StrOpt) Filename of rc in credentials zip %s will be replaced by name of the region (nova by default)
credential_vpn_file=nova-vpn.conf (StrOpt) Filename of certificate in credentials zip
credentials_template=$pybasedir/nova/auth/novarc.template (StrOpt) Template for creating users rc file
global_roles=cloudadmin,itsec (ListOpt) Roles that apply to all projects
superuser_roles=cloudadmin (ListOpt) Roles that ignore authorization checking completely
vpn_client_template=$pybasedir/nova/cloudpipe/client.ovpn.template (StrOpt) Template for creating users VPN file

Table 5.11. Description of nova.conf file configuration options for LDAP
Configuration option=Default value (Type) Description
ldap_cloudadmin= "cn=cloudadmins,ou=Groups,dc=example,dc=com" (StrOpt) CN for Cloud Admins
ldap_developer= "cn=developers,ou=Groups,dc=example,dc=com" (StrOpt) CN for Developers
ldap_itsec= "cn=itsec,ou=Groups,dc=example,dc=com" (StrOpt) CN for ItSec
ldap_netadmin= "cn=netadmins,ou=Groups,dc=example,dc=com" (StrOpt) CN for NetAdmins
ldap_password= "changeme" (StrOpt) LDAP password
ldap_suffix= "cn=example,cn=com" (StrOpt) LDAP suffix
ldap_use_dumb_member=False (BoolOpt) Simulates an LDAP member
ldap_project_subtree= "ou=Groups,dc=example,dc=com" (StrOpt) OU for Projects
ldap_objectClass= inetOrgPerson (StrOpt) LDAP objectClass to use
ldap_schema_version=2 (IntOpt) Current version of the LDAP schema
ldap_sysadmin= "cn=sysadmins,ou=Groups,dc=example,dc=com" (StrOpt) CN for Sysadmins
ldap_url= "ldap://localhost" (StrOpt) Point this at your ldap server
ldap_user= "dc=Manager,dc=example,dc=com" (StrOpt) LDAP User
ldap_user_tree_dn="ou=Users,dc=example,dc=com" (StrOpt) OU for Users
ldap_user_dn= "cn=Manager,dc=example,dc=com" (StrOpt) DN of Users
ldap_user_objectClass= inetOrgPerson (StrOpt) DN of Users
ldap_user_id_attribute= cn (StrOpt) Attribute to use as id
ldap_user_modify_only=false (BoolOpt) Modify user attributes instead of creating/deleting
ldap_user_name_attribute= cn (StrOpt) Attribute to use as name
ldap_user_subtree= "ou=Users,dc=example,dc=com" (StrOpt) OU for Users
ldap_user_unit= "Users" (StrOpt) OID for Users
ldap_tenant_tree_dn="ou=Groups,dc=example,dc=com" (StrOpt) OU for Tenants
ldap_tenant_objectclass= groupOfNames (StrOpt) LDAP ObjectClass to use for Tenants
ldap_tenant_id_attribute= cn (strOpt) Attribute to use as Tenant
ldap_tenant_member_attribute= member (strOpt) Attribute to use as Member
ldap_role_tree_dn= "ou=Roles,dc=example,dc=com" (strOpt) OU for Roles
ldap_role_objectclass= organizationalRole (strOpt) LDAP ObjectClass to use for Roles
ldap_role_project_subtree= "ou=Groups,dc=example,dc=com" (StrOpt) OU for Roles
ldap_role_member_attribute= roleOccupant (StrOpt) Attribute to use as Role member
ldap_role_id_attribute= cn (StrOpt) Attribute to use as Role

Table 5.12. Description of nova.conf file configuration options for roles and authentication

Configuration option=Default value

(Type) Description

allowed_roles=cloudadmin,itsec,sysadmin,netadmin,developer

(ListOpt) Allowed roles for project (tenant)

auth_driver=nova.auth.dbdriver.DbDriver

(StrOpt) Driver that auth manager uses

credential_cert_file=cert.pem

(StrOpt) Filename of certificate in credentials zip

credential_key_file=pk.pem

(StrOpt) Filename of private key in credentials zip

credential_rc_file=%src

(StrOpt) Filename of rc in credentials zip %s will be replaced by name of the region (nova by default)

credential_vpn_file=nova-vpn.conf

(StrOpt) Filename of certificate in credentials zip

credentials_template=$pybasedir/nova/auth/novarc.template

(StrOpt) Template for creating users rc file

global_roles=cloudadmin,itsec

(ListOpt) Roles that apply to all projects (tenants)

superuser_roles=cloudadmin

(ListOpt) Roles that ignore authorization checking completely

vpn_client_template=$pybasedir/nova/cloudpipe/client.ovpn.template

(StrOpt) Template for creating users vpn file

use_forwarded_for=false

(BoolOpt) Treat X-Forwarded-For as the canonical remote address. Only enable this if you have a sanitizing proxy.

Table 5.13. Description of nova.conf file configuration options for EC2 API

Configuration option=Default value

(Type) Description

ec2_listen=0.0.0.0

(StrOpt) IP address for EC2 API to listen

ec2_listen_port=8773

(IntOpt) port for ec2 api to listen

ec2_private_dns_show_ip=false

(BoolOpt) Return the IP address as private dns hostname in describe instances, else returns instance name

keystone_ec2_url=http://localhost:5000/v2.0/ec2tokens

(StrOpt) URL to get token from ec2 request

lockout_attempts=5

(IntOpt) Number of failed auths before lockout.

lockout_minutes=15

(IntOpt) Number of minutes to lockout if triggered.

lockout_window=15

(IntOpt) Number of minutes for lockout window.

Table 5.14. Description of nova.conf file configuration options for VNC access to guest instances

Configuration option=Default value

(Type) Description

novncproxy_base_url=http://127.0.0.1:6080/vnc_auto.html

(StrOpt) location of VNC console proxy, in the form "http://127.0.0.1:6080/vnc_auto.html"

vnc_enabled=true

(BoolOpt) enable VNC related features

vnc_keymap=en-us

(StrOpt) keymap for vnc

vnc_require_instance_uuid_as_password=false

(BoolOpt) When set to true, secure VNC connections by requiring the user to enter the instance uuid as the password. This ensures the user is connecting to the correct VNC console.

vncserver_listen=127.0.0.1

(StrOpt) IP address on which instance VNC servers should listen

vncserver_proxyclient_address=127.0.0.1

(StrOpt) the address to which proxy clients (like nova-xvpvncproxy) should connect

xvpvncproxy_base_url=http://127.0.0.1:6081/console

(StrOpt) location of nova XCP VNC console proxy, in the form "http://127.0.0.1:6081/console"

xvpvncproxy_host=0.0.0.0

(StrOpt) Address that the XCP VNC proxy should bind to

xvpvncproxy_port=6081

(IntOpt) Port that the XCP VNC proxy should bind to

Table 5.15. Description of nova.conf [spice] section configuration options for SPICE HTML5 access to guest instances

Configuration option=Default value

(Type) Description

html5proxy_base_url=http://$nova-html5proxy_host:6082/spice_auto.html

(StrOpt) location of spice html5 console proxy, in the form "http://$nova-html5proxy_host:6082/spice_auto.html"

enabled=false

(BoolOpt) enable spice related features

agent_enabled=true

(BoolOpt) enable spice guest agent support

keymap=en-us

(StrOpt) keymap for spice

server_listen=0.0.0.0

(StrOpt) IP address on which instance spice servers should listen

server_proxyclient_address=$compute_host

(StrOpt) Management IP Address on which instance spiceservers will listen on the compute host.

Table 5.16. Description of nova.conf file configuration options for networking options

Configuration option=Default value

(Type) Description

allow_same_net_traffic=true

(BoolOpt) Whether to allow network traffic from same network

defer_iptables_apply=false

(BoolOpt) Whether to batch up the application of IPTables rules during a host restart and apply all at the end of the init phase

dhcp_lease_time=120

(IntOpt) Lifetime of a DHCP lease in seconds

dhcpbridge=$bindir/nova-dhcpbridge

(StrOpt) location of nova-dhcpbridge

dhcpbridge_flagfile=/etc/nova/nova-dhcpbridge.conf

(StrOpt) location of flagfile for dhcpbridge

dmz_cidr=10.128.0.0/24

(StrOpt) dmz range that should be accepted

dns_server=[]

(MultiStrOpt) if set, uses specific dns server for dnsmasq. Can be specified multiple times.

use_network_dns_servers=False

(BoolOpt) if set, uses the dns server from the node's network settings for the servers in dnsmasq.

dnsmasq_config_file=

(StrOpt) Override the default dnsmasq settings with this file

linuxnet_interface_driver=nova.network.linux_net.LinuxBridgeInterfaceDriver

(StrOpt) Driver used to create ethernet devices.

linuxnet_ovs_integration_bridge=br-int

(StrOpt) Name of Open vSwitch bridge used with linuxnet

network_device_mtu=<None>

(StrOpt) MTU setting for vlan

networks_path=$state_path/networks

(StrOpt) Location to keep network config files

public_interface=eth0

(StrOpt) Interface for public IP addresses

routing_source_ip=$my_ip

(StrOpt) Public IP of network host

send_arp_for_ha=false

(BoolOpt) send gratuitous ARPs for HA setup

use_single_default_gateway=false

(BoolOpt) Use single default gateway. Only first nic of vm will get default gateway from dhcp server

forward_bridge_interface=all

(ListOpt) An interface that bridges can forward to. If this is set to all then all traffic will be forwarded. This is useful in vlan mode when a deployer doesn't want traffic to be routed between vlans. Note that forward_bridge_interface can be specified multiple times and should be specified once for each interface that supports floating ips.

auto_assign_floating_ip=false

(BoolOpt) Autoassigning floating IP to VM

cnt_vpn_clients=0

(IntOpt) Number of addresses reserved for vpn clients

create_unique_mac_address_attempts=5

(IntOpt) Number of attempts to create unique mac address

default_floating_pool=nova

(StrOpt) Default pool for floating ips

dhcp_domain=novalocal

(StrOpt) domain to use for building the hostnames

fake_call=false

(BoolOpt) If True, skip using the queue and make local calls

fixed_ip_disassociate_timeout=600

(IntOpt) Seconds after which a deallocated IP is disassociated

fixed_range=10.0.0.0/8

(StrOpt) Fixed IP address block

flat_injected=false

(BoolOpt) Whether to attempt to inject network setup into guest

flat_interface=<None>

(StrOpt) FlatDhcp will bridge into this interface if set

flat_network_bridge=<None>

(StrOpt) Bridge for simple network instances

flat_network_dns=8.8.4.4

(StrOpt) Dns for simple network

floating_range=4.4.4.0/24

(StrOpt) Floating IP address block

force_dhcp_release=false

(BoolOpt) If True, send a dhcp release on instance termination

gateway=<None>

(StrOpt) Default IPv4 gateway

l3_lib=nova.network.l3.LinuxNetL3

(StrOpt) Indicates underlying L3 management library

multi_host=false

(BoolOpt) Default value for multi_host in networks. Enable when using nova networking (not quantum) on multiple compute nodes for creation and runtime efficiency. Also provides incremental fault tolerance.

share_dhcp_address=false

(BoolOpt) If True and multi_host is also true all compute hosts will share the same dhcp address.

update_dns_entries=false

(BoolOpt) True will message all network hosts to update their DNS entries when update occurs. Useful when multi_host is True.

network_host=MGG2WEDRJM

(StrOpt) Network host to use for IP allocation in flat modes

network_size=256

(IntOpt) Number of addresses in each private subnet

num_networks=1

(IntOpt) Number of networks to support

vlan_interface=<None>

(StrOpt) VLANs will bridge into this interface if set

vlan_start=100

(IntOpt) First VLAN for private networks

vpn_ip=$my_ip

(StrOpt) Public IP for the cloudpipe VPN servers

vpn_start=1000

(IntOpt) First VPN port for private networks

CloudPipe specifics

boot_script_template=$pybasedir/nova/cloudpipe/bootscript.template

(StrOpt) Template for cloudpipe instance boot script

dmz_mask=255.255.255.0

(StrOpt) Netmask to push into openvpn config

dmz_net=10.0.0.0

(StrOpt) Network to push into openvpn config

vpn_instance_type=m1.tiny

(StrOpt) Instance type for vpn instances

Quantum specifics

network_api_class=nova.network.api.API

(StrOpt) Defaults to nova-network. Must be modified to nova.network.quantumv2.api.API indicate that Quantum should be used rather than the traditional nova-network networking model.

quantum_url=http://127.0.0.1:9696

(IntOpt) URL for connecting to the Quantum networking service. Indicates the hostname/IP and port of the Quantum server for your deployment.

quantum_auth_strategy=keystone

(StrOpt) Should be kept as default 'keystone' for all production deployments.

quantum_admin_tenant_name=<None>

(StrOpt) Tenant name for connecting to Quantum network services in admin context through the OpenStack Identity service.

quantum_admin_username=<None>

(StrOpt) Username for connecting to Quantum network services in admin context through the OpenStack Identity service.

quantum_admin_password=<None>

(StrOpt) Password for connecting to Quantum network services in admin context through the OpenStack Identity service.

quantum_admin_auth_url=<None>

(StrOpt) Points to the OpenStack Identity server IP and port. This is the Identity (keystone) admin API server IP and port value, and not the Identity service API IP and port.

quantum_region_name=<None>

(StrOpt) Region name for connecting to quantum in admin context, through the OpenStack Identity service,

quantum_extension_sync_interval=<600>

(IntOpt) Some OpenStack Networking (quantum) extensions require Compute (nova) to pass in additional fields based on which extension the Networking (quantum) service is running. This is the number of seconds that nova will wait before requerying.

Table 5.17. Description of nova.conf file configuration options for live migration
Configuration option=Default value (Type) Description
live_migration_bandwidth=0 (IntOpt) Maximum bandwidth to be used during migration transfer, in Mbps.
live_migration_flag= VIR_MIGRATE_UNDEFINE_SOURCE,VIR_MIGRATE_PEER2PEER (StrOpt) Migration flags to be set for live migration, defines parameters for use during the migration.
live_migration_retry_count=30 (IntOpt) Number of one-second retries needed in live_migration.
live_migration_uri=qemu+tcp://%s/system (StrOpt) Define Host URI used by live_migration feature. Any included "%s" is replaced with the migration target host name.

Table 5.18. Description of nova.conf file configuration options for compute nodes

Configuration option=Default value

(Type) Description

base_dir_name=

(StrOpt) Directory where cached images are stored under directory indicated with instances_path

compute_driver=nova.virt.connection.get_connection

(StrOpt) Driver to use for controlling virtualization

console_host=MGG2WEDRJM

(StrOpt) Console proxy host to use to connect to instances on this host.

default_notification_level=INFO

(StrOpt) Default notification level for outgoing notifications

default_publisher_id=$host

(StrOpt) Default publisher_id for outgoing notifications

heal_instance_info_cache_interval=60

(IntOpt) Number of seconds between instance info_cache self healing updates

host_state_interval=120

(IntOpt) Interval in seconds for querying the host status

image_cache_manager_interval=40

(IntOpt) Number of periodic scheduler ticks to wait between runs of the image cache manager.

instances_path=$state_path/instances

(StrOpt) where instances are stored on disk

reboot_timeout=0

(IntOpt) Automatically hard reboot an instance if it has been stuck in a rebooting state longer than N seconds. Set to 0 to disable.

rescue_timeout=0

(IntOpt) Automatically unrescue an instance after N seconds. Set to 0 to disable.

resize_confirm_window=0

(IntOpt) Automatically confirm resizes after N seconds. Set to 0 to disable.

running_deleted_instance_action=log

(StrOpt) Action to take if a running deleted instance is detected.Valid options are 'noop', 'log' and 'reap'. Set to 'noop' to disable.

running_deleted_instance_poll_interval=30

(IntOpt) Number of periodic scheduler ticks to wait between runs of the cleanup task.

running_deleted_instance_timeout=0

(IntOpt) Number of seconds after being deleted when a running instance should be considered eligible for cleanup.

Table 5.19. Description of nova.conf file configuration options for bare metal deployment

Configuration option=Default value

(Type) Description

[Note]Note

Options should be placed in the [baremetal] config group

db_backend=sqlalchemy

(StrOpt) The backend to use for db

deply_kernel

(StrOpt) Glance image UUID for the special deploy kernel. Can also be set on the flavor (instance type).

deploy_ramdisk

(StrOpt) Glance image UUID for the special deploy ramdisk. Can also be set on the flavor (instance type).

driver=nova.virt.baremetal.pxe.PXE

(StrOpt) Nova class for the imaging sub-driver to use

instance_type_extra_specs

(StrOpt) Additional capabilities this baremetal compute host should advertise. Should include the "cpu_arch" of the baremetal nodes managed by this host, which must match hardware and flavor extra_specs. Example: cpu_arch:x86_64

ipmi_power_retry=5

(IntOpt) Number of times that an IPMI command should be retried before raising an error and aborting the action. Actions are retried at half second intervals.

net_config_template=$pybasedir/nova/virt/baremetal/net-dhcp.ubuntu.template

(StrOpt) Template file for injected network. Use net-static.ubuntu.template if you are not using Quantum DHCP.

power_manager=nova.virt.baremetal.ipmi.IPMI

(StrOpt) Nova class for the power sub-driver to use.

pxe_append_params

(StrOpt) Any additional parameters that must be passed to the baremetal nodes during the PXE boot process.

pxe_config_template=$pybasedir/nova/virt/baremetal/pxe_config.template

(StrOpt) Template file for PXE configuration.

pxe_deploy_timeout=0

(IntOpt) Timeout in seconds to wait for PXE deployment to complete. Defaults to 0 (unlimited). This should be set to a value appropriate for each environment, but should not be more than instance_build_timeout.

sql_connection=sqlite:///$state_path/baremetal_$sqlite_db

(StrOpt) The SQLAlchemy connection string used to connect to the database

terminal=shellinaboxd

(StrOpt) Path to remote terminal program that provides terminal access to baremetal nodes.

terminal_cert_dir

(StrOpt) Path to directory which stores SSL/PEM certs for terminal access.

terminal_pid_dir

(StrOpt) Path to directory which stores PID files for terminal access.

tftproot=/tftpboot

(StrOpt) Path to directory where TFTP images should be placed. Required for PXE driver.

vif_driver=nova.virt.baremetal.vif_driver.BareMetalVIFDriver

(StrOpt) Nova class for the VIF sub-driver to use.

volume_driver=nova.virt.baremetal.volume_driver.LibvirtVolumeDriver

(StrOpt) Nova class for the Volume sub-driver to use.

Table 5.20. Description of nova.conf file configuration options for hypervisors
Configuration option=Default value (Type) Description
block_migration_flag=VIR_MIGRATE_UNDEFINE_SOURCE,VIR_MIGRATE_PEER2PEER,VIR_MIGRATE_NON_SHARED_INC (StrOpt) Define block migration behavior.
checksum_base_images=false (BoolOpt) Used as an additional check to detect if cached images have become corrupted. If true, the compute service will write checksums for image files in the /var/lib/nova/instances/_base directory to disk, and do periodic checks to verify that this checksum is valid. If the checksum fails to validate, the failure is recorded to the log as an error, but no other action is taken: it is assumed that an operator will monitor the logs and take appropriate action. If false, image hashes are not verified.
hyperv_attaching_volume_retry_count=10 (IntOpt) Number of times to retry attaching to a volume when using the Hyper-V hypervisor
hyperv_wait_between_attach_retry=5 (IntOpt) To be written: found in /nova/virt/hyperv/volumeops.py
libvirt_cpu_mode=<None> (StrOpt) Configures the guest CPU model exposed to the hypervisor. Valid options are: custom, host-model, host-passthrough, none. If the hypervisor is KVM or QEMU, the default value is host-model, otherwise the default value is none.
libvirt_cpu_model=<None> (StrOpt) Specify the guest CPU model exposed to the hypervisor. This configuration option is only applicable if libvirt_cpu_mode is set to custom. Valid options: one of the named models specified in /usr/share/libvirt/cpu_map.xml, e.g.: Westmere, Nehalem, Opteron_G3.
libvirt_disk_prefix=<None> (StrOpt) Override the default disk prefix for the devices attached to a server, which is dependent on libvirt_type. (valid options are: sd, xvd, uvd, vd)
libvirt_inject_key=true (BoolOpt) Inject the ssh public key at boot time
libvirt_inject_partition=1 (IntOpt) The partition to inject to : -2 => disable, -1 => inspect (libguestfs only), 0 => not partitioned, >0 => partition number'

libvirt_images_type=default

(StrOpt) Instance ephemeral storage backend format. Acceptable values are: raw, qcow2, lvm, default. If default is specified, then use_cow_images flag is used instead of this one. Please note, that current snapshot mechanism in OpenStack Compute works only with instances backed with Qcow2 images.

libvirt_images_volume_group=None

(StrOpt) LVM Volume Group that is used for instance ephemerals, when you specify libvirt_images_type=lvm.

libvirt_inject_password=false (BoolOpt) Inject the admin password at boot time, without an agent.
libvirt_lvm_snapshot_size=1000 (IntOpt) The amount of storage (in megabytes) to allocate for LVM snapshot copy-on-write blocks.
libvirt_nonblocking=true (BoolOpt) Use a separated OS thread pool to realize non-blocking libvirt calls
libvirt_snapshots_directory=$instances_path/snapshots (StrOpt) Location where libvirt driver will store snapshots before uploading them to image service
libvirt_snapshot_compression=False (BoolOpt) Compresses snapshot images when possible. This currently applies exclusively to qcow2 images.

libvirt_sparse_logical_volumes=false

(BoolOpt) Create sparse (not fully allocated) LVM volumes for instance ephemerals if you use LVM backend for them.

libvirt_type=kvm (StrOpt) Libvirt domain type (valid options are: kvm, lxc, qemu, uml, xen)
libvirt_uri= (StrOpt) Override the default libvirt URI (which is dependent on libvirt_type)
libvirt_vif_driver=nova.virt.libvirt.vif.LibvirtGenericVifDriver (StrOpt) The libvirt VIF driver to configure the VIFs.

libvirt_volume_drivers="iscsi=nova.virt.libvirt.volume.LibvirtISCSIVolumeDriver,

local=nova.virt.libvirt.volume.LibvirtVolumeDriver,

fake=nova.virt.libvirt.volume.LibvirtFakeVolumeDriver,

rbd=nova.virt.libvirt.volume.LibvirtNetVolumeDriver,

sheepdog=nova.virt.libvirt.volume.LibvirtNetVolumeDriver,

glusterfs=nova.virt.libvirt.volume.LibvirtGlusterfsVolumeDriver"

(ListOpt) Libvirt handlers for remote volumes.
libvirt_wait_soft_reboot_seconds=120 (IntOpt) Number of seconds to wait for instance to shut down after soft reboot request is made. We fall back to hard reboot if instance does not shutdown within this window.
limit_cpu_features=false (BoolOpt) Used by Hyper-V
remove_unused_base_images=true (BoolOpt) Indicates whether unused base images should be removed
remove_unused_kernels=false (BoolOpt) Should unused kernel images be removed? If unused images should be removed set to true, if not, set to false. This option is only safe to set to true if all compute nodes have been updated to support this option so that older image cache managers on remote compute nodes are prevented from cleaning up kernels because they appear unused. This will be enabled by default in a future release.
remove_unused_original_minimum_age_seconds=86400 (IntOpt) Unused unresized base images younger than this will not be removed
remove_unused_resized_minimum_age_seconds=3600 (IntOpt) Unused resized base images younger than this will not be removed
rescue_image_id=<None> (StrOpt) Rescue ami image
rescue_kernel_id=<None> (StrOpt) Rescue aki image
rescue_ramdisk_id=<None> (StrOpt) Rescue ari image
snapshot_image_format=<None> (StrOpt) Snapshot image format (valid options are : raw, qcow2, vmdk, vdi). Defaults to same as source image
use_usb_tablet=true (BoolOpt) Sync virtual and real mouse cursors in Windows VMs
libvirt integration
libvirt_ovs_bridge=br-int (StrOpt) Name of Integration Bridge used by Open vSwitch
libvirt_use_virtio_for_bridges=false (BoolOpt) Use virtio for bridge interfaces
VMWare integration
vmwareapi_wsdl_loc=<None> (StrOpt) VIM Service WSDL Location e.g http://<server>/vimService.wsdl, due to a bug in vSphere ESX 4.1 default wsdl.
vmware_vif_driver=nova.virt.vmwareapi.vif.VMWareVlanBridgeDriver (StrOpt) The VMWare VIF driver to configure the VIFs.
vmwareapi_api_retry_count=10 (FloatOpt) The number of times we retry on failures, e.g., socket error, etc. Used only if compute_driver is vmwareapi.VMwareESXDriver.
vmwareapi_host_ip=<None> (StrOpt) URL for connection to VMWare ESX host.Required if compute_driver is vmwareapi.VMwareESXDriver.
vmwareapi_host_password=<None> (StrOpt) Password for connection to VMWare ESX host. Used only if compute_driver is vmwareapi.VMwareESXDriver.
vmwareapi_host_username=<None> (StrOpt) Username for connection to VMWare ESX host. Used only if compute_driver is vmwareapi.VMwareESXDriver.
vmwareapi_task_poll_interval=5.0 (FloatOpt) The interval used for polling of remote tasks. Used only if compute_driver is vmwareapi.VMwareESXDriver,
vmwareapi_vlan_interface=vmnic0 (StrOpt) Physical ethernet adapter name for vlan networking
powervm_mgr_type=ivm (StrOpt) PowerVM system manager type (ivm, hmc)
powervm_mgr=<None> (StrOpt) PowerVM manager host or ip
powervm_vios=powervm_mgr (StrOpt) PowerVM VIOS host or ip if different from manager
powervm_mgr_user=<None> (StrOpt) PowerVM manager user name
powervm_mgr_passwd=<None> (StrOpt) PowerVM manager user password
powervm_img_remote_path=<None> (StrOpt) PowerVM image remote path. Used to copy and store images from Glance on the PowerVM VIOS LPAR.
powervm_img_local_path=<None> (StrOpt) Local directory on the compute host to download glance images to.

Table 5.21. Description of nova.conf file configuration options for console access to VMs on VMWare VMRC or XenAPI

Configuration option=Default value

(Type) Description

console_driver=nova.console.xvp.XVPConsoleProxy

(StrOpt) Driver to use for the console proxy

console_public_hostname=MGG2WEDRJM

(StrOpt) Publicly visible name for this console host

stub_compute=false

(BoolOpt) Stub calls to compute worker for tests

console_vmrc_error_retries=10

(IntOpt) number of retries for retrieving VMRC information

console_vmrc_port=443

(IntOpt) port for VMware VMRC connections

console_xvp_conf=/etc/xvp.conf

(StrOpt) generated XVP conf file

console_xvp_conf_template=$pybasedir/nova/console/xvp.conf.template

(StrOpt) XVP conf template

console_xvp_log=/var/log/xvp.log

(StrOpt) XVP log file

console_xvp_multiplex_port=5900

(IntOpt) port for XVP to multiplex VNC connections on

console_xvp_pid=/var/run/xvp.pid

(StrOpt) XVP master process pid file

xenapi_agent_path=usr/sbin/xe-update-networking

(StrOpt) Specifies the path in which the xenapi guest agent should be located. If the agent is present, network configuration is not injected into the image. Used if compute_driver=xenapi.XenAPIDriver and flat_injected=True.

xenapi_connection_concurrent=5

(IntOpt) Maximum number of concurrent XenAPI connections. Used only if compute_driver=xenapi.XenAPIDriver.

xenapi_connection_url=<None>

(StrOpt) URL for connection to XenServer/Xen Cloud Platform. Required if compute_driver=xenapi.XenAPIDriver.

xenapi_connection_username=root

(StrOpt) Password for connection to XenServer/Xen Cloud Platform. Used only if compute_driver=xenapi.XenAPIDriver.

xenapi_connection_password=<None>

(StrOpt) Username for connection to XenServer/Xen Cloud Platform. Used only if compute_driver=xenapi.XenAPIDriver.

xenapi_check_host=true

(BoolOpt) Ensure compute service is running on host XenAPI connects to.

xenapi_login_timeout=10

(BoolOpt) Timeout in seconds for XenAPI login.

xenapi_remap_vbd_dev=false

(BoolOpt) Used to enable the remapping of VBD dev. (Works around an issue in Ubuntu Maverick).

xenapi_remap_vbd_dev_prefix=sd

(StrOpt) Specify prefix to remap VBD dev to (ex. /dev/xvdb -> /dev/sdb). Used when xenapi_remap_vbd_dev=true.

xenapi_sr_base_path=/var/run/sr-mount

(StrOpt) Base path to the storage repository.

xenapi_vhd_coalesce_poll_interval=5.0

(FloatOpt) The interval used for polling of coalescing vhds. Used only if compute_driver=xenapi.XenAPIDriver.

xenapi_vhd_coalesce_max_attempts=5

(IntOpt) Max number of times to poll for VHD to coalesce. Used only if compute_driver=xenapi.XenAPIDriver.

Table 5.22. Description of nova.conf file configuration options for S3 access to image storage
Configuration option=Default value (Type) Description
image_decryption_dir=/tmp (StrOpt) parent dir for tempdir used for image decryption
s3_access_key=notchecked (StrOpt) access key to use for s3 server for images
s3_affix_tenant=false (BoolOpt) whether to affix the tenant id to the access key when downloading from s3
s3_secret_key=notchecked (StrOpt) secret key to use for s3 server for images
s3_use_ssl=false (BoolOpt) whether to use ssl when talking to s3

Table 5.23. Description of nova.conf file configuration options for schedulers that use algorithms to assign VM launch on particular compute hosts

Configuration option=Default value

(Type) Description

scheduler_host_manager=nova.scheduler.host_manager.HostManager

(StrOpt) The scheduler host manager class to use.

scheduler_max_attempts=3

(IntOpt) Maximum number of attempts to schedule an instance before giving up and setting the instance to error.

cpu_allocation_ratio=16.0

(FloatOpt) Virtual CPU to Physical CPU allocation ratio.

ram_allocation_ratio=1.5

(FloatOpt) virtual ram to physical ram allocation ratio.

reserved_host_disk_mb=0

(IntOpt) Amount of disk in MB to reserve for host/dom0.

reserved_host_memory_mb=512

(IntOpt) Amount of memory in MB to reserve for host/dom0.

scheduler_available_filters=nova.scheduler.filters.all_filters

(MultiStrOpt) Filter classes available to the scheduler which may be specified more than once. An entry of "nova.scheduler.filters.all_filters" maps to all filters included with nova.

scheduler_default_filters=AvailabilityZoneFilter,RamFilter,ComputeFilter

(ListOpt) Which filter class names to use for filtering hosts when not specified in the request.

compute_fill_first_cost_fn_weight=-1.0

(FloatOpt) How much weight to give the fill-first cost function. A negative value will reverse behavior: e.g. spread-first.

retry_host_cost_fn_weight=1.0

(FloatOpt) How much weight to give the retry host cost function. A negative value will reverse behavior: e.g. use multiple-times-retried hosts first.

least_cost_functions=nova.scheduler.least_cost.compute_fill_first_cost_fn

(ListOpt) Which cost functions the LeastCostScheduler should use.

noop_cost_fn_weight=1.0

(FloatOpt) How much weight to give the noop cost function.

scheduler_driver=nova.scheduler.multi.MultiScheduler

(StrOpt) Default driver to use for the scheduler.

compute_scheduler_driver=nova.scheduler.filter_scheduler.FilterScheduler

(StrOpt) Driver to use for scheduling Compute calls.

volume_scheduler_driver=nova.scheduler.chance.ChanceScheduler

(StrOpt) Driver to use for scheduling volume calls.

scheduler_json_config_location=

(StrOpt) Absolute path to scheduler configuration JSON file.

max_cores=16

(IntOpt) maximum number of instance cores to allow per host.

max_gigabytes=10000

(IntOpt) maximum number of volume gigabytes to allow per host.

max_networks=1000

(IntOpt) maximum number of networks to allow per host.

skip_isolated_core_check=true

(BoolOpt) Allow overcommitting vcpus on isolated hosts.

scheduler_host_subset_size=1

(IntOpt) New instances will be scheduled on a host chosen randomly from a subset of the N best hosts, rather than just the host with the highest weight. This property defines the subset size that a host is chosen from. A value of 1 chooses the first host returned by the weighing functions. This value must be at least 1. Any value less than 1 will be ignored, and 1 will be used instead.

Table 5.24. Description of nova.conf file configuration options for config drive features

Configuration option=Default value

(Type) Description

config_drive_format=

(StrOpt) File format for the config drive, options: iso9660, vfat

config_drive_skip_versions=1.0 2007-01-19 2007-03-01 2007-08-29 2007-10-10 2007-12-15 2008-02-01 2008-09-01

(StrOpt) Version numbers of the config drive releases to skip

config_drive_tempdir=<None>

(StrOpt)

force_config_drive=

(StrOpt) Forces use of config drive, such as using config drive based on image properties; reserved for future use

using_config_drive=

(StrOpt) Enables use of config drive for images launched

Table 5.25. Description of nova.conf file configuration options for volumes attached to VMs

Configuration option=Default value

(Type) Description

cinder_cross_az_attach=True

(BoolOpt) Allow attach between instance and volume in different availability zones.

iscsi_helper=ietadm

(StrOpt) iscsi target user-land tool to use

iscsi_ip_address=$my_ip

(StrOpt) use this ip for iscsi

iscsi_num_targets=100

(IntOpt) Number of iscsi target ids per host

iscsi_port=3260

(IntOpt) The port that the iSCSI daemon is listening on

iscsi_target_prefix=iqn.2010-10.org.openstack:

(StrOpt) prefix for iscsi volumes

num_iscsi_scan_tries=3

(StrOpt) number of times to rescan iSCSI target to find volume

num_shell_tries=3

(StrOpt) number of times to attempt to run flakey shell commands

rbd_pool=rbd

(StrOpt) the RADOS pool in which rbd volumes are stored

rbd_secret_uuid=<None>

(StrOpt) the libvirt uuid of the secret for the rbd_uservolumes

rbd_user=<None>

(StrOpt) the RADOS client name for accessing rbd volumes

volume_group=nova-volumes

(StrOpt) Name for the VG that will contain exported volumes

netapp_login=<None>

(StrOpt) User name for the DFM server

netapp_password=<None>

(StrOpt) Password for the DFM server

netapp_server_hostname=<None>

(StrOpt) Hostname for the DFM server

netapp_server_port=8088

(IntOpt) Port number for the DFM server

netapp_storage_service=<None>

(StrOpt) Storage service to use for provisioning

netapp_vfiler=<None>

(StrOpt) Vfiler to use for provisioning

netapp_wsdl_url=<None>

(StrOpt) URL of the WSDL file for the DFM server

nexenta_blocksize=

(StrOpt) block size for volumes (blank=default,8KB)

nexenta_host=

(StrOpt) IP address of Nexenta SA

nexenta_iscsi_target_portal_port=3260

(IntOpt) Nexenta target portal port

nexenta_password=nexenta

(StrOpt) Password to connect to Nexenta SA

nexenta_rest_port=2000

(IntOpt) HTTP port to connect to Nexenta REST API server

nexenta_rest_protocol=auto

(StrOpt) Use http or https for REST connection (default auto)

nexenta_sparse=false

(BoolOpt) flag to create sparse volumes

nexenta_target_group_prefix=nova/

(StrOpt) prefix for iSCSI target groups on SA

nexenta_target_prefix=iqn.1986-03.com.sun:02:nova-

(StrOpt) IQN prefix for iSCSI targets

nexenta_user=admin

(StrOpt) User name to connect to Nexenta SA

nexenta_volume=nova

(StrOpt) pool on SA that will hold all volumes

san_clustername=

(StrOpt) Cluster name to use for creating volumes

san_ip=

(StrOpt) IP address of SAN controller

san_is_local=false

(BoolOpt) Execute commands locally instead of over SSH; use if the volume service is running on the SAN device

san_login=admin

(StrOpt) Username for SAN controller

san_password=

(StrOpt) Password for SAN controller

san_private_key=

(StrOpt) Filename of private key to use for SSH authentication

san_ssh_port=22

(IntOpt) SSH port to use with SAN

san_thin_provision=true

(BoolOpt) Use thin provisioning for SAN volumes?

san_zfs_volume_base=rpool/

(StrOpt) The ZFS path under which to create zvols for volumes.


loading table of contents...