From jyri@sac.sfbay.sun.com Thu Oct 15 01:53:54 2009
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n9F8rsQ9015541
	for <LSARC-ext@sac.sfbay.sun.com>; Thu, 15 Oct 2009 01:53:54 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id n9F8rsdf020124;
	Thu, 15 Oct 2009 01:53:54 -0700 (PDT)
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 <0KRJ00D01SPUMU00@brm-avmta-1.central.sun.com>; Thu,
 15 Oct 2009 02:53:54 -0600 (MDT)
Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KRJ00DLHSPTZVE0@brm-avmta-1.central.sun.com>; Thu,
 15 Oct 2009 02:53:53 -0600 (MDT)
Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id n9F8rqFG019188; Thu, 15 Oct 2009 01:53:52 -0700 (PDT)
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 n9F8rpCf015536; Thu,
 15 Oct 2009 01:53:51 -0700 (PDT)
Received: (from jyri@localhost)	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit)
 id n9F8rpJM015532; Thu, 15 Oct 2009 01:53:51 -0700 (PDT)
Date: Thu, 15 Oct 2009 01:53:51 -0700 (PDT)
From: Jyri Virkki <jyri@sac.sfbay.sun.com>
Subject: Updating Lighttpd in OpenSolaris and repackaging spawn-fcgi
 [LSARC/2009/562 FastTrack timeout 10/22/2009]
To: LSARC-ext@sun.com
Cc: webstack-discuss@opensolaris.org
Message-id: <200910150853.n9F8rpJM015532@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 6623


I am sponsoring this case for Amanda Waite; timeout set for Oct.22.
The case updates lighttpd version and refactors its packaging.


Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 Updating Lighttpd in OpenSolaris and repackaging spawn-fcgi
    1.2. Name of Document Author/Supplier:
	 Author:  Amanda Waite
    1.3  Date of This Document:
	15 October, 2009
4. Technical Description

Updating Lighttpd in OpenSolaris and repackaging spawn-fcgi

Amanda Waite <amanda.waite@sun.com>

13 October 2009

1. Summary and motivation

    1.1. Introduction

    This project will update Lighttpd in OpenSolaris to version 1.4.23.
    As part of the upgrade, spawn-fcgi will be broken out into a
    separate package. This case also adds support for Lighttpd
    loadable modules that require the Lua programming language and
    will also include a change to the packaged Lighttpd configuration
    file requested by the upstream community.

2. Technical Description

    2.1. Details

    Version 1.4.23 of the Lighttpd web server sees the refactoring of the
    spawn-fcgi utility into a separate source distribution. This case
    proposes that we break out spawn-fcgi into a separate package
    while maintaining the Lighttpd interfaces provided by the existing
    Lighttpd packages through the use of symbolic links and
    dependencies.

    The spawn-fcgi paths delivered previously by lighttpd are retained
    but will be converted to symlinks by this case (details below).
    These symlinks are declared Obsolete and customers will be
    encouraged to start referencing spawn-fcgi by its new location.

    The symlinks will later be removed by a future case, not by this case.

    2.2. Ongoing updates

    Updates to the spawn-fcgi interfaces will delivered by the
    spawn-fcgi package (proposed as SUNWspawn-fcgi)

    2.3 Changes to loadable modules

    The mod_magnet and mod_cml loadable modules are now built against
    the Lua libraries integrated with LSARC/2009/013. mod_magnet is
    one of the key lighttpd differentiators over Apache. mod_magnet
    and mod_cml already exist in SUNWlighttpd14u but are effectively
    'stub' modules in that they do nothing.

    2.4 Changes to the configuration file

    At the request of the upstream Lighttpd community this case will remove
    the line:

    server.max-workers = 4

    from the default Lighttpd configuration file. Running Lighttpd
    with multiple workers is not supported by the upstream community.

    Upgrades to the Lighttpd packages will not clobber the existing
    configuration file.  If a user reports an issue that is fixed by
    not running with multiple workers, then they will be informed that
    they will need to modify their setup, either by moving to a single
    worker setup or by not using modules that are affected by the
    issue. A note to this effect will be added to the lighttpd.1m,
    lighttpd.1 and spawn-fcgi.1 man pages.

    2.5 spawn-fcgi

    The spawn-fcgi executable and it's manpage will be delivered as a
    separate package.

    The Lighttpd package: SUNWlighttpd14u will include a dependency on
    the spawn-fcgi package and will provide symbolic links from the
    existing locations of the executable and manpage to the locations
    delivered by the spawn-fcgi package, i.e.:

    /usr/lighttpd/1.4/bin/spawn-fcgi -> /usr/bin/spawn-fcgi

    /usr/lighttpd/1.4/share/man/man1/spawn-fcgi.1
                                       -> /usr/share/man/man1/spawn-fcgi.1

    2.6 Obsolescence of Lighttpd spawn-fcgi interfaces

    The following file paths will be obsoleted:

    /usr/lighttpd/1.4/bin/spawn-fcgi
    /usr/lighttpd/1.4/share/man/man1/spawn-fcgi.1

    Lighttpd has no specific dependency on spawn-fcgi, it has it's own
    mechanism for starting and stopping backend processes. Therefore
    it is expected that this change will have limited impact on
    existing deployments. Where spawn-fcgi is being used no change
    will be required initially as the existing file paths will be
    preserved through the use of Symbolic Links (See section 2.5).
    Once these links are removed end users will need to update
    existing scripts and services with the paths delivered by
    SUNWspawn-fcgi.

