Jump to: navigation, search

Difference between revisions of "Documentation/HA Guide Update"

(Logistics)
(Next Meeting)
 
(85 intermediate revisions by 6 users not shown)
Line 3: Line 3:
 
== What ==
 
== What ==
  
Let's update the OpenStack HA Guide. Based on direction from Anne Gentile, we will follow a similar path as the Security Guide -- subject matter experts working with core docs team members for reviews.
+
Let's update the OpenStack HA Guide. Based on direction from Anne Gentle, we will follow a similar path as the Security Guide -- subject matter experts working with core docs team members for reviews.
  
 
In addition to addressing the bug list (https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=ha-guide), this effort will update all aspects of the guide to be more current and provide richer information and advice about OpenStack HA.
 
In addition to addressing the bug list (https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=ha-guide), this effort will update all aspects of the guide to be more current and provide richer information and advice about OpenStack HA.
  
 
We've created an [https://etherpad.openstack.org/p/openstack-haguide-update etherpad] to capture ideas and start to form a plan for what is going to be updated, in what way, and who is responsible.
 
We've created an [https://etherpad.openstack.org/p/openstack-haguide-update etherpad] to capture ideas and start to form a plan for what is going to be updated, in what way, and who is responsible.
 +
 +
Meetings take place in #openstack-meeting-3. Team members may communicate on relevant topics via the [http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs OpenStack Docs] mailing list by using "[ha-guide]" at the beginning of the subject line.
 +
  
 
== Next Meeting ==
 
== Next Meeting ==
Thursday, January 22 at 9:00 pm UTC on #openstack-meeting-3
+
 
 +
There is no participants, so please just contact #beekhof on irc if we have
 +
any items to discuss.
 +
 
 +
Agenda
 +
* Info about OpenStack HA community WIP on auto-evac of instances
 +
* Addressing TODO sections of the HA guide
 +
* [[Documentation/LibertyDocTesting#HA_guide|Testing]] the HA guide how-to steps
 +
* Open discussion
 +
 
 +
== Past Meetings ==
 +
Thursday, November 19 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-11-19-20.00.txt minutes])
 +
 
 +
Agenda
 +
* Created a survey for a new meeting time
 +
* Open discussion
 +
 
 +
 
 +
Thursday, September 17 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-09-17-20.01.html minutes])
 +
 
 +
Agenda
 +
* Continue to review copy - IN PROGRESS
 +
* Create a survey for a new meeting time - IN PROGRESS
 +
 
 +
 
 +
Thursday, September 10 at 8:00 pm UTC on #openstack-meeting-3
 +
 
 +
Agenda
 +
* No meeting today
 +
 
 +
 
 +
Thursday, September 3 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-09-03-20.00.html minutes])
 +
 
 +
Agenda
 +
* Update on content review
 +
* Update on translations
 +
* Transition
 +
* New meeting times
 +
 
 +
 
 +
Thursday, August 13 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-08-13-20.00.html minutes])
 +
 
 +
Agenda
 +
* Review todo's from last meeting
 +
* Update on content review
 +
 
 +
 
 +
Thursday, August 6 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-08-06-20.01.html minutes])
 +
 
 +
Agenda
 +
* Review action items from [http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-30-20.00.html last week's minutes]
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
 
 +
 
 +
 
 +
Thursday, July 30 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-30-20.00.html minutes])
 +
 
 +
Agenda
 +
* Review action items from [http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-23-20.04.html last week's minutes]
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
 
 +
 
 +
 
 +
Thursday, July 23 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-23-20.04.html minutes])
 +
 
 +
Agenda
 +
* Review action items from [http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-16-20.07.html last week's minutes]
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
 
 +
 
 +
 
 +
Thursday, July 16 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-16-20.07.html minutes])
 +
 
 +
Agenda
 +
* Review action items from [http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-09-20.00.html last week's minutes]
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
 
 +
 
 +
Thursday, July 9 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-07-09-20.00.html minutes])
 +
 
 +
Agenda
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
 
 +
 
 +
Thursday, July 9 at 8:00 pm UTC on #openstack-meeting-3
 +
* No meeting
 +
 
 +
 
 +
