Update installation guide for Juno release

I updated the installation guide for Juno release packages as
follows:

1) Converted 'systemctl' commands to single lines.
2) Converted more sections to use 'systemctl' commands.
3) Added note about lengthy installation time for
   'openstack-selinux' package.
4) Explicitly configured UUID tokens and SQL driver in
   keystone. RDO needs to update or remove the 'dist'
   configuration files for services.
5) Explicitly configured local file system store options
   in [glance_store] section that appeared two days before
   official release. Although the Ubuntu and RDO packages
   appear to work by default, late changes to configuration
   files tend to cause problems at some point.
6) Explicitly configured authentication strategy to keystone
   in nova on controller and compute nodes. I think we should
   avoid relying on defaults for this option and reconsider
   for Kilo, particularly with RDO packages.
7) Explicitly installed 'sysfsutils' package on nova compute nodes
   because nova looks for it during cinder volume operations.
8) Removed explicit installation of 'ipset' package on neutron
   network and compute nodes because the Ubuntu and RDO packages
   install it as a dependency. Not sure about SUSE, so I left
   the explicit installation.
9) Changed cinder example devices from /dev/sdb to /dev/sdb1
   because LVM on CentOS didn't like the former.

Note: The configuration changes mostly apply to RDO packages on
CentOS, but given the time constraints, I fixed some other issues.
Also, this patch ignores the sahara chapter.

Closes-Bug: #1383925

Change-Id: I0c9bbbfe72b8f0358f00d4f82b90ce4976a90ea2

doc/install-guide/section_basics-packages.xml

@@ -165,6 +165,10 @@ Key Expires: Thu Dec 17 13:34:21 2015</programlisting>
       <note>
         <para>Fedora does not require this package.</para>
       </note>
+      <note>
+        <para>The installation process for this package can take a
+          while.</para>
+      </note>
     </step>
   </procedure>
 </section>

doc/install-guide/section_ceilometer-cinder.xml

@@ -20,13 +20,21 @@ notification_driver = cinder.openstack.common.notifier.rpc_notifier</programlist
       <para>Restart the Block Storage services with their new
         settings.</para>
       <para>On the controller node:</para>
-        <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-api restart</userinput>
+      <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-api restart</userinput>
 <prompt>#</prompt> <userinput>service cinder-scheduler restart</userinput></screen>
-        <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-cinder-api.service openstack-cinder-scheduler.service</userinput></screen>
+      <para os="sles">On SLES:</para>
+      <screen os="sles"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput>
 <prompt>#</prompt> <userinput>service openstack-cinder-scheduler restart</userinput></screen>
-      <para>On the volume node:</para>
-      <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-volume restart</userinput></screen>
+      <para os="opensuse">On openSUSE:</para>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-cinder-api.service openstack-cinder-scheduler.service</userinput></screen>
+      <para>On the storage node:</para>
       <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-volume restart</userinput></screen>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-cinder-volume.service</userinput></screen>
+      <para os="sles">On SLES:</para>
+      <screen os="sles"><prompt>#</prompt> <userinput>service openstack-cinder-volume restart</userinput></screen>
+      <para os="opensuse">On openSUSE:</para>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-cinder-volume.service</userinput></screen>
     </step>
       <step>
        <para>If you want to collect OpenStack Block Storage notification on demand,

doc/install-guide/section_ceilometer-controller.xml

@@ -351,18 +351,12 @@ os_password = <replaceable>CEILOMETER_PASS</replaceable></programlisting>
     <step os="rhel;centos;fedora;sles;opensuse">
       <para>Start the Telemetry services and configure them to start when the
         system boots:</para>
