openstack/openstack-manuals
Code Issues Proposed changes

Update installation guide for Juno release

Browse Source 
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
This commit is contained in:
Matthew Kassawara 2014-10-29 11:51:08 -05:00
parent 77b9dd9543
commit 8f963115d7
18 changed files with 159 additions and 143 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/install-guide/section_basics-packages.xml
View File

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

14
doc/install-guide/section_ceilometer-cinder.xml
View File

@ -22,11 +22,19 @@ notification_driver = cinder.openstack.common.notifier.rpc_notifier</programlist
<para>On the controller node:</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> <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> <prompt>#</prompt> <userinput>service openstack-cinder-scheduler restart</userinput></screen>
<para>On the volume node:</para> <para os="opensuse">On openSUSE:</para>
<screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-volume restart</userinput></screen> <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="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>
<step> <step>
<para>If you want to collect OpenStack Block Storage notification on demand, <para>If you want to collect OpenStack Block Storage notification on demand,

18
doc/install-guide/section_ceilometer-controller.xml
View File

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

6
doc/install-guide/section_ceilometer-glance.xml
View File

@ -22,8 +22,12 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
settings:</para> settings:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service glance-registry restart</userinput> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service glance-registry restart</userinput>
<prompt>#</prompt> <userinput>service glance-api restart</userinput></screen> <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> <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> </step>
</procedure> </procedure>
</section> </section>

18
doc/install-guide/section_ceilometer-nova.xml
View File

@ -31,8 +31,12 @@ notification_driver = ceilometer.compute.nova_notifier</programlisting>
</step> </step>
<step> <step>
<para>Restart the Compute service:</para> <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="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> </step>
</procedure> </procedure>
<procedure> <procedure>
@ -100,13 +104,17 @@ log_dir = /var/log/ceilometer</programlisting>
<para>Restart the service with its new settings:</para> <para>Restart the service with its new settings:</para>
<screen><prompt>#</prompt> <userinput>service ceilometer-agent-compute restart</userinput></screen> <screen><prompt>#</prompt> <userinput>service ceilometer-agent-compute restart</userinput></screen>
</step> </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 <para>Start the service and configure it to start when the
system boots:</para> 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> <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> <para os="opensuse">On openSUSE:</para>
<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-compute on</userinput></screen> <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> </step>
</procedure> </procedure>
</section> </section>

10
doc/install-guide/section_ceilometer-swift.xml
View File

@ -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 <para>Add the system user <literal>swift</literal> to the system group
<literal>ceilometer</literal> to give Object Storage access to the <literal>ceilometer</literal> to give Object Storage access to the
<filename>ceilometer.conf</filename> file.</para> <filename>ceilometer.conf</filename> file.</para>
<screen> <screen><prompt>#</prompt> <userinput>usermod -a -G ceilometer swift</userinput></screen>
<prompt>#</prompt> <userinput>usermod -a -G ceilometer swift</userinput>
</screen>
</step> </step>
<step> <step>
<para>Add <literal>ResellerAdmin</literal> to the <para>Add <literal>ResellerAdmin</literal> to the
@ -61,7 +59,11 @@ pipeline = healthcheck cache authtoken keystoneauth ceilometer proxy-server</pro
<step> <step>
<para>Restart the service with its new settings:</para> <para>Restart the service with its new settings:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service swift-proxy restart</userinput></screen> <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> </step>
</procedure> </procedure>
</section> </section>

15
doc/install-guide/section_cinder-storage-node.xml
View File

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

20
doc/install-guide/section_glance-install.xml
View File

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

20
doc/install-guide/section_heat-install.xml
View File

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

16
doc/install-guide/section_keystone-install.xml
View File

