[Openstack-docs] Config Guide inclusions

Anne Gentle annegentle at justwriteclick.com
Thu Aug 8 13:00:21 UTC 2013


A while back I fixed this bug:
https://bugs.launchpad.net/openstack-manuals/+bug/1160757
with this patch:
https://review.openstack.org/#/c/26950/3/doc/src/docbkx/common/getstart.xml
Which offered a lot more explanation of services, daemons, and so forth.
The file I updated is common/getstart.xml. I think this info can go there.
Since it's reused many places, do not use conditional markup in that file.

Anne


On Wed, Aug 7, 2013 at 7:14 PM, Summer Long <slong at redhat.com> wrote:

>  Hi Tom,
> Yes, I can see your point. Am just thinking about whether folks will find
> it if they are not in the middle of an OpenStack install?
>
> Are all of the values really distribution dependant? If so, and if the
> installation really is the better place, then putting them into
> distribution Installation guides probably would work better.
>
> Other opinions?
>
> cheers, Summer
>
>  Summer Long
> OpenStack Documentation
> Engineering Content Services
>
> Red Hat Asia Pacific
> Brisbane, Australia
> slong at redhat.com
>
>  On 08/08/2013 09:58 AM, Tom Fifield wrote:
>
> Hmm, nice one!
>
> My initial impression is that this information is most useful to users
> on installation (planning systems), rather than post-install
> 'fixing'/configuration.
>
> It's also raised some interesting questions in my mind about whether the
> configuration reference is distribution agnostic - since uid/gids are
> different between RHEL and ubuntu if I remember correctly. My feeling is
> that to be more low maintenance (which was one of the driving factors in
> the creation of the config reference), we probably want it to be "just
> about OpenStack", rather than doing conditional formatting for
> rhel/ubuntu/suse etc. However, I also have the feeling that we'll end up
> with more of these situations and I'll break down :)
>
> Can we move this discussion to the mailing list?
>
> Regards,
>
>
> Tom
>
> On 08/08/13 07:22, Summer Long wrote:
>
>  Hi Tom,
> I just got a request to put the reserved uids/guids used by OpenStack
> somewhere in the documentation. So that configurers can know what
> products pull in which uid/gids/software, and also in case they are
> assigning uids/gids to other third-party software or systems.
>
> It feels like the Configuration Reference is the right place. Have you
> had any requests for these?
> For example:
>
> keystone:x:163:163:OpenStack Keystone Daemons:/var/lib/keystone:sbin/nologin
> glance:x:161:161:OpenStack Glance Daemons:/var/lib/glance:/sbin/nologin
> cinder:x:165:165:OpenStack Cinder Daemons:/var/lib/cinder:/sbin/nologin
> nova:x:162:162:OpenStack Nova Daemons:/var/lib/nova:/sbin/nologin
>
> Plus neutron, swift, ceilometer, heat?
>
> And if we're including info for third-party glue, then possibly:
>
> mysql:x:27:27:MySQL Server:/var/lib/mysql:/bin/bash
> qpidd:x:498:499:Owner of Qpidd Daemons:/var/lib/qpidd:/sbin/nologin
> nagios:x:496:495::/var/spool/nagios:/sbin/nologin
>
> What do you think?
> thanks, Summer
> --
> Summer Long
> OpenStack Documentation
> Engineering Content Services
>
> Red Hat Asia Pacific
> Brisbane, Australiaslong at redhat.com <mailto:slong at redhat.com> <slong at redhat.com>
>
>
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>


-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130808/953739f3/attachment.html>


More information about the Openstack-docs mailing list