From jyri@sac.sfbay.sun.com Thu Feb 28 17:44:06 2008
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m1T1i52J026312
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 28 Feb 2008 17:44:05 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m1T1i3bM016267;
	Fri, 29 Feb 2008 01:44:04 GMT
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0JWZ00G198TFU900@brm-avmta-1.central.sun.com>; Thu,
 28 Feb 2008 18:44:03 -0700 (MST)
Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0JWZ008XK8TEXY60@brm-avmta-1.central.sun.com>; Thu,
 28 Feb 2008 18:44:02 -0700 (MST)
Received: from sac.sfbay.sun.com (new-sac.SFBay.Sun.COM [129.146.175.65])
	by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id m1T1i0N1020058; Thu, 28 Feb 2008 17:44:00 -0800 (PST)
Received: from sac.sfbay.sun.com (localhost [127.0.0.1])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m1T1T0RI026019; Thu,
 28 Feb 2008 17:29:00 -0800 (PST)
Received: (from jyri@localhost)	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit)
 id m1T1T0Hl026015; Thu, 28 Feb 2008 17:29:00 -0800 (PST)
Date: Thu, 28 Feb 2008 17:29:00 -0800 (PST)
From: Jyri Virkki <jyri@sac.sfbay.sun.com>
Subject: Apache 2.2 config samples directory structure [PSARC/2008/163 Self
 Review]
To: PSARC-ext@sun.com
Cc: seema.alevoor@sun.com, webstack-discuss@opensolaris.org
Message-id: <200802290129.m1T1T0Hl026015@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.2.0.264296
Status: RO
Content-Length: 2094


I am sponsoring this case for Seema Alevoor and closing it approved automatic.


Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 Apache 2.2 config samples directory structure
    1.2. Name of Document Author/Supplier:
	 Author:  Seema Alevoor
    1.3  Date of This Document:
	28 February, 2008
4. Technical Description

Apache 2.2 config samples directory structure

Background: 

PSARC/2007/586 "Including Apache 2.2.6 with Solaris" approved the
integration of Apache 2.2.6 into Nevada with the following
configuration directory structure (later PSARC/2008/118 updated Apache
to 2.2.8):

       /etc/apache2/[version]
                             /conf.d/
                             /original/
                             /original/extra/
            
As a recap, the contents under /etc/apache2/[version]/original/extra
directory were delivered as-is from the Apache distribution and these
files are never read by the server. They are there as examples only.

This location has proven confusing and users find it hard to find the
example configuration files. Furthermore, since these files were
delivered as-is, not all of them necessarily even work in OpenSolaris.
This led to even more confusion when users attempted to copy them
into the config directory and found that didn't work.

To improve the user experience, this project creates a new directory,
"samples-conf.d", under /etc/apache2/[version] directory.  It will
contain the sample configuration files with any and all necessary
OpenSolaris-specific modifications. This will enable the user to use
them by simply copying them to conf.d directory.

This project removes the redundant 
/etc/apache2/[version]/original/extra/ directory.


Exported Interfaces
-------------------
/etc/apache2/2.2/samples-conf.d     Uncommitted


6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		sfw
    6.5. ARC review type: Automatic
    6.6. ARC Exposure: open


From John.Plocher@sun.com Thu Feb 28 20:10:20 2008
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m1T4AJVC000420
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 28 Feb 2008 20:10:19 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m1T4ADMQ006131
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 29 Feb 2008 04:10:18 GMT
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0JWZ00G03FL47900@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@Sun.COM); Thu, 28 Feb 2008 20:10:16 -0800 (PST)
Received: from sca-es-mail-2.sun.com ([192.18.43.133])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0JWZ00EJAFL4L1E0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.COM); Thu,
 28 Feb 2008 20:10:16 -0800 (PST)
Received: from fe-sfbay-09.sun.com ([192.18.43.129])
	by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m1T4AGTD004905	for
 <PSARC-ext@Sun.COM>; Thu, 28 Feb 2008 20:10:16 -0800 (PST)
Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0JWZ00401FFL2W00@fe-sfbay-09.sun.com>
 (original mail from John.Plocher@Sun.COM)
 for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Thu,
 28 Feb 2008 20:10:16 -0800 (PST)
Received: from wp668.local ([208.74.177.212])
 by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb
 28 2007)) with ESMTPSA id <0JWZ00J5GFL32V40@fe-sfbay-09.sun.com>; Thu,
 28 Feb 2008 20:10:15 -0800 (PST)
