openstack/openstack-manuals
Code Issues Proposed changes

Use traditional init script commands for openSUSE

Browse Source 
These changes allow sharing the code of Fedora with openSUSE
and also SLES.

Also, tag some openSUSE changes with sles as well, more
to come.

Change-Id: I6b7fb9fb271e4ddbf267a09b2f10c4c968ef7092
This commit is contained in:
Andreas Jaeger 2013-10-16 08:56:40 +02:00
parent 726b04a717
commit 9876fe99af
18 changed files with 107 additions and 146 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/install-guide/ap_configuration_files.xml
View File

@ -95,7 +95,7 @@
</listitem> </listitem>
</itemizedlist></para> </itemizedlist></para>
<literallayout os="ubuntu;opensuse" class="monospaced"><xi:include parse="text" href="../common/samples/nova.conf"/></literallayout> <literallayout os="ubuntu;opensuse;sles" class="monospaced"><xi:include parse="text" href="../common/samples/nova.conf"/></literallayout>
<literallayout os="rhel;centos;fedora" class="monospaced"><xi:include parse="text" href="../common/samples/nova.conf-yum"/></literallayout> <literallayout os="rhel;centos;fedora" class="monospaced"><xi:include parse="text" href="../common/samples/nova.conf-yum"/></literallayout>
</section> </section>
<section xml:id="api-paste-ini-file"> <section xml:id="api-paste-ini-file">

33
doc/install-guide/ch_basics.xml
View File

@ -111,7 +111,7 @@ DEFROUTE=yes
ONBOOT=yes</programlisting> ONBOOT=yes</programlisting>
</example> </example>
<para os="opensuse"> <para os="opensuse;sles">
To set up the two network interfaces, start the YaST To set up the two network interfaces, start the YaST
network module, as follows: network module, as follows:
<screen><prompt>#</prompt> <userinput>yast2 network</userinput></screen> <screen><prompt>#</prompt> <userinput>yast2 network</userinput></screen>
@ -161,8 +161,7 @@ iface eth1 inet static
<para>Once you've configured the network, restart the daemon for changes to take effect:</para> <para>Once you've configured the network, restart the daemon for changes to take effect:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service networking restart</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service networking restart</userinput></screen>
<screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>service network restart</userinput></screen> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>service network restart</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart network.service</userinput></screen>
<para>Set the host name of each machine. Name the controller node <para>Set the host name of each machine. Name the controller node
<literal>controller</literal> and the first compute node <literal>controller</literal> and the first compute node
@ -171,7 +170,7 @@ iface eth1 inet static
<para os="ubuntu;debian;fedora;rhel;centos">Use the <para os="ubuntu;debian;fedora;rhel;centos">Use the
<command>hostname</command> command to set the host name: <command>hostname</command> command to set the host name:
<screen><prompt>#</prompt> <userinput>hostname controller</userinput></screen></para> <screen><prompt>#</prompt> <userinput>hostname controller</userinput></screen></para>
<para os="opensuse">Use <command>yast network</command> to set the <para os="opensuse;sles">Use <command>yast network</command> to set the
host name with YaST.</para> host name with YaST.</para>
<para os="rhel;fedora;centos">To have the host name change persist <para os="rhel;fedora;centos">To have the host name change persist
when the system reboots, you need to specify it in the proper when the system reboots, you need to specify it in the proper
@ -216,16 +215,14 @@ iface eth1 inet static
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ntp</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ntp</userinput></screen>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install ntp</userinput></screen> <screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install ntp</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install ntp</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install ntp</userinput></screen>
<para os="rhel;fedora;centos;opensuse">Set up the NTP server on your <para os="rhel;fedora;centos;opensuse;sles">Set up the NTP server on your
controller node so that it receives data by modifying the <filename>ntp.conf</filename> controller node so that it receives data by modifying the <filename>ntp.conf</filename>
file and restarting the service.</para> file and restarting the service.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service ntpd start</userinput> <screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service ntpd start</userinput>
<prompt>#</prompt> <userinput>chkconfig ntpd on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig ntpd on</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start ntp.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable ntp.service</userinput></screen>
<para>Set up all additional nodes to synchronize their time from the <para>Set up all additional nodes to synchronize their time from the
controller node. The simplest way to do this is to add a daily cron job. controller node. The simplest way to do this is to add a daily cron job.
@ -286,12 +283,10 @@ hwclock -w</programlisting>
<phrase os="opensuse">MariaDB</phrase> <phrase os="opensuse">MariaDB</phrase>
database server and set it to start automatically when database server and set it to start automatically when
the system boots.</para> the system boots.</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>service mysqld start</userinput> <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service mysqld start</userinput>
<prompt>#</prompt> <userinput>chkconfig mysqld on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig mysqld on</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl enable mysql.service</userinput>
<prompt>#</prompt> <userinput>systemctl start mysql.service</userinput></screen>
<para os="rhel;centos;fedora;opensuse">Finally, you should set a root password for your <para os="rhel;centos;fedora;opensuse;sles">Finally, you should set a root password for your
<phrase os="rhel;fedora;centos">MySQL</phrase> <phrase os="rhel;fedora;centos">MySQL</phrase>
<phrase os="opensuse">MariaDB</phrase> <phrase os="opensuse">MariaDB</phrase>
database. The OpenStack programs that set up databases and tables will database. The OpenStack programs that set up databases and tables will
@ -318,13 +313,13 @@ hwclock -w</programlisting>
<section xml:id="basics-queue"> <section xml:id="basics-queue">
<title>Messaging Server</title> <title>Messaging Server</title>
<para>On the controller node, install the messaging queue server. Typically this is <phrase <para>On the controller node, install the messaging queue server. Typically this is <phrase
os="ubuntu;opensuse">RabbitMQ</phrase><phrase os="centos;rhel;fedora" os="ubuntu;opensuse;sles">RabbitMQ</phrase><phrase os="centos;rhel;fedora"
>Qpid</phrase> but <phrase os="ubuntu;opensuse">Qpid</phrase><phrase >Qpid</phrase> but <phrase os="ubuntu;opensuse;sles">Qpid</phrase><phrase
os="centos;rhel;fedora">RabbitMQ</phrase> and ZeroMQ (0MQ) are also os="centos;rhel;fedora">RabbitMQ</phrase> and ZeroMQ (0MQ) are also
available.</para> available.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install rabbitmq-server</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install rabbitmq-server</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install rabbitmq-server</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install rabbitmq-server</userinput></screen>
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install qpid-cpp-server memcached</userinput></screen> <screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install qpid-cpp-server memcached</userinput></screen>
<note os="ubuntu;debian"> <note os="ubuntu;debian">
@ -345,9 +340,9 @@ hwclock -w</programlisting>
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>service qpidd start</userinput> <screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>service qpidd start</userinput>
<prompt>#</prompt> <userinput>chkconfig qpidd on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig qpidd on</userinput></screen>
<para os="opensuse">Start the messaging service and set it to start automatically when the system boots:</para> <para os="opensuse;sles">Start the messaging service and set it to start automatically when the system boots:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start rabbitmq-server.service</userinput> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>service rabbitmq-server start</userinput>
<prompt>#</prompt> <userinput>systemctl enable rabbitmq-server.service</userinput></screen> <prompt>#</prompt> <userinput>service rabbitmq-server enable</userinput></screen>
</section> </section>
<section xml:id="basics-packages"> <section xml:id="basics-packages">

12
doc/install-guide/object-storage/section_object-storage-install-config-proxy-node.xml
View File

