Open Stack

Apologies for not sending more context here.  Short answer is that I don't think we havea problem.
Our current working strategy is to have a separate HA Installation Guide, but we do notwant to needlessly duplicate information that is in the Installation Guide so we will linkto specific sections of the Install Guide for steps that are identical for HA and non-HAinstallations, in the appropriate order.
The current etherpad document is the outline of the "clean" Install Guide, annotated withlinks to the current HA Guide just to facilitate our discussion.  We need to start with the listof steps to take, in order, to install HA OpenStack.  Then we identify the tasks that areidentical for HA and non-HA, and what is left are the steps we will write up for the HA InstallGuide, along with a bit of conceptual and introductory material.
We should indeed write up a spec when we have a better definition of the HA Guide.  But Ithink we are all in favor of the "clean" Install Guide.  We should have a discussion about howmuch linking the Install Guide has to the HA Install Guide.  I think one link at the beginningis a good idea:  "If you are setting up a production, highly available OpenStack environment,see <link-to-HA-install-Guide>."  

Whether we want additional links is a topic for discussion.  For example, in the Install Guidematerial for setting up MySQL, do we want a link that says, "If you are setting up an HA environment,follow the instructions in <link-to-HA-guide-section-about-MySQL> rather than these instructions."
Summary: the HA Installation Guide will be based on and will link to the Install Guide but shouldnot significantly modify the clean Install Guide.
Does this clarify the situation and does it seem like the right direction?meg
 
      From: Andreas Jaeger <aj at suse.com>
 To: "openstack-docs at lists.openstack.org" <openstack-docs at lists.openstack.org> 
 Sent: Monday, February 16, 2015 10:16 PM
 Subject: [OpenStack-docs] HA and Install Guide - Request for SPEC
   
Looking at the etherpad
https://etherpad.openstack.org/p/openstack-basic-install-steps, I wonder
whether the changes that are planned with enhancing the Install Guide
regarding HA are far too involved for the Install Guide.

The Install Guide describes a very limited setup that will help people
learn about OpenStack, it is not a large scale production ready setup.

HA is crucial for production ready setup. I fear that the "clean"
Install Guide that we created over the last releases will become a mess
again with far too many different options - thus loosing it's clear focus.

Before sending in patches, let's follow the good practice we have and
write a SPEC!

I'd like to see a spec written that explains what exactly you're
planning so that we can discuss the plan with a common understanding and
you can put my fears to rest.

Could those working on this create a spec, please?

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
  GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
      Graham Norton, HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126


_______________________________________________
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/20150217/fde7afbf/attachment.html>