Date: Thu, 28 Feb 2008 20:10:13 -0800
From: John Plocher <John.Plocher@sun.com>
Subject: Re: Apache 2.2 config samples directory structure [PSARC/2008/163 Self
	Review]
In-reply-to: <200802290129.m1T1T0Hl026015@sac.sfbay.sun.com>
Sender: John.Plocher@sun.com
To: Jyri Virkki <jyri@sac.sfbay.sun.com>
Cc: PSARC-ext@sun.com, Seema.Alevoor@sun.com, webstack-discuss@opensolaris.org
Message-id: <47C785A5.6010507@Sun.Com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.2.0.264296
References: <200802290129.m1T1T0Hl026015@sac.sfbay.sun.com>
User-Agent: Thunderbird 2.0.0.9 (Macintosh/20071031)
Status: RO
Content-Length: 2634

Have you looked at how debian does this?

IIRC, they have a whole dir structure that deals with sites, configs and modules
that is managed with symlinks rather than editing config files...

It might be worth looking at, even if the end result is an informed "no thanks"...

    -John


Jyri Virkki wrote:
> I am sponsoring this case for Seema Alevoor and closing it approved automatic.
> 
> 
> Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
> This information is Copyright 2008 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
> 	 Apache 2.2 config samples directory structure
>     1.2. Name of Document Author/Supplier:
> 	 Author:  Seema Alevoor
>     1.3  Date of This Document:
> 	28 February, 2008
> 4. Technical Description
> 
> Apache 2.2 config samples directory structure
> 
> Background: 
> 
> PSARC/2007/586 "Including Apache 2.2.6 with Solaris" approved the
> integration of Apache 2.2.6 into Nevada with the following
> configuration directory structure (later PSARC/2008/118 updated Apache
> to 2.2.8):
> 
>        /etc/apache2/[version]
>                              /conf.d/
>                              /original/
>                              /original/extra/
>             
> As a recap, the contents under /etc/apache2/[version]/original/extra
> directory were delivered as-is from the Apache distribution and these
> files are never read by the server. They are there as examples only.
> 
> This location has proven confusing and users find it hard to find the
> example configuration files. Furthermore, since these files were
> delivered as-is, not all of them necessarily even work in OpenSolaris.
> This led to even more confusion when users attempted to copy them
> into the config directory and found that didn't work.
> 
> To improve the user experience, this project creates a new directory,
> "samples-conf.d", under /etc/apache2/[version] directory.  It will
> contain the sample configuration files with any and all necessary
> OpenSolaris-specific modifications. This will enable the user to use
> them by simply copying them to conf.d directory.
> 
> This project removes the redundant 
> /etc/apache2/[version]/original/extra/ directory.
> 
> 
> Exported Interfaces
> -------------------
> /etc/apache2/2.2/samples-conf.d     Uncommitted
> 
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>    	6.4.1. Consolidation C-team Name:
> 		sfw
>     6.5. ARC review type: Automatic
>     6.6. ARC Exposure: open
> 
> _______________________________________________
> opensolaris-arc mailing list
> opensolaris-arc@opensolaris.org


From Seema.Alevoor@sun.com Fri Feb 29 01:04:10 2008
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m1T94At9007246
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 29 Feb 2008 01:04:10 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m1T945fO058634
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 29 Feb 2008 02:04:10 -0700 (MST)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0JWZ0021FT6YHD00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@Sun.COM); Fri, 29 Feb 2008 01:04:10 -0800 (PST)
Received: from sineb-mail-1.sun.com ([192.18.19.6])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0JWZ00CO3T6V0R50@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.COM); Fri,
 29 Feb 2008 01:04:08 -0800 (PST)
Received: from fe-apac-05.sun.com
 (fe-apac-05.sun.com [192.18.19.176] (may be forged))
	by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m1T94CR1006447	for
 <PSARC-ext@Sun.COM>; Fri, 29 Feb 2008 09:04:12 +0000 (GMT)
Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com
 (Sun Java System Messaging Server 6.2-6.01 (built Apr  3 2006))
 id <0JWZ00C01T5B1E00@mail-apac.sun.com>
 (original mail from Seema.Alevoor@Sun.COM)
 for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Fri,
 29 Feb 2008 17:04:07 +0800 (SGT)
