2d44b2b36d
The new sphinx version introduces some changes that break build: * Warns if code cannot be parsed for highlighting. Fix the code so that it can be parsed, this includes uncommenting "..." lines. Note that not every config file is an ini-file. Also, the parser seems to have bugs and cannot parse all files. Fix mysql ini file and enable the parameter, see http://dev.mysql.com/doc/refman/5.7/en/innodb-parameters.html#sysvar_innodb_file_per_table * :option: works only with declared options, replace useage with simple ``. This change only handles a few files, more to come later. Change-Id: I7c7335e514581622dd562ee355f62d6ae1beaa18
120 lines
3.4 KiB
ReStructuredText
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
|