Merge "openSUSE Install Guide"
This commit is contained in:
Jenkins
Gerrit Code Review
commit
e8d8e24858
@ -22,6 +22,7 @@
|
||||
Identity Service as root:</para>
|
||||
<screen os="ubuntu"><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="opensuse"><prompt>#</prompt> <userinput>zypper install memcached python-python-memcached apache2-mod_wsgi openstack-dashboard</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Modify the value of
|
||||
@ -29,21 +30,22 @@
|
||||
<filename os="ubuntu"
|
||||
>/etc/openstack-dashboard/local_settings.py</filename><filename
|
||||
os="centos;fedora;rhel"
|
||||
>/etc/openstack-dashboard/local_settings</filename> to match
|
||||
the ones set in <filename os="ubuntu"
|
||||
>/etc/openstack-dashboard/local_settings</filename><filename
|
||||
os="opensuse">/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
||||
to match the ones set in <filename os="ubuntu"
|
||||
>/etc/memcached.conf</filename><filename
|
||||
os="centos;fedora;rhel"
|
||||
os="centos;fedora;rhel;opensuse"
|
||||
>/etc/sysconfig/memcached.conf</filename>.</para>
|
||||
<para>Open <filename os="ubuntu"
|
||||
>/etc/openstack-dashboard/local_settings.py</filename><filename
|
||||
os="centos;fedora;rhel"
|
||||
>/etc/openstack-dashboard/local_settings.py</filename>
|
||||
<filename os="centos;fedora;rhel"
|
||||
>/etc/openstack-dashboard/local_settings</filename> and look
|
||||
for this line:</para>
|
||||
<programlisting language="bash" linenumbering="unnumbered">CACHES = {
|
||||
'default': {
|
||||
'BACKEND' : 'django.core.cache.backends.memcached.MemcachedCache',
|
||||
'LOCATION' : '127.0.0.1:11211'
|
||||
}
|
||||
'default': {
|
||||
'BACKEND' : 'django.core.cache.backends.memcached.MemcachedCache',
|
||||
'LOCATION' : '127.0.0.1:11211'
|
||||
}
|
||||
}</programlisting>
|
||||
<note xlink:href="#installing-openstack-dashboard"
|
||||
xlink:title="Notes">
|
||||
@ -53,7 +55,7 @@
|
||||
<para>The address and port must match the ones set in
|
||||
<filename os="ubuntu"
|
||||
>/etc/memcached.conf</filename><filename
|
||||
os="centos;fedora;rhel"
|
||||
os="centos;fedora;rhel;opensuse"
|
||||
>/etc/sysconfig/memcached</filename>.</para>
|
||||
<para>If you change the memcached settings, you must
|
||||
restart the Apache web server for the changes to
|
||||
@ -70,7 +72,9 @@
|
||||
the <filename os="centos;fedora;rhel"
|
||||
>/etc/openstack-dashboard/local_settings</filename><filename
|
||||
os="ubuntu"
|
||||
>/etc/openstack-dashboard/local_settings.py</filename>
|
||||
>/etc/openstack-dashboard/local_settings.py</filename><filename
|
||||
os="opensuse"
|
||||
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
||||
file.</para>
|
||||
<para>Change the following parameter: <code>TIME_ZONE =
|
||||
"UTC"</code>
|
||||
|
||||
@ -24,6 +24,7 @@
|
||||
install <literal>git</literal>:</para>
|
||||
<screen os="ubuntu" language="bash"><prompt>$</prompt> <userinput>sudo apt-get install git-core</userinput></screen>
|
||||
<screen os="centos;rhel;fedora" language="bash"><prompt>$</prompt> <userinput>sudo yum install git</userinput></screen>
|
||||
<screen os="opensuse" language="bash"><prompt>$</prompt> <userinput>sudo zypper install git</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Python 2.6 or 2.7. The Python version must support
|
||||
|
||||
@ -127,6 +127,7 @@ text-decoration: none;
|
||||
<para>Restart apache:</para>
|
||||
<screen os="ubuntu"><prompt>$</prompt> <userinput>sudo service apache2 restart</userinput></screen>
|
||||
<screen os="centos;fedora;rhel"><prompt>$</prompt> <userinput>sudo service httpd restart</userinput></screen>
|
||||
<screen os="opensuse"><prompt>$</prompt> <userinput>sudo service apache2 restart</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Reload the dashboard in your browser to view your
|
||||
|
||||
@ -12,7 +12,9 @@
|
||||
<literal>SESSION_ENGINE</literal> setting in your
|
||||
<filename os="centos;fedora;rhel">
|
||||
/etc/openstack-dashboard/local_settings</filename>
|
||||
<filename os="ubuntu">local_settings.py</filename> file.</para>
|
||||
<filename os="ubuntu">local_settings.py</filename><filename
|
||||
os="opensuse">/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
||||
file.</para>
|
||||
<para>The following sections describe the pros and cons of each
|
||||
option as it pertains to deploying the dashboard.</para>
|
||||
<section xml:id="dashboard-session-local">
|
||||
@ -131,6 +133,8 @@ CACHES = {
|
||||
>/etc/openstack-dashboard/local_settings.py</filename>
|
||||
<filename os="centos;fedora;rhel"
|
||||
>/etc/openstack-dashboard/local_settings</filename>
|
||||
<filename os="opensuse"
|
||||
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
||||
file, change these options:</para>
|
||||
<programlisting language="python">SESSION_ENGINE = 'django.core.cache.backends.db.DatabaseCache'
|
||||
DATABASES = {
|
||||
@ -146,7 +150,7 @@ DATABASES = {
|
||||
}</programlisting>
|
||||
</step>
|
||||
<step>
|
||||
<para>After configuring the <filename os="ubuntu"
|
||||
<para>After configuring the <filename os="ubuntu;opensuse"
|
||||
>local_settings.py</filename>
|
||||
<filename os="centos;fedora;rhel"
|
||||
>/etc/openstack-dashboard/local_settings</filename>
|
||||
@ -172,6 +176,7 @@ No fixtures found.</computeroutput></screen>
|
||||
symbolic link settings:</para>
|
||||
<screen os="ubuntu"><prompt>#</prompt> <userinput>/etc/init.d/apache2 restart</userinput></screen>
|
||||
<screen os="centos;fedora;rhel"><prompt>#</prompt> <userinput>service httpd restart</userinput></screen>
|
||||
<screen os="centos;fedora;rhel"><prompt>#</prompt> <userinput>service apache2 restart</userinput></screen>
|
||||
</step>
|
||||
<step os="ubuntu">
|
||||
<para>Restart the <systemitem class="service">nova-api</systemitem> service to ensure that the
|
||||
|
||||
@ -11,6 +11,8 @@
|
||||
cinder-scheduler cinder-volume open-iscsi python-cinderclient tgt</userinput></screen>
|
||||
<screen os="rhel;centos;fedora"><prompt>$</prompt> <userinput>sudo yum install openstack-cinder openstack-cinder-doc \
|
||||
iscsi-initiator-utils scsi-target-utils</userinput></screen>
|
||||
<screen os="opensuse"><prompt>$</prompt> <userinput>sudo zypper install openstack-cinder openstack-cinder-doc \
|
||||
open-iscsi tgt</userinput></screen>
|
||||
<para>Edit <filename>/etc/cinder/api-paste.ini</filename> (filter
|
||||
authtoken).<programlisting>[filter:authtoken]
|
||||
paste.filter_factory = keystoneclient.middleware.auth_token:filter_factory
|
||||
@ -46,6 +48,13 @@ rabbit_port = 5672
|
||||
#rabbit_virtual_host = /nova</programlisting>
|
||||
<programlisting os="rhel;centos;fedora">
|
||||
qpid_hostname=192.168.206.130</programlisting>
|
||||
<programlisting os="opensuse">
|
||||
rabbit_host = 10.10.10.10
|
||||
rabbit_port = 5672
|
||||
# Change the following settings if you're not using the default RabbitMQ configuration
|
||||
#rabbit_userid = rabbit
|
||||
#rabbit_password = secure_password
|
||||
#rabbit_virtual_host = /nova</programlisting>
|
||||
<para>Verify entries in <filename>/etc/nova/nova.conf</filename>. The
|
||||
<literal>volume_api_class</literal> setting is the default setting since
|
||||
grizzly.</para>
|
||||
|
||||
@ -21,4 +21,5 @@
|
||||
<screen><prompt>$</prompt> <userinput>sudo apt-get install ubuntu-cloud-keyring</userinput></screen>
|
||||
</para>
|
||||
<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>
|
||||
</section>
|
||||
|
||||
@ -40,9 +40,21 @@ DELAY=0
|
||||
BOOTPROTO=static
|
||||
IPADDR=192.168.100.1
|
||||
NETMASK=255.255.255.0</programlisting>
|
||||
<para os="opensuse">Here's an example network setup for openSUSE. Create
|
||||
<filename>/etc/sysconfig/network/ifcfg-br100</filename>:</para>
|
||||
<programlisting os="opensuse">DEVICE=br100
|
||||
TYPE=Bridge
|
||||
ONBOOT=yes
|
||||
DELAY=0
|
||||
BOOTPROTO=static
|
||||
STARTMODE=auto
|
||||
IPADDR=192.168.100.1
|
||||
NETMASK=255.255.255.0</programlisting>
|
||||
|
||||
<para>Also install bridge-utils:</para>
|
||||
<screen os="ubuntu"><prompt>$</prompt> <userinput>sudo apt-get install bridge-utils</userinput></screen>
|
||||
<screen os="rhel;centos;fedora"><prompt>$</prompt> <userinput>sudo yum install bridge-utils</userinput></screen>
|
||||
<screen os="opensuse"><prompt>$</prompt> <userinput>sudo zypper install bridge-utils</userinput></screen>
|
||||
<para>Ensure that you set up the bridge, although if you use flat_network_bridge=br100 in your
|
||||
<filename>nova.conf</filename> file, nova will set up the bridge for you when you run
|
||||
the <command>nova network-create</command> command.</para>
|
||||
|
||||
@ -2,17 +2,23 @@
|
||||
<section xml:id="compute-db-sync"
|
||||
xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"><title>Configuring the Database for Compute</title>
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
||||
<title>Configuring the Database for Compute</title>
|
||||
<para>Create the tables in your backend data store by running
|
||||
the following command:</para>
|
||||
<screen os="ubuntu"><prompt>$</prompt> <userinput>sudo nova-manage db sync</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>nova-manage db sync</userinput></screen>
|
||||
<screen os="rhel;fedora;centos;opensuse"><prompt>#</prompt> <userinput>nova-manage db sync</userinput></screen>
|
||||
<para>If you see any response, you can look in
|
||||
/var/log/nova/nova-manage.log to see the problem. No
|
||||
<filename>/var/log/nova/nova-manage.log</filename> to see the problem. No
|
||||
response means the command completed correctly and your
|
||||
nova database is now populated.</para>
|
||||
<note><title>Deprecation warnings</title>
|
||||
<para>Note that if while running this command you see warnings such as <literal>SADeprecationWarning: The 'listeners' argument to Pool (and create_engine()) is deprecated. Use event.listen().</literal>, these will be fixed in future version of the libraries and can be safely ignored.</para></note>
|
||||
<para>Note that if while running this command you see warnings
|
||||
such as <literal>SADeprecationWarning: The 'listeners' argument to
|
||||
Pool (and create_engine()) is deprecated. Use
|
||||
event.listen().</literal>, these will be fixed in future version
|
||||
of the libraries and can be safely ignored.</para>
|
||||
</note>
|
||||
|
||||
<para>Restart all services in total, just to cover the entire spectrum. On the controller node
|
||||
run:</para>
|
||||
@ -25,14 +31,16 @@ sudo start nova-novncproxy
|
||||
sudo start libvirt-bin
|
||||
sudo /etc/init.d/rabbitmq-server restart </screen>
|
||||
</para>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>for svc in api objectstore conductor network volume scheduler cert; do sudo service openstack-nova-$svc start; done</userinput></screen>
|
||||
<screen os="rhel;fedora;centos;opensuse"><prompt>#</prompt> <userinput>for svc in api objectstore conductor network volume scheduler cert; do sudo service openstack-nova-$svc start; done</userinput></screen>
|
||||
<para>On the compute node run:</para>
|
||||
<para>
|
||||
<screen os="ubuntu">sudo start nova-compute
|
||||
sudo start nova-network</screen>
|
||||
</para>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>for svc in compute network; do sudo service openstack-nova-$svc start; done</userinput></screen>
|
||||
<screen os="rhel;fedora;centos;opensuse"><prompt>#</prompt> <userinput>for svc in compute network; do sudo service openstack-nova-$svc start; done</userinput></screen>
|
||||
<para>All nova services are now installed and started. If the
|
||||
"start" command doesn't work, your services may not be
|
||||
running correctly (or not at all). Review the logs in
|
||||
/var/log/nova to look for clues.</para></section>
|
||||
<filename>/var/log/nova</filename> to look for clues.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
@ -85,7 +85,7 @@ flat_network_bridge=br100</programlisting>
|
||||
<para>Here is an example <filename>nova.conf</filename> with
|
||||
commented sections:</para>
|
||||
<para>
|
||||
<programlisting os="ubuntu"><xi:include parse="text" href="../common/samples/nova.conf"/>
|
||||
<programlisting os="ubuntu;opensuse"><xi:include parse="text" href="../common/samples/nova.conf"/>
|
||||
</programlisting>
|
||||
<programlisting os="rhel;centos;fedora"><xi:include parse="text" href="../common/samples/nova.conf-yum"/>
|
||||
</programlisting>
|
||||
@ -116,10 +116,10 @@ flat_network_bridge=br100</programlisting>
|
||||
<prompt>#</prompt> <userinput>stop nova-scheduler</userinput>
|
||||
<prompt>#</prompt> <userinput>stop nova-novncproxy</userinput>
|
||||
</screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>$</prompt> <userinput>for svc in api objectstore conductor network volume scheduler cert; do sudo service openstack-nova-$svc stop ; sudo chkconfig openstack-nova-$svc on ; done</userinput></screen>
|
||||
<screen os="rhel;fedora;centos;opensuse"><prompt>$</prompt> <userinput>for svc in api objectstore conductor network volume scheduler cert; do sudo service openstack-nova-$svc stop ; sudo chkconfig openstack-nova-$svc on ; done</userinput></screen>
|
||||
<para>On the compute node run:</para>
|
||||
<screen os="ubuntu"><prompt>#</prompt> <userinput>stop nova-compute</userinput>
|
||||
<prompt>#</prompt> <userinput>stop nova-network</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>$></prompt> <userinput>for svc in api compute network; do sudo service openstack-nova-$svc stop ; sudo chkconfig openstack-nova-$svc on ; done</userinput>
|
||||
<screen os="rhel;fedora;centos;opensuse"><prompt>$></prompt> <userinput>for svc in api compute network; do sudo service openstack-nova-$svc stop ; sudo chkconfig openstack-nova-$svc on ; done</userinput>
|
||||
</screen>
|
||||
</section>
|
||||
|
||||
@ -16,7 +16,9 @@
|
||||
<listitem>
|
||||
<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>
|
||||
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-swift-proxy memcached openstack-utils python-swiftclient python-keystone-auth-token</userinput></screen></para>
|
||||
<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>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Create self-signed cert for SSL:</para>
|
||||
|
||||
@ -17,7 +17,9 @@
|
||||
<listitem><para>Install Storage node packages:</para>
|
||||
<para>
|
||||
<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></para>
|
||||
<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>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>For every device on the node you wish to use for storage,
|
||||
|
||||
@ -62,10 +62,11 @@
|
||||
using 10g networking to the proxy, or are
|
||||
terminating SSL traffic at the proxy,
|
||||
greater CPU power will be required.</para></td></tr></tbody></table>
|
||||
|
||||
<para><emphasis role="bold">Operating System</emphasis>: OpenStack
|
||||
Object Storage currently runs on Ubuntu, RHEL, CentOS, or
|
||||
Fedora and the large scale deployment at Rackspace runs on
|
||||
Ubuntu 10.04 LTS.</para>
|
||||
Object Storage currently runs on Ubuntu, RHEL, CentOS, Fedora,
|
||||
openSUSE, or SLES and the large scale deployment at Rackspace runs
|
||||
on Ubuntu 10.04 LTS.</para>
|
||||
<para><emphasis role="bold">Networking</emphasis>: 1000 Mbps are suggested. For
|
||||
OpenStack Object Storage, an external network should connect the outside
|
||||
world to the proxy servers, and the storage network is intended to be
|
||||
|
||||
Loading…
Reference in New Issue
Block a user