@ -62,13 +62,13 @@
<para>Run the following command to install the packages:</para> <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="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="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>
<step os="ubuntu;rhel;centos;fedora;sles;opensuse"> <step>
<para>Edit the <filename>/etc/keystone/keystone.conf</filename> file and <para>Edit the <filename>/etc/keystone/keystone.conf</filename> file and
complete the following actions:</para> complete the following actions:</para>
<substeps> <substeps>
<step os="ubuntu;rhel;centos;fedora;sles;opensuse"> <step>
<para>In the <literal>[DEFAULT]</literal> section, define the value <para>In the <literal>[DEFAULT]</literal> section, define the value
of the initial administration token:</para> of the initial administration token:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
@ -77,7 +77,7 @@ admin_token = <replaceable>ADMIN_TOKEN</replaceable></programlisting>
<para>Replace <replaceable>ADMIN_TOKEN</replaceable> with the random <para>Replace <replaceable>ADMIN_TOKEN</replaceable> with the random
value that you generated in a previous step.</para> value that you generated in a previous step.</para>
</step> </step>
<step os="ubuntu;rhel;centos;fedora;sles;opensuse"> <step>
<para>In the <literal>[database]</literal> section, configure <para>In the <literal>[database]</literal> section, configure
database access:</para> database access:</para>
<programlisting language="ini">[database] <programlisting language="ini">[database]
@ -86,6 +86,14 @@ connection = mysql://keystone:<replaceable>KEYSTONE_DBPASS</replaceable>@<replac
<para>Replace <replaceable>KEYSTONE_DBPASS</replaceable> with the <para>Replace <replaceable>KEYSTONE_DBPASS</replaceable> with the
password you chose for the database.</para> password you chose for the database.</para>
</step> </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> <step>
<para>(Optional) To assist with troubleshooting, <para>(Optional) To assist with troubleshooting,
enable verbose logging in the <literal>[DEFAULT]</literal> section:</para> enable verbose logging in the <literal>[DEFAULT]</literal> section:</para>

4
doc/install-guide/section_neutron-compute-node.xml
View File

@ -26,8 +26,8 @@ net.ipv4.conf.default.rp_filter=0</programlisting>
<procedure os="ubuntu;rhel;centos;fedora;sles;opensuse"> <procedure os="ubuntu;rhel;centos;fedora;sles;opensuse">
<title>To install the Networking components</title> <title>To install the Networking components</title>
<step> <step>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-ml2 neutron-plugin-openvswitch-agent ipset</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-ml2 neutron-plugin-openvswitch-agent</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-neutron-ml2 openstack-neutron-openvswitch ipset</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-neutron-ml2 openstack-neutron-openvswitch</userinput></screen>
<screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install --no-recommends openstack-neutron-openvswitch-agent ipset</userinput></screen> <screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install --no-recommends openstack-neutron-openvswitch-agent ipset</userinput></screen>
<note os="sles;opensuse"> <note os="sles;opensuse">
<para>SUSE does not use a separate ML2 plug-in package.</para> <para>SUSE does not use a separate ML2 plug-in package.</para>

10
doc/install-guide/section_neutron-controller-node.xml
View File

@ -389,17 +389,15 @@ admin_password = <replaceable>NEUTRON_PASS</replaceable></programlisting>
</step> </step>
<step> <step>
<para>Restart the Compute services:</para> <para>Restart the Compute services:</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-scheduler.service</userinput> openstack-nova-conductor.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-conductor.service</userinput></screen>
<para os="sles">On SLES:</para> <para os="sles">On SLES:</para>
<screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-api restart</userinput> <screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-api restart</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-scheduler restart</userinput> <prompt>#</prompt> <userinput>service openstack-nova-scheduler restart</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-conductor restart</userinput></screen> <prompt>#</prompt> <userinput>service openstack-nova-conductor restart</userinput></screen>
<para os="opensuse">On openSUSE:</para> <para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service</userinput> <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-scheduler.service</userinput> openstack-nova-conductor.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-conductor.service</userinput></screen>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-api restart</userinput> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-api restart</userinput>
<prompt>#</prompt> <userinput>service nova-scheduler restart</userinput> <prompt>#</prompt> <userinput>service nova-scheduler restart</userinput>
<prompt>#</prompt> <userinput>service nova-conductor restart</userinput></screen> <prompt>#</prompt> <userinput>service nova-conductor restart</userinput></screen>

32
doc/install-guide/section_neutron-network-node.xml
View File