@ -13,11 +13,11 @@
<para>Swift processes run under a separate user and group, set <para>Swift processes run under a separate user and group, set
by configuration options, and referred to as <phrase by configuration options, and referred to as <phrase
os="ubuntu;debian;rhel;centos;fedora">swift:swift</phrase><phrase os="ubuntu;debian;rhel;centos;fedora">swift:swift</phrase><phrase
os="opensuse">openstack-swift:openstack-swift</phrase>. The os="opensuse;sles">openstack-swift:openstack-swift</phrase>. The
default user is <phrase default user is <phrase
os="ubuntu;debian;rhel;centos;fedora">swift, which may not os="ubuntu;debian;rhel;centos;fedora">swift, which may not
exist on your system.</phrase><phrase exist on your system.</phrase><phrase
os="opensuse">openstack-swift.</phrase> os="opensuse;sles">openstack-swift.</phrase>
</para> </para>
</note> </note>
<orderedlist> <orderedlist>
@ -25,7 +25,7 @@
<para>Install swift-proxy service:</para> <para>Install swift-proxy service:</para>
<para><screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install swift-proxy memcached python-keystoneclient python-swiftclient python-webob</userinput></screen> <para><screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install swift-proxy memcached python-keystoneclient python-swiftclient python-webob</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift-proxy memcached openstack-utils python-swiftclient python-keystone-auth-token</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift-proxy memcached openstack-utils python-swiftclient python-keystone-auth-token</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-swift-proxy memcached openstack-utils python-swiftclient python-keystoneclient</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-swift-proxy memcached openstack-utils python-swiftclient python-keystoneclient</userinput></screen>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
@ -62,7 +62,7 @@ to
<para>Create <filename>/etc/swift/proxy-server.conf</filename>:</para> <para>Create <filename>/etc/swift/proxy-server.conf</filename>:</para>
<para> <para>
<literallayout os="rhel;centos;fedora;ubuntu;debian" class="monospaced"><xi:include parse="text" href="../samples/proxy-server.conf.txt" /></literallayout> <literallayout os="rhel;centos;fedora;ubuntu;debian" class="monospaced"><xi:include parse="text" href="../samples/proxy-server.conf.txt" /></literallayout>
<literallayout os="opensuse" class="monospaced"><xi:include parse="text" href="../samples/proxy-server.conf.txt-openSUSE" /></literallayout> <literallayout os="opensuse;sles" class="monospaced"><xi:include parse="text" href="../samples/proxy-server.conf.txt-openSUSE" /></literallayout>
</para> </para>
<note> <note>
<para>If you run multiple memcache servers, put the multiple <para>If you run multiple memcache servers, put the multiple
@ -77,7 +77,7 @@ to
>signing_dir</parameter> and set its permissions >signing_dir</parameter> and set its permissions
accordingly.<screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>mkdir -p /home/swift/keystone-signing</userinput> accordingly.<screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>mkdir -p /home/swift/keystone-signing</userinput>
<prompt>#</prompt> <userinput>chown -R swift:swift /home/swift/keystone-signing</userinput></screen> <prompt>#</prompt> <userinput>chown -R swift:swift /home/swift/keystone-signing</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>mkdir -p /home/swift/keystone-signing</userinput> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>mkdir -p /home/swift/keystone-signing</userinput>
<prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /home/swift/keystone-signing</userinput></screen> <prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /home/swift/keystone-signing</userinput></screen>
</para> </para>
</listitem> </listitem>
@ -158,7 +158,7 @@ to
user:</para> user:</para>
<para> <para>
<screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>chown -R swift:swift /etc/swift</userinput></screen> <screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>chown -R swift:swift /etc/swift</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /etc/swift</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /etc/swift</userinput></screen>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>

8
doc/install-guide/object-storage/section_object-storage-install-config-storage-nodes.xml
View File

@ -19,7 +19,7 @@
<para> <para>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install swift-account swift-container swift-object xfsprogs</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install swift-account swift-container swift-object xfsprogs</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift-account openstack-swift-container openstack-swift-object xfsprogs</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift-account openstack-swift-container openstack-swift-object xfsprogs</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-swift-account openstack-swift-container openstack-swift-object xfsprogs</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-swift-account openstack-swift-container openstack-swift-object xfsprogs</userinput></screen>
</para> </para>
</step> </step>
<step> <step>
@ -36,7 +36,7 @@
<prompt>#</prompt> <userinput>mkdir -p /srv/node/sdb1</userinput> <prompt>#</prompt> <userinput>mkdir -p /srv/node/sdb1</userinput>
<prompt>#</prompt> <userinput>mount /srv/node/sdb1</userinput> <prompt>#</prompt> <userinput>mount /srv/node/sdb1</userinput>
<prompt>#</prompt> <userinput>chown -R swift:swift /srv/node</userinput></screen> <prompt>#</prompt> <userinput>chown -R swift:swift /srv/node</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>fdisk /dev/sdb</userinput> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>fdisk /dev/sdb</userinput>
<prompt>#</prompt> <userinput>mkfs.xfs /dev/sdb1</userinput> <prompt>#</prompt> <userinput>mkfs.xfs /dev/sdb1</userinput>
<prompt>#</prompt> <userinput>echo "/dev/sdb1 /srv/node/sdb1 xfs noatime,nodiratime,nobarrier,logbufs=8 0 0" &gt;&gt; /etc/fstab</userinput> <prompt>#</prompt> <userinput>echo "/dev/sdb1 /srv/node/sdb1 xfs noatime,nodiratime,nobarrier,logbufs=8 0 0" &gt;&gt; /etc/fstab</userinput>
<prompt>#</prompt> <userinput>mkdir -p /srv/node/sdb1</userinput> <prompt>#</prompt> <userinput>mkdir -p /srv/node/sdb1</userinput>
@ -70,7 +70,7 @@ max connections = 2
path = /srv/node/ path = /srv/node/
read only = false read only = false
lock file = /var/lock/object.lock</programlisting> lock file = /var/lock/object.lock</programlisting>
<programlisting language="ini" os="opensuse">uid = openstack-swift <programlisting language="ini" os="opensuse;sles">uid = openstack-swift
gid = openstack-swift gid = openstack-swift
log file = /var/log/rsyncd.log log file = /var/log/rsyncd.log
pid file = /var/run/rsyncd.pid pid file = /var/run/rsyncd.pid
@ -125,7 +125,7 @@ address = &lt;STORAGE_REPLICATION_NET_IP&gt;
<para>Create the swift recon cache directory and set its <para>Create the swift recon cache directory and set its
permissions.<screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>mkdir -p /var/swift/recon</userinput> permissions.<screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>mkdir -p /var/swift/recon</userinput>
<prompt>#</prompt> <userinput>chown -R swift:swift /var/swift/recon</userinput></screen> <prompt>#</prompt> <userinput>chown -R swift:swift /var/swift/recon</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>mkdir -p /var/swift/recon</userinput> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>mkdir -p /var/swift/recon</userinput>
<prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /var/swift/recon</userinput></screen> <prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /var/swift/recon</userinput></screen>
</para> </para>
</step> </step>

4
doc/install-guide/object-storage/section_object-storage-install.xml
View File

