[Openstack-docs] Config Guide inclusions

Nermina Miller nerminamiller at gmail.com
Thu Aug 8 15:06:25 UTC 2013


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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130808/b43c4e5f/attachment-0001.html>


More information about the Openstack-docs mailing list