[Openstack-docs] Config Guide inclusions

Anne Gentle annegentle at justwriteclick.com
Thu Aug 8 15:08:43 UTC 2013


Sure, but realize that with git-based work, it merges in, and if it can't
resolve the merge, a human makes sure it all works together still. So we
don't have to "lock" any given file. Which to me is full of win!

Anne


On Thu, Aug 8, 2013 at 10:06 AM, Nermina Miller <nerminamiller at gmail.com>wrote:

> Anne and Summer,
>
> Since I'm working on the rewrite of Getting Started, should we wait till
> that process is done to make these edits? I have Mirantis SMEs looking at
> it and I'm updating simultaneously.
>
> Thank you both!
>
> Nermina
>
>
> On Thu, Aug 8, 2013 at 9:00 AM, Anne Gentle <annegentle at justwriteclick.com
> > wrote:
>
>> 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
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>
>
> --
> Thank you!
>
> Nermina Miller
> Tech Writer and Editor
>



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


More information about the Openstack-docs mailing list