Thursday, June 25 at 8:00 pm UTC on #openstack-meeting-3
 +
 
 +
Agenda
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
* Timeline update
 +
 
 +
 
 +
 
 +
Useful links:
 +
* Current build of merged content:  http://docs.openstack.org/draft/ha-guide/index.html
 +
* Working list that includes bugs associated with each topic:  https://etherpad.openstack.org/p/openstack-haguide-update-next-steps
 +
 
 +
 
 +
Thursday, June 18 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-06-18-20.00.html minutes])
 +
 
 +
Agenda
 +
* Review [https://docs.google.com/spreadsheets/d/17EApMTVzCgddR62ZYJC4qAs9imdZWDcSy81UNEae8WY/edit#gid=0 HA Guide topics status]
 +
* Need to identify writers and SMEs
 +
* Poke on reviews
 +
 
 +
 
 +
Thursday, June 11 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-06-11-20.05.html minutes])
 +
 
 +
Agenda
 +
* Review [https://mattgriffin.aha.io/published/d04139fdb37ba3edd4fa88dd0d22728a?page=2 proposed timeline]
 +
* Status on [https://etherpad.openstack.org/p/openstack-haguide-update-next-steps RST migration]
 +
* HA Guide [https://review.openstack.org/#/q/project:openstack/ha-guide,n,z reviews needed]
 +
* Other agenda topics
 +
 
 +
 
 +
Action items
 +
# mattgriffin contact the contributors that came to the room in Vancouver to contribute
 +
# mattgriffin and nickchase will do reviews of megm's CRs in https://etherpad.openstack.org/p/openstack-haguide-update-next-steps
 +
# Need a technical person to own the flow of the doc through having the Controllers configured
 +
# Meg to send Matt names of other contributors
 +
# Misc: Need a technical person to own the flow of the doc through having the Controllers configured
 +
 
 +
 
 +
Thursday, June 4 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-06-04-20.03.html minutes])
 +
 
 +
Agenda
 +
* Recap Vancouver Summit outcomes
 +
* Proposed process to convert from docbook to RST, rework structure, and add new content - [https://etherpad.openstack.org/p/openstack-haguide-update-next-steps Next Steps]
 +
# Convert existing HA Guide from docbook to RST and as much as possible in the new table of contents structure (megm leading). Focus on technical aspects of conversion. Do content changes/updates later in bugs/CRs.
 +
# Publish new Liberty HA Guide from new RST version (Current version can be viewed at http://docs.openstack.org/draft/draft-index.html, as soon as https://review.openstack.org/187687 and https://review.openstack.org/187686 are merged). Draft is available at http://docs.openstack.org/draft/ha-guide/.
 +
# Solicit reviews from PTLs and SMEs. Get them to file content bugs on incorrect technical content or gaps. (all HA Guide team)
 +
# HA Guide team writes updated content (all HA Guide team) - complete by mid-cycle?
 +
# Involve translations team as content matures
 +
# As part of this effort, we should be checking the relevant content in the Configuration Reference Guide (http://docs.openstack.org/kilo/config-reference/content/index.html) to ensure that the HA config options are represented appropriately.
 +
* Continue to accept docbook contributions to existing HA Guide? mattgriffin & megm recommend Yes.... Until the conversion is complete?
 +
 
 +
 
 +
 
 +
Thursday, May 21 at 10:45am PT in Vancouver
 +
 
 +
Agenda
 +
* HA Guide Hackathon in Vancouver - in-person and virtual ([https://plus.google.com/hangouts/_/percona.com/ha-guide Hangout link])
 +
 
 +
 
 +
Thursday, May 14 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-05-14-20.00.html minutes])
 +
 
 +
Agenda
 +
* Docs start by megm - https://review.openstack.org/#/c/182972/1
 +
* HA Guide Hackathon in Vancouver - in-person and virtual
 +
 
 +
 
 +
 
 +
Thursday, May 7 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-05-07-20.13.html minutes])
 +
 
 +
Agenda
 +
* Review changes to [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC TOC]
 +
