openstack-manuals/doc/high-availability-guide
Stephen Gordon 1a2e3dd027 Use correct URLs for pacemaker scripts
Updated URLs in HA guide to point to new location of pacemaker scripts.

Change-Id: I1a5ea97e2ec7cad9270f3b815fa5caea9e3d4ff1
Closes-Bug: #1252131
2014-02-22 14:04:43 -05:00
..
figures Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
includes Fixes pacemaker-neutron_server resources 2014-01-15 13:04:57 +08:00
locale Imported Translations from Transifex 2014-01-30 06:26:14 +00:00
aa-automated-deployment.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-computes.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-controllers.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-database.txt Fixed typo - cleanup documentation 2013-12-05 13:44:05 -05:00
aa-haproxy.txt Fix misspellings 2014-01-10 09:34:22 -06:00
aa-network.txt Fix misspellings 2014-01-10 09:34:22 -06:00
aa-overview.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-rabbitmq.txt Cleanup of HA guide - AA-rabbitmq 2014-02-19 13:15:35 -06:00
aa-storage.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-api-node.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-api-pacemaker.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-api-vip.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-ceilometer-agent-central.txt Cleanup of ap-ceilometer-agent-central 2014-02-17 11:45:24 -05:00
ap-cinder-api.txt cleanup ap-cinder-api_txt 2014-02-17 11:49:33 -05:00
ap-cloud-controller.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-glance-api.txt cleanup of ap-glance-api_txt 2014-02-17 11:54:41 -05:00
ap-keystone.txt cleanup of ap-keystone 2014-02-18 16:19:50 -05:00
ap-mysql.txt Fix typo in device name 2014-02-05 18:44:01 +01:00
ap-network-controller.txt Use correct URLs for pacemaker scripts 2014-02-22 14:04:43 -05:00
ap-neutron-server.txt minor cleanup ap-neutron-server 2014-02-17 12:11:20 -05:00
ap-overview.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-pacemaker.txt changed al-pacemaker cleanup 2014-02-17 12:18:24 -05:00
ap-rabbitmq.txt minor cleanup to ap-rabbitmq 2014-02-17 12:30:00 -05:00
ha-guide-docinfo.xml Attempt to fix problems in high availability guide 2013-10-14 11:18:51 -05:00
ha-guide.txt Attempt to fix problems in high availability guide 2013-10-14 11:18:51 -05:00
intro.txt minor edits to HA guide 2013-10-29 16:56:19 +11:00
pom.xml Update of pom.xml files 2014-01-28 17:30:51 +01:00
README Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00

This directory contains what's eventually intended to become reference
documentation for OpenStack High Availability.

Contrary to the rest of the documentation which is straight-up
DocBook, this guide is being maintained, at least for the time being,
in AsciiDoc. AsciiDoc processing is supported by the OpenStack Jenkins
CI infrastructure, but not by the Maven toolchain. So as a stop-gap
measure until such support becomes available, please do this if you
want to build offline before you send a patch:

1. Make your change to the AsciiDoc source file (.txt). The syntax
   should be self explanatory-and intuitive to anyone who's ever used
   something like Markdown or RST. The AsciiDoc cheatsheet is an
   extremely useful resource: http://powerman.name/doc/asciidoc

2. Pipe your stuff through AsciiDoc. Here's one catch: AsciiDoc
   currently doesn't fully support DocBook 5, but the Maven toolchain
   requires it. So you'll have to run your AsciiDoc output through the
   "db4upgrade.xsl" stylesheet that ships with DocBook 5.

3. Finally, indent your resulting XML with two spaces. This should
   produce a clean patch against bk-ha-guide.xml which you can then
   submit to Gerrit along with your .txt file patch.

4. Add an "xml:id" attribute on the root <book> element. The Maven
   toolchain requires this.

Here's a command line you can use with AsciiDoc, xsltproc, xmllint and
sed to achieve all of the above:

asciidoc -b docbook -d book -o - ha-guide.txt | \
  xsltproc -o - /path/to/db4-upgrade.xsl - | \
  xmllint --format - | \
  sed -e 's,^<book ,<book xml:id="bk-ha-guide" ,' \
  > bk-ha-guide.xml

Admittedly, the sed hack is particularly ugly, but it does get the job
done.

After that, you should be able to build with "mvn clean
generate-sources" as you normally would.