About This Guide #
SUSE® OpenStack Cloud Crowbar is an open source software solution that provides the fundamental capabilities to deploy and manage a cloud infrastructure based on SUSE Linux Enterprise. SUSE OpenStack Cloud Crowbar is powered by OpenStack, the leading community-driven, open source cloud infrastructure project. It seamlessly manages and provisions workloads across a heterogeneous cloud environment in a secure, compliant, and fully-supported manner. The product tightly integrates with other SUSE technologies and with the SUSE maintenance and support infrastructure.
In SUSE OpenStack Cloud Crowbar, there are several different high-level user roles:
- SUSE OpenStack Cloud Operator
Installs and deploys SUSE OpenStack Cloud Crowbar on bare-metal, then installs the operating system and the OpenStack components. For detailed information about the operator's tasks and how to solve them, refer to SUSE OpenStack Cloud Deployment Guide using Crowbar.
- SUSE OpenStack Cloud Administrator
Manages projects, users, images, flavors, and quotas within SUSE OpenStack Cloud Crowbar. For detailed information about the administrator's tasks and how to solve them, refer to the OpenStack Administrator Guide and the SUSE OpenStack Cloud Supplement to Administrator Guide and User Guide.
- SUSE OpenStack Cloud User
End user who launches and manages instances, creates snapshots, and uses volumes for persistent storage within SUSE OpenStack Cloud Crowbar. For detailed information about the user's tasks and how to solve them, refer to OpenStack User Guide and the SUSE OpenStack Cloud Supplement to Administrator Guide and User Guide.
This guide provides cloud operators with the information needed to deploy and maintain SUSE OpenStack Cloud administrative units, the Administration Server, the Control Nodes, and the Compute and Storage Nodes. The Administration Server provides all services needed to manage and deploy all other nodes in the cloud. The Control Node hosts all OpenStack components needed to operate virtual machines deployed on the Compute Nodes in the SUSE OpenStack Cloud. Each virtual machine (instance) started in the cloud will be hosted on one of the Compute Nodes. Object storage is managed by the Storage Nodes.
Many chapters in this manual contain links to additional documentation resources. These include additional documentation that is available on the system, and documentation available on the Internet.
For an overview of the documentation available for your product and the latest documentation updates, refer to https://documentation.suse.com.
1 Available Documentation #
Documentation for our products is available at http://documentation.suse.com, where you can also find the latest updates, and browse or download the documentation in various formats.
In addition, the product documentation
is usually available in your installed system under
/usr/share/doc/manual
. You can also access the
product-specific manuals and the upstream documentation from
the links in the graphical Web interfaces.
The following documentation is available for this product:
- Deployment Guide using Crowbar
Gives an introduction to the SUSE® OpenStack Cloud Crowbar architecture, lists the requirements, and describes how to set up, deploy, and maintain the individual components. Also contains information about troubleshooting, support, and a glossary listing the most important terms and concepts for SUSE OpenStack Cloud Crowbar.
- Administrator Guide
Introduces the OpenStack services and their components.
Also guides you through tasks like managing images, roles, instances, flavors, volumes, shares, quotas, host aggregates, and viewing cloud resources. To complete these tasks, use either the graphical Web interface (OpenStack Dashboard, code name
horizon
) or the OpenStack command line clients.- User Guide
Describes how to manage images, instances, networks, object containers, volumes, shares, stacks, and databases. To complete these tasks, use either the graphical Web interface (OpenStack Dashboard, code name
horizon
) or the OpenStack command line clients.- Operations Guide Crowbar
- Supplement to Administrator Guide and User Guide
A supplement to the SUSE OpenStack Cloud Crowbar Administrator Guide and SUSE OpenStack Cloud Crowbar User Guide. It contains additional information for admins and end users that is specific to SUSE OpenStack Cloud Crowbar.
2 Feedback #
Several feedback channels are available:
- Services and Support Options
For services and support options available for your product, refer to http://www.suse.com/support/.
- User Comments/Bug Reports
We want to hear your comments about and suggestions for this manual and the other documentation included with this product. If you are reading the HTML version of this guide, use the Comments feature at the bottom of each page in the online documentation at http://documentation.suse.com.
If you are reading the single-page HTML version of this guide, you can use the https://bugzilla.suse.com/. A user account is needed for this.
link next to each section to open a bug report atFor feedback on the documentation of this product, you can also send a mail to
doc-team@suse.com
. Make sure to include the document title, the product version, and the publication date of the documentation. To report errors or suggest enhancements, provide a concise description of the problem and refer to the respective section number and page (or URL).
3 Documentation Conventions #
The following notices and typographical conventions are used in this documentation:
- Warning
Vital information you must be aware of before proceeding. Warns you about security issues, potential loss of data, damage to hardware, or physical hazards.
ImportantImportant information you should be aware of before proceeding.
NoteAdditional information, for example about differences in software versions.
TipHelpful information, like a guideline or a piece of practical advice.
tux >
command
Commands that can be run by any user, including the
root
user.root #
command
Commands that must be run with
root
privileges. Often you can also prefix these commands with thesudo
command to run them./etc/passwd
: directory names and file namesPLACEHOLDER: replace PLACEHOLDER with the actual value
PATH
: the environment variable PATHls
,--help
: commands, options, and parametersuser
: users or groupsAlt, Alt–F1: a key to press or a key combination; keys are shown in uppercase as on a keyboard
AMD/Intel This paragraph is only relevant for the AMD64/Intel 64 architecture. The arrows mark the beginning and the end of the text block.
IBM Z, POWER This paragraph is only relevant for the architectures
z Systems
andPOWER
. The arrows mark the beginning and the end of the text block.Dancing Penguins (Chapter Penguins, ↑Another Manual): This is a reference to a chapter in another manual.
4 About the Making of This Manual #
This documentation is written in SUSEDoc, a subset of DocBook 5. The XML source
files were validated by jing
, processed by
xsltproc
, and converted into XSL-FO using a customized
version of Norman Walsh's stylesheets. The final PDF is formatted through
FOP from Apache Software Foundation. The open source tools
and the environment used to build this documentation are provided by the
DocBook Authoring and Publishing Suite (DAPS). The project's home page can
be found at https://github.com/openSUSE/daps.
The XML source code of this documentation can be found at https://github.com.