[Openstack-docs] Config Guide inclusions

Nermina Miller nerminamiller at gmail.com
Thu Aug 8 15:14:42 UTC 2013


No problem, then ;)


On Thu, Aug 8, 2013 at 11:08 AM, Anne Gentle
<annegentle at justwriteclick.com>wrote:

> 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
>



-- 
Thank you!

Nermina Miller
Tech Writer and Editor
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130808/be96248b/attachment-0001.html>


More information about the Openstack-docs mailing list