OK. I will +1 this.

-- mark



On Mar 23, 2009, at 12:29 PM, John Fischer <John.Fischer at Sun.COM> wrote:

> All,
>
> I still have an empty mail log for the EOL of BDB 4.2 thus
> need a +1.
>
> We (LSARC) approved BDB 4.7 in (2008/570).  That case included
> a migration tool from BDB 4.2 to BDB 4.7.  This case deprecates
> the interfaces of BDB 4.2 in a Patch release of Solaris (i.e.,
> Solaris 10 Update) and removes them in a Minor release of Solaris
> (i.e., Solaris Nevada).  The case will provide the necessary
> documentation for the Patch release of Solaris.  The case directory
> shows the package map entries after BDB 4.2 is removed.
>
> I have attached the project proposal to this email for your convience.
>
> Thanks,
>
> John
>
>
> Template Version: @(#)onepager.txt 1.35 07/11/07 SMI
> Copyright 2007 Sun Microsystems
>
> 1. Introduction
>   1.1. Project/Component Working Name:
>        EOL of Berkeley DB 4.2 in Solaris.
>
>   1.2. Name of Document Author/Supplier:
>    Karen Langford
>
>   1.3. Date of This Document:
>    03/05/09
>
>   1.4. Name of Major Document Customer(s)/Consumer(s):
>    1.4.1. The PAC or CPT you expect to review your project:
>
>            Database PAC
>
>    1.4.2. The ARC(s) you expect to review your project:
>
>            LSARC
>
>    1.4.3. The Director/VP who is "Sponsoring" this project:
>
>            Jeffrey.Pugh at sun.com
>
>    1.4.4. The name of your business unit:
>
>            Software
>
>   1.5. Email Aliases:
>        1.5.1. Responsible Manager: Lars.Heill at sun.com
>        1.5.2. Responsible Engineer: Karen.Langford at sun.com
>        1.5.3. Marketing Manager: Rebecca.Hansen at sun.com
>    1.5.4. Interest List: sleepycat-productgroup-users at sun.com
>
> 2. Project Summary
>
>   2.1. Project Description:
>
>    The Berkeley DB (BDB) 4.2 release was approved by ARC back in
>    2003 and integrated into Nevada and Solaris in 2007.
>
>        In 2008 the latest release of Berkeley DB 4.7 was approved
>    by ARC and integrated into Nevada along with the old 4.2 release.
>
>    This project proposes the EOL and removal of the 4.2 release from
>    Nevada.
>
>
>   2.2. Previous relevant ARC cases
>
>        LSARC/2003/585 BDB 4.2 - Integrated into Solaris 10 and Nevada
>        LSARC/2008/570 BDB 4.7 - Integrated along with BDB 4.2 into  
> Nevada
>
>    Note BDB 4.2 is not in OpenSolaris, neither is 4.7.
>
>   2.3. Risks and Assumptions:
>
>        As we propose to leave 4.2 in the Solaris Updates we see no  
> risks
>    there. We will commit to delivering critical bug fixes for the  
> duration
>    of the Update's Active Service Life.
>
>    We also see no risk in regards to removing 4.2 from Nevada as S11  
> has
>    not been offically released. We contacted our sole Nevada customer,
>    Evolution, and they confirmed that they have upgraded their product
>        to use 4.7.
>
>
> 3. Business Summary
>
>   3.1. Problem Area:
>
>        As mentioned above we foresee no problems with removing 4.2  
> from Nevada.
>
>   3.2. Market/Requester:
>
>    Database Technology Group.
>
>        This was recommended in the discussions around the ARC case for
>        BDB 4.7 (LSARC/2008/570).
>
>   3.3. Business Justification:
>
>        We want to reduce the amount of resources needed to sustain  
> the old 4.2
>    release in the future.
>
>   3.4. Competitive Analysis:
>
>        N/A
>
>   3.5. Opportunity Window/Exposure:
>
>        We want to remove 4.2 from Nevada before FCS in 2010.
>
>    We also want to include the EOF announcement in the S10U7 release  
> notes.
>    Deadline is March 30, 08.
>
>
>   3.6. How will you know when you are done?:
>
>        When 4.2 has been removed from the ONNV consolidation.
>
>
> 4. Technical Description:
>
>   4.1. Details:
>
>        This project will remove the 4.2 software from the following  
> packages
>    delivered to Nevada:
>
>    SUNWbdb - Berkeley DB for C/C++ applications
>        SUNWbdbj - Berkeley DB for Java applications
>
>
>   4.2. Bug/RFE Number(s):
>
>        6813821
>
>   4.3. Doc Impact:
>
>    We will announce the EOL of 4.2 in S10U7 release notes.
>
>   4.4. Admin/Config Impact:
>
>        None.
>
>   4.5. HA Impact:
>
>        N/A
>
>   4.6. I18N/L10N Impact:
>
>        No.
>
>   4.7. Packaging & Delivery:
>
>        SUNWbdb - Berkeley DB for C/C++ applications
>        SUNWbdbj - Berkeley DB for Java applications
>
>
>        4.7.1. Packages:
>
>    Cluster id: SUNWCbdb
>    Metaclusters: SUNWCXall, SUNWCall, SUNWCprog, SUNWCuser, SUNWreq
>    Cluster name: BerkeleyDB-Base
>    Packages: SUNWbdb, SUNWbdbj
>
>
>        4.7.2. Package Layout
>
>        For both the Solaris updates and Nevada, BDB 4.2 is currently  
> installed under:
>        /usr/lib/bdb     - c utilities
>        /usr/lib         - libraries (versioned ie: libdb.so.1,  
> libdb_java.so.1)
>        /usr/share       - db.jar
>
>        In Nevada, BDB 4.7 is delivered under:
>        /usr/lib/bdb47   - c utilities
>        /usr/lib         - libraries (versioned ie: libdb.so.5,  
> libdb_java.so.5)
>        /usr/share/bdb47 - db.jar
>
>
>    4.7.3. Proposed change for Nevada delivery
>
>    We will update both packages, removing the 4.2 software prior to  
> integrating
>        into Nevada. See [1] for new package layout.
>
>
>   4.8. Upgrading
>
>    Nevada customers using 4.2 must upgrade their products to use  
> 4.7. As
>    mentioned above, Evolution, our sole customer, has already  
> upgraded their
>    product.
>
>    The topic of upgrading from 4.2 to 4.7 was discussed in LSARC  
> 2008/570,
>    below is the relevant section from that case:
>
>        "The BDB software does not automatically inform applications  
> that a new
>    release is available. The decision to upgrade must be made by the  
> customer.
>    Existing applications will continue to access the old library  
> (4.2) until
>    the user performs the manual steps required to upgrade which  
> include
>    linking to the new library and recompiling.
>
>        Before performing an upgrade customers must backup their  
> database and
>        log files.
>
>        The upgrade process for the Berkeley database requires that  
> customers
>        perform a number of manual steps. These steps are clearly  
> documented
>        in Chapter 31 of BDB's Reference manual and must be followed  
> by the customer.
>        
> http://www.oracle.com/technology/documentation/berkeley-db/db/ref/toc.html
>
>        The Berkeley database does provided a db_upgrade utility  
> which must be
>        used as part of the upgrade procedure.
>
>        The 4.7 release introduces a number of modifications to  
> existing APIs
>        in the form of method name changes, and new parameters. These
>    incompatibilities with the previous release may be transparent to a
>    customer's application, depending on how the application is coded.
>
>        An example of an API change in moving from 4.2 to 4.7: DB  
> Cursor APIs
>        were renamed from (for example) dbc->c_close() to dbc- 
> >close(). All code
>        referencing these APIs would have to be updated.
>
>        As part of the upgrade procedure each customer must determine  
> whether
>        their application requires modification based on changes  
> introduced by 4.7.
>        Again, this information is available in BDB's reference  
> manual."
>
>
>   4.9. Interfaces:
>
>        All interfaces provided by the 4.2 software will be deleted.  
> See Appendix A
>    for full list.
>
>   4.10. Security Impact:
>
>        No impact.
>
>
> 5. Reference Documents:
>
>       Berkeley DB Public Websites:
>
>          http://www.oracle.com/technology/products/berkeley-db/index.html
>
>
>       Berkeley DB 4.7.25 Release Notes:
>
>          
> http://www.oracle.com/technology/documentation/berkeley-db/db/ref/changelog/4.7.html
>
>
>       References:
>
>           [1] ./pkgmaps.txt
>
>
> 6. Resources and Schedule:
>
>   6.1. Projected Availability:
>
>        This project will be included in Nevada.
>
>    This project will not be included in S10, note S10 include BDB  
> 4.2 but not 4.7.
>
>    This project will not be included in OpenSolaris.
>
>   6.2. Cost of Effort:
>
>        Minimal; just removal of a component within packages.
>
>   6.3. Cost of Capital Resources:
>
>        None.
>
>       6.4.1. Consolidation or Component Name:
>
>        ON
>
>    6.4.3. Type of CPT Review and Approval expected:
>
>        FastTrack
>
>        6.4.4. Project Boundary Conditions:
>
>        N/A
>
>    6.4.5. Is this a necessary project for OEM agreements:
>
>               No
>
>
>   6.5. ARC review type:
>
>        FastTrack
>
>
>
> 7. Prototype Availability:
>
>   7.1. Prototype Availability:
>
>    BDB 4.7.25 binaries are available to test.
>
>
>   7.2. Prototype Cost:
>
>        Minimal.
>
>
> Appendix A
>
>        FULL LIST of EXPORTED INTERFACES in BDB 4.2.52:
>
>                            Proposed        Former Stability
>        Interface           Stability       Classification
>        Name                Classification  and Other Comments
>        ------------------  -------------    
> ----------------------------------
>        C API            Obsolete        Formerly External, Removed  
> in a
>                         Volatile        Minor release of Solaris
>        C++ API            Obsolete        Formerly External, Removed  
> in a
>                         Volatile        Minor release of Solaris
>        Java API        Obsolete        Formerly External, Removed in a
>                         Volatile        Minor release of Solaris
>        TCL API                Obsolete        Formerly External,  
> Removed in a
>                         Volatile        Minor release of Solaris
>        DB_HOME env            Obsolete        Formerly External,  
> Removed in a
>        Variable        Volatile        Minor release of Solaris
>                               Used to configure the
>                                            location of db files.
>
>        DB_CONFIG           Obsolete        Formerly External,  
> Removed in a
>        config file        Volatile        Minor release of Solaris
>                               Used to configure a
>                                            database
>
>        database file       Obsolete        Removed in a Minor  
> release of Solaris
>                Project Private
>        transaction log     Obsolete        Removed in a Minor  
> release of Solaris
>                            Project Private
>        temporary backing   Obsolete        Removed in a Minor  
> release of Solaris
>        files               Project Private
>
>        db_archive          Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_checkpoint       Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_deadlock         Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_dump             Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_load             Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_printlog         Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_recover          Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_stat             Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_upgrade          Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>        db_verify           Obsolete        Formerly Unstable,  
> Removed in a
>                Uncommitted     minor release of Solaris
>

Reply via email to