Open Stack

The HA guide, similar to our other operational guides, needs contributions
from operators or developers of deployment tools that implement HA. Without
recent relevant content, we're just restructuring defunct content and/or
making assumptions that don't benefit our audience. At this point, the HA
guide needs a rip-and-replace by people who also commit themselves to
keeping the content fresh... or just archive it.

On Tue, Dec 6, 2016 at 6:55 AM, Alexandra Settle <a.settle at outlook.com>
wrote:

> Thanks, Chason!
>
>
>
> Being spurred on by this conversation, I’ve started up another patch:
> https://review.openstack.org/#/c/407508/ Removing some of the content
> that was simply blank, and moving some things around with the occasional
> cursory edit.
>
>
>
> Reviews very welcome J
>
>
>
> Cheers,
>
>
>
> Alex
>
>
>
> *From: *Chason <chen.xing at 99cloud.net>
> *Date: *Tuesday, December 6, 2016 at 4:57 AM
> *To: *Alexandra Settle <a.settle at outlook.com>, Andrew Beekhof <
> abeekhof at redhat.com>, Lana Brindley <openstack at lanabrindley.com>
> *Cc: *openstack-docs <openstack-docs at lists.openstack.org>, "
> aspiers at suse.com" <aspiers at suse.com>
> *Subject: *Re: Re: Future of the HA Guide?
>
>
>
> 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. : )
>
>
>
> Thanks,
>
>
>
> Chason
>
>
>
> *From:* Alexandra Settle <a.settle at outlook.com>
>
> *Date:* 2016-12-06 17:47
>
> *To:* Andrew Beekhof <abeekhof at redhat.com>; Lana Brindley
> <openstack at lanabrindley.com>
>
> *CC:* OpenStack Manuals <openstack-docs at lists.openstack.org>;
> chen.xing at 99cloud.net; aspiers at suse.com
>
> *Subject:* Re: Future of the HA Guide?
>
> Hey Andrew, Hey Lana,
>
>
>
> So, I only have one minor patch left in flight, see here:
> https://review.openstack.org/#/c/406882/
>
>
>
> 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.
>
>
>
> 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.
>
>
>
> 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.
>
>
>
> 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.
>
>
>
> Cheers,
>
>
>
> Alex
>
>
>
> On 12/6/16, 3:53 AM, "Andrew Beekhof" <abeekhof at redhat.com> wrote:
>
>
>
>     I have no spec for this, but my plan has been to par back the guide to
>
>     the essentials.
>
>     Most OpenStack services no longer need any hand-holding from a cluster
>
>     manager and don't need to be covered.
>
>
>
>     Instead I think the guide should:
>
>     1. outline and justify an architecture
>
>     2. show how to configure shared services for HA, such as haproxy,
>
>     galera, rabbitmq
>
>     3. explain in general how to configure openstack services to use the
>
>     shared services (haproxy for galera, node list for rabbit, etc)
>
>     4. explain how to accomodate any active-passive services (ie.
> cinder-volume)
>
>
>
>     I (now) have most of this information ready in another context, what
>
>     remains is to shape it into a suitable format for the guide.
>
>     I might be able to find a few days for this before christmas if that
>
>     would help, but it would be good to have Alexandra's efforts completed
>
>     first least we end up with a tonne of merge conflicts.
>
>
>
>     -- Andrew
>
>
>
>
>
>
>
>
>
>     On Tue, Dec 6, 2016 at 2:32 PM, Lana Brindley
>
>     <openstack at lanabrindley.com> wrote:
>
>     > Hi everyone,
>
>     >
>
>     > 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
>
>     >
>
>     > 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)?
>
>     >
>
>     > 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!
>
>     >
>
>     > L
>
>     >
>
>     > --
>
>     > Lana Brindley
>
>     > Technical Writer
>
>     > Rackspace Cloud Builders Australia
>
>     > http://lanabrindley.com
>
>     >
>
>
>
>
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20161206/9ec4009a/attachment-0001.html>