openstack/ha-guide
Code Issues Proposed changes
OpenStack High Availability Guide
547 Commits 1 Branch 0 Tags 6.2 MiB
Python 100%
15207289e6
Go to file
Leon Zachery 15207289e6 Move Configure the VIP to different location in docs 
In the current draft for the updated HA Guide, the
"Configure the VIP" subsection is included in the
"Installing high availability packages" section.

Given the previous step is just installing the
operating system, it is moved under the
"Configuring the controller for high availability section",
which describes how to install the Pacemaker/Corosync packages.
This is a pre-requisite for the VIP configuration.

Change-Id: Id5ef39dd59ae322aed26133ad873e4642c5195e4
Closes-Bug: #1484477
2015-08-25 23:03:14 -07:00
doc Move Configure the VIP to different location in docs 2015-08-25 23:03:14 -07:00
tools Rework RST building 2015-07-12 11:59:51 +02:00
.gitignore Add RST infrastructure for HA Guide 2015-05-02 09:08:43 +02:00
.gitreview Setup ha-guide infrastructure 2014-09-15 19:40:07 +02:00
doc-test.conf Rename doc/ha-guide to doc/high-availability-guide 2014-09-21 07:03:26 +02:00
doc-tools-check-languages.conf Blacklist common-rst for translation 2015-07-23 20:42:50 +02:00
README.rst Rename doc/ha-guide to doc/high-availability-guide 2014-09-21 07:03:26 +02:00
test-requirements.txt Enable doc8 and fix failures 2015-05-28 13:22:59 +02:00
tox.ini Prepare for translation of common files 2015-07-23 19:05:17 +02:00

README.rst

OpenStack High Availability Guide

This repository contains the OpenStack High Availability Guide.

For more details, see the OpenStack Documentation wiki page.

Prerequisites

Apache Maven must be installed to build the documentation.

To install Maven 3 for Ubuntu 12.04 and later, and Debian wheezy and later:

apt-get install maven

On Fedora 20 and later:

yum install maven

On openSUSE 13.1 and later:

zypper ar http://download.opensuse.org/repositories/devel:/tools:/building/openSUSE_13.1/devel:tools:building.repo
zypper install maven

Building

The root directory of the OpenStack High Availability Guide is doc/high-availability-guide.

To build the guide, move into the directory doc/high-availability-guide, then run the mvn command in that directory:

cd doc/high-availability-guide/
mvn clean generate-sources

The generated PDF documentation file is:

doc/high-availability-guide/target/docbkx/webhelp/high-availability-guide/high-availability-guide.pdf

The root of the generated HTML documentation is:

doc/high-availability-guide/target/docbkx/webhelp/high-availability-guide/index.html

Testing of changes and building of the manual

Install the python tox package and run tox from the top-level directory to use the same tests that are done as part of our Jenkins gating jobs.

If you like to run individual tests, run:

  • tox -e checkniceness - to run the niceness tests
  • tox -e checksyntax - to run syntax checks
  • tox -e checkdeletions - to check that no deleted files are referenced
  • tox -e checkbuild - to actually build the manual

tox will use the openstack-doc-tools package for execution of these tests.

Contributing

Our community welcomes all people interested in open source cloud computing, and encourages you to join the OpenStack Foundation.

The best way to get involved with the community is to talk with others online or at a meet up and offer contributions through our processes, the OpenStack wiki, blogs, or on IRC at #openstack on irc.freenode.net.

We welcome all types of contributions, from blueprint designs to documentation to testing to deployment scripts.

If you would like to contribute to the documents, please see the Documentation HowTo.

Bugs

Bugs should be filed on Launchpad, not GitHub:

https://bugs.launchpad.net/openstack-manuals

Installing

Refer to http://docs.openstack.org to see where these documents are published and to learn more about the OpenStack project.