@ -47,14 +47,14 @@
<para>Install core Swift files and openSSH.</para> <para>Install core Swift files and openSSH.</para>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install swift openssh-server rsync memcached python-netifaces python-xattr python-memcache</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install swift openssh-server rsync memcached python-netifaces python-xattr python-memcache</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift openstack-swift-proxy openstack-swift-account openstack-swift-container openstack-swift-object memcached</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift openstack-swift-proxy openstack-swift-account openstack-swift-container openstack-swift-object memcached</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-swift openstack-swift-proxy openstack-swift-account openstack-swift-container openstack-swift-object memcached</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-swift openstack-swift-proxy openstack-swift-account openstack-swift-container openstack-swift-object memcached</userinput></screen>
</step> </step>
<step> <step>
<para>Create and populate configuration directories on all nodes:</para> <para>Create and populate configuration directories on all nodes:</para>
<para> <para>
<screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>mkdir -p /etc/swift</userinput> <screen os="ubuntu;debian;rhel;centos;fedora"><prompt>#</prompt> <userinput>mkdir -p /etc/swift</userinput>
<prompt>#</prompt> <userinput>chown -R swift:swift /etc/swift/</userinput></screen> <prompt>#</prompt> <userinput>chown -R swift:swift /etc/swift/</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>mkdir -p /etc/swift</userinput> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>mkdir -p /etc/swift</userinput>
<prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /etc/swift/</userinput></screen> <prompt>#</prompt> <userinput>chown -R openstack-swift:openstack-swift /etc/swift/</userinput></screen>
</para> </para>
</step> </step>

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

@ -20,12 +20,10 @@
<screen><prompt>#</prompt> <userinput>service cinder-volume restart</userinput> <screen><prompt>#</prompt> <userinput>service cinder-volume restart</userinput>
<prompt>#</prompt> <userinput>service cinder-api restart</userinput></screen> <prompt>#</prompt> <userinput>service cinder-api restart</userinput></screen>
</step> </step>
<step os="rhel;fedora;centos;opensuse"><para>We now restart the Block Storage service with its new <step os="rhel;fedora;centos;opensuse;sles"><para>We now restart the Block Storage service with its new
settings.</para> settings.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput> <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput>
<prompt>#</prompt> <userinput>service openstack-cinder-agent-central restart</userinput></screen> <prompt>#</prompt> <userinput>service openstack-cinder-agent-central restart</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-cinder-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl restart openstack-cinder-volume.service</userinput></screen>
</step> </step>
</procedure> </procedure>

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

@ -21,13 +21,11 @@
<prompt>#</prompt> <userinput>service glance-api restart</userinput></screen> <prompt>#</prompt> <userinput>service glance-api restart</userinput></screen>
</step> </step>
<step os="rhel;fedora;centos;opensuse"><para>Restart the <systemitem <step os="rhel;fedora;centos;opensuse;sles"><para>Restart the <systemitem
class="service">glance-api</systemitem> and <systemitem class="service">glance-api</systemitem> and <systemitem
class="service">glance-registry</systemitem> services.</para> class="service">glance-registry</systemitem> services.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-glance-api restart</userinput> <screen os="rhel;fedora;centos;opensuse;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>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-glance-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl restart openstack-glance-registry.service</userinput></screen>
</step> </step>
</procedure> </procedure>
</section> </section>

22
doc/install-guide/section_ceilometer-install.xml
View File

@ -14,7 +14,7 @@
<para>Install the Metering Service on the controller node:</para> <para>Install the Metering Service on the controller node:</para>
<screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install ceilometer-api ceilometer-collector ceilometer-agent-central python-ceilometerclient</userinput></screen> <screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install ceilometer-api ceilometer-collector ceilometer-agent-central python-ceilometerclient</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-api openstack-ceilometer-collector openstack-ceilometer-agent-central python-ceilometerclient FIXME</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-api openstack-ceilometer-collector openstack-ceilometer-agent-central python-ceilometerclient FIXME</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-api openstack-ceilometer-collector openstack-ceilometer-agent-central python-ceilometerclient</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-api openstack-ceilometer-collector openstack-ceilometer-agent-central python-ceilometerclient</userinput></screen>
</step> </step>
<step> <step>
@ -22,7 +22,7 @@
Specify the location of the database in the configuration file. Specify the location of the database in the configuration file.
In this guide, we use a MongoDB database on the controller node.</para> In this guide, we use a MongoDB database on the controller node.</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>FIXME</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>FIXME</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install mongodb</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mongodb</userinput></screen>
<screen os="ubuntu;debian"> <screen os="ubuntu;debian">
<prompt>#</prompt> <userinput>apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10</userinput></screen> <prompt>#</prompt> <userinput>apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10</userinput></screen>
@ -35,7 +35,7 @@
<prompt>#</prompt> <userinput>apt-get update</userinput> <prompt>#</prompt> <userinput>apt-get update</userinput>
<prompt>#</prompt> <userinput>apt-get install mongodb-10gen</userinput></screen> <prompt>#</prompt> <userinput>apt-get install mongodb-10gen</userinput></screen>
</step> </step>
<step os="opensuse"> <step os="opensuse;sles">
<para>Start the MonoDB server and configure it to start when the system boots:</para> <para>Start the MonoDB server and configure it to start when the system boots:</para>
<screen><prompt>#</prompt> <userinput>systemctl start mongodb.service</userinput> <screen><prompt>#</prompt> <userinput>systemctl start mongodb.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable mongodb.service</userinput></screen> <prompt>#</prompt> <userinput>systemctl enable mongodb.service</userinput></screen>
@ -53,7 +53,7 @@
<step><para>Tell the Metering Service to use the created database.</para> <step><para>Tell the Metering Service to use the created database.</para>
<screen os="rhel;centos;fedora;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \ <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \
database connection mongodb://ceilometer:<replaceable>CEILOMETER_DBPASS</replaceable>@<replaceable>controller</replaceable>:27017/ceilometer</userinput></screen> database connection mongodb://ceilometer:<replaceable>CEILOMETER_DBPASS</replaceable>@<replaceable>controller</replaceable>:27017/ceilometer</userinput></screen>
<para os="ubuntu;debian">Edit <filename>/etc/ceilometer/ceilometer.conf</filename> <para os="ubuntu;debian">Edit <filename>/etc/ceilometer/ceilometer.conf</filename>
and change the <literal>[database]</literal> section.</para> and change the <literal>[database]</literal> section.</para>
@ -74,7 +74,7 @@ connection = mongodb://ceilometer:<replaceable>CEILOMETER_DBPASS</replaceable>@<
shared secret between the Metering Service nodes. shared secret between the Metering Service nodes.
Use <command>openssl</command> to generate a random token, then store it Use <command>openssl</command> to generate a random token, then store it
in the configuration file.</para> in the configuration file.</para>
<screen os="rhel;centos;fedora;opensuse"><prompt>#</prompt> <userinput>ADMIN_TOKEN=$(openssl rand -hex 10)</userinput> <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>ADMIN_TOKEN=$(openssl rand -hex 10)</userinput>
<prompt>#</prompt> <userinput>echo $ADMIN_TOKEN</userinput> <prompt>#</prompt> <userinput>echo $ADMIN_TOKEN</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf publisher_rpc metering_secret $ADMIN_TOKEN</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf publisher_rpc metering_secret $ADMIN_TOKEN</userinput></screen>
<screen os="ubuntu"><prompt>#</prompt> <userinput>openssl rand -hex 10</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>openssl rand -hex 10</userinput></screen>
@ -102,7 +102,7 @@ metering_secret = ADMIN_TOKEN
<step><para>Add the credentials to the Metering Service's configuration files.</para> <step><para>Add the credentials to the Metering Service's configuration files.</para>
<screen os="centos;rhel;fedora;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken auth_host <replaceable>controller</replaceable></userinput> <screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken auth_host <replaceable>controller</replaceable></userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken admin_user ceilometer</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken admin_user ceilometer</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken admin_tenant_name service</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken admin_tenant_name service</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken auth_protocol http</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf keystone_authtoken auth_protocol http</userinput>
@ -144,24 +144,18 @@ admin_password = CEILOMETER_PASS
<prompt>#</prompt> <userinput>service ceilometer-collector restart</userinput></screen> <prompt>#</prompt> <userinput>service ceilometer-collector restart</userinput></screen>
</step> </step>
<step os="rhel;fedora;centos;opensuse"><para>Start the <systemitem <step os="rhel;fedora;centos;opensuse;sles"><para>Start the <systemitem
class="service">ceilometer-api</systemitem>, <systemitem class="service">ceilometer-api</systemitem>, <systemitem
class="service">ceilometer-agent-central</systemitem> and class="service">ceilometer-agent-central</systemitem> and
<systemitem class="service">ceilometer-collector</systemitem> <systemitem class="service">ceilometer-collector</systemitem>
services and configure them to start when the system services and configure them to start when the system
boots.</para> boots.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-ceilometer-api start</userinput> <screen os="rhel;fedora;centos;sles"><prompt>#</prompt> <userinput>service openstack-ceilometer-api start</userinput>
<prompt>#</prompt> <userinput>service openstack-ceilometer-agent-central start</userinput> <prompt>#</prompt> <userinput>service openstack-ceilometer-agent-central start</userinput>
<prompt>#</prompt> <userinput>service openstack-ceilometer-collector start</userinput> <prompt>#</prompt> <userinput>service openstack-ceilometer-collector start</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-api on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-api on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-agent-central on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-agent-central on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-collector on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-collector on</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-agent-central.service</userinput>
<prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-collector.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-agent-central.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-collector.service</userinput></screen>
</step> </step>
</procedure> </procedure>

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

