<div dir="ltr">I plan to make a more detailed post to the OpenStack documentation mailing list regarding the installation guide development process, but here's a quick list of prerequisites:<div><div><br></div><div>1) Installation guide contributors often find packaging bugs long before "test days" for any distribution. For some distributions, we provide the only "real world" testing. Packagers should take advantage of our labor by providing a process to address potential bugs in a timely fashion.</div><div><br></div><div>2) Packages become available at a known and consistent location at some point during the milestone tags, ideally a bit over a month before the official upstream release, and update in a timely fashion to include at least one release candidate for each project. Release packages become available, at least for testing, within a week of the upstream release.</div><div><br></div><div>3) Packages follow best practices for deployment. In most cases, this simply involves including upstream example configuration files with default values. If a project requires generation of example configuration files, run the necessary procedure prior to packaging it.</div><div><br></div><div>4) Packages only reference upstream configuration files in standard locations (e.g., /etc/keystone).</div></div><div><br></div><div>Matt</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 15, 2015 at 8:43 AM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">----- Original Message -----<br>
> From: "Rich Bowen" <<a href="mailto:rbowen@redhat.com">rbowen@redhat.com</a>><br>
> To: <a href="mailto:rdo-list@redhat.com">rdo-list@redhat.com</a><br>
> Sent: Thursday, October 15, 2015 9:01:03 AM<br>
> Subject: Re: [Rdo-list] Fwd: [OpenStack-docs] [install-guide] Status of RDO<br>
><br>
> Just to follow up:<br>
><br>
> <a href="http://docs.openstack.org/" rel="noreferrer" target="_blank">http://docs.openstack.org/</a><br>
><br>
> Installation Guide for Debian 8 (not yet available)<br>
><br>
> Installation Guide for Red Hat Enterprise Linux 7, CentOS 7, and Fedora<br>
> 22 (not yet available)<br>
><br>
><br>
><br>
> --Rich<br>
<br>
</span>To get this updated what is required is for someone to walk through the draft install guide [1] vetting each procedure on each target distro and updating the test matrix here:<br>
<br>
    <a href="https://wiki.openstack.org/wiki/Documentation/LibertyDocTesting" rel="noreferrer" target="_blank">https://wiki.openstack.org/wiki/Documentation/LibertyDocTesting</a><br>
