[OpenStack-docs] Installation guide disintegration

Matt Kassawara mkassawara at gmail.com
Thu Jul 21 00:27:36 UTC 2016


Done... 1605020, 1605021, and 1605022.

On Wed, Jul 20, 2016 at 4:51 PM, Lana Brindley <openstack at lanabrindley.com>
wrote:

> Thanks Matt,
>
> Can you create bugs for these please?
>
> L
>
> On 21/07/16 03:24, Matt Kassawara wrote:
> > I'm trying to avoid working on the installation guide outside of fixing
> bugs, but came across a patch [1] that requires a bit more effort for
> proper integration. In the patch, the Block Storage backup service depends
> on the Object Storage service. The content for the latter recently moved to
> the swift repository. While trying to fix references to the Object Storage
> service, I found the following problems:
> >
> > 1) The URLs to project-specific guides [2] return 404s, making the
> content difficult to test.
> > 2) The primary guide still references the swift storage nodes [3,4], but
> the content describing how to configure the hosts (particularly the network
> configuration) no longer exists anywhere [5]. Thus, swift is not
> installable.
> > 3) Looking at the source of some project-specific guides, the content
> varies enough to reduce or eliminate the consistency of the original guide,
> a rather important attribute for our audience. In particular, most projects
> seem to lack support for all distributions. Someone wanting to evaluate
> Zaqar may install core services on Ubuntu and only later realize the
> instructions for Zaqar only support RDO packages [6].
> >
> > [1] https://review.openstack.org/#/c/293331/
> > [2]
> http://docs.openstack.org/draft/install-guide-ubuntu/additional-services.html
> > [3] http://docs.openstack.org/mitaka/install-guide-ubuntu/overview.html
> > [4]
> http://docs.openstack.org/mitaka/install-guide-ubuntu/environment-networking.html
> > [5]
> http://docs.openstack.org/mitaka/install-guide-ubuntu/environment-networking-storage-swift.html
> > [6] https://github.com/openstack/zaqar/tree/master/install-guide/source
> >
> >
> > _______________________________________________
> > OpenStack-docs mailing list
> > OpenStack-docs at lists.openstack.org
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> >
>
> --
> 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/20160720/3752d017/attachment.html>


More information about the OpenStack-docs mailing list