@ -13,12 +13,12 @@
<para>Install the Metering service on the controller node:</para> <para>Install the Metering service on the controller node:</para>
<screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install ceilometer-agent-compute</userinput></screen> <screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install ceilometer-agent-compute</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-agent-compute FIXME</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-agent-compute FIXME</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-agent-compute</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-agent-compute</userinput></screen>
</step> </step>
<step><para>Set the following options in <step><para>Set the following options in
<filename>/etc/nova/nova.conf</filename>.</para> <filename>/etc/nova/nova.conf</filename>.</para>
<screen os="fedora;rhel;centos;opensuse"> <screen os="fedora;rhel;centos;opensuse;sles">
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT instance_usage_audit True</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT instance_usage_audit True</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT instance_usage_audit Hhour</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT instance_usage_audit Hhour</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT notify_on_state_change vm_and_task_state</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT notify_on_state_change vm_and_task_state</userinput>
@ -61,12 +61,10 @@ metering_secret = ADMIN_TOKEN
</step> </step>
<step os="rhel;fedora;centos;opensuse"><para>Start the <literal>ceilometer-agent-compute</literal> service and configure <step os="rhel;fedora;centos;opensuse;sles"><para>Start the <literal>ceilometer-agent-compute</literal> service and configure
to start when the system boots.</para> to start when the system boots.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-ceilometer-agent-compute start</userinput> <screen os="rhel;fedora;centos;opensuse;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="opensuse"><prompt>#</prompt> <userinput>systemctl start openstack-ceilometer-agent-compute.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-ceilometer-agent-compute.service</userinput></screen>
</step> </step>
</procedure> </procedure>

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

@ -39,9 +39,8 @@ use = egg:ceilometer#swift</programlisting>Next,
<para>We now restart the service with its new settings.</para> <para>We now restart the service with its new settings.</para>
<screen><prompt>#</prompt> <userinput>service swift-proxy-server restart</userinput></screen> <screen><prompt>#</prompt> <userinput>service swift-proxy-server restart</userinput></screen>
</step> </step>
<step os="rhel;fedora;centos;opensuse"><para>We now restart the service with its new settings.</para> <step os="rhel;fedora;centos;opensuse;sles"><para>We now restart the service with its new settings.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-swift-proxy-server restart</userinput></screen> <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-swift-proxy-server restart</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy-server.service</userinput></screen>
</step> </step>
</procedure> </procedure>
</section> </section>

2
doc/install-guide/section_compute-cloud-controller.xml
View File

@ -21,5 +21,5 @@
<screen><prompt>$</prompt> <userinput>sudo apt-get install ubuntu-cloud-keyring</userinput></screen> <screen><prompt>$</prompt> <userinput>sudo apt-get install ubuntu-cloud-keyring</userinput></screen>
</para> </para>
<screen os="centos;rhel;fedora"><prompt>$</prompt> <userinput>sudo yum install openstack-nova</userinput></screen> <screen os="centos;rhel;fedora"><prompt>$</prompt> <userinput>sudo yum install openstack-nova</userinput></screen>
<screen os="opensuse"><prompt>$</prompt> <userinput>sudo zypper install openstack-nova</userinput></screen> <screen os="opensuse;sles"><prompt>$</prompt> <userinput>sudo zypper install openstack-nova</userinput></screen>
</section> </section>

26
doc/install-guide/section_dashboard-install.xml
View File

