OpsGuide

= OpenStack Operations Guide =

Abstract
This guide provides information about operating OpenStack clouds.

We recommend that you turn to the Installation Tutorials and Guides, which contains a step-by-step guide on how to manually install the OpenStack packages and dependencies on your cloud.

While it is important for an operator to be familiar with the steps involved in deploying OpenStack, we also strongly encourage you to evaluate OpenStack deployment tools and configuration-management tools, such as Puppet or Chef, which can help automate this deployment process.

In this guide, we assume that you have successfully deployed an OpenStack cloud and are able to perform basic operations such as adding images, booting instances, and attaching volumes.

As your focus turns to stable operations, we recommend that you do skim this guide to get a sense of the content. Some of this content is useful to read in advance so that you can put best practices into effect to simplify your life in the long run. Other content is more useful as a reference that you might turn to when an unexpected event occurs (such as a power failure), or to troubleshoot a particular problem.

Contents

 * Acknowledgements
 * Preface
 * Introduction to OpenStack
 * Getting Started with OpenStack
 * Who This Book Is For
 * How This Book Is Organized
 * Why and How We Wrote This Book
 * How to Contribute to This Book
 * Conventions
 * Notices
 * Command prompts
 * Factors affecting OpenStack deployment
 * Security requirements
 * Legal requirements
 * Cloud security architecture
 * Software licensing
 * Planning for deploying and provisioning OpenStack
 * Automated deployment
 * Automated configuration
 * Remote management
 * Other considerations
 * Capacity planning and scaling
 * Determining cloud scalability
 * Adding cloud controller nodes
 * Segregating your cloud
 * Scalable Hardware
 * Lay of the Land
 * Using the OpenStack Dashboard for Administration
 * Command-Line Tools
 * Network Inspection
 * Users and Projects
 * Running Instances
 * Summary
 * Managing Projects and Users
 * Managing Projects
 * Quotas
 * User Management
 * Summary
 * Projects or Tenants?
 * User-Facing Operations
 * Images
 * Flavors
 * Security Groups
 * Block Storage
 * Shared File Systems Service
 * Instances
 * Associating Security Groups
 * Floating IPs
 * Attaching Block Storage
 * Taking Snapshots
 * Instances in the Database
 * Good Luck!
 * Maintenance, Failures, and Debugging
 * Cloud Controller and Storage Proxy Failures and Maintenance
 * Compute Node Failures and Maintenance
 * Storage Node Failures and Maintenance
 * Handling a Complete Failure
 * Configuration Management
 * Working with Hardware
 * Databases
 * RabbitMQ troubleshooting
 * HDWMY
 * Determining Which Component Is Broken
 * What to do when things are running slowly
 * Uninstalling
 * Network Troubleshooting
 * Using ip a to Check Interface States
 * Visualizing nova-network Traffic in the Cloud
 * Visualizing OpenStack Networking Service Traffic in the Cloud
 * Finding a Failure in the Path
 * tcpdump
 * iptables
 * Network Configuration in the Database for nova-network
 * Debugging DHCP Issues with nova-network
 * Debugging DNS Issues
 * Troubleshooting Open vSwitch
 * Dealing with Network Namespaces
 * Assign a lost IPv4 address back to a project
 * Tools for automated neutron diagnosis
 * Logging and Monitoring
 * Logging
 * Monitoring
 * Summary
 * Backup and Recovery
 * What to Back Up
 * Database Backups
 * File System Backups
 * Recovering Backups
 * Summary
 * Customization
 * Provision an instance
 * Create an OpenStack Development Environment
 * Customizing Object Storage (Swift) Middleware
 * Customizing the OpenStack Compute (nova) Scheduler
 * Customizing the Dashboard (Horizon)
 * Conclusion
 * Advanced Configuration
 * Differences Between Various Drivers
 * Implementing Periodic Tasks
 * Specific Configuration Topics
 * Operational Upgrades
 * Pre-upgrade considerations
 * Upgrade process
 * Rolling back a failed upgrade
 * Appendix
 * Use Cases
 * Tales From the Cryp^H^H^H^H Cloud
 * Working with Roadmaps
 * More Resources
 * OpsGuide/Community support
 * Glossary