[Openstack-docs] Config Guide inclusions

Anne Gentle annegentle at justwriteclick.com
Fri Aug 9 00:38:31 UTC 2013


It is included in at least the Compute Admin and Object Storage Admin Guides and maybe more. It is reused a lot.

I'll look tomorrow to see if I have any Ubuntu specific info squirreled away related to reserved UIDs/GIDs. I don't think I do.

Anne Gentle
Content Stacker
anne at openstack.org


On Aug 8, 2013, at 5:25 PM, Summer Long <slong at redhat.com> wrote:

> Interesting, Anne, that closely matches what I put together for the Red Hat general introduction (included in all the guides so far). I like the additional 'why cloud' and 'logical architecture' sections. 
> 
> Question, is that only included in the Installation Guide? I'd sent our introduction over to Shaun McCance,  via Tom, for review towards possibly including in all intro-type docs. Obviously, that doesn't need to be done if the Getting Started intro can be used across other docs.
> 
> Nermina, are you ok with coming up with a distribution-dependant table, in case that's necessary (per Tom, sounds like it is)?
> 
> :>
> Summer
> 
> 
> Summer Long
> OpenStack Documentation
> Engineering Content Services
> 
> Red Hat Asia Pacific
> Brisbane, Australia
> slong at redhat.com
> 
> On 08/09/2013 01:14 AM, Nermina Miller wrote:
>> 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, Australia
>>>>>>>> slong at redhat.com <mailto: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/61d26103/attachment-0001.html>


More information about the Openstack-docs mailing list