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,9 +50,20 @@ 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:
 
+   .. only:: obs or rdo or ubuntu
+
       * In the ``[DEFAULT]`` and [oslo_messaging_rabbit]
         sections, configure ``RabbitMQ`` message queue access:
 
@@ -99,6 +110,25 @@ Install and configure components
            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
+
+        [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>`.
+
+   .. only:: obs or rdo or ubuntu
+
       * In the ``[DEFAULT]`` section, configure the ``my_ip`` option:
 
         .. 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