openstack-manuals/doc/config-reference/compute/section_compute-config-overview.xml

<section xml:id="section_compute-config-overview"
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xlink="http://www.w3.org/1999/xlink"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:ns5="http://www.w3.org/1999/xhtml"
    xmlns:ns4="http://www.w3.org/2000/svg"
    xmlns:ns3="http://www.w3.org/1998/Math/MathML"
    xmlns:ns="http://docbook.org/ns/docbook"
    version="5.0">
    <title>General Compute Configuration Overview</title>
    <para>Most configuration information is available in the <filename>nova.conf</filename>
        configuration option file, which is in the <filename>/etc/nova</filename> directory.</para>
    <para>You can use a particular configuration option file by using the <literal>option</literal>
            (<filename>nova.conf</filename>) parameter when running one of the
            <literal>nova-*</literal> services. This inserts configuration option definitions from
        the given configuration file name, which may be useful for debugging or performance
        tuning.</para>
    <para>If you want to maintain the state of all the services, you can use the
            <literal>state_path</literal> configuration option to indicate a top-level directory for
        storing data related to the state of Compute including images if you are using the Compute
        object store.</para>
    <para>You can place comments in the <filename>nova.conf</filename> file by entering a new line
        with a <literal>#</literal> sign at the beginning of the line. To see a listing of all
        possible configuration options, refer to the tables in this guide. Here are some general
        purpose configuration options that you can use to learn more about the configuration option
        file and the node.</para>
    <para/>
    <xi:include href="../../common/tables/nova-common.xml"/>

<!--status: good, right place-->
<section xml:id="sample-nova-configuration-files">
    <title>Example <filename>nova.conf</filename> Configuration
        Files</title>
    <para>The following sections describe many of the configuration
        option settings that can go into the
        <filename>nova.conf</filename> files. Copies of each
        <filename>nova.conf</filename> file need to be copied to each
        compute node. Here are some sample
        <filename>nova.conf</filename> files that offer examples of
        specific configurations.</para>
    <simplesect>
        <title>Small, private cloud</title>
        <para>Here is a simple example <filename>nova.conf</filename>
            file for a small private cloud, with all the cloud controller
            services, database server, and messaging server on the same
            server. In this case, CONTROLLER_IP represents the IP address
            of a central server, BRIDGE_INTERFACE represents the bridge
            such as br100, the NETWORK_INTERFACE represents an interface
            to your VLAN setup, and passwords are represented as
            DB_PASSWORD_COMPUTE for your Compute (nova) database password,
            and RABBIT PASSWORD represents the password to your message
            queue installation.</para>
        <programlisting language="ini"><xi:include parse="text" href="../../common/samples/nova.conf"/></programlisting>
      </simplesect>
    <simplesect>
        <title>KVM, Flat, MySQL, and Glance, OpenStack or EC2
            API</title>
        <para>This example <filename>nova.conf</filename> file is from
            an internal Rackspace test system used for
            demonstrations.</para>
        <programlisting language="ini"><xi:include parse="text" href="../../common/samples/nova.conf"/></programlisting>
        <figure xml:id="Nova_conf_KVM_Flat">
            <title>KVM, Flat, MySQL, and Glance, OpenStack or EC2
                API</title>
            <mediaobject>
                <imageobject>
                    <imagedata
                        fileref="../../common/figures/SCH_5004_V00_NUAC-Network_mode_KVM_Flat_OpenStack.png"
                        contentwidth="6in"/>
                </imageobject>
            </mediaobject>
        </figure>
    </simplesect>
    <simplesect>
        <title>XenServer, Flat networking, MySQL, and Glance, OpenStack
            API</title>
        <para>This example <filename>nova.conf</filename> file is from
            an internal Rackspace test system.</para>
        <programlisting language="ini">verbose
nodaemon
sql_connection=mysql://root:&lt;password&gt;@127.0.0.1/nova
network_manager=nova.network.manager.FlatManager
image_service=nova.image.glance.GlanceImageService
flat_network_bridge=xenbr0
compute_driver=xenapi.XenAPIDriver
xenapi_connection_url=https://&lt;XenServer IP&gt;
xenapi_connection_username=root
xenapi_connection_password=supersecret
xenapi_image_upload_handler=nova.virt.xenapi.imageupload.glance.GlanceStore
rescue_timeout=86400
use_ipv6=true

# To enable flat_injected, currently only works on Debian-based systems
flat_injected=true
ipv6_backend=account_identifier
ca_path=./nova/CA

# Add the following to your conf file if you're running on Ubuntu Maverick
xenapi_remap_vbd_dev=true</programlisting>
        <figure xml:id="Nova_conf_XEN_Flat">
            <title>KVM, Flat, MySQL, and Glance, OpenStack or EC2
                API</title>
            <mediaobject>
                <imageobject>
                    <imagedata
                        fileref="../../common/figures/SCH_5005_V00_NUAC-Network_mode_XEN_Flat_OpenStack.png"
                        scale="60"/>
                </imageobject>
            </mediaobject>
        </figure>
    </simplesect>
</section>
</section>