@ -27,8 +27,8 @@ net.ipv4.conf.default.rp_filter=0</programlisting>
<title>To install the Networking components</title> <title>To install the Networking components</title>
<step> <step>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-ml2 neutron-plugin-openvswitch-agent \ <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-ml2 neutron-plugin-openvswitch-agent \
neutron-l3-agent neutron-dhcp-agent ipset</userinput></screen> neutron-l3-agent neutron-dhcp-agent</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-neutron openstack-neutron-ml2 openstack-neutron-openvswitch ipset</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-neutron openstack-neutron-ml2 openstack-neutron-openvswitch</userinput></screen>
<screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install --no-recommends openstack-neutron-openvswitch-agent openstack-neutron-l3-agent \ <screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install --no-recommends openstack-neutron-openvswitch-agent openstack-neutron-l3-agent \
openstack-neutron-dhcp-agent openstack-neutron-metadata-agent ipset</userinput></screen> openstack-neutron-dhcp-agent openstack-neutron-metadata-agent ipset</userinput></screen>
<note os="sles;opensuse"> <note os="sles;opensuse">
@ -493,15 +493,11 @@ metadata_proxy_shared_secret = <replaceable>METADATA_SECRET</replaceable></progr
<step os="rhel;centos;fedora;sles;opensuse"> <step os="rhel;centos;fedora;sles;opensuse">
<para>Start the Networking services and configure them to start <para>Start the Networking services and configure them to start
when the system boots:</para> when the system boots:</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable neutron-openvswitch-agent.service</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable neutron-openvswitch-agent.service neutron-l3-agent.service \
<prompt>#</prompt> <userinput>systemctl enable neutron-l3-agent.service</userinput> neutron-dhcp-agent.service neutron-metadata-agent.service \
<prompt>#</prompt> <userinput>systemctl enable neutron-dhcp-agent.service</userinput> neutron-ovs-cleanup.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable neutron-metadata-agent.service</userinput> <prompt>#</prompt> <userinput>systemctl start neutron-openvswitch-agent.service neutron-l3-agent.service \
<prompt>#</prompt> <userinput>systemctl enable neutron-ovs-cleanup.service</userinput> neutron-dhcp-agent.service neutron-metadata-agent.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl start neutron-openvswitch-agent.service</userinput>
<prompt>#</prompt> <userinput>systemctl start neutron-l3-agent.service</userinput>
<prompt>#</prompt> <userinput>systemctl start neutron-dhcp-agent.service</userinput>
<prompt>#</prompt> <userinput>systemctl start neutron-metadata-agent.service</userinput></screen>
<note os="rhel;centos;fedora"> <note os="rhel;centos;fedora">
<para>Do not explictly start the <para>Do not explictly start the
<systemitem class="service">neutron-ovs-cleanup</systemitem> <systemitem class="service">neutron-ovs-cleanup</systemitem>
@ -518,15 +514,11 @@ metadata_proxy_shared_secret = <replaceable>METADATA_SECRET</replaceable></progr
<prompt>#</prompt> <userinput>chkconfig openstack-neutron-metadata-agent on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-neutron-metadata-agent on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-neutron-ovs-cleanup on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-neutron-ovs-cleanup on</userinput></screen>
<para os="opensuse">On openSUSE:</para> <para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-neutron-openvswitch-agent.service</userinput> <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-neutron-openvswitch-agent.service openstack-neutron-l3-agent.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-neutron-l3-agent.service</userinput> openstack-neutron-dhcp-agent.service openstack-neutron-metadata-agent.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-neutron-dhcp-agent.service</userinput> openstack-neutron-ovs-cleanup.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-neutron-metadata-agent.service</userinput> <prompt>#</prompt> <userinput>systemctl start openstack-neutron-openvswitch-agent.service openstack-neutron-l3-agent.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-neutron-ovs-cleanup.service</userinput> openstack-neutron-dhcp-agent.service openstack-neutron-metadata-agent.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl start openstack-neutron-openvswitch-agent.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-neutron-l3-agent.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-neutron-dhcp-agent.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-neutron-metadata-agent.service</userinput></screen>
<note os="sles;opensuse"> <note os="sles;opensuse">
<para>Do not explictly start the <para>Do not explictly start the
<systemitem class="service">openstack-neutron-ovs-cleanup</systemitem> <systemitem class="service">openstack-neutron-ovs-cleanup</systemitem>

