Run db_sync commands as the proper users

keystone-manage db_sync creates a log file
/var/log/keystone/keystone.log (and other db_sync commands create similar
logs in their respective directories).  If run as root, the log file is
owned by root.  In some cases (keystone), this prevents services from
starting.  In other cases (e.g. glance-api), it prevents the service
from writing to its log file.  Thus, all db_sync commands were changed
to run them as the correct users for the services being configured.
Note: this does not appear to be a problem with Ubuntu, but I made the
change for all distros for consistency, since it will not harm anything
to run db_sync as the correct user on Ubuntu, even if it is not
necessary.  Feel free to -1 this if you think there should be an
OS-specific step instead.

Change-Id: Idd8ea62cf883edcc7b308d25292d8b18d2631330
Closes-Bug: #1308316

doc/install-guide/section_cinder-controller.xml

@@ -53,7 +53,7 @@ connection = mysql://cinder:<replaceable>CINDER_DBPASS</replaceable>@<replaceabl
     <step os="ubuntu;rhel;centos;fedora;opensuse;sles">
       <para>Create the database tables for the Block Storage
         service:</para>
-      <screen><prompt>#</prompt> <userinput>cinder-manage db sync</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "cinder-manage db sync" cinder</userinput></screen>
     </step>
     <step os="rhel;centos;fedora;opensuse;sles;ubuntu">
       <para>Create a <literal>cinder</literal> user.</para>

doc/install-guide/section_glance-install.xml

@@ -125,7 +125,7 @@ IDENTIFIED BY '<replaceable>GLANCE_DBPASS</replaceable>';</userinput></screen>
     </step>
     <step os="ubuntu;rhel;centos;fedora;opensuse;sles">
       <para>Create the database tables for the Image Service:</para>
-      <screen><prompt>#</prompt> <userinput>glance-manage db_sync</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "glance-manage db_sync" glance</userinput></screen>
     </step>
     <step os="rhel;centos;fedora;opensuse;sles;ubuntu">
       <para>Create a <literal>glance</literal> user that the Image

doc/install-guide/section_heat-install.xml

@@ -64,7 +64,7 @@ IDENTIFIED BY '<replaceable>HEAT_DBPASS</replaceable>';</userinput></screen>
     </step>
     <step os="fedora;centos;rhel;ubuntu">
       <para>Create the heat service tables:</para>
-      <screen><prompt>#</prompt> <userinput>heat-manage db_sync</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "heat-manage db_sync" heat</userinput></screen>
       <note>
         <para>Ignore <errortext>DeprecationWarning</errortext>
           errors.</para>

doc/install-guide/section_keystone-install.xml

@@ -61,9 +61,8 @@ connection = mysql://keystone:<replaceable>KEYSTONE_DBPASS</replaceable>@<replac
     </step>
     <step os="ubuntu;rhel;centos;fedora;opensuse;sles">
       <para>Create the database tables for the Identity Service:</para>
-      <screen><prompt>#</prompt> <userinput>keystone-manage db_sync</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "keystone-manage db_sync" keystone</userinput></screen>
     </step>
-
     <step os="debian">
       <para>Define an authorization token to use as a shared secret
         between the Identity Service and other OpenStack services.

doc/install-guide/section_nova-controller.xml

@@ -121,7 +121,7 @@ IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput></screen>
     </step>
     <step os="ubuntu;rhel;centos;fedora;opensuse;sles">
       <para>Create the Compute service tables:</para>
-      <screen><prompt>#</prompt> <userinput>nova-manage db sync</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "nova-manage db sync" nova</userinput></screen>
     </step>
     <step os="rhel;centos;fedora;opensuse;sles;ubuntu">
       <para>Create a <literal>nova</literal> user that Compute uses to