216 lines
8.0 KiB
ReStructuredText
216 lines
8.0 KiB
ReStructuredText
.. ## WARNING ##########################################################
|
|
.. This file is synced from openstack/openstack-manuals repository to
|
|
.. other related repositories. If you need to make changes to this file,
|
|
.. make the changes in openstack-manuals. After any change merged to,
|
|
.. openstack-manuals, automatically a patch for others will be proposed.
|
|
.. #####################################################################
|
|
|
|
=================
|
|
Community support
|
|
=================
|
|
|
|
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.
|
|
|
|
Documentation
|
|
~~~~~~~~~~~~~
|
|
|
|
For the available OpenStack documentation, see
|
|
`docs.openstack.org <https://docs.openstack.org>`_.
|
|
|
|
The following guides explain how to install a Proof-of-Concept OpenStack cloud
|
|
and its associated components:
|
|
|
|
* `Rocky Installation Guides <https://docs.openstack.org/rocky/install/>`_
|
|
|
|
The following books explain how to configure and run an OpenStack cloud:
|
|
|
|
* `Architecture Design Guide <https://docs.openstack.org/arch-design/>`_
|
|
|
|
* `Rocky Administrator Guides <https://docs.openstack.org/rocky/admin/>`_
|
|
|
|
* `Rocky Configuration Guides <https://docs.openstack.org/rocky/configuration/>`_
|
|
|
|
* `Rocky Networking Guide <https://docs.openstack.org/neutron/rocky/admin/>`_
|
|
|
|
* `High Availability Guide <https://docs.openstack.org/ha-guide/>`_
|
|
|
|
* `Security Guide <https://docs.openstack.org/security-guide/>`_
|
|
|
|
* `Virtual Machine Image Guide <https://docs.openstack.org/image-guide/>`_
|
|
|
|
The following book explains how to use the command-line clients:
|
|
|
|
* `Rocky API Bindings
|
|
<https://docs.openstack.org/rocky/language-bindings.html>`_
|
|
|
|
The following documentation provides reference and guidance information
|
|
for the OpenStack APIs:
|
|
|
|
* `API Documentation <https://docs.openstack.org/api-quick-start/>`_
|
|
|
|
The following guide provides information on how to contribute to OpenStack
|
|
documentation:
|
|
|
|
* `Documentation Contributor Guide <https://docs.openstack.org/doc-contrib-guide/>`_
|
|
|
|
The OpenStack wiki
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
The `OpenStack wiki <https://wiki.openstack.org/>`_ 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.
|
|
|
|
The Launchpad bugs area
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
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
|
|
<https://launchpad.net/+login>`_. 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.
|
|
|
|
Some tips:
|
|
|
|
* Give a clear, concise summary.
|
|
|
|
* 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.
|
|
|
|
* Be sure to include the software and package versions that you are
|
|
using, especially if you are using a development branch, such as,
|
|
``"Kilo release" vs git commit bc79c3ecc55929bac585d04a03475b72e06a3208``.
|
|
|
|
* Any deployment-specific information is helpful, such as whether you
|
|
are using Ubuntu 14.04 or are performing a multi-node installation.
|
|
|
|
The following Launchpad Bugs areas are available:
|
|
|
|
* `Bugs: OpenStack Block Storage
|
|
(cinder) <https://bugs.launchpad.net/cinder>`_
|
|
|
|
* `Bugs: OpenStack Compute (nova) <https://bugs.launchpad.net/nova>`_
|
|
|
|
* `Bugs: OpenStack Dashboard
|
|
(horizon) <https://bugs.launchpad.net/horizon>`_
|
|
|
|
* `Bugs: OpenStack Identity
|
|
(keystone) <https://bugs.launchpad.net/keystone>`_
|
|
|
|
* `Bugs: OpenStack Image service
|
|
(glance) <https://bugs.launchpad.net/glance>`_
|
|
|
|
* `Bugs: OpenStack Networking
|
|
(neutron) <https://bugs.launchpad.net/neutron>`_
|
|
|
|
* `Bugs: OpenStack Object Storage
|
|
(swift) <https://bugs.launchpad.net/swift>`_
|
|
|
|
* `Bugs: Application catalog (murano) <https://bugs.launchpad.net/murano>`_
|
|
|
|
* `Bugs: Bare metal service (ironic) <https://bugs.launchpad.net/ironic>`_
|
|
|
|
* `Bugs: Clustering service (senlin) <https://bugs.launchpad.net/senlin>`_
|
|
|
|
* `Bugs: Container Infrastructure Management service (magnum) <https://bugs.launchpad.net/magnum>`_
|
|
|
|
* `Bugs: Data processing service
|
|
(sahara) <https://bugs.launchpad.net/sahara>`_
|
|
|
|
* `Bugs: Database service (trove) <https://bugs.launchpad.net/trove>`_
|
|
|
|
* `Bugs: DNS service (designate) <https://bugs.launchpad.net/designate>`_
|
|
|
|
* `Bugs: Key Manager Service (barbican) <https://bugs.launchpad.net/barbican>`_
|
|
|
|
* `Bugs: Monitoring (monasca) <https://bugs.launchpad.net/monasca>`_
|
|
|
|
* `Bugs: Orchestration (heat) <https://bugs.launchpad.net/heat>`_
|
|
|
|
* `Bugs: Rating (cloudkitty) <https://bugs.launchpad.net/cloudkitty>`_
|
|
|
|
* `Bugs: Shared file systems (manila) <https://bugs.launchpad.net/manila>`_
|
|
|
|
* `Bugs: Telemetry
|
|
(ceilometer) <https://bugs.launchpad.net/ceilometer>`_
|
|
|
|
* `Bugs: Telemetry v3
|
|
(gnocchi) <https://bugs.launchpad.net/gnocchi>`_
|
|
|
|
* `Bugs: Workflow service
|
|
(mistral) <https://bugs.launchpad.net/mistral>`_
|
|
|
|
* `Bugs: Messaging service
|
|
(zaqar) <https://bugs.launchpad.net/zaqar>`_
|
|
|
|
* `Bugs: Container service
|
|
(zun) <https://bugs.launchpad.net/zun>`_
|
|
|
|
* `Bugs: OpenStack API Documentation
|
|
(developer.openstack.org) <https://bugs.launchpad.net/openstack-api-site>`_
|
|
|
|
* `Bugs: OpenStack Documentation
|
|
(docs.openstack.org) <https://bugs.launchpad.net/openstack-manuals>`_
|
|
|
|
Documentation feedback
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
To provide feedback on documentation, join our IRC channel ``#openstack-doc``
|
|
on the OFTC IRC network, or `report a bug in Launchpad
|
|
<https://bugs.launchpad.net/openstack/+filebug>`_ and choose the particular
|
|
project that the documentation is a part of.
|
|
|
|
The OpenStack IRC channel
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The OpenStack community lives in the #openstack IRC channel on the
|
|
OFTC 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
|
|
`https://webchat.oftc.net/ <https://webchat.oftc.net>`_. You can
|
|
also use `Colloquy <http://colloquy.info/>`_ (Mac OS X),
|
|
`mIRC <http://www.mirc.com/>`_ (Windows),
|
|
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 `Paste
|
|
<http://paste.openstack.org>`_. 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 ``#openstack`` on
|
|
``irc.oftc.net``. You can find a list of all OpenStack IRC channels on
|
|
the `IRC page on the wiki <https://wiki.openstack.org/wiki/IRC>`_.
|
|
|
|
OpenStack mailing lists
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
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 the `general OpenStack mailing list
|
|
<http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack>`_. If you are
|
|
interested in the other mailing lists for specific projects or development,
|
|
refer to `Mailing Lists <https://wiki.openstack.org/wiki/Mailing_Lists>`_.
|
|
|
|
OpenStack distribution packages
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The following Linux distributions provide community-supported packages
|
|
for OpenStack:
|
|
|
|
* **CentOS, Fedora, and Red Hat Enterprise Linux:**
|
|
https://www.rdoproject.org/
|
|
|
|
* **openSUSE and SUSE Linux Enterprise Server:**
|
|
https://en.opensuse.org/Portal:OpenStack
|
|
|
|
* **Ubuntu:** https://wiki.ubuntu.com/OpenStack/CloudArchive
|