@ -29,7 +29,7 @@
the Identity Service as root:</para> the Identity Service as root:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install memcached libapache2-mod-wsgi openstack-dashboard</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install memcached libapache2-mod-wsgi openstack-dashboard</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install memcached python-memcached mod_wsgi openstack-dashboard</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install memcached python-memcached mod_wsgi openstack-dashboard</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install memcached python-python-memcached apache2-mod_wsgi openstack-dashboard</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install memcached python-python-memcached apache2-mod_wsgi openstack-dashboard</userinput></screen>
<note os="ubuntu"> <note os="ubuntu">
<para>Remove the <para>Remove the
@ -47,11 +47,11 @@
>/etc/openstack-dashboard/local_settings.py</filename><filename >/etc/openstack-dashboard/local_settings.py</filename><filename
os="centos;fedora;rhel" os="centos;fedora;rhel"
>/etc/openstack-dashboard/local_settings</filename><filename >/etc/openstack-dashboard/local_settings</filename><filename
os="opensuse" os="opensuse;sles"
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename> >/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
to match the ones set in <filename os="ubuntu;debian" to match the ones set in <filename os="ubuntu;debian"
>/etc/memcached.conf</filename><filename >/etc/memcached.conf</filename><filename
os="centos;fedora;rhel;opensuse" os="centos;fedora;rhel;opensuse;sles"
>/etc/sysconfig/memcached.conf</filename>.</para> >/etc/sysconfig/memcached.conf</filename>.</para>
<para>Open <filename os="ubuntu;debian" <para>Open <filename os="ubuntu;debian"
>/etc/openstack-dashboard/local_settings.py</filename> >/etc/openstack-dashboard/local_settings.py</filename>
@ -72,7 +72,7 @@
<para>The address and port must match the ones <para>The address and port must match the ones
set in <filename os="ubuntu;debian" set in <filename os="ubuntu;debian"
>/etc/memcached.conf</filename><filename >/etc/memcached.conf</filename><filename
os="centos;fedora;rhel;opensuse" os="centos;fedora;rhel;opensuse;sles"
>/etc/sysconfig/memcached</filename>.</para> >/etc/sysconfig/memcached</filename>.</para>
<para>If you change the memcached settings, <para>If you change the memcached settings,
you must restart the Apache web server for you must restart the Apache web server for
@ -92,7 +92,7 @@
>/etc/openstack-dashboard/local_settings</filename><filename >/etc/openstack-dashboard/local_settings</filename><filename
os="ubuntu;debian" os="ubuntu;debian"
>/etc/openstack-dashboard/local_settings.py</filename><filename >/etc/openstack-dashboard/local_settings.py</filename><filename
os="opensuse" os="opensuse;sles"
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename> >/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
file.</para> file.</para>
<para>Change the following parameter: <para>Change the following parameter:
@ -111,20 +111,20 @@
>/etc/openstack-dashboard/local_settings</filename><filename >/etc/openstack-dashboard/local_settings</filename><filename
os="ubuntu;debian" os="ubuntu;debian"
>/etc/openstack-dashboard/local_settings.py</filename><filename >/etc/openstack-dashboard/local_settings.py</filename><filename
os="opensuse" os="opensuse;sles"
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename> >/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
and change <literal>OPENSTACK_HOST</literal> to the hostname of your Identity Service.</para> and change <literal>OPENSTACK_HOST</literal> to the hostname of your Identity Service.</para>
<programlisting language="python" linenumbering="unnumbered"><?db-font-size 75%?>OPENSTACK_HOST = "controller" <programlisting language="python" linenumbering="unnumbered"><?db-font-size 75%?>OPENSTACK_HOST = "controller"
</programlisting> </programlisting>
</step> </step>
<step os="opensuse"> <step os="opensuse;sles">
<para>Setup Apache configuration: <para>Setup Apache configuration:
<screen><prompt>#</prompt> <userinput>cp /etc/apache2/conf.d/openstack-dashboard.conf.sample \ <screen><prompt>#</prompt> <userinput>cp /etc/apache2/conf.d/openstack-dashboard.conf.sample \
/etc/apache2/conf.d/openstack-dashboard.conf</userinput> /etc/apache2/conf.d/openstack-dashboard.conf</userinput>
<prompt>#</prompt> <userinput>a2enmod rewrite;a2enmod ssl;a2enmod wsgi</userinput></screen> <prompt>#</prompt> <userinput>a2enmod rewrite;a2enmod ssl;a2enmod wsgi</userinput></screen>
</para> </para>
</step> </step>
<step os="opensuse"> <step os="opensuse;sles">
<para>By default, the <para>By default, the
<systemitem>openstack-dashboard</systemitem> package enables <systemitem>openstack-dashboard</systemitem> package enables
a database as session store. Before you continue, either a database as session store. Before you continue, either
@ -134,17 +134,19 @@
linkend="dashboard-session-database"/>. linkend="dashboard-session-database"/>.
</para> </para>
</step> </step>
<step os="opensuse"> <step os="opensuse;sles">
<para> <para>
Start the Apache web server and memcached: Start the Apache web server and memcached:
</para> </para>
<screen><prompt>#</prompt> <userinput>systemctl start apache2.service memcached.service</userinput> <screen><prompt>#</prompt> <userinput>service apache2 start</userinput>
<prompt>#</prompt> <userinput>systemctl enable apache2.service memcached.service</userinput></screen> <prompt>#</prompt> <userinput>service memcached start</userinput>
<prompt>#</prompt> <userinput>chckconfig apache2 on</userinput>
<prompt>#</prompt> <userinput>chckconfig memcached on</userinput></screen>
</step> </step>
<step> <step>
<para>You can now access the dashboard at <para>You can now access the dashboard at
<uri os="centos;fedora;rhel;debian;ubuntu">http://controller/horizon</uri> <uri os="centos;fedora;rhel;debian;ubuntu">http://controller/horizon</uri>
<uri os="opensuse">http://controller</uri>.</para> <uri os="opensuse;sles">http://controller</uri>.</para>
<para>Login with credentials for any user that you created <para>Login with credentials for any user that you created
with the OpenStack Identity Service.</para> with the OpenStack Identity Service.</para>
</step> </step>

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

@ -22,9 +22,9 @@
<step><para>Install the Image Service on the controller node.</para> <step><para>Install the Image Service on the controller node.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install glance</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install glance</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-glance</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-glance</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-glance python-glanceclient</userinput></screen></step> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-glance python-glanceclient</userinput></screen></step>
<step os="rhel;centos;fedora;opensuse"><para>The Image Service stores information about images in a database. <step os="rhel;centos;fedora;opensuse;sles"><para>The Image Service stores information about images in a database.
This guide uses the MySQL database used by other OpenStack services.</para> This guide uses the MySQL database used by other OpenStack services.</para>
<para>Use the <command>openstack-db</command> command to create the <para>Use the <command>openstack-db</command> command to create the
database and tables for the Image Service, as well as a database user database and tables for the Image Service, as well as a database user
@ -54,7 +54,7 @@ IDENTIFIED BY '<replaceable>GLANCE_DBPASS</replaceable>';</userinput></screen>
services: <literal>glance-api</literal> and <literal>glance-registry</literal>. They each services: <literal>glance-api</literal> and <literal>glance-registry</literal>. They each
have separate configuration files, so you must configure both files throughout this have separate configuration files, so you must configure both files throughout this
section.</para> section.</para>
<screen os="rhel;centos;fedora;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf \ <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf \
DEFAULT sql_connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput> DEFAULT sql_connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf \ <prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf \
DEFAULT sql_connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput></screen> DEFAULT sql_connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput></screen>
@ -87,7 +87,7 @@ sql_connection = mysql://glance:GLANCE_DBPASS@localhost/glance
<prompt>#</prompt> <userinput>keystone user-role-add --user=glance --tenant=service --role=admin</userinput></screen></step> <prompt>#</prompt> <userinput>keystone user-role-add --user=glance --tenant=service --role=admin</userinput></screen></step>
<step><para>Add the credentials to the Image Service's configuration files.</para> <step><para>Add the credentials to the Image Service's configuration files.</para>
<screen os="centos;rhel;fedora;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken auth_host <replaceable>controller</replaceable></userinput> <screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken auth_host <replaceable>controller</replaceable></userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_user glance</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_user glance</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_tenant_name service</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_tenant_name service</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_password <replaceable>GLANCE_DBPASS</replaceable></userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_password <replaceable>GLANCE_DBPASS</replaceable></userinput>
@ -146,16 +146,13 @@ admin_password=<replaceable>GLANCE_DBPASS</replaceable></programlisting> -->
<step os="rhel;fedora;centos;opensuse"><para>Start the <literal>glance-api</literal> and <step os="rhel;fedora;centos;opensuse;sles"><para>Start the <literal>glance-api</literal> and
<literal>glance-registry</literal> services and configure them to <literal>glance-registry</literal> services and configure them to
start when the system boots.</para> start when the system boots.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-glance-api start</userinput> <screen os="rhel;fedora;centos;opensuse;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>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start openstack-glance-api.service</userinput> </step>
<prompt>#</prompt> <userinput>systemctl start openstack-glance-registry.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-glance-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-glance-registry.service</userinput></screen></step>
</procedure> </procedure>
</section> </section>

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

