| >          It also removes some of the tuning directives, and adds
| >          newer directives. The removed directives do not cause squid
| >          to fail if present.
| 
| You'll want to say a bit more here. From the earlier thread, my
| understanding was that if these are present in the config, squid will
| log a warning to inform user the directive is no longer valid and then
| continue to function normally. If so, document that.

updated,
 
| Do some of the added directives map to some of the removed directives?
| If so, case should document "directive old_directive is obsoleted and
| replaced with new_directive" for whichever case(s) that might be true.

no, the removed directives do not map to the new ones.

| >         The default values of various directives has also been changed.
| 
| Any incompatibilities introduced by this?

None. I have updated the ARC to document these and the impact.

| If customer left those directives out of their config and relied on
| the defaults, now changed, can they experience any incompatible
| behavior after upgrade?

no

 
| >         A new project private file has been added (logfile-daemon), another
| >         project private file (sasl_auth) has been renamed to 
(squid_sasl_auth)
| 
| Since(if?) you confirmed these are project private implementation
| detail, no reason to mention it.
 
 
| >     3.1. Exported Interfaces
| >                          
| >     NAME                            STABILITY      NOTES
| >                          
| >     /usr/squid/libexec/                             Executable location
| >             logfile-daemon          Project Private    
| >             squid_sasl_auth         Project Private    
| 
| Is everything else in /usr/squid/libexec/ Project Private (refer to
| previous case)? If so, no real reason to list those two.

Yes, they were, but I had enumerated all of them. I will remove it from
the current ARC.

| (If some things in the dir are public but other private, then it's
| good to list them so it is clear which is which. OTOH if previous case
| declared /usr/squid/libexec/* to be Project Private then it is
| unambiguous these new ones are as well, so no reason to list.)


| What's missing in the exported interface table is:

| - the removed directives: previous classification: XYZ
|   (I don't remember value of XYZ, look up in previous case)
|   new classification: Obsolete XYZ

| - the added directives; their interface classification

In the previous squid ARC
http://sac.sfbay.sun.com/WSARC/2007/554/materials/squid.txt
the directives were not listed, only the directory structure was
enumerated. Please let me know what I should do for this?
(list all the directives (under what classification) or to list the
newly added directives?)


Updated ARC case attached.
                                    rahul
--
1. e4 _
-------------- next part --------------
Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
         Squid 2.7STABLE5
    1.2. Name of Document Author/Supplier:
         Author: Rahul Nair
    1.3  Date of This Document:
        16 February, 2009
4. Technical Description
Update Squid Proxy Server to 2.7STABLE5 in OpenSolaris
                          
1. Introduction
    1.1. Project/Component Working Name:
                          
         Update Squid Proxy Server to 2.7STABLE5 within OpenSolaris
                          
    1.2. Name of Document Author/Supplier:
                         
         Author:  Rahul Nair  (rahul.g.nair at sun.com)
                         
    1.3  Date of This Document:
                         
         16 February, 2009
                         
2. Technical Description
                         
    2.1. Update Squid to 2.7STABLE5
                         
         WSARC/2007/554 "Including Squid 2.6.STABLE16 with Solaris SXDE"
         approved the integration of Squid 2.6.STABLE16.
                         
         Now that Squid has released the next major version, 2.7STABLE5,
         this project updates the integrated Squid version to 2.7STABLE5. [1]
                         
         This version includes a number of general bug fixes and optimizations
         It also removes some of the tuning directives, and adds newer
         directives. The removed directives do not cause squid to fail if 
present.
         The behavior of squid when these directives are present is to issue a 
         warning message and continue normally.

         The removed directives are
             incoming_icp_average
             incoming_http_average
             incoming_dns_average
             min_icp_poll_cnt
             min_dns_poll_cnt
             min_http_poll_cnt

         The added directives are
             acl myportname
             authenticate_ip_shortcircuit_ttl
             authenticate_ip_shortcircuit_access
             zph_mode
             zph_local
             zph_sibling
             zph_parent
             zph_option
             update_headers
             logfile_daemon
             netdb_filename
             storeurl_rewrite_program
             storeurl_rewrite_children
             storeurl_rewrite_concurrency
             storeurl_access
             rewrite_access
             rewrite
             max_stale
             server_http11
             ignore_expect_100
             external_refresh_check
             delay_body_max_size
             ignore_ims_on_miss
             max_filedescriptors
             accept_filter
             incoming_rate
             zero_buffers

        The default values of various directives has also been changed.
            cache
                  - recommended defaults modified, no change in actual values
            cache_dir 
                  - change of option name from read-only to no-store    
                  - accepts both options as of now.
            cache_peer
            external_acl_type
                  - new options
            acl
                  - recommended defaults changed, no change in actual values
                  - new options
            icp_access
                   - recommended defaults changed, no change in actual values
            http_access
                   - recommended defaults changed, no change in actual values
            http[s]_port
                   - new options
            logformat
                   - new options
            refresh_pattern
                   - new options
            url_rewrite_program
                   - new extensions
            forwarded_for
                   - new modes
             

        Three new languages has been added to the localization.
            Ukrainian-1251
            Ukrainian-koi8-u
            Ukrainian-utf8
        
                         
        There are no other changes nor any other interface changes introduced
        by this case.
                         
        Squid 2.7STABLE5 Changelog can be found here.
        
http://mirrors.dotsrc.org/squid/squid-2/STABLE/squid-2.7.STABLE1-RELEASENOTES.html
                         
3. Interfaces
                         
    3.1. Exported Interfaces
                         
    NAME                            STABILITY      NOTES
                         
                         
3.  References
                         
    [1]  http://www.squid-cache.org/A
    [2] 
http://mirrors.dotsrc.org/squid/squid-2/STABLE/squid-2.7.STABLE1-RELEASENOTES.html
                         
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

Reply via email to