Received: from [129.158.228.102] by mail-apac.sun.com
 (Sun Java System Messaging Server 6.2-6.01 (built Apr  3 2006))
 with ESMTPSA id <0JWZ0066YT6UKKO5@mail-apac.sun.com>; Fri,
 29 Feb 2008 17:04:07 +0800 (SGT)
Date: Fri, 29 Feb 2008 14:44:16 +0530
From: Seema Alevoor <Seema.Alevoor@sun.com>
Subject: Re: [webstack-discuss] Apache 2.2 config samples directory	structure
 [PSARC/2008/163 Self	Review]
In-reply-to: <47C785A5.6010507@Sun.Com>
Sender: Seema.Alevoor@sun.com
To: John Plocher <John.Plocher@sun.com>
Cc: Jyri Virkki <jyri@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        webstack-discuss@opensolaris.org
Message-id: <47C7CCE8.8070607@sun.com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.2.0.264296
References: <200802290129.m1T1T0Hl026015@sac.sfbay.sun.com>
 <47C785A5.6010507@Sun.Com>
User-Agent: Thunderbird 2.0.0.6 (X11/20070802)
Status: RO
Content-Length: 3579



John Plocher wrote:
> Have you looked at how debian does this?
> 
> IIRC, they have a whole dir structure that deals with sites, configs and modules
> that is managed with symlinks rather than editing config files...

One does not have to always edit the config file. Editing is needed only when the user
wants to customize the settings.
And, of course symlink, too, can be created, but not recommended because the
files in samples-conf.d get overwritten during upgrade whereas the ones in
conf.d are retained.

  > It might be worth looking at, even if the end result is an informed "no thanks"...
> 

Yes, I did look at debian's structure. Theirs is more granular
(e.g., .load file for every individual module) which leads to too many configuration files.
Apache 2.2.6 and above is something in-between and not very different from what was
supported earlier.
If required, we can think of supporting such a configuration, in future, as
it involves many more changes.


Thanks,
Seema.

> 
> Jyri Virkki wrote:
>> I am sponsoring this case for Seema Alevoor and closing it approved automatic.
>>
>>
>> Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
>> This information is Copyright 2008 Sun Microsystems
>> 1. Introduction
>>     1.1. Project/Component Working Name:
>> 	 Apache 2.2 config samples directory structure
>>     1.2. Name of Document Author/Supplier:
>> 	 Author:  Seema Alevoor
>>     1.3  Date of This Document:
>> 	28 February, 2008
>> 4. Technical Description
>>
>> Apache 2.2 config samples directory structure
>>
>> Background: 
>>
>> PSARC/2007/586 "Including Apache 2.2.6 with Solaris" approved the
>> integration of Apache 2.2.6 into Nevada with the following
>> configuration directory structure (later PSARC/2008/118 updated Apache
>> to 2.2.8):
>>
>>        /etc/apache2/[version]
>>                              /conf.d/
>>                              /original/
>>                              /original/extra/
>>             
>> As a recap, the contents under /etc/apache2/[version]/original/extra
>> directory were delivered as-is from the Apache distribution and these
>> files are never read by the server. They are there as examples only.
>>
>> This location has proven confusing and users find it hard to find the
>> example configuration files. Furthermore, since these files were
>> delivered as-is, not all of them necessarily even work in OpenSolaris.
>> This led to even more confusion when users attempted to copy them
>> into the config directory and found that didn't work.
>>
>> To improve the user experience, this project creates a new directory,
>> "samples-conf.d", under /etc/apache2/[version] directory.  It will
>> contain the sample configuration files with any and all necessary
>> OpenSolaris-specific modifications. This will enable the user to use
>> them by simply copying them to conf.d directory.
>>
>> This project removes the redundant 
>> /etc/apache2/[version]/original/extra/ directory.
>>
>>
>> Exported Interfaces
>> -------------------
>> /etc/apache2/2.2/samples-conf.d     Uncommitted
>>
>>
>> 6. Resources and Schedule
>>     6.4. Steering Committee requested information
>>    	6.4.1. Consolidation C-team Name:
>> 		sfw
>>     6.5. ARC review type: Automatic
>>     6.6. ARC Exposure: open
>>
>> _______________________________________________
>> opensolaris-arc mailing list
>> opensolaris-arc@opensolaris.org
> 
> _______________________________________________
> 
> 
> webstack-discuss mailing list
> webstack-discuss@opensolaris.org
> http://mail.opensolaris.org/mailman/listinfo/webstack-discuss