3. Spawn-fcgi technical details

    3.1. Key objects

        /usr/bin/spawn-fcgi

    3.2. Versioning

        The versioning model for spawn-fcgi is <major>.<minor>.<micro>.

        The compatibility expectations for spawn-fcgi are as follows:

        (1) Version x.y.z is compatible for different values of z,
                        such that z >= 0.
        (2) Version x.y.z is not expected to be compatible for different
                        values of x or y

    3.3 Directory Naming and Structure

        Refer to Appendix 1 for file layout.


4.
    4.1 Changes/Additions to Imported Interfaces

    NAME            STABILITY    ARC CASE         NOTES
    ---------------------------------------------------
    Lua             Uncommitted  LSARC/2009/013   Added


    4.2 Changes to Exported Interfaces

    NAME                                      STABILITY               NOTES
    ---------------------------------------------------------------------------
    /usr/lighttpd/1.4/bin/spawn-fcgi          Obsolete Uncommitted    Obsoleted
    /usr/lighttpd/1.4/man/man1/spawn-fcgi.1   Obsolete Uncommitted    Obsoleted
    SUNWspawn-fcgi                            Committed               Pkg name
    spawn-fcgi command line options           Uncommitted
    /usr/bin/spawn-fcgi                       Uncommitted             Location


5. Packaging and Delivery

   The exisiting Lighttpd packages: SUNWlighttpd14u and
   SUNWlighttpd14r will remain and the following package will be added:

   SUNWspawn-fcgi - spawn-fcgi executable and man pages

6. References


================================================================
Appendix 1: Lighttpd Integration Directory and File Structure.

1. The following files are new or updated by this case:

/usr
    /bin
        /spawn-fcgi
    /lighttpd/1.4
                 /bin
                      /spawn-fcgi=>../../../bin/spawn-fcgi
                 /man/man1
                          /spawn-fcgi.1=>../../../share/man/man1/spawn-fcgi.1
    /share/man
              /man1
                   /spawn-fcgi.1




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


From Jyri.Virkki@Sun.COM Fri Oct 16 14:52:12 2009
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 n9GLqBRG014377
	for <LSARC-ext@sac.sfbay.sun.com>; Fri, 16 Oct 2009 14:52:12 -0700 (PDT)
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 n9GLq4jH064981;
	Fri, 16 Oct 2009 15:52:10 -0600 (MDT)
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 <0KRM00A0DNEWNK00@nwk-avmta-1.sfbay.Sun.COM>; Fri,
 16 Oct 2009 14:52:08 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KRM00M2ZNEWIJ90@nwk-avmta-1.sfbay.Sun.COM>; Fri,
 16 Oct 2009 14:52:08 -0700 (PDT)
Received: from dm-usca19-13.red.iplanet.com
 (host-179-56-18-192.iplanet.com [192.18.56.179] (may be forged))
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n9GLq7vh024924; Fri,
 16 Oct 2009 21:52:07 +0000 (GMT)
Received: from buye.red.iplanet.com (buye [192.18.65.224])
	by dm-usca19-13.red.iplanet.com (8.11.7p1+Sun/8.11.7/IPLANET,v1.2)
 with ESMTP id n9GLq7J24284; Fri, 16 Oct 2009 14:52:07 -0700 (PDT)
