423 lines
20 KiB
XML
423 lines
20 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<appendix 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"
|
|
xml:id="app_community_support">
|
|
<?dbhtml stop-chunking?>
|
|
<title>Community support</title>
|
|
<para>The following resources are available to help you run and use
|
|
OpenStack. The OpenStack community constantly improves and
|
|
adds to the main features of OpenStack, but if you have
|
|
any questions, do not hesitate to ask. Use the
|
|
following resources to get OpenStack support,
|
|
and troubleshoot your installations.</para>
|
|
<section xml:id="support-documentation">
|
|
<title>Documentation</title>
|
|
<para>For the available OpenStack documentation, see <link
|
|
xlink:href="http://docs.openstack.org"
|
|
>docs.openstack.org</link>.</para>
|
|
<para>To provide feedback on documentation, join and use the
|
|
<email>openstack-docs@lists.openstack.org</email>
|
|
mailing list at <link
|
|
xlink:href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs"
|
|
>OpenStack Documentation Mailing List</link>, or <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+filebug"
|
|
>report a bug</link>.</para>
|
|
<para>The following books explain how to install an OpenStack
|
|
cloud and its associated components:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/liberty/install-guide-obs/">
|
|
<citetitle>Installation Guide for openSUSE 13.2 and
|
|
SUSE Linux Enterprise Server 12</citetitle>
|
|
</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/liberty/install-guide-rdo/">
|
|
<citetitle>Installation Guide for Red Hat
|
|
Enterprise Linux 7, CentOS 7, and
|
|
Fedora 22</citetitle>
|
|
</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/liberty/install-guide-ubuntu/">
|
|
<citetitle>Installation Guide for Ubuntu
|
|
14.04 (LTS)</citetitle>
|
|
</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>The following books explain how to configure and run an
|
|
OpenStack cloud:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/arch-design/content/"
|
|
><citetitle>Architecture Design
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/admin-guide-cloud/"
|
|
><citetitle>Cloud Administrator
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/liberty/config-reference/content/"
|
|
><citetitle>Configuration
|
|
Reference</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/ops/"
|
|
><citetitle>Operations
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/networking-guide/"
|
|
><citetitle>Networking
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/ha-guide/"
|
|
><citetitle>High Availability
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/sec/"
|
|
><citetitle>Security
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://docs.openstack.org/image-guide/content/"
|
|
><citetitle>Virtual Machine Image
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>The following books explain how to use the OpenStack
|
|
dashboard and command-line clients:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://developer.openstack.org/api-guide/quick-start/"
|
|
><citetitle>API
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/user-guide/"
|
|
><citetitle>End User
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/user-guide-admin/"
|
|
><citetitle>Admin User
|
|
Guide</citetitle></link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<link
|
|
xlink:href="http://docs.openstack.org/cli-reference/content/"
|
|
><citetitle>Command-Line Interface
|
|
Reference</citetitle></link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>The following documentation provides reference and
|
|
guidance information for the OpenStack APIs:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://developer.openstack.org/api-ref.html"
|
|
>OpenStack API Complete
|
|
Reference (HTML)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="http://developer.openstack.org/api-ref-guides/bk-api-ref.pdf"
|
|
>API Complete Reference (PDF)</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
<section xml:id="support-ask_openstack">
|
|
<title>ask.openstack.org</title>
|
|
<para>During the set up or testing of OpenStack, you might
|
|
have questions about how a specific task is completed or
|
|
be in a situation where a feature does not work correctly.
|
|
Use the <link xlink:href="https://ask.openstack.org"
|
|
>ask.openstack.org</link> site to ask questions and
|
|
get answers. When you visit the <link
|
|
xlink:href="https://ask.openstack.org"
|
|
>https://ask.openstack.org</link> site, scan the
|
|
recently asked questions to see whether your question has
|
|
already been answered. If not, ask a new question. Be sure
|
|
to give a clear, concise summary in the title and provide
|
|
as much detail as possible in the description. Paste in
|
|
your command output or stack traces, links to screen
|
|
shots, and any other information which
|
|
might be useful.</para>
|
|
</section>
|
|
<section xml:id="support-mailing-lists">
|
|
<title>OpenStack mailing lists</title>
|
|
<para>A great way to get answers and insights is to post your
|
|
question or problematic scenario to the OpenStack mailing
|
|
list. You can learn from and help others who might have
|
|
similar issues. To subscribe or view the archives, go to
|
|
<link
|
|
xlink:href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack"
|
|
>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack</link>.
|
|
You might be interested in the other mailing lists for
|
|
specific projects or development, which you can find <link
|
|
xlink:href="https://wiki.openstack.org/wiki/MailingLists">on
|
|
the wiki</link>. A description of all mailing lists is
|
|
available at <link
|
|
xlink:href="https://wiki.openstack.org/wiki/MailingLists"
|
|
>https://wiki.openstack.org/wiki/MailingLists</link>.</para>
|
|
</section>
|
|
<section xml:id="support-wiki">
|
|
<title>The OpenStack wiki</title>
|
|
<para>The <link xlink:href="https://wiki.openstack.org/">OpenStack
|
|
wiki</link> contains a broad range of topics but some of the
|
|
information can be difficult to find or is a few pages deep.
|
|
Fortunately, the wiki search feature enables you to search by title
|
|
or content. If you search for specific information, such as about
|
|
networking or OpenStack Compute, you can find a large amount of relevant
|
|
material. More is being added all the time, so be sure to check back
|
|
often. You can find the search box in the upper-right corner of any
|
|
OpenStack wiki page.</para>
|
|
</section>
|
|
<section xml:id="support-bugs-area">
|
|
<title>The Launchpad Bugs area</title>
|
|
<para>The OpenStack community values your set up and testing efforts and
|
|
wants your feedback. To log a bug, you must sign up for a Launchpad
|
|
account at <link xlink:href="https://launchpad.net/+login"
|
|
>https://launchpad.net/+login</link>. You can view existing bugs
|
|
and report bugs in the Launchpad Bugs area. Use the search feature
|
|
to determine whether the bug has already been reported or already
|
|
been fixed. If it still seems like your bug is unreported, fill out
|
|
a bug report.</para>
|
|
<para>Some tips:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Give a clear, concise summary.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Provide as much detail as possible in the
|
|
description. Paste in your command output or stack
|
|
traces, links to screen shots, and any
|
|
other information which might be useful.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Be sure to include the software and package
|
|
versions that you are using, especially if you are
|
|
using a development branch, such as,
|
|
<literal>"Liberty release" vs git commit
|
|
bc79c3ecc55929bac585d04a03475b72e06a3208</literal>.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Any deployment-specific information is helpful, such as
|
|
whether you are using Ubuntu 14.04 or are performing a
|
|
multi-node installation.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>The following Launchpad Bugs areas are available:</para>
|
|
<itemizedlist>
|
|
<!-- Core projects, sorted alphabetically -->
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/cinder"
|
|
>Bugs: OpenStack Block Storage
|
|
(cinder)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/nova"
|
|
>Bugs: OpenStack Compute (nova)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/horizon"
|
|
>Bugs: OpenStack Dashboard
|
|
(horizon)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/keystone"
|
|
>Bugs: OpenStack Identity
|
|
(keystone)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/glance"
|
|
>Bugs: OpenStack Image service
|
|
(glance)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/neutron"
|
|
>Bugs: OpenStack Networking
|
|
(neutron)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/swift"
|
|
>Bugs: OpenStack Object Storage
|
|
(swift)</link></para>
|
|
</listitem>
|
|
<!-- Modules, sorted alphabetically -->
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/murano"
|
|
>Bugs: Application catalog (murano)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/ironic"
|
|
>Bugs: Bare metal service (ironic)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/magnum"
|
|
>Bugs: Containers service (magnum)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/sahara"
|
|
>Bugs: Data processing service
|
|
(sahara)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/trove"
|
|
>Bugs: Database service (trove)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/tuskar"
|
|
>Bugs: Deployment service (tuskar)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/trove"
|
|
>Bugs: Key Manager service (barbican)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/heat"
|
|
>Bugs: Orchestration (heat)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/manila"
|
|
>Bugs: Shared file systems (manila)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/ceilometer"
|
|
>Bugs: Telemetry (ceilometer)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/mistral"
|
|
>Bugs: Workflow service (mistral)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/zaqar"
|
|
>Bugs: Message Service (zaqar)</link></para>
|
|
</listitem>
|
|
<!-- Programs, sorted alphabetically -->
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/openstack-api-site"
|
|
>Bugs: OpenStack API Documentation
|
|
(developer.openstack.org)</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals"
|
|
>Bugs: OpenStack Documentation
|
|
(docs.openstack.org)</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
<section xml:id="support-irc-channel">
|
|
<title>The OpenStack IRC channel</title>
|
|
<para>The OpenStack community lives in the #openstack IRC channel on the
|
|
Freenode network. You can hang out, ask questions, or get immediate
|
|
feedback for urgent and pressing issues. To install an IRC client or
|
|
use a browser-based client, go to <link
|
|
xlink:href="https://webchat.freenode.net"
|
|
>https://webchat.freenode.net/</link>. You can also use Colloquy
|
|
(Mac OS X, <link xlink:href="http://colloquy.info/"
|
|
>http://colloquy.info/</link>), mIRC (Windows, <link
|
|
xlink:href="http://www.mirc.com/">http://www.mirc.com/</link>),
|
|
or XChat (Linux). When you are in the IRC channel and want to share
|
|
code or command output, the generally accepted method is to use a
|
|
Paste Bin. The OpenStack project has one at <link
|
|
xlink:href="http://paste.openstack.org"
|
|
>http://paste.openstack.org</link>. Just paste your longer
|
|
amounts of text or logs in the web form and you get a URL that you
|
|
can paste into the channel. The OpenStack IRC channel is
|
|
<literal>#openstack</literal> on
|
|
<literal>irc.freenode.net</literal>. You can find a list of all
|
|
OpenStack IRC channels at <link
|
|
xlink:href="https://wiki.openstack.org/wiki/IRC"
|
|
>https://wiki.openstack.org/wiki/IRC</link>.</para>
|
|
</section>
|
|
<section xml:id="support-documentation-feedback">
|
|
<title>Documentation feedback</title>
|
|
<para>To provide feedback on documentation, join and use the
|
|
<email>openstack-docs@lists.openstack.org</email> mailing list at
|
|
<link xlink:href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">OpenStack
|
|
Documentation Mailing List</link>, or <link xlink:href="https://bugs.launchpad.net/openstack-manuals/+filebug">report a bug</link>.</para>
|
|
</section>
|
|
<section xml:id="distro-support">
|
|
<title>OpenStack distribution packages</title>
|
|
<para>The following Linux distributions provide
|
|
community-supported packages for OpenStack:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><emphasis role="bold">Debian:</emphasis>
|
|
<link
|
|
xlink:href="https://wiki.debian.org/OpenStack"
|
|
>https://wiki.debian.org/OpenStack</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold">CentOS, Fedora, and Red
|
|
Hat Enterprise Linux:</emphasis>
|
|
<link xlink:href="https://www.rdoproject.org/"
|
|
>https://www.rdoproject.org/</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold">openSUSE and SUSE Linux
|
|
Enterprise Server:</emphasis>
|
|
<link
|
|
xlink:href="http://en.opensuse.org/Portal:OpenStack"
|
|
>https://en.opensuse.org/Portal:OpenStack</link></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold">Ubuntu:</emphasis>
|
|
<link
|
|
xlink:href="https://wiki.ubuntu.com/ServerTeam/CloudArchive"
|
|
>https://wiki.ubuntu.com/ServerTeam/CloudArchive</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
</appendix>
|