-      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>service openstack-ceilometer-api start</userinput>
-<prompt>#</prompt> <userinput>service openstack-ceilometer-notification start</userinput>
-<prompt>#</prompt> <userinput>service openstack-ceilometer-central start</userinput>
-<prompt>#</prompt> <userinput>service openstack-ceilometer-collector start</userinput>
-<prompt>#</prompt> <userinput>service openstack-ceilometer-alarm-evaluator start</userinput>
-<prompt>#</prompt> <userinput>service openstack-ceilometer-alarm-notifier start</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-api on</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-notification on</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-central on</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-collector on</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-alarm-evaluator on</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-alarm-notifier on</userinput></screen>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-api.service openstack-ceilometer-notification.service \
+  openstack-ceilometer-central.service openstack-ceilometer-collector.service \
+  openstack-ceilometer-alarm-evaluator.service openstack-ceilometer-alarm-notifier.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-api.service openstack-ceilometer-notification.service \
+  openstack-ceilometer-central.service openstack-ceilometer-collector.service \
+  openstack-ceilometer-alarm-evaluator.service openstack-ceilometer-alarm-notifier.service</userinput></screen>
       <para os="sles">On SLES:</para>
       <screen os="sles"><prompt>#</prompt> <userinput>service openstack-ceilometer-api start</userinput>
 <prompt>#</prompt> <userinput>service openstack-ceilometer-agent-notification start</userinput>

doc/install-guide/section_ceilometer-glance.xml

@@ -22,8 +22,12 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
           settings:</para>
         <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service glance-registry restart</userinput>
 <prompt>#</prompt> <userinput>service glance-api restart</userinput></screen>
-        <screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-glance-api restart</userinput>
+        <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-glance-api.service openstack-glance-registry.service</userinput></screen>
+        <para os="sles">On SLES:</para>
+        <screen os="sles"><prompt>#</prompt> <userinput>service openstack-glance-api restart</userinput>
 <prompt>#</prompt> <userinput>service openstack-glance-registry restart</userinput></screen>
+        <para os="opensuse">On openSUSE:</para>
+        <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-glance-api.service openstack-glance-registry.service</userinput></screen>
     </step>
   </procedure>
 </section>

doc/install-guide/section_ceilometer-nova.xml

@@ -31,8 +31,12 @@ notification_driver = ceilometer.compute.nova_notifier</programlisting>
     </step>
     <step>
       <para>Restart the Compute service:</para>
-      <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-compute restart</userinput></screen>
       <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-compute restart</userinput></screen>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-compute.service</userinput></screen>
+      <para os="sles">On SLES:</para>
+      <screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-compute restart</userinput></screen>
+      <para os="opensuse">On openSUSE:</para>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-compute.service</userinput></screen>
     </step>
   </procedure>
   <procedure>
@@ -100,13 +104,17 @@ log_dir = /var/log/ceilometer</programlisting>
       <para>Restart the service with its new settings:</para>
       <screen><prompt>#</prompt> <userinput>service ceilometer-agent-compute restart</userinput></screen>
     </step>
-    <step os="rhel;fedora;centos;opensuse;sles">
+    <step os="rhel;centos;fedora;sles;opensuse">
       <para>Start the service and configure it to start when the
         system boots:</para>
-      <screen os="opensuse;sles"><prompt>#</prompt> <userinput>service openstack-ceilometer-agent-compute start</userinput>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-compute.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-compute.service</userinput></screen>
+      <para os="sles">On SLES:</para>
+      <screen os="sles"><prompt>#</prompt> <userinput>service openstack-ceilometer-agent-compute start</userinput>
 <prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-agent-compute on</userinput></screen>
-      <screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-ceilometer-compute start</userinput>
-<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-compute on</userinput></screen>
+      <para os="opensuse">On openSUSE:</para>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-compute.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-compute.service</userinput></screen>
     </step>
   </procedure>
 </section>

doc/install-guide/section_ceilometer-swift.xml

@@ -49,9 +49,7 @@ pipeline = healthcheck cache authtoken keystoneauth ceilometer proxy-server</pro
       <para>Add the system user <literal>swift</literal> to the system group
       <literal>ceilometer</literal> to give Object Storage access to the
       <filename>ceilometer.conf</filename> file.</para>
-      <screen>
-        <prompt>#</prompt> <userinput>usermod -a -G ceilometer swift</userinput>
-      </screen>
+      <screen><prompt>#</prompt> <userinput>usermod -a -G ceilometer swift</userinput></screen>
     </step>
     <step>
       <para>Add <literal>ResellerAdmin</literal> to the
@@ -61,7 +59,11 @@ pipeline = healthcheck cache authtoken keystoneauth ceilometer proxy-server</pro
     <step>
       <para>Restart the service with its new settings:</para>
       <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service swift-proxy restart</userinput></screen>