18
doc/install-guide/section_nova-compute-install.xml
View File

@ -22,8 +22,8 @@
<title>To install and configure the Compute hypervisor components</title> <title>To install and configure the Compute hypervisor components</title>
<step> <step>
<para>Install the packages:</para> <para>Install the packages:</para>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-compute</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-compute sysfsutils</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-compute</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-compute sysfsutils</userinput></screen>
<screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install openstack-nova-compute genisoimage kvm</userinput></screen> <screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper install openstack-nova-compute genisoimage kvm</userinput></screen>
</step> </step>
<step> <step>
@ -43,9 +43,13 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<application>RabbitMQ</application>.</para> <application>RabbitMQ</application>.</para>
</step> </step>
<step> <step>
<para>In the <literal>[keystone_authtoken]</literal> section, <para>In the <literal>[DEFAULT]</literal> and
<literal>[keystone_authtoken]</literal> sections,
configure Identity service access:</para> configure Identity service access:</para>
<programlisting language="ini"> <programlisting language="ini">[DEFAULT]
...
auth_strategy = keystone
[keystone_authtoken] [keystone_authtoken]
... ...
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0 auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0
@ -188,9 +192,8 @@ virt_type = qemu</programlisting>
<step os="rhel;centos;fedora;sles;opensuse"> <step os="rhel;centos;fedora;sles;opensuse">
<para>Start the Compute service including its dependencies and configure <para>Start the Compute service including its dependencies and configure
them to start automatically when the system boots:</para> them to start automatically when the system boots:</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable libvirtd.service</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable libvirtd.service openstack-nova-compute.service</userinput>
<prompt>#</prompt> <userinput>systemctl start libvirtd.service</userinput> <prompt>#</prompt> <userinput>systemctl start libvirtd.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-compute.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-compute.service</userinput></screen> <prompt>#</prompt> <userinput>systemctl start openstack-nova-compute.service</userinput></screen>
<para os="sles">On SLES:</para> <para os="sles">On SLES:</para>
<screen os="sles"><prompt>#</prompt> <userinput>service libvirtd start</userinput> <screen os="sles"><prompt>#</prompt> <userinput>service libvirtd start</userinput>
@ -198,9 +201,8 @@ virt_type = qemu</programlisting>
<prompt>#</prompt> <userinput>service openstack-nova-compute start</userinput> <prompt>#</prompt> <userinput>service openstack-nova-compute start</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-nova-compute on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-nova-compute on</userinput></screen>
<para os="opensuse">On openSUSE:</para> <para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable libvirtd.service</userinput> <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable libvirtd.service openstack-nova-compute.service</userinput>
<prompt>#</prompt> <userinput>systemctl start libvirtd.service</userinput> <prompt>#</prompt> <userinput>systemctl start libvirtd.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-compute.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-compute.service</userinput></screen> <prompt>#</prompt> <userinput>systemctl start openstack-nova-compute.service</userinput></screen>
</step> </step>
<step os="ubuntu"> <step os="ubuntu">

45
doc/install-guide/section_nova-controller-install.xml
View File

