openstack-manuals/doc/install-guide-debconf/source/nova-controller-install.rst
Thomas Goirand d81e46f2ef Fix debconf nova install
* Remove tweakings of ``use_neutron`` and
``firewall_driver`` as default is already correct.

* Disable spice (it's enabled by default in Debian)

Change-Id: I3901452a72251facf29d39b7e4511cd5f830085d
2016-10-10 21:50:56 +02:00

120 lines
3.4 KiB
ReStructuredText

Install and configure controller node
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the
Compute service, code-named nova, on the controller node.
Install and configure components
--------------------------------
.. include:: shared/note_configuration_vary_by_distribution.rst
#. Install the packages:
.. code-block:: console
# apt-get install nova-api nova-conductor nova-consoleauth \
nova-consoleproxy nova-scheduler python-novaclient
Respond to prompts for
:doc:`database management <debconf/debconf-dbconfig-common>`,
:doc:`Identity service credentials <debconf/debconf-keystone-authtoken>`,
:doc:`service endpoint registration <debconf/debconf-api-endpoints>`,
and :doc:`message broker credentials <debconf/debconf-rabbitmq>`.
.. note::
``nova-api-metadata`` is included in the ``nova-api`` package,
and can be selected through debconf, or editing ``enabled_apis``
in the ``[DEFAULT]`` section of nova.conf.
.. note::
A unique ``nova-consoleproxy`` package provides the
``nova-novncproxy``, ``nova-spicehtml5proxy``, and
``nova-xvpvncproxy`` packages. To select packages, edit the
``/etc/default/nova-consoleproxy`` file or use the debconf interface.
You can also manually edit the ``/etc/default/nova-consoleproxy``
file, and stop and start the console daemons.
#. Edit the ``/etc/nova/nova.conf`` file and
complete the following actions:
* In the ``[DEFAULT]`` section, enable only the compute and metadata
APIs:
.. code-block:: ini
[DEFAULT]
...
enabled_apis = osapi_compute,metadata
* The ``.config`` and ``.postinst`` maintainer scripts of the
``nova-common`` package detect automatically the IP address which
goes in the ``my_ip`` directive of the ``[DEFAULT]`` section. This
value will normally still be prompted, and you can check that it
is correct in the nova.conf after ``nova-common`` is installed:
.. code-block:: ini
[DEFAULT]
...
my_ip = 10.0.0.11
* In the ``[DEFAULT]`` section, enable support for the Networking service:
.. code-block:: ini
[DEFAULT]
...
use_neutron = True
firewall_driver = nova.virt.firewall.NoopFirewallDriver
.. note::
By default, Compute uses an internal firewall driver. Since the
Networking service includes a firewall driver, you must disable the
Compute firewall driver by using the
``nova.virt.firewall.NoopFirewallDriver`` firewall driver.
* In the ``[vnc]`` section, configure the VNC proxy to use the management
interface IP address of the controller node:
.. code-block:: ini
[vnc]
enabled = true
...
vncserver_listen = $my_ip
vncserver_proxyclient_address = $my_ip
* In the ``[spice]`` section, disable spice.
.. code-block:: ini
[spice]
enabled = false
* In the ``[glance]`` section, configure the location of the
Image service API:
.. code-block:: ini
[glance]
...
api_servers = http://controller:9292
Finalize installation
---------------------
* Restart the Compute services:
.. code-block:: console
# service nova-api restart
# service nova-consoleauth restart
# service nova-scheduler restart
# service nova-conductor restart
# service nova-novncproxy restart