-      <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-swift-proxy restart</userinput></screen>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy.service</userinput></screen>
+      <para os="sles">On SLES:</para>
+      <screen os="sles"><prompt>#</prompt> <userinput>service openstack-swift-proxy restart</userinput></screen>
+      <para os="opensuse">On openSUSE:</para>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy.service</userinput></screen>
     </step>
   </procedure>
 </section>

doc/install-guide/section_cinder-storage-node.xml

@@ -9,9 +9,10 @@
   <para>This section describes how to install and configure storage nodes
     for the Block Storage service. For simplicity, this configuration
     references one storage node with an empty local block storage device
-    <literal>/dev/sdb</literal>. The service provisions logical volumes
-    on this device using the <glossterm>LVM</glossterm> driver and provides
-    them to instances via
+    <literal>/dev/sdb</literal> that contains a suitable partition table with
+    one partition <literal>/dev/sdb1</literal> occupying the entire device.
+    The service provisions logical volumes on this device using the
+    <glossterm>LVM</glossterm> driver and provides them to instances via
     <glossterm baseform="Internet Small Computer Systems Interface (iSCSI)"
     >iSCSI</glossterm> transport. You can follow these instructions with
     minor modifications to horizontally scale your environment with
@@ -65,9 +66,9 @@
 <prompt>#</prompt> <userinput>systemctl start lvm2-lvmetad.service</userinput></screen>
     </step>
     <step>
-      <para>Create the LVM physical volume <literal>/dev/sdb</literal>:</para>
-      <screen><prompt>#</prompt> <userinput>pvcreate /dev/sdb</userinput>
-<computeroutput>  Physical volume "/dev/sdb" successfully created</computeroutput></screen>
+      <para>Create the LVM physical volume <literal>/dev/sdb1</literal>:</para>
+      <screen><prompt>#</prompt> <userinput>pvcreate /dev/sdb1</userinput>
+<computeroutput>  Physical volume "/dev/sdb1" successfully created</computeroutput></screen>
       <note>
         <para>If your system uses a different device name, adjust these
           steps accordingly.</para>
@@ -76,7 +77,7 @@
     <step>
       <para>Create the LVM volume group
         <literal>cinder-volumes</literal>:</para>
-      <screen><prompt>#</prompt> <userinput>vgcreate cinder-volumes /dev/sdb</userinput>
+      <screen><prompt>#</prompt> <userinput>vgcreate cinder-volumes /dev/sdb1</userinput>
 <computeroutput>  Volume group "cinder-volumes" successfully created</computeroutput></screen>
       <para>The Block Storage service creates logical volumes in this
         volume group.</para>

doc/install-guide/section_glance-install.xml

@@ -207,6 +207,14 @@ flavor = keystone</programlisting>
               <literal>identity_uri</literal> option replaces them.</para>
           </note>
         </step>
+        <step>
+          <para>In the <literal>[glance_store]</literal> section, configure
+            the local file system store and location of image files:</para>
+          <programlisting language="ini">[glance_store]
+...
+default_store = file
+filesystem_store_datadir = /var/lib/glance/images/</programlisting>
+        </step>
         <step>
           <para>In the <literal>[DEFAULT]</literal> section, we recommend
             enabling verbose logging to assist with potential
@@ -260,20 +268,16 @@ verbose = True</programlisting>
     <step os="rhel;centos;fedora;sles;opensuse">
       <para>Start the Image Service services and configure them to start when
         the system boots:</para>
-      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-glance-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl enable openstack-glance-registry.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-glance-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-glance-registry.service</userinput></screen>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-glance-api.service openstack-glance-registry.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-glance-api.service openstack-glance-registry.service</userinput></screen>
       <para os="sles">On SLES:</para>
       <screen os="sles"><prompt>#</prompt> <userinput>service openstack-glance-api start</userinput>
 <prompt>#</prompt> <userinput>service openstack-glance-registry start</userinput>
 <prompt>#</prompt> <userinput>chkconfig openstack-glance-api on</userinput>
 <prompt>#</prompt> <userinput>chkconfig openstack-glance-registry on</userinput></screen>
       <para os="opensuse">On openSUSE:</para>
-      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-glance-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl enable openstack-glance-registry.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-glance-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-glance-registry.service</userinput></screen>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-glance-api.service openstack-glance-registry.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-glance-api.service openstack-glance-registry.service</userinput></screen>
     </step>
     <step os="ubuntu">
       <para>By default, the Ubuntu packages create an SQLite database.</para>