* Spec [https://review.openstack.org/#/c/178427/ review status]
 +
* [http://git.openstack.org/cgit/openstack/ha-guide/tree/doc/ha-guide HA Guide structure] in place (Thanks Andreas! See his [http://lists.openstack.org/pipermail/openstack-docs/2015-May/006558.html announcement].)
 +
* xrefs to Install Guide. Need prototype?
 +
* Next steps to writing content
 +
 
 +
 
 +
No meeting on Thursday, April 30 at 8:00 pm UTC on #openstack-meeting-3
 +
 
 +
 
 +
Thursday, April 23 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-04-23-20.03.html minutes])
 +
 
 +
Agenda
 +
* mattgriffin: Spec ([https://etherpad.openstack.org/p/ha-guide-update-2015-spec-draft draft]) submission status
 +
* Vancouver meeting date/time for Shamail to reserve a spot - Target is Thursday from 10:45-12:15P PT for now
 +
 
 +
Welcome jpena, erikmwilson, and Nikolay_St!
 +
 
 +
 
 +
Thursday, April 16 at 8:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide_update/2015/ha_guide_update.2015-04-16-20.03.html minutes])
 +
 
 +
Agenda
 +
* Action items from last week
 +
** megm_ update the [https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide Launchpad blueprint]
 +
** mattgriffin update progress on writing a spec - [https://wiki.openstack.org/wiki/Blueprints#Spec_.2B_Blueprints_lifecycle guide] / [https://etherpad.openstack.org/p/ha-guide-update-2015-spec-draft draft] in progress
 +
** nickchase work on converting docs
 +
** nickchase review ToC with Bogdan
 +
* Do by Vancouver - Crude [https://etherpad.openstack.org/p/openstack-haguide-update-next-steps project plan] feedback?
 +
 
 +
 
 +
Thursday, April 9 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-04-09-21.02.html minutes])
 +
 
 +
Agenda
 +
* nickchase work on converting docs
 +
* nickchase review [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC ToC] with Bogdan
 +
* add priorities (P1, P2, P3, etc) next to each section title in the [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC ToC]
 +
* [https://etherpad.openstack.org/p/openstack-haguide-update-next-steps next steps?]
 +
* other items
 +
 
 +
 
 +
 
 +
Thursday, April 2 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-04-02-21.01.html minutes])
 +
 
 +
Agenda
 +
* Action items from [http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-03-26-21.02.html last meeting]
 +
* how to convert (nickchase)
 +
 
 +
 
 +
 
 +
Thursday, March 26 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide/2015/ha_guide.2015-03-26-21.02.html minutes])
 +
 
 +
Agenda
 +
* Terminology question:  "storage provider" or "storage backend"?
 +
* Action items from [http://eavesdrop.openstack.org/meetings/ha_guide_update/2015/ha_guide_update.2015-03-19-21.01.html last meeting]
 +
* update on whether people reviewed TOC and when can we consider it finalized to start making further progress
 +
 
 +
 
 +
Thursday, March 19 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide_update/2015/ha_guide_update.2015-03-19-21.01.html minutes])
 +
 
 +
Agenda
 +
* Review action items from last meeting
 +
** megm review the Docs team email draft on the pad
 +
** check with sam-i-am and nickchase on starting a "new" doc structure
 +
** mattgriffin & nickchase: enlist people
 +
* Start assigning content & sections from [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC TOC]
 +
 
 +
 
 +
Thursday, March 12 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide_update/2015/ha_guide_update.2015-03-12-20.07.html minutes])
 +
 
 +
Agenda
 +
* Review [https://etherpad.openstack.org/p/ha-guide-march-2015-update HA Guide update for Docs]
 +
* [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC Outline/TOC] update
 +
* Updates on other contributors from Mirantis, Percona, and other orgs
 +
 
 +
 
 +
Thursday, March 5 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide_update/2015/ha_guide_update.2015-03-05-21.01.html minutes])
 +
 
 +
Agenda
 +
* Review last meeting actions
 +
* Next actions. Content structure?
 +
 
 +
 
 +
 
 +
Thursday, February 26 at 9:00 pm UTC on #openstack-meeting-3
 +
 
 +
Agenda
 +
* TBD
 +
 
 +
 
 +
