[OpenStack-docs] Installation guide disintegration

Lana Brindley openstack at lanabrindley.com
Wed Jul 20 22:51:14 UTC 2016


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

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 538 bytes
Desc: OpenPGP digital signature
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20160721/15a5c264/attachment.pgp>


More information about the OpenStack-docs mailing list