Merge "Fix the Debian nova-compute node install"

doc/install-guide/source/nova-compute-install.rst

@@ -42,7 +42,7 @@ Install and configure components
 
          # yum install openstack-nova-compute sysfsutils
 
-.. only:: ubuntu
+.. only:: ubuntu or debian
 
    #. Install the packages:
 
@@ -50,56 +50,71 @@ Install and configure components
 
          # apt-get install nova-compute sysfsutils
 
+   .. only:: debian
+
+      * Respond to prompts for
+         :doc:`database management <debconf/debconf-dbconfig-common>`,
+         :doc:`Identity service credentials <debconf/debconf-keystone-authtoken>`,
+         and :doc:`message broker credentials <debconf/debconf-rabbitmq>`. Make
+         sure that you do not activate database management handling by debconf,
+         as a compute node should not access the central database.
+
 2. Edit the ``/etc/nova/nova.conf`` file and
    complete the following actions:
 
-   * In the ``[DEFAULT]`` and [oslo_messaging_rabbit]
+   .. only:: obs or rdo or ubuntu
-     sections, configure ``RabbitMQ`` message queue access:
 
-     .. code-block:: ini
+      * In the ``[DEFAULT]`` and [oslo_messaging_rabbit]
+        sections, configure ``RabbitMQ`` message queue access:
 
-        [DEFAULT]
+        .. code-block:: ini
-        ...
-        rpc_backend = rabbit
 
-        [oslo_messaging_rabbit]
+           [DEFAULT]
-        ...
+           ...
-        rabbit_host = controller
+           rpc_backend = rabbit
-        rabbit_userid = openstack
-        rabbit_password = RABBIT_PASS
 
-     Replace ``RABBIT_PASS`` with the password you chose for
+           [oslo_messaging_rabbit]
-     the ``openstack`` account in ``RabbitMQ``.
+           ...
+           rabbit_host = controller
+           rabbit_userid = openstack
+           rabbit_password = RABBIT_PASS
 
-   * In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections,
+        Replace ``RABBIT_PASS`` with the password you chose for
-     configure Identity service access:
+        the ``openstack`` account in ``RabbitMQ``.
 
-     .. code-block:: ini
+      * In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections,
+        configure Identity service access:
 
-        [DEFAULT]
+        .. code-block:: ini
-        ...
-        auth_strategy = keystone
 
-        [keystone_authtoken]
+           [DEFAULT]
-        ...
+           ...
-        auth_uri = http://controller:5000
+           auth_strategy = keystone
-        auth_url = http://controller:35357
-        auth_plugin = password
-        project_domain_id = default
-        user_domain_id = default
-        project_name = service
-        username = nova
-        password = NOVA_PASS
 
-     Replace ``NOVA_PASS`` with the password you chose for the
+           [keystone_authtoken]
-     ``nova`` user in the Identity service.
+           ...
+           auth_uri = http://controller:5000
+           auth_url = http://controller:35357
+           auth_plugin = password
+           project_domain_id = default
+           user_domain_id = default
+           project_name = service
+           username = nova
+           password = NOVA_PASS
 
-     .. note::
+        Replace ``NOVA_PASS`` with the password you chose for the
+        ``nova`` user in the Identity service.
 
-        Comment out or remove any other options in the
+        .. note::
-        ``[keystone_authtoken]`` section.
 
-   * In the ``[DEFAULT]`` section, configure the ``my_ip`` option:
+           Comment out or remove any other options in the
+           ``[keystone_authtoken]`` section.
+
+   .. only:: debian
+
+   * In the ``[DEFAULT]`` section, check that the ``my_ip`` option
+     is correctly set (this value is handled by the config and postinst
+     scripts of the ``nova-common`` package using debconf):
 
      .. code-block:: ini
 
@@ -112,6 +127,21 @@ Install and configure components
      typically 10.0.0.31 for the first node in the
      :ref:`example architecture <overview-example-architectures>`.
 
+   .. only:: obs or rdo or ubuntu
+
+      * In the ``[DEFAULT]`` section, configure the ``my_ip`` option:
+
+        .. code-block:: ini
+
+           [DEFAULT]
+           ...
+           my_ip = MANAGEMENT_INTERFACE_IP_ADDRESS
+
+        Replace ``MANAGEMENT_INTERFACE_IP_ADDRESS`` with the IP address
+        of the management network interface on your compute node,
+        typically 10.0.0.31 for the first node in the
+        :ref:`example architecture <overview-example-architectures>`.
+
    * In the ``[DEFAULT]`` section, enable support for the Networking service:
 
      .. code-block:: ini
@@ -192,7 +222,7 @@ Install and configure components
         ...
         verbose = True
 
-.. only:: obs
+.. only:: obs or debian
 
    3. Ensure the kernel module ``nbd`` is loaded.
 
@@ -243,6 +273,16 @@ Finalize installation
            ...
            virt_type = qemu
 
+   .. only:: debian
+
+      * Replace the ``nova-compute-kvm`` package by the ``nova-compute-qemu``,
+        which will automatically change the ``/etc/nova/nova-compute.conf``
+        file and install the needed dependencies:
+
+        .. code-block:: console
+
+           # apt-get install nova-compute-qemu
+
 .. only:: obs or rdo
 
    2. Start the Compute service including its dependencies and configure
@@ -253,7 +293,7 @@ Finalize installation
          # systemctl enable libvirtd.service openstack-nova-compute.service
          # systemctl start libvirtd.service openstack-nova-compute.service
 
-.. only:: ubuntu
+.. only:: ubuntu or debian
 
    2. Restart the Compute service:
 
@@ -261,6 +301,8 @@ Finalize installation
 
          # service nova-compute restart
 
+.. only:: ubuntu
+
    3. By default, the Ubuntu packages create an SQLite database.
 
       Because this configuration uses an SQL database server, you can