[Openstack-docs] Config Guide inclusions

Nermina Miller nerminamiller at gmail.com
Thu Aug 8 22:59:14 UTC 2013


No problem, Summer. Would be happy too! Is all of the info included in the
initial email? Thanks! - Nermina


On Thu, Aug 8, 2013 at 6: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, 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
>
>
>


-- 
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/68da2f22/attachment.html>


More information about the Openstack-docs mailing list