@ -146,9 +146,14 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<application>RabbitMQ</application>.</para> <application>RabbitMQ</application>.</para>
</step> </step>
<step> <step>
<para>In the <literal>[keystone_authtoken]</literal> section, <para>In the <literal>[DEFAULT]</literal> and
<literal>[keystone_authtoken]</literal> sections,
configure Identity service access:</para> configure Identity service access:</para>
<programlisting language="ini">[keystone_authtoken] <programlisting language="ini">[DEFAULT]
...
auth_strategy = keystone
[keystone_authtoken]
... ...
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0 auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0
identity_uri = http://<replaceable>controller</replaceable>:35357 identity_uri = http://<replaceable>controller</replaceable>:35357
@ -250,18 +255,12 @@ vncserver_proxyclient_address = 10.0.0.11</programlisting>
<step os="rhel;centos;fedora;sles;opensuse"> <step os="rhel;centos;fedora;sles;opensuse">
<para>Start the Compute services and configure them to start when the <para>Start the Compute services and configure them to start when the
system boots:</para> system boots:</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-api.service</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-api.service openstack-nova-cert.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-cert.service</userinput> openstack-nova-consoleauth.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-consoleauth.service</userinput> openstack-nova-conductor.service openstack-nova-novncproxy.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-scheduler.service</userinput> <prompt>#</prompt> <userinput>systemctl start openstack-nova-api.service openstack-nova-cert.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-conductor.service</userinput> openstack-nova-consoleauth.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-novncproxy.service</userinput> openstack-nova-conductor.service openstack-nova-novncproxy.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-cert.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-consoleauth.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-scheduler.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-conductor.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-novncproxy.service</userinput></screen>
<para os="sles">On SLES:</para> <para os="sles">On SLES:</para>
<screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-api start</userinput> <screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-api start</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-cert start</userinput> <prompt>#</prompt> <userinput>service openstack-nova-cert start</userinput>
@ -276,18 +275,12 @@ vncserver_proxyclient_address = 10.0.0.11</programlisting>
<prompt>#</prompt> <userinput>chkconfig openstack-nova-conductor on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-nova-conductor on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-nova-novncproxy on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-nova-novncproxy on</userinput></screen>
<para os="opensuse">On openSUSE:</para> <para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-api.service</userinput> <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-api.service openstack-nova-cert.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-cert.service</userinput> openstack-nova-consoleauth.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-consoleauth.service</userinput> openstack-nova-conductor.service openstack-nova-novncproxy.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-scheduler.service</userinput> <prompt>#</prompt> <userinput>systemctl start openstack-nova-api.service openstack-nova-cert.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-conductor.service</userinput> openstack-nova-consoleauth.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-novncproxy.service</userinput> openstack-nova-conductor.service openstack-nova-novncproxy.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-cert.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-consoleauth.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-scheduler.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-conductor.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-novncproxy.service</userinput></screen>
</step> </step>
<step os="ubuntu"> <step os="ubuntu">
<para>By default, the Ubuntu packages create an SQLite database.</para> <para>By default, the Ubuntu packages create an SQLite database.</para>

12
doc/install-guide/section_nova-networking-compute-node.xml
View File

@ -56,20 +56,16 @@ public_interface = <replaceable>INTERFACE_NAME</replaceable></programlisting>
<prompt>#</prompt> <userinput>service nova-api-metadata restart</userinput></screen> <prompt>#</prompt> <userinput>service nova-api-metadata restart</userinput></screen>
<para os="rhel;centos;fedora;sles;opensuse">Start the services and <para os="rhel;centos;fedora;sles;opensuse">Start the services and
configure them to start when the system boots:</para> configure them to start when the system boots:</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-network.service</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-network.service openstack-nova-metadata-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-metadata-api.service</userinput> <prompt>#</prompt> <userinput>systemctl start openstack-nova-network.service openstack-nova-metadata-api.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-network.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-metadata-api.service</userinput></screen>
<para os="sles">On SLES:</para> <para os="sles">On SLES:</para>
<screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-network start</userinput> <screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-network start</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-api-metadata start</userinput> <prompt>#</prompt> <userinput>service openstack-nova-api-metadata start</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-nova-network on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-nova-network on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-nova-api-metadata on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-nova-api-metadata on</userinput></screen>
<para os="opensuse">On openSUSE:</para> <para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-network.service</userinput> <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-nova-network.service openstack-nova-metadata-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-metadata-api.service</userinput> <prompt>#</prompt> <userinput>systemctl start openstack-nova-network.service penstack-nova-metadata-api.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-network.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-nova-metadata-api.service</userinput></screen>
</step> </step>
</procedure> </procedure>
</section> </section>