<br>
We also need to determine which "known issues" need to be resolved, and document + file bugs for any new ones that pop up (and ideally resolve them). In future as part of the RDO test day I think we should:<br>
<br>
a) Broadcast where the correct packages are more widely (e.g. include <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a> in the distribution list for the test day). There seems to be a contention that they weren't available or were available but were mixed up with Mitaka packages which was true at a point in time but was quickly resolved (there was an issue with the config files being shipped though).<br>
<br>
b) Integrate the install guide test matrix into the test day so that we (the RDO community) can help drive vetting it earlier.<br>
<br>
Thanks,<br>
<br>
Steve<br>
<br>
<br>
[1] <a href="http://docs.openstack.org/draft/install-guide-rdo/" rel="noreferrer" target="_blank">http://docs.openstack.org/draft/install-guide-rdo/</a><br>
<div class="HOEnZb"><div class="h5"><br>
> On 10/14/2015 07:49 AM, Rich Bowen wrote:<br>
> > I wanted to be certain that everyone has seen this message to<br>
> > OpenStack-docs, and the subsequent conversation at<br>
> > <a href="http://lists.openstack.org/pipermail/openstack-docs/2015-October/007622.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack-docs/2015-October/007622.html</a><br>
> ><br>
> ><br>
> > This is quite serious, as Lana is basically saying that RDO isn't a<br>
> > viable way to deploy OpenStack in Liberty, and so it's being removed<br>
> > from the docs.<br>
> ><br>
> > It would be helpful if someone closer to Liberty packages, and Delorean,<br>
> > could participate there in a constructive way to bring this to a happy<br>
> > conclusion before the release tomorrow.<br>
> ><br>
> > Thanks.<br>
> ><br>
> > --Rich<br>
> ><br>
> ><br>
> > -------- Forwarded Message --------<br>
> > Subject: [OpenStack-docs] [install-guide] Status of RDO<br>
> > Date: Wed, 14 Oct 2015 16:22:45 +1000<br>
> > From: Lana Brindley <<a href="mailto:openstack@lanabrindley.com">openstack@lanabrindley.com</a>><br>
> > To: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a> <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>><br>
> ><br>
> > -----BEGIN PGP SIGNED MESSAGE-----<br>
> > Hash: SHA256<br>
> ><br>
> > Hi everyone,<br>
> ><br>
> > We've been unable to obtain good pre-release packages from Red Hat for<br>
> > the Fedora and Red Hat/CentOS repos, despite our best efforts. This has<br>
> > left the RDO Install Guide in a largely untested state, so I don't feel<br>
> > confident publishing it at this stage.<br>
> ><br>
> > As far as we can tell, Fedora are no longer planning on having<br>
> > pre-release packages available, so this might be a permanent change for<br>
> > that OS. For Red Hat/CentOS, it seems to be a temporary problem, so<br>
> > hopefully we can get the packages, complete testing, and publish the<br>
> > book soon.<br>
> ><br>
> > The patch to remove RDO is here, for anyone who cares to comment:<br>
> > <a href="https://review.openstack.org/#/c/234584/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/234584/</a><br>
> ><br>
> > Lana<br>
> ><br>
> > - -- Lana Brindley<br>
> > Technical Writer<br>
> > Rackspace Cloud Builders Australia<br>
> > <a href="http://lanabrindley.com" rel="noreferrer" target="_blank">http://lanabrindley.com</a><br>
> > -----BEGIN PGP SIGNATURE-----<br>
> > Version: GnuPG v2<br>
> > Comment: Using GnuPG with Thunderbird - <a href="http://www.enigmail.net/" rel="noreferrer" target="_blank">http://www.enigmail.net/</a><br>
> ><br>
> > iQEcBAEBCAAGBQJWHfS1AAoJELppzVb4+KUyM7cH/ii5Ekz5vjTe3dTykXBUbWGt<br>
> > bR2XJTAbS/mFB+xayecNNPLvgejI6Nxvk8msSFNnN7/ZyDNwr+eceQw7ftMKuJnR<br>
> > h7qKBb6o5iayLJxgNRK3Kjo13NjGdaiXwfLTbB5br/aiP2HHsrDRexAcLteUCKGt<br>
> > eHbZUEYqg4VADUvodxNpbZ+7fHuXrIRZoH4aDQ4+o1p0dCdw+vkjzF/MzPSgZFar<br>
> > Rq9L94rpofDat9ymuW48c+SgUeOnmTvxwEN8ExTENNMXo4nUOJwcUS65J6XURO9K<br>
> > RUGvjPmSmm7ZaQGE+koKyGZSzF/Oqoa+vBUwxdeQqmtr2tWo//jlUVV/PDc8QV0=<br>
> > =rQp4<br>
> > -----END PGP SIGNATURE-----<br>
> ><br>
> > _______________________________________________<br>
> > OpenStack-docs mailing list<br>
> > <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
> ><br>
> ><br>
> > _______________________________________________<br>
> > Rdo-list mailing list<br>
> > <a href="mailto:Rdo-list@redhat.com">Rdo-list@redhat.com</a><br>
> > <a href="https://www.redhat.com/mailman/listinfo/rdo-list" rel="noreferrer" target="_blank">https://www.redhat.com/mailman/listinfo/rdo-list</a><br>
> ><br>
> > To unsubscribe: <a href="mailto:rdo-list-unsubscribe@redhat.com">rdo-list-unsubscribe@redhat.com</a><br>
><br>
><br>
> --<br>
> Rich Bowen - <a href="mailto:rbowen@redhat.com">rbowen@redhat.com</a><br>
> OpenStack Community Liaison<br>
> <a href="http://rdoproject.org/" rel="noreferrer" target="_blank">http://rdoproject.org/</a><br>
><br>
> _______________________________________________<br>
> Rdo-list mailing list<br>
> <a href="mailto:Rdo-list@redhat.com">Rdo-list@redhat.com</a><br>
> <a href="https://www.redhat.com/mailman/listinfo/rdo-list" rel="noreferrer" target="_blank">https://www.redhat.com/mailman/listinfo/rdo-list</a><br>
><br>
> To unsubscribe: <a href="mailto:rdo-list-unsubscribe@redhat.com">rdo-list-unsubscribe@redhat.com</a><br>
><br>
<br>
</div></div><span class="im HOEnZb">--<br>
Steve Gordon, RHCE<br>
Sr. Technical Product Manager,<br>
Red Hat Enterprise Linux OpenStack Platform<br>
<br>
</span><div class="HOEnZb"><div class="h5">_______________________________________________<br>
Rdo-list mailing list<br>
<a href="mailto:Rdo-list@redhat.com">Rdo-list@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/rdo-list" rel="noreferrer" target="_blank">https://www.redhat.com/mailman/listinfo/rdo-list</a><br>
<br>
To unsubscribe: <a href="mailto:rdo-list-unsubscribe@redhat.com">rdo-list-unsubscribe@redhat.com</a><br>
</div></div></blockquote></div><br></div>