@ -9,7 +9,7 @@
<para>Install the Orchestration Service on the controller node:</para> <para>Install the Orchestration Service on the controller node:</para>
<screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install heat-api heat-api-cfn</userinput></screen> <screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install heat-api heat-api-cfn</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-heat-api FIXME</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-heat-api FIXME</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-heat-api openstack-heat-api-cfn</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-heat-api openstack-heat-api-cfn</userinput></screen>
</step> </step>
<step> <step>
@ -19,7 +19,7 @@
with the username <literal>heat</literal>. Replace with the username <literal>heat</literal>. Replace
<literal><replaceable>HEAT_DBPASS</replaceable></literal> <literal><replaceable>HEAT_DBPASS</replaceable></literal>
with a suitable password for the database user.</para> with a suitable password for the database user.</para>
<screen os="rhel;centos;fedora;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/heat/heat.conf \ <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/heat/heat.conf \
database connection mysql://heat:<replaceable>HEAT_DBPASS</replaceable>@controller/heat</userinput></screen> database connection mysql://heat:<replaceable>HEAT_DBPASS</replaceable>@controller/heat</userinput></screen>
<para os="ubuntu">Edit <filename>/etc/heat/heat.conf</filename> and change the <literal>[DEFAULT]</literal> section.</para> <para os="ubuntu">Edit <filename>/etc/heat/heat.conf</filename> and change the <literal>[DEFAULT]</literal> section.</para>
<programlisting os="ubuntu" language="ini"> <programlisting os="ubuntu" language="ini">
@ -103,18 +103,13 @@ admin_password = HEAT_PASS
</step> </step>
<step os="rhel;fedora;centos;opensuse"><para>Start the <literal>heat-api</literal> and <step os="rhel;fedora;centos;opensuse;sles"><para>Start the <literal>heat-api</literal> and
<literal>heat-api-cfn</literal> services and configure them to <literal>heat-api-cfn</literal> services and configure them to
start when the system boots.</para> start when the system boots.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-heat-api start</userinput> <screen os="rhel;fedora;centos;opensuse;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>
<prompt>#</prompt> <userinput>chkconfig openstack-heat-api on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-heat-api on</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-heat-api-cfn on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-heat-api-cfn on</userinput></screen>
<screen os="opensuse"><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 enable openstack-heat-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-heat-api-cfn.service</userinput></screen>
</step> </step>
</procedure> </procedure>

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

@ -9,7 +9,7 @@
<para>Install the Identity Service on the controller node:</para> <para>Install the Identity Service on the controller node:</para>
<screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install keystone python-keystone python-keystoneclient</userinput></screen> <screen os="ubuntu;deb"><prompt>#</prompt> <userinput>apt-get install keystone python-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"><prompt>#</prompt> <userinput>zypper install openstack-keystone python-keystoneclient openstack-utils</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-keystone python-keystoneclient openstack-utils</userinput></screen>
</step> </step>
<step> <step>
@ -19,7 +19,7 @@
with the username <literal>keystone</literal>. Replace with the username <literal>keystone</literal>. Replace
<literal><replaceable>KEYSTONE_DBPASS</replaceable></literal> <literal><replaceable>KEYSTONE_DBPASS</replaceable></literal>
with a suitable password for the database user.</para> with a suitable password for the database user.</para>
<screen os="rhel;centos;fedora;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf \ <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf \
sql connection mysql://keystone:<replaceable>KEYSTONE_DBPASS</replaceable>@controller/keystone</userinput></screen> sql connection mysql://keystone:<replaceable>KEYSTONE_DBPASS</replaceable>@controller/keystone</userinput></screen>
<para os="ubuntu">Edit <filename>/etc/keystone/keystone.conf</filename> and change the <literal>[sql]</literal> section.</para> <para os="ubuntu">Edit <filename>/etc/keystone/keystone.conf</filename> and change the <literal>[sql]</literal> section.</para>
<programlisting os="ubuntu" language="ini"> <programlisting os="ubuntu" language="ini">
@ -31,7 +31,7 @@ connection = mysql://keystone:KEYSTONE_DBPASS@controller/keystone
</programlisting> </programlisting>
</step> </step>
<step os="rhel;centos;fedora;opensuse"> <step os="rhel;centos;fedora;opensuse;sles">
<para>Use the <command>openstack-db</command> command to create the <para>Use the <command>openstack-db</command> command to create the
database and tables, as well as a database user called database and tables, as well as a database user called
<literal>keystone</literal> to connect to the database. Replace <literal>keystone</literal> to connect to the database. Replace
@ -61,7 +61,7 @@ IDENTIFIED BY '<replaceable>KEYSTONE_DBPASS</replaceable>';</userinput></screen>
shared secret between the Identity Service and other OpenStack services. shared secret between the Identity Service and other OpenStack services.
Use <command>openssl</command> to generate a random token, then store it Use <command>openssl</command> to generate a random token, then store it
in the configuration file.</para> in the configuration file.</para>
<screen os="rhel;centos;fedora;opensuse"><prompt>#</prompt> <userinput>ADMIN_TOKEN=$(openssl rand -hex 10)</userinput> <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>ADMIN_TOKEN=$(openssl rand -hex 10)</userinput>
<prompt>#</prompt> <userinput>echo $ADMIN_TOKEN</userinput> <prompt>#</prompt> <userinput>echo $ADMIN_TOKEN</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf DEFAULT admin_token $ADMIN_TOKEN</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf DEFAULT admin_token $ADMIN_TOKEN</userinput></screen>
<screen os="ubuntu"><prompt>#</prompt> <userinput>openssl rand -hex 10</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>openssl rand -hex 10</userinput></screen>
@ -77,16 +77,16 @@ admin_token = ADMIN_TOKEN
</step> </step>
<step os="rhel;centos;fedora;opensuse"> <step os="rhel;centos;fedora;opensuse;sles">
<para>By default Keystone will use PKI tokens. Create the signing <para>By default Keystone will use PKI tokens. Create the signing
keys and certificates.</para> keys and certificates.</para>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>keystone-manage pki_setup --keystone-user keystone --keystone-group keystone</userinput> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>keystone-manage pki_setup --keystone-user keystone --keystone-group keystone</userinput>
<prompt>#</prompt> <userinput>chown -R keystone:keystone /etc/keystone/* /var/log/keystone/keystone.log</userinput></screen> <prompt>#</prompt> <userinput>chown -R keystone:keystone /etc/keystone/* /var/log/keystone/keystone.log</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>keystone-manage pki_setup --keystone-user openstack-keystone --keystone-group openstack-keystone</userinput> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>keystone-manage pki_setup --keystone-user openstack-keystone --keystone-group openstack-keystone</userinput>
<prompt>#</prompt> <userinput>chown -R openstack-keystone:openstack-keystone /etc/keystone/* /var/log/keystone/keystone.log</userinput></screen> <prompt>#</prompt> <userinput>chown -R openstack-keystone:openstack-keystone /etc/keystone/* /var/log/keystone/keystone.log</userinput></screen>
</step> </step>
<step os="opensuse"> <step os="opensuse;sles">
<para>Setup the <filename>/etc/keystone/default_catalog.templates</filename> file: <para>Setup the <filename>/etc/keystone/default_catalog.templates</filename> file:
</para> </para>
<screen><prompt>#</prompt> <userinput>KEYSTONE_CATALOG=/etc/keystone/default_catalog.templates</userinput> <screen><prompt>#</prompt> <userinput>KEYSTONE_CATALOG=/etc/keystone/default_catalog.templates</userinput>
@ -98,13 +98,11 @@ admin_token = ADMIN_TOKEN
<screen><prompt>#</prompt> <userinput>service keystone restart</userinput></screen> <screen><prompt>#</prompt> <userinput>service keystone restart</userinput></screen>
</step> </step>
<step os="rhel;fedora;centos;opensuse"> <step os="rhel;fedora;centos;opensuse;sles">
<para>Start the Identity Service and enable it so it start when <para>Start the Identity Service and enable it so it start when
the system boots.</para> the system boots.</para>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-keystone start</userinput> <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-keystone start</userinput>
<prompt>#</prompt> <userinput>chkconfig openstack-keystone on</userinput></screen> <prompt>#</prompt> <userinput>chkconfig openstack-keystone on</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start openstack-keystone.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-keystone.service</userinput></screen>
</step> </step>
</procedure> </procedure>

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