10
doc/install-guide/section_nova-networking-controller-node.xml
View File

@ -26,17 +26,15 @@ security_group_api = nova</programlisting>
</step> </step>
<step> <step>
<para>Restart the Compute services:</para> <para>Restart the Compute services:</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-scheduler.service</userinput> openstack-nova-conductor.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-conductor.service</userinput></screen>
<para os="sles">On SLES:</para> <para os="sles">On SLES:</para>
<screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-api restart</userinput> <screen os="sles"><prompt>#</prompt> <userinput>service openstack-nova-api restart</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-scheduler restart</userinput> <prompt>#</prompt> <userinput>service openstack-nova-scheduler restart</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-conductor restart</userinput></screen> <prompt>#</prompt> <userinput>service openstack-nova-conductor restart</userinput></screen>
<para os="opensuse">On openSUSE:</para> <para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service</userinput> <screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-nova-api.service openstack-nova-scheduler.service \
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-scheduler.service</userinput> openstack-nova-conductor.service</userinput></screen>
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-conductor.service</userinput></screen>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-api restart</userinput> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-api restart</userinput>
<prompt>#</prompt> <userinput>service nova-scheduler restart</userinput> <prompt>#</prompt> <userinput>service nova-scheduler restart</userinput>
<prompt>#</prompt> <userinput>service nova-conductor restart</userinput></screen> <prompt>#</prompt> <userinput>service nova-conductor restart</userinput></screen>

28
doc/install-guide/section_trove-install.xml
View File

@ -215,23 +215,31 @@ trove_auth_url = http://<replaceable>controller</replaceable>:35357/v2.0</progra
--adminurl http://<replaceable>controller</replaceable>:8779/v1.0/%\(tenant_id\)s \ --adminurl http://<replaceable>controller</replaceable>:8779/v1.0/%\(tenant_id\)s \
--region regionOne</userinput></screen> --region regionOne</userinput></screen>
</step> </step>
<step os="ubuntu;debian">
<step os="rhel;centos;fedora;opensuse;sles;ubuntu"> <para>Restart the Database services:</para>
<para os="centos;fedora;rhel;opensuse;sles">Start Database <screen><prompt>#</prompt> <userinput>service trove-api restart</userinput>
services and configure them to start when the system
boots:</para>
<para os="ubuntu">Restart Database services:</para>
<screen os="ubuntu"><prompt>#</prompt> <userinput>service trove-api restart</userinput>
<prompt>#</prompt> <userinput>service trove-taskmanager restart</userinput> <prompt>#</prompt> <userinput>service trove-taskmanager restart</userinput>
<prompt>#</prompt> <userinput>service trove-conductor restart</userinput></screen> <prompt>#</prompt> <userinput>service trove-conductor restart</userinput></screen>
</step>
<screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-trove-api start</userinput> <step os="rhel;centos;fedora;sles;opensuse">
<para>Start the Database services and configure them to start when the
system boots:</para>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>systemctl enable openstack-trove-api.service openstack-trove-taskmanager.service \
openstack-trove-conductor.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-trove-api.service openstack-trove-taskmanager.service \
openstack-trove-conductor.service</userinput></screen>
<para os="sles">On SLES:</para>
<screen os="sles"><prompt>#</prompt> <userinput>service openstack-trove-api start</userinput>
<prompt>#</prompt> <userinput>service openstack-trove-taskmanager start</userinput> <prompt>#</prompt> <userinput>service openstack-trove-taskmanager start</userinput>
<prompt>#</prompt> <userinput>service openstack-trove-conductor start</userinput> <prompt>#</prompt> <userinput>service openstack-trove-conductor start</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-trove-api on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-trove-api on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-trove-taskmanager on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-trove-taskmanager on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-trove-conductor on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-trove-conductor on</userinput></screen>
<para os="opensuse">On openSUSE:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable openstack-trove-api.service openstack-trove-taskmanager.service \
openstack-trove-conductor.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-trove-api.service openstack-trove-taskmanager.service \
openstack-trove-conductor.service</userinput></screen>
</step> </step>
</procedure> </procedure>