Thursday, February 19 at 9:00 pm UTC on #openstack-meeting-3 ([http://eavesdrop.openstack.org/meetings/ha_guide_update/2015/ha_guide_update.2015-02-19-21.01.html minutes])
 +
 
 +
Agenda
 +
# Review what we discussed last Tuesday (Feb 17) in a Hangout ([https://etherpad.openstack.org/p/openstack-basic-install-steps notes])
 +
# Update on [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC content structure]
 +
 
 +
 
 +
Action items
 +
* Review and update the [https://wiki.openstack.org/wiki/HAGuideImprovements/TOC Table of Contents]
 +
* megm_ will start to add links to the TOC for content to keep/replace and links to the related areas in the Install Guide
 +
* wait on converting until the TOC is done-ish
 +
 
 +
 
 +
Thursday, February 5 at 9:00 pm UTC on #openstack-meeting-3
 +
 
 +
Action items from last meeting:
 +
* DONE Start an discussion about content structure (see Feb 17 Hangout notes link above)
 +
* Add hangout URL to the agenda for next week on the wiki page
 +
* Continue to find and triage content bugs
 +
 
 +
Agenda
 +
# Content structure changes
 +
 
 +
 
 +
Thursday, January 29 at 9:00 pm UTC on #openstack-meeting-3 ([https://etherpad.openstack.org/p/20150129-ha-guide-update-meeting irc log])
 +
 
 +
Agenda
 +
# Bug bash results
 +
# Next steps - triage the [https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=ha-guide open bugs] and possible assignment of bugs
 +
# Update on getting added to the [https://wiki.openstack.org/wiki/Meetings#HA_Guide_Update_Meeting OpenStack Calendar]. Thanks Sriram!
 +
 
 +
 
 +
Thursday, January 22 at 9:00 pm UTC on #openstack-meeting-3 ([https://etherpad.openstack.org/p/20150122-ha-guide-update-meeting irc log])
  
 
Agenda
 
Agenda
 
# Update on ACTION items from last meeting
 
# Update on ACTION items from last meeting
## ACTION (All): Update wiki with the project that you are investigating
+
## DONE ACTION (All): Update wiki with the project that you are investigating
## ACTION (Sriram): Check how we can get this meeting on the OpenStack Calendar
+
## IN PROGRESS ACTION (Sriram): Check how we can get this meeting on the OpenStack Calendar
## ACTION (Sriram): Can we move meetings to an official IRC channel
+
## DONE ACTION (Sriram): Can we move meetings to an official IRC channel
 
# Bug bash on January 23 focused on [https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=ha-guide existing bugs]
 
# Bug bash on January 23 focused on [https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=ha-guide existing bugs]
  
== Past Meetings ==
+
 
 
Thursday, January 15 on #openstack-haguide ([https://etherpad.openstack.org/p/20150115-ha-guide-update-meeting irc log])
 
Thursday, January 15 on #openstack-haguide ([https://etherpad.openstack.org/p/20150115-ha-guide-update-meeting irc log])
 
# Regular meeting time
 
# Regular meeting time
Line 29: Line 311:
  
 
== Where ==
 
== Where ==
Join the group in #openstack-haguide to chat about this effort. Regular meetings are for 30 minutes on each Thursday at 3pm US Central.
+
Join the group in #openstack-meeting-3 to chat about this effort. Regular meetings are for 30 minutes on each Thursday at 3pm US Central.
  
 
== Project HA Status Tracker ==
 
== Project HA Status Tracker ==
Line 51: Line 333:
 
| Neutron || Aaron Rosen, Akihiro Motoki, Armando Migliaccio, Carl Baldwin, Edgar Magana, Henry Gessau, Kevin Benton, ''Kyle Mestery'', Maru Newby, Oleg Bondarev, Salvatore Orlando, Gary Kotton, Mark McClain || TBD || TBD || TBD || -- || TBD
 
| Neutron || Aaron Rosen, Akihiro Motoki, Armando Migliaccio, Carl Baldwin, Edgar Magana, Henry Gessau, Kevin Benton, ''Kyle Mestery'', Maru Newby, Oleg Bondarev, Salvatore Orlando, Gary Kotton, Mark McClain || TBD || TBD || TBD || -- || TBD
 
|-
 
|-
| Cinder || Avishay Traeger, Duncan Thomas, Eric Harney, Huang Zhiteng, Jay Bryant, John Griffith, ''Mike Perez'', Walter A. Boring IV, Xing Yang || TBD || TBD || TBD || -- || TBD
+
| Cinder || Avishay Traeger, Duncan Thomas, Eric Harney, Huang Zhiteng, Jay Bryant, John Griffith, ''Mike Perez'', Walter A. Boring IV, Xing Yang, Ivan Kolodyazhny || Active/Active || Active/Active (both cinder-volume and cinder-scheduler) || Not Applicable || Leverages HA Proxy for API HA || Michal Dulko
 
|-
 
|-
 
| Ceilometer || Angus Salkeld, Dina Belova, Doug Hellmann, ''Eoghan Glynn'', Ildiko Vancsa, Julien Danjou, Lianhao Lu, Mehdi Abaakouk, Nadya Privalova, Nejc Saje, Nick Barcet, Gordon Chung || TBD || TBD || TBD || -- || TBD
 
| Ceilometer || Angus Salkeld, Dina Belova, Doug Hellmann, ''Eoghan Glynn'', Ildiko Vancsa, Julien Danjou, Lianhao Lu, Mehdi Abaakouk, Nadya Privalova, Nejc Saje, Nick Barcet, Gordon Chung || TBD || TBD || TBD || -- || TBD
 
|-
 
|-
| Heat || ''Angus Salkeld'', Bartosz Górski, Clint 'SpamapS' Byrum, Jason Dunsmore, Jeff Peeler, Pavlo Shchelokovskyy, Randall Burt, Sergey Kraynev, Steve Baker, Steven Hardy, Thomas Herve, Thomas Spatzier, Zane Bitter || TBD || TBD || TBD || -- || TBD
+
| Heat || ''Angus Salkeld'', Bartosz Górski, Clint 'SpamapS' Byrum, Jason Dunsmore, Jeff Peeler, Pavlo Shchelokovskyy, Randall Burt, Sergey Kraynev, Steve Baker, Steven Hardy, Thomas Herve, Thomas Spatzier, Zane Bitter || Active/Active || Active/Passive - RH configures it that way || Not Applicable || Leverages HA Proxy for APIs (heat-api, heat-api-cfn), heat-engine has big HA issues - when it dies during request processing (which may take a long time), the stack will be in unrecoverable state || Michal Dulko
 
|-
 
|-
 
| Trove || Auston McReynolds, Craig Vyvial, Michael Basnight, ''Nikhil Manchanda'', Tim Simpson, Vipul Sabhaya, Amrith (Tesora),  Iccha Sethi || TBD || TBD || TBD || -- || TBD
 
| Trove || Auston McReynolds, Craig Vyvial, Michael Basnight, ''Nikhil Manchanda'', Tim Simpson, Vipul Sabhaya, Amrith (Tesora),  Iccha Sethi || TBD || TBD || TBD || -- || TBD
Line 73: Line 355:
 
Open Bugsː [https://bugs.launchpad.net/openstack/+bugs?field.tag=ha-guide Link]
 
Open Bugsː [https://bugs.launchpad.net/openstack/+bugs?field.tag=ha-guide Link]
 
# Tag to useː ha-guide
 
# Tag to useː ha-guide
 +
# Version of Book to file bugs againstː [http://docs.openstack.org/high-availability-guide/content/index.html HTML] Version
  
 
=== Suggested Priority ===
 
=== Suggested Priority ===
Line 80: Line 363:
  
 
=== Things to Note ===
 
=== Things to Note ===
 +
#Use the little 'bug' icon to auto-magically create a bug entry with relevant info such as chapter name, page, url. You can add more details like tag, description as required.
 
#Include as many details as possible, chapter #, location etc in the book.
 
#Include as many details as possible, chapter #, location etc in the book.
 
#Include OpenStack Versions if applicable
 
#Include OpenStack Versions if applicable

Latest revision as of 01:03, 26 July 2016

HA Guide Update

What

Let's update the OpenStack HA Guide. Based on direction from Anne Gentle, we will follow a similar path as the Security Guide -- subject matter experts working with core docs team members for reviews.

In addition to addressing the bug list (https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=ha-guide), this effort will update all aspects of the guide to be more current and provide richer information and advice about OpenStack HA.

We've created an etherpad to capture ideas and start to form a plan for what is going to be updated, in what way, and who is responsible.

Meetings take place in #openstack-meeting-3. Team members may communicate on relevant topics via the OpenStack Docs mailing list by using "[ha-guide]" at the beginning of the subject line.


Next Meeting

There is no participants, so please just contact #beekhof on irc if we have any items to discuss.

Agenda

  • Info about OpenStack HA community WIP on auto-evac of instances
  • Addressing TODO sections of the HA guide
  • Testing the HA guide how-to steps
  • Open discussion

Past Meetings

Thursday, November 19 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Created a survey for a new meeting time
  • Open discussion


Thursday, September 17 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Continue to review copy - IN PROGRESS
  • Create a survey for a new meeting time - IN PROGRESS


Thursday, September 10 at 8:00 pm UTC on #openstack-meeting-3

Agenda

  • No meeting today


Thursday, September 3 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Update on content review
  • Update on translations
  • Transition
  • New meeting times


Thursday, August 13 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Review todo's from last meeting
  • Update on content review


Thursday, August 6 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, July 30 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, July 23 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, July 16 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, July 9 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, July 9 at 8:00 pm UTC on #openstack-meeting-3

  • No meeting


Thursday, June 25 at 8:00 pm UTC on #openstack-meeting-3

Agenda


Useful links:


Thursday, June 18 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, June 11 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Action items

  1. mattgriffin contact the contributors that came to the room in Vancouver to contribute
  2. mattgriffin and nickchase will do reviews of megm's CRs in https://etherpad.openstack.org/p/openstack-haguide-update-next-steps
  3. Need a technical person to own the flow of the doc through having the Controllers configured
  4. Meg to send Matt names of other contributors
  5. Misc: Need a technical person to own the flow of the doc through having the Controllers configured


Thursday, June 4 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Recap Vancouver Summit outcomes
  • Proposed process to convert from docbook to RST, rework structure, and add new content - Next Steps
  1. Convert existing HA Guide from docbook to RST and as much as possible in the new table of contents structure (megm leading). Focus on technical aspects of conversion. Do content changes/updates later in bugs/CRs.
  2. Publish new Liberty HA Guide from new RST version (Current version can be viewed at http://docs.openstack.org/draft/draft-index.html, as soon as https://review.openstack.org/187687 and https://review.openstack.org/187686 are merged). Draft is available at http://docs.openstack.org/draft/ha-guide/.
  3. Solicit reviews from PTLs and SMEs. Get them to file content bugs on incorrect technical content or gaps. (all HA Guide team)
  4. HA Guide team writes updated content (all HA Guide team) - complete by mid-cycle?
  5. Involve translations team as content matures
  6. As part of this effort, we should be checking the relevant content in the Configuration Reference Guide (http://docs.openstack.org/kilo/config-reference/content/index.html) to ensure that the HA config options are represented appropriately.
  • Continue to accept docbook contributions to existing HA Guide? mattgriffin & megm recommend Yes.... Until the conversion is complete?


Thursday, May 21 at 10:45am PT in Vancouver

Agenda

  • HA Guide Hackathon in Vancouver - in-person and virtual (Hangout link)


Thursday, May 14 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, May 7 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


No meeting on Thursday, April 30 at 8:00 pm UTC on #openstack-meeting-3


Thursday, April 23 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • mattgriffin: Spec (draft) submission status
  • Vancouver meeting date/time for Shamail to reserve a spot - Target is Thursday from 10:45-12:15P PT for now

Welcome jpena, erikmwilson, and Nikolay_St!


Thursday, April 16 at 8:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Action items from last week
    • megm_ update the Launchpad blueprint
    • mattgriffin update progress on writing a spec - guide / draft in progress
    • nickchase work on converting docs
    • nickchase review ToC with Bogdan
  • Do by Vancouver - Crude project plan feedback?


Thursday, April 9 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • nickchase work on converting docs
  • nickchase review ToC with Bogdan
  • add priorities (P1, P2, P3, etc) next to each section title in the ToC
  • next steps?
  • other items


Thursday, April 2 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, March 26 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Terminology question: "storage provider" or "storage backend"?
  • Action items from last meeting
  • update on whether people reviewed TOC and when can we consider it finalized to start making further progress


Thursday, March 19 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Review action items from last meeting
    • megm review the Docs team email draft on the pad
    • check with sam-i-am and nickchase on starting a "new" doc structure
    • mattgriffin & nickchase: enlist people
  • Start assigning content & sections from TOC


Thursday, March 12 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda


Thursday, March 5 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  • Review last meeting actions
  • Next actions. Content structure?


Thursday, February 26 at 9:00 pm UTC on #openstack-meeting-3

Agenda

  • TBD


Thursday, February 19 at 9:00 pm UTC on #openstack-meeting-3 (minutes)

Agenda

  1. Review what we discussed last Tuesday (Feb 17) in a Hangout (notes)
  2. Update on content structure


Action items

  • Review and update the Table of Contents
  • megm_ will start to add links to the TOC for content to keep/replace and links to the related areas in the Install Guide
  • wait on converting until the TOC is done-ish


Thursday, February 5 at 9:00 pm UTC on #openstack-meeting-3

Action items from last meeting:

  • DONE Start an discussion about content structure (see Feb 17 Hangout notes link above)
  • Add hangout URL to the agenda for next week on the wiki page
  • Continue to find and triage content bugs

Agenda

  1. Content structure changes


Thursday, January 29 at 9:00 pm UTC on #openstack-meeting-3 (irc log)

Agenda

  1. Bug bash results
  2. Next steps - triage the open bugs and possible assignment of bugs
  3. Update on getting added to the OpenStack Calendar. Thanks Sriram!


Thursday, January 22 at 9:00 pm UTC on #openstack-meeting-3 (irc log)

Agenda

  1. Update on ACTION items from last meeting
    1. DONE ACTION (All): Update wiki with the project that you are investigating
    2. IN PROGRESS ACTION (Sriram): Check how we can get this meeting on the OpenStack Calendar
    3. DONE ACTION (Sriram): Can we move meetings to an official IRC channel
  2. Bug bash on January 23 focused on existing bugs


Thursday, January 15 on #openstack-haguide (irc log)

  1. Regular meeting time
  2. Existing bugs - Plan to resolve
  3. Need an owner for finding out from PTLs which projects work in a/a or a/p


Wednesday, October 29 on #openstack-haguide (irc log)

Where

Join the group in #openstack-meeting-3 to chat about this effort. Regular meetings are for 30 minutes on each Thursday at 3pm US Central.

Project HA Status Tracker

This section is intended to be used by the HA Guide Update team to track HA considerations for OpenStack integrated projects (created due to a request during the 01/15/15 meeting). This information will be used as we build an updated TOC and also help determine content for each project. Integrated projects information obtained from programs.yaml.

OpenStack Project Core Members (Italic = PTL) API HA Status Service HA Status Metadata HA Status Additional Comments Section Completed By
Sample John Doe, Jane Doe Active/Active Active/Passive Not Applicable Leverages HA Proxy for API HA Shamail T.
Nova Andrew Laski, Christopher Yeoh, Dan Smith, Daniel Berrange, Jay Pipes, Joe Gordon, John Garbutt, Ken'ichi Ohmichi, Kevin L. Mitchell, Matt Dietz, Matt Riedemann, Michael Still, Nikola Dipanov, OpenStack Hudson, Russell Bryant, Sean Dague TBD TBD TBD -- TBD
Swift Alistair Coles, Chmouel Boudjnah, Christian Schwede, Chuck Thier, Clay Gerrard, Darrell Bishop, David Goetz, Greg Lange, John Dickinson, Michael Barton, OpenStack Hudson, Pete Zaitcev, Peter Portante, Samuel Merritt, gholt, paul luse TBD TBD TBD -- TBD
Glance Alex Meade, Alexander Tivelkov, Arnaud Legendre, Brian Lamar, Brian Waldon, Dan Prince, Eoghan Glynn, Erno Kuvaja, Fei Long Wang, Flavio Percoco, John Bresnahan, Mark Washenberger, OpenStack Hudson, Stuart McLaren, Zhi Yan Liu, Iccha Sethi, Nikhil Komawar TBD TBD TBD -- TBD
Keystone Brant Knudson, David Stanek, Dolph Mathews, Jamie Lennox, Lance Bragstad, Morgan Fainberg, OpenStack Hudson, Steve Martinelli, A. Young, Guang Yee, Henry Nash TBD TBD TBD -- TBD
Horizon Akihiro Motoki, Ana Krivokapic, Cindy Lu, David Lyle, Gabriel Hurley, Julie Pichon, Kieran Spear, Lin Hua Cheng, Matthias Runge, Radomir Dopieralski, Tatiana Ovchinnikova, Thai Tran, Tihomir Trifonov, Zhenguo Niu TBD TBD TBD -- TBD
Neutron Aaron Rosen, Akihiro Motoki, Armando Migliaccio, Carl Baldwin, Edgar Magana, Henry Gessau, Kevin Benton, Kyle Mestery, Maru Newby, Oleg Bondarev, Salvatore Orlando, Gary Kotton, Mark McClain TBD TBD TBD -- TBD
Cinder Avishay Traeger, Duncan Thomas, Eric Harney, Huang Zhiteng, Jay Bryant, John Griffith, Mike Perez, Walter A. Boring IV, Xing Yang, Ivan Kolodyazhny Active/Active Active/Active (both cinder-volume and cinder-scheduler) Not Applicable Leverages HA Proxy for API HA Michal Dulko
Ceilometer Angus Salkeld, Dina Belova, Doug Hellmann, Eoghan Glynn, Ildiko Vancsa, Julien Danjou, Lianhao Lu, Mehdi Abaakouk, Nadya Privalova, Nejc Saje, Nick Barcet, Gordon Chung TBD TBD TBD -- TBD
Heat Angus Salkeld, Bartosz Górski, Clint 'SpamapS' Byrum, Jason Dunsmore, Jeff Peeler, Pavlo Shchelokovskyy, Randall Burt, Sergey Kraynev, Steve Baker, Steven Hardy, Thomas Herve, Thomas Spatzier, Zane Bitter Active/Active Active/Passive - RH configures it that way Not Applicable Leverages HA Proxy for APIs (heat-api, heat-api-cfn), heat-engine has big HA issues - when it dies during request processing (which may take a long time), the stack will be in unrecoverable state Michal Dulko
Trove Auston McReynolds, Craig Vyvial, Michael Basnight, Nikhil Manchanda, Tim Simpson, Vipul Sabhaya, Amrith (Tesora), Iccha Sethi TBD TBD TBD -- TBD
Ironic Chris Krelle, David Shrewsbury, Devananda van der Veen, Dmitry Tantsur, Haomeng,Wang, Jim Rollenhagen, Lucas Alvares, Ruby Loo, Yuriy Zveryanskyy, Lifeless TBD TBD TBD -- TBD
Sahara Alexander Ignatov, Andrew Lazarev, John Speidel, Matthew Farrellee, Michael McCune, Sergey Lukjanov, Sergey Reshetnyak, Trevor McKay TBD TBD TBD -- TBD

Bug Bash

  1. Whenː 01/23/2014
  2. Whereː online

Logistics

Open Bugsː Link

  1. Tag to useː ha-guide
  2. Version of Book to file bugs againstː HTML Version

Suggested Priority

  1. Pri0ː Stale/ Incorrect info (for instance wrong config, incorrect settings etc)
  2. Pri1ː Missing Info (like new chapters to add, topics to cover etc)
  3. Pri2ː Cosmetic Errors/ Sentence formation etc

Things to Note

  1. Use the little 'bug' icon to auto-magically create a bug entry with relevant info such as chapter name, page, url. You can add more details like tag, description as required.
  2. Include as many details as possible, chapter #, location etc in the book.
  3. Include OpenStack Versions if applicable