@ -48,18 +48,18 @@
packages for the compute service.</para> packages for the compute service.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-compute-kvm python-novaclient python-guestfs</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-compute-kvm python-novaclient python-guestfs</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-compute</userinput></screen> <screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-compute</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-nova-compute kvm openstack-utils</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-compute kvm openstack-utils</userinput></screen>
</step> </step>
<step os="ubuntu"> <step os="ubuntu">
<para>Due to <link xlink:href="https://bugs.launchpad.net/ubuntu/+source/linux/+bug/759725">a bug</link> <para>Due to <link xlink:href="https://bugs.launchpad.net/ubuntu/+source/linux/+bug/759725">a bug</link>
that Canonical "Won't Fix", guestfs is broken out of the box. that Canonical "Won't Fix", guestfs is broken out of the box.
Run the following command to fix it:</para> Run the following command to fix it:</para>
<screen><prompt>#</prompt> <userinput> chmod 0644 /boot/vmlinuz*</userinput></screen> <screen><prompt>#</prompt> <userinput>chmod 0644 /boot/vmlinuz*</userinput></screen>
</step> </step>
<step><para>Either copy the file <filename>/etc/nova/nova.conf</filename> from the <step><para>Either copy the file <filename>/etc/nova/nova.conf</filename> from the
<replaceable>controller</replaceable> node, or run the same configuration commands.</para> <replaceable>controller</replaceable> node, or run the same configuration commands.</para>
<screen os="fedora;rhel;centos;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \ <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \
database connection mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@controller/nova</userinput> database connection mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@controller/nova</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_host <replaceable>controller</replaceable></userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_host <replaceable>controller</replaceable></userinput>
@ -105,7 +105,7 @@ rabbit_host = controller</programlisting>
<literal>vncserver_listen</literal>, and <literal>vncserver_listen</literal>, and
<literal>vncserver_proxyclient_address</literal> to the IP address of the <literal>vncserver_proxyclient_address</literal> to the IP address of the
compute node on the internal network.</para> compute node on the internal network.</para>
<screen os="fedora;rhel;centos;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.11</userinput> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.11</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.11</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.11</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.11</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.11</userinput></screen>
<para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</para> <para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</para>
@ -117,7 +117,7 @@ vncserver_proxyclient_address=192.168.0.11</programlisting>
</step> </step>
<step><para>Specify the host running the Image Service.<phrase os="ubuntu;debian"> Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</phrase></para> <step><para>Specify the host running the Image Service.<phrase os="ubuntu;debian"> Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</phrase></para>
<screen os="fedora;rhel;centos;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT glance_host <replaceable>controller</replaceable></userinput></screen> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT glance_host <replaceable>controller</replaceable></userinput></screen>
<programlisting os="ubuntu;debian" language="ini">[DEFAULT] <programlisting os="ubuntu;debian" language="ini">[DEFAULT]
... ...
glance_host=<replaceable>controller</replaceable></programlisting> glance_host=<replaceable>controller</replaceable></programlisting>
@ -133,16 +133,15 @@ admin_user=nova
admin_tenant_name=service admin_tenant_name=service
admin_password=<replaceable>NOVA_DBPASS</replaceable> admin_password=<replaceable>NOVA_DBPASS</replaceable>
</programlisting> </programlisting>
<note os="fedora;rhel;centos;opensuse"><para>Ensure that <filename>api_paste_config=/etc/nova/api-paste.ini</filename> is set in <note os="fedora;rhel;centos;opensuse;sles"><para>Ensure that <filename>api_paste_config=/etc/nova/api-paste.ini</filename> is set in
<filename>/etc/nova/nova.conf</filename>.</para></note> <filename>/etc/nova/nova.conf</filename>.</para></note>
</step> </step>
<step> <step>
<para os="fedora;rhel;centos;opensuse">Start the Compute service and configure it to start when the system boots.</para> <para os="fedora;rhel;centos;opensuse;Sles">Start the Compute service and configure it to start when the system boots.</para>
<para os="ubuntu;debian">Restart the Compute service.</para> <para os="ubuntu;debian">Restart the Compute service.</para>
<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="centos;rhel;fedora"><prompt>#</prompt> <userinput>service openstack-nova-compute start</userinput> <screen os="centos;rhel;fedora;opensuse;sles"><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>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start openstack-nova-compute.service</userinput> </step>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-compute.service</userinput></screen></step>
</procedure> </procedure>
</section> </section>

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

