[install] Fix the Debian nova-compute node install

This patch fixes numerous issues in the nova-compute setup in Debian.
This is a 2nd attempt after the patch was reverted. Hopefuly, this
patch wont have issues with conditionals this time.

Change-Id: I03eedb6e6262e2a0484814a953a5787aca7b5624

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.
 
@@ -200,8 +230,8 @@ Install and configure components
 
          # modprobe nbd
 
-   4. Ensure the module will be loaded on every boot by adding
+   4. Ensure the module loads on every boot by adding ``nbd``
-      ``nbd`` in the ``/etc/modules-load.d/nbd.conf`` file.
+      to the ``/etc/modules-load.d/nbd.conf`` file.
 
 Finalize installation
 ---------------------
@@ -243,6 +273,16 @@ Finalize installation
            ...
            virt_type = qemu
 
+   .. only:: debian
+
+      * Replace the ``nova-compute-kvm`` package with ``nova-compute-qemu``
+        which automatically changes the ``/etc/nova/nova-compute.conf``
+        file and installs the necessary 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