doc/install-guide/section_heat-install.xml

@@ -265,12 +265,10 @@ auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0</programlistin
     <step os="rhel;fedora;centos;sles;opensuse">
       <para>Start the Orchestration services and configure them to start when
         the system boots:</para>
-      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-heat-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl enable openstack-heat-api-cfn.service</userinput>
-<prompt>#</prompt> <userinput>systemctl enable openstack-heat-engine.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-heat-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-heat-api-cfn.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-heat-engine.service</userinput></screen>
+      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-heat-api.service openstack-heat-api-cfn.service \
+  openstack-heat-engine.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-heat-api.service openstack-heat-api-cfn.service \
+  openstack-heat-engine.service</userinput></screen>
       <para os="sles">On SLES:</para>
       <screen os="sles"><prompt>#</prompt> <userinput>service openstack-heat-api start</userinput>
 <prompt>#</prompt> <userinput>service openstack-heat-api-cfn start</userinput>
@@ -279,12 +277,10 @@ auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0</programlistin
 <prompt>#</prompt> <userinput>chkconfig openstack-heat-api-cfn on</userinput>
 <prompt>#</prompt> <userinput>chkconfig openstack-heat-engine on</userinput></screen>
       <para os="opensuse">On openSUSE:</para>
-      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-heat-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl enable openstack-heat-api-cfn.service</userinput>
-<prompt>#</prompt> <userinput>systemctl enable openstack-heat-engine.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-heat-api.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-heat-api-cfn.service</userinput>
-<prompt>#</prompt> <userinput>systemctl start openstack-heat-engine.service</userinput></screen>
+      <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-heat-api.service openstack-heat-api-cfn.service \
+  openstack-heat-engine.service</userinput>
+<prompt>#</prompt> <userinput>systemctl start openstack-heat-api.service openstack-heat-api-cfn.service \
+  openstack-heat-engine.service</userinput></screen>
     </step>
     <step os="ubuntu">
       <para>By default, the Ubuntu packages create a SQLite database.</para>

doc/install-guide/section_keystone-install.xml

@@ -62,13 +62,13 @@
       <para>Run the following command to install the packages:</para>
       <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install keystone python-keystoneclient</userinput></screen>
       <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-keystone python-keystoneclient</userinput></screen>
-      <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-keystone python-keystoneclient</userinput></screen>
+      <screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install openstack-keystone python-keystoneclient</userinput></screen>
     </step>
-    <step os="ubuntu;rhel;centos;fedora;sles;opensuse">
+    <step>
       <para>Edit the <filename>/etc/keystone/keystone.conf</filename> file and
         complete the following actions:</para>
       <substeps>
-        <step os="ubuntu;rhel;centos;fedora;sles;opensuse">
+        <step>
           <para>In the <literal>[DEFAULT]</literal> section, define the value
             of the initial administration token:</para>
           <programlisting language="ini">[DEFAULT]
@@ -77,7 +77,7 @@ admin_token = <replaceable>ADMIN_TOKEN</replaceable></programlisting>
           <para>Replace <replaceable>ADMIN_TOKEN</replaceable> with the random
             value that you generated in a previous step.</para>
         </step>
-        <step os="ubuntu;rhel;centos;fedora;sles;opensuse">
+        <step>
           <para>In the <literal>[database]</literal> section, configure
             database access:</para>
           <programlisting language="ini">[database]
@@ -86,6 +86,14 @@ connection = mysql://keystone:<replaceable>KEYSTONE_DBPASS</replaceable>@<replac
           <para>Replace <replaceable>KEYSTONE_DBPASS</replaceable> with the
             password you chose for the database.</para>
         </step>
+        <step>
+          <para>In the <literal>[token]</literal> section, configure the UUID
+            token provider and SQL driver:</para>
+          <programlisting language="ini">[token]
+...
+provider = keystone.token.providers.uuid.Provider
+driver = keystone.token.persistence.backends.sql.Token</programlisting>
+        </step>
         <step>
           <para>(Optional) To assist with troubleshooting,
             enable verbose logging in the <literal>[DEFAULT]</literal> section:</para>