@ -20,13 +20,14 @@
<screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>yum install openstack-nova python-novaclient</userinput></screen> <screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>yum install openstack-nova python-novaclient</userinput></screen>
<para os="ubuntu;debian;opensuse">Install the following Nova packages. These packages provide <para os="ubuntu;debian;opensuse;sles">Install the following Nova packages. These packages provide
the OpenStack Compute services that will be run on the controller node in this the OpenStack Compute services that will be run on the controller node in this
guide.</para> guide.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-novncproxy novnc nova-api nova-ajax-console-proxy nova-cert \ <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-novncproxy novnc nova-api nova-ajax-console-proxy nova-cert \
nova-conductor nova-consoleauth nova-doc nova-scheduler python-novaclient</userinput></screen> nova-conductor nova-consoleauth nova-doc nova-scheduler python-novaclient</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-nova-api openstack-nova-scheduler \ <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-api openstack-nova-scheduler \
>>>>>>> 0558383... Use traditional init script commands for openSUSE
openstack-nova-cert openstack-nova-conductor openstack-nova-console \ openstack-nova-cert openstack-nova-conductor openstack-nova-console \
openstack-nova-consoleauth openstack-nova-doc \ openstack-nova-consoleauth openstack-nova-doc \
openstack-nova-novncproxy python-novaclient</userinput></screen> openstack-nova-novncproxy python-novaclient</userinput></screen>
@ -35,13 +36,13 @@
<step> <step>
<para>The Compute Service stores information in a database. This guide uses <para>The Compute Service stores information in a database. This guide uses
the MySQL database used by other OpenStack services.</para> the MySQL database used by other OpenStack services.</para>
<para os="fedora;rhel;centos;opensuse"> Use the <para os="fedora;rhel;centos;opensuse;sles"> Use the
<command>openstack-db</command> command to create the database and tables <command>openstack-db</command> command to create the database and tables
for the Compute Service, as well as a database user called for the Compute Service, as well as a database user called
<literal>nova</literal> to connect to the database. Replace <literal>nova</literal> to connect to the database. Replace
<literal><replaceable>NOVA_DBPASS</replaceable></literal> with a <literal><replaceable>NOVA_DBPASS</replaceable></literal> with a
password of your choosing.</para> password of your choosing.</para>
<screen os="fedora;rhel;centos;opensuse"><prompt>#</prompt> <userinput>openstack-db --init --service nova --password <replaceable>NOVA_DBPASS</replaceable></userinput></screen> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-db --init --service nova --password <replaceable>NOVA_DBPASS</replaceable></userinput></screen>
<para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add the <literal>[database]</literal> section.</para> <para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add the <literal>[database]</literal> section.</para>
<programlisting os="ubuntu;debian" language="ini"> <programlisting os="ubuntu;debian" language="ini">
... ...
@ -65,7 +66,7 @@ IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput></screen>
<screen><prompt>#</prompt> <userinput>nova-manage db sync</userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage db sync</userinput></screen>
</step> </step>
<step os="fedora;rhel;centos;opensuse"> <step os="fedora;rhel;centos;opensuse;sles">
<para>Tell the Compute Service to use the created database.</para> <para>Tell the Compute Service to use the created database.</para>
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \ <screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \
@ -78,7 +79,7 @@ IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput></screen>
<literal>vncserver_proxyclient_address</literal> to the internal IP address of the <literal>vncserver_proxyclient_address</literal> to the internal IP address of the
controller node.</para> controller node.</para>
<screen os="fedora;rhel;centos;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.10</userinput> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.10</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.10</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.10</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.10</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.10</userinput></screen>
<para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</para> <para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</para>
@ -105,7 +106,7 @@ vncserver_proxyclient_address=192.168.0.10
<step> <step>
<para>For the Compute Service to use these credentials, you must alter the <filename>nova.conf</filename> configuration file.</para> <para>For the Compute Service to use these credentials, you must alter the <filename>nova.conf</filename> configuration file.</para>
<!-- FIXME don't think this is necessary - now happens in api-paste.ini --> <!-- FIXME don't think this is necessary - now happens in api-paste.ini -->
<screen os="fedora;rhel;centos;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone</userinput> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_host <replaceable>controller</replaceable></userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_host <replaceable>controller</replaceable></userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_user nova</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_user nova</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_tenant_name service</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_tenant_name service</userinput>
@ -135,7 +136,7 @@ admin_tenant_name=service
admin_user=nova admin_user=nova
admin_password=<replaceable>NOVA_DBPASS</replaceable> admin_password=<replaceable>NOVA_DBPASS</replaceable>
</programlisting> </programlisting>
<note os="fedora;rhel;centos;opensuse;debian"><para>Ensure that <literal>api_paste_config=/etc/nova/api-paste.ini</literal> <note os="fedora;rhel;centos;opensuse;debian;sles"><para>Ensure that <literal>api_paste_config=/etc/nova/api-paste.ini</literal>
is set in <filename>/etc/nova/nova.conf</filename>.</para></note> is set in <filename>/etc/nova/nova.conf</filename>.</para></note>
</step> </step>
<step> <step>
@ -174,7 +175,7 @@ admin_password=<replaceable>NOVA_DBPASS</replaceable>
<programlisting language="ini">rpc_backend = nova.rpc.impl_kombu <programlisting language="ini">rpc_backend = nova.rpc.impl_kombu
rabbit_host = controller</programlisting> rabbit_host = controller</programlisting>
</step> </step>
<step os="opensuse"> <step os="opensuse;sles">
<para>Configure the Compute Service to use the RabbitMQ <para>Configure the Compute Service to use the RabbitMQ
message broker by setting the following configuration keys.</para> message broker by setting the following configuration keys.</para>
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \ <screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \
@ -182,7 +183,7 @@ rabbit_host = controller</programlisting>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT rabbit_host controller</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT rabbit_host controller</userinput></screen>
</step> </step>
<step> <step>
<para os="centos;fedora;rhel;opensuse">Finally, start the various Nova services and configure them <para os="centos;fedora;rhel;opensuse;sles">Finally, start the various Nova services and configure them
to start when the system boots.</para> to start when the system boots.</para>
<para os="ubuntu;debian">Finally, restart the various Nova services.</para> <para os="ubuntu;debian">Finally, restart the various Nova services.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-api restart</userinput> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-api restart</userinput>
@ -191,7 +192,7 @@ rabbit_host = controller</programlisting>
<prompt>#</prompt> <userinput>service nova-scheduler restart</userinput> <prompt>#</prompt> <userinput>service nova-scheduler restart</userinput>
<prompt>#</prompt> <userinput>service nova-conductor restart</userinput> <prompt>#</prompt> <userinput>service nova-conductor restart</userinput>
<prompt>#</prompt> <userinput>service nova-novncproxy restart</userinput></screen> <prompt>#</prompt> <userinput>service nova-novncproxy restart</userinput></screen>
<screen os='centos;rhel;fedora'><prompt>#</prompt> <userinput>service openstack-nova-api start</userinput> <screen os="centos;rhel;fedora;opensuse;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>
<prompt>#</prompt> <userinput>service openstack-nova-consoleauth start</userinput> <prompt>#</prompt> <userinput>service openstack-nova-consoleauth start</userinput>
<prompt>#</prompt> <userinput>service openstack-nova-scheduler start</userinput> <prompt>#</prompt> <userinput>service openstack-nova-scheduler start</userinput>
@ -203,18 +204,6 @@ rabbit_host = controller</programlisting>
<prompt>#</prompt> <userinput>chkconfig openstack-nova-scheduler on</userinput> <prompt>#</prompt> <userinput>chkconfig openstack-nova-scheduler on</userinput>
<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>
<screen os="opensuse"><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>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-api.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-cert.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-consoleauth.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-scheduler.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-conductor.service</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-nova-novncproxy.service</userinput></screen>
</step> </step>
<step> <step>
<para>To verify that everything is configured correctly, use the <para>To verify that everything is configured correctly, use the

9
doc/install-guide/section_nova-network.xml
View File

@ -17,12 +17,12 @@
install the appropriate packages for compute networking.</para> install the appropriate packages for compute networking.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-network</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-network</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-network</userinput></screen> <screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-network</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-nova-network</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-network</userinput></screen>
</step> </step>
<step> <step>
<para>First, set the configuration options needed in <filename>nova.conf</filename> for the chosen networking mode.</para> <para>First, set the configuration options needed in <filename>nova.conf</filename> for the chosen networking mode.</para>
<screen os="fedora;rhel;centos;opensuse"> <screen os="fedora;rhel;centos;opensuse;sles">
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_manager nova.network.manager.FlatDHCPManager</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_manager nova.network.manager.FlatDHCPManager</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT firewall_driver nova.virt.libvirt.firewall.IptablesFirewallDriver</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT firewall_driver nova.virt.libvirt.firewall.IptablesFirewallDriver</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_size 254</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_size 254</userinput>
@ -60,15 +60,14 @@ public_interface = br100
<screen os="ubuntu;debian"> <screen os="ubuntu;debian">
<prompt>#</prompt> <userinput>service nova-network restart</userinput></screen> <prompt>#</prompt> <userinput>service nova-network restart</userinput></screen>
<screen os='centos;rhel;fedora'> <screen os="centos;rhel;fedora;opensuse;sles">
<prompt>#</prompt> <userinput>service openstack-nova-network restart</userinput></screen> <prompt>#</prompt> <userinput>service openstack-nova-network restart</userinput></screen>
<screen os="opensuse">
<prompt>#</prompt> <userinput>systemctl restart openstack-nova-network.service</userinput></screen>
</step> </step>
<step> <step>
<para>You must run the command that creates the network that the virtual machines use. <para>You must run the command that creates the network that the virtual machines use.
You only need to run this command once, from a place where your admin user credentials are loaded.</para> You only need to run this command once, from a place where your admin user credentials are loaded.</para>
<screen>source keystonerc</screen> <screen>source keystonerc</screen>
<screen><prompt>#</prompt> <userinput>nova network-create vmnet --fixed-range-v4=10.0.0.0/24 --bridge-interface=br100 --multi-host=T</userinput></screen> <screen><prompt>#</prompt> <userinput>nova network-create vmnet --fixed-range-v4=10.0.0.0/24 --bridge-interface=br100 --multi-host=T</userinput></screen>
</step> </step>
</procedure> </procedure>