Install Guide: Add table documenting reserved UIDs

Add a table documenting the reserved UIDs that are used by
OpenStack.
This is information that belongs IMO into an appendix, let's make
it specific for each distribution.

backport: none
Change-Id: I66f861b4ad84231af5053826dbc47df4d91bc0b9
Closes-Bug: #1239879

doc/install-guide/app_reserved_uids.xml

@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appendix xml:id="reserved_uids"
+  xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  <title>Reserved user IDs</title>
+
+  <para>
+    In OpenStack, certain user IDs are reserved and used to run
+    specific OpenStack services and own specific OpenStack
+    files. These users are set up according to the distribution
+    packages. The following table gives an overview.
+  </para>
+
+  <note os="debian;opensuse;sles;ubuntu">
+    <para>Some OpenStack packages generate and assign user IDs
+      automatically during package installation. In these cases, the
+      user ID value is not important. The existence of the user ID is
+      what matters.
+    </para>
+  </note>
+
+  <table rules="all">
+    <caption>Reserved user IDs</caption>
+    <thead>
+      <tr>
+        <th>Name</th>
+        <th>Description</th>
+        <th>ID</th>
+      </tr>
+    </thead>
+    <tbody>
+      <!-- sorted by first column -->
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">ceilometer</td>
+        <td os="opensuse;sles">openstack-ceilometer</td>
+        <td>OpenStack Ceilometer Daemons</td>
+        <td os="rhel;centos;fedora">166</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">cinder</td>
+        <td os="opensuse;sles">openstack-cinder</td>
+        <td>OpenStack Cinder Daemons</td>
+        <td os="rhel;centos;fedora">165</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">glance</td>
+        <td os="opensuse;sles">openstack-glance</td>
+        <td>OpenStack Glance Daemons</td>
+        <td os="rhel;centos;fedora">161</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">heat</td>
+        <td os="opensuse;sles">openstack-heat</td>
+        <td>OpenStack Heat Daemons</td>
+        <td os="rhel;centos;fedora">187</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">keystone</td>
+        <td os="opensuse;sles">openstack-keystone</td>
+        <td>OpenStack Keystone Daemons</td>
+        <td os="rhel;centos;fedora">163</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">neutron</td>
+        <td os="opensuse;sles">openstack-neutron</td>
+        <td>OpenStack Neutron Daemons</td>
+        <td os="rhel;centos;fedora">164</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">nova</td>
+        <td os="opensuse;sles">openstack-nova</td>
+        <td>OpenStack Nova Daemons</td>
+        <td os="rhel;centos;fedora">162</td>
+        <td os="opensuse;sles">96</td>
+        <td os="debian;ubuntu">Assigned during package installation</td>
+      </tr>
+      <tr>
+        <td os="ubuntu;debian;rhel;centos;fedora">swift</td>
+        <td os="opensuse;sles">openstack-swift</td>
+        <td>OpenStack Swift Daemons</td>
+        <td os="rhel;centos;fedora">160</td>
+        <td os="debian;opensuse;sles;ubuntu">Assigned during package installation</td>
+      </tr>
+    </tbody>
+  </table>
+  <para>Each user belongs to a user group with the same name as the
+  user.
+  </para>
+</appendix>

doc/install-guide/bk_openstackinstallguide.xml

@@ -566,5 +566,6 @@
     <xi:include href="ch_neutron.xml"/>
     <xi:include href="ch_heat.xml"/>
     <xi:include href="ch_ceilometer.xml"/>
+    <xi:include href="app_reserved_uids.xml"/>
     <xi:include href="../common/app_support.xml"/>
 </book>