<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Title" content="">
<meta name="Keywords" content="">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:Calibri;
color:windowtext;}
span.msoIns
{mso-style-type:export-only;
mso-style-name:"";
text-decoration:underline;
color:teal;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style>
</head>
<body bgcolor="white" lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Thanks, Chason!<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Being spurred on by this conversation, I’ve started up another patch:
<a href="https://review.openstack.org/#/c/407508/">https://review.openstack.org/#/c/407508/</a> Removing some of the content that was simply blank, and moving some things around with the occasional cursory edit.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Reviews very welcome
</span><span style="font-size:11.0pt;font-family:Wingdings">J</span><span style="font-size:11.0pt;font-family:Calibri">
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Cheers,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Alex<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-family:Calibri;color:black">From: </span>
</b><span style="font-family:Calibri;color:black">Chason <chen.xing@99cloud.net><br>
<b>Date: </b>Tuesday, December 6, 2016 at 4:57 AM<br>
<b>To: </b>Alexandra Settle <a.settle@outlook.com>, Andrew Beekhof <abeekhof@redhat.com>, Lana Brindley <openstack@lanabrindley.com><br>
<b>Cc: </b>openstack-docs <openstack-docs@lists.openstack.org>, "aspiers@suse.com" <aspiers@suse.com><br>
<b>Subject: </b>Re: Re: Future of the HA Guide?<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.5pt;color:black">I have the same opinion with Alex. It is still worthwhile to keep HA guide in publication. I am looking forward to the spec and willing to get involved in this improving job. : )</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Thanks,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Chason<o:p></o:p></p>
<blockquote style="margin-left:6.0pt">
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<div>
<div>
<p class="MsoNormal" style="background:#EFEFEF"><b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black">From:</span></b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black"> <a href="mailto:a.settle@outlook.com">Alexandra
Settle</a><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal" style="background:#EFEFEF"><b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black">Date:</span></b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black"> 2016-12-06 17:47<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal" style="background:#EFEFEF"><b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black">To:</span></b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black"> <a href="mailto:abeekhof@redhat.com">Andrew Beekhof</a>;
<a href="mailto:openstack@lanabrindley.com">Lana Brindley</a><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal" style="background:#EFEFEF"><b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black">CC:</span></b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black"> <a href="mailto:openstack-docs@lists.openstack.org">OpenStack
Manuals</a>; <a href="mailto:chen.xing@99cloud.net">chen.xing@99cloud.net</a>; <a href="mailto:aspiers@suse.com">
aspiers@suse.com</a><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal" style="background:#EFEFEF"><b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black">Subject:</span></b><span style="font-size:9.0pt;font-family:"tahoma","serif";color:black"> Re: Future of the HA Guide?<o:p></o:p></span></p>
</div>
</div>
</div>
<div>
<div>
<p class="MsoNormal">Hey Andrew, Hey Lana,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">So, I only have one minor patch left in flight, see here: https://review.openstack.org/#/c/406882/
<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">After extensively reviewing the guide over the last two weeks I do believe it has some highly beneficial content and, now that Lana has the numbers to justify it, I sincerely believe we should keep this guide in publication.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">However, it can no longer go ignored as a background guide. There are chapters, such as this one http://docs.openstack.org/ha-guide/networking-ha.html, that literally have next to no information on it. It is a file of publicly visible TODOs.
I have filed numerous bugs here: https://bugs.launchpad.net/openstack-manuals/+bugs?field.tag=ha-guide based mostly out of the TODOs I found in the guide.
<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Thank you, Chen, for filing the blueprint. If someone has the time (and I have CC’d in Adam Spiers who also works on HA ‘stuff’ to hopefully find such a person) to go through the bugs and find what is still relevant to the guide – and then
perhaps we can go ahead and write a specification based of the plans from Andrew.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">TL;DR - If we can get the blueprint (and bugs) reviewed for relevant content, we can create the spec, and then maybe discuss a potential sprint in the near future.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Cheers,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Alex<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">On 12/6/16, 3:53 AM, "Andrew Beekhof" <abeekhof@redhat.com> wrote:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> I have no spec for this, but my plan has been to par back the guide to<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> the essentials.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> Most OpenStack services no longer need any hand-holding from a cluster<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> manager and don't need to be covered.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> Instead I think the guide should:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> 1. outline and justify an architecture<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> 2. show how to configure shared services for HA, such as haproxy,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> galera, rabbitmq<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> 3. explain in general how to configure openstack services to use the<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> shared services (haproxy for galera, node list for rabbit, etc)<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> 4. explain how to accomodate any active-passive services (ie. cinder-volume)<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> I (now) have most of this information ready in another context, what<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> remains is to shape it into a suitable format for the guide.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> I might be able to find a few days for this before christmas if that<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> would help, but it would be good to have Alexandra's efforts completed<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> first least we end up with a tonne of merge conflicts.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> -- Andrew<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> On Tue, Dec 6, 2016 at 2:32 PM, Lana Brindley<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <openstack@lanabrindley.com> wrote:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > Hi everyone,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> ><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > Seems that the HA Guide is rearing its ugly head again at the moment. It's not had a lot of attention in the past year or so, so it's gotten more and more out of date. Under the guidance of Andrew Beekhof, it's slowly improving, and
Alexandra Settle has been putting in a lot of effort recently, however it's time we decided whether or not it's worth overhauling the guide. At the moment, we have an unapproved blueprint here: https://blueprints.launchpad.net/openstack-manuals/+spec/implement-ha-guide-todos<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> ><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > So, what do you think? We know that a fair few people are looking at it (the HA Guide had 1,621 visitors in the last 30 days. Compare that to the Ubuntu Newton Install Guide which got 3,426 or the Ops Guide at 1,547 in the same period),
but it's important that if people are accessing the information that it's accurate, and we already know the HA Guide is not current. Is it better to have it there and possibly incorrect, or to remove it entirely? Can we subsume any good content in the HA Guide
into another guide (or guides)?<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> ><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > I want to make sure we have a clear direction on this guide before we commit resources to improving it. So, ideas please, before the book gets consigned to the recycling bin!<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> ><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > L<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> ><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > --<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > Lana Brindley<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > Technical Writer<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > Rackspace Cloud Builders Australia<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> > http://lanabrindley.com<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> ><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
</div>
</blockquote>
</div>
</div>
</body>
</html>