Received: from buye.red.iplanet.com (localhost [127.0.0.1])
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7) with ESMTP id n9GLq7GP028133; Fri,
 16 Oct 2009 14:52:07 -0700 (PDT)
Received: (from jyri@localhost)
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7/Submit) id n9GLq7vE028132; Fri,
 16 Oct 2009 14:52:07 -0700 (PDT)
Date: Fri, 16 Oct 2009 14:52:07 -0700
From: Jyri Virkki <Jyri.Virkki@Sun.COM>
Subject: Re: Updating Lighttpd in OpenSolaris and repackaging spawn-fcgi
 [LSARC/2009/562 FastTrack timeout 10/22/2009]
In-reply-to: <200910150853.n9F8rpJM015532@sac.sfbay.sun.com>
To: Amanda Waite <Amanda.Waite@Sun.COM>
Cc: LSARC-ext@Sun.COM
Message-id: <20091016215207.GA28074@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
References: <200910150853.n9F8rpJM015532@sac.sfbay.sun.com>
User-Agent: Mutt/1.5.11
Status: RO
Content-Length: 405

Jyri Virkki wrote:
>
> I am sponsoring this case for Amanda Waite; timeout set for Oct.22.
> The case updates lighttpd version and refactors its packaging.

FYI I won't be here for the next two ARC meetings, if other ARC
members have a chance to review and +1 this it can get closed. If it
doesn't happen, the timeout can be extended to 11/3.


-- 
Jyri J. Virkki - jyri.virkki@sun.com - Sun Microsystems

From Jyri.Virkki@sun.com Tue Nov  3 16:41:25 2009
Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id nA40fOfT005157
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 3 Nov 2009 16:41:25 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id nA40fEuS024738;
	Wed, 4 Nov 2009 08:41:22 +0800 (SGT)
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 <0KSK0000P78WTL00@nwk-avmta-1.sfbay.Sun.COM>; Tue,
 03 Nov 2009 16:41:20 -0800 (PST)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KSK005ZF78UMAA0@nwk-avmta-1.sfbay.Sun.COM>; Tue,
 03 Nov 2009 16:41:18 -0800 (PST)
Received: from dm-usca19-13.red.iplanet.com
 (host-179-56-18-192.iplanet.com [192.18.56.179] (may be forged))
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id nA40ebpC008053; Wed,
 04 Nov 2009 00:40:37 +0000 (GMT)
Received: from buye.red.iplanet.com (buye [192.18.65.224])
	by dm-usca19-13.red.iplanet.com (8.11.7p1+Sun/8.11.7/IPLANET,v1.2)
 with ESMTP id nA40eiJ17815; Tue, 03 Nov 2009 16:40:44 -0800 (PST)
Received: from buye.red.iplanet.com (localhost [127.0.0.1])
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7) with ESMTP id nA40ebxa022851; Tue,
 03 Nov 2009 16:40:37 -0800 (PST)
Received: (from jyri@localhost)
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7/Submit) id nA40ebSN022850; Tue,
 03 Nov 2009 16:40:37 -0800 (PST)
Date: Tue, 03 Nov 2009 16:40:37 -0800
From: Jyri Virkki <Jyri.Virkki@sun.com>
Subject: Re: Updating Lighttpd in OpenSolaris and repackaging spawn-fcgi
 [LSARC/2009/562 FastTrack timeout 10/22/2009]
In-reply-to: <200910150853.n9F8rpJM015532@sac.sfbay.sun.com>
To: Amanda Waite <Amanda.Waite@sun.com>
Cc: LSARC-ext@sun.com, webstack-discuss@opensolaris.org
Message-id: <20091104004037.GA22752@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
References: <200910150853.n9F8rpJM015532@sac.sfbay.sun.com>
User-Agent: Mutt/1.5.11
Status: RO
Content-Length: 294

Jyri Virkki wrote:
> 
> I am sponsoring this case for Amanda Waite; timeout set for Oct.22.
> The case updates lighttpd version and refactors its packaging.

For the email record, this case was approved at the Oct.20 LSARC meeting. 

-- 
Jyri J. Virkki - jyri.virkki@sun.com - Sun Microsystems

