<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>8637</bug_id>
          
          <creation_ts>2015-11-03 20:11:57 +0000</creation_ts>
          <short_desc>proxy settings are not accurate for SOCKS proxy</short_desc>
          <delta_ts>2016-02-05 11:04:40 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>General Docs</product>
          <component>docs-general</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>04 Feb 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.1 M3</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Liam R. Howlett">liam.howlett</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>bogdanx.a.voiculescu</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>srifenbark</cc>
          
          <qa_contact name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</qa_contact>
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>56159</commentid>
    <comment_count>0</comment_count>
    <who name="Liam R. Howlett">liam.howlett</who>
    <bug_when>2015-11-03 20:11:57 +0000</bug_when>
    <thetext>https://wiki.yoctoproject.org/wiki/Working_Behind_a_Network_Proxy is not correct for socks proxy.

wget of https://eula-downloads.yoctoproject.org/index.php in CONNECTIVITY_CHECK_URIS will fail, and thus the user will get the message:

 Failed to fetch test data from the network. Please ensure your network is configured correctly.

Please update the wiki and any other documentation in regards to proxy to state that SOCKS proxy need the user to:

export SOCKS_SERVER=`server:port`
unset http_proxy
unset https_proxy
unset ftp_proxy</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>57869</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-01-15 15:43:54 +0000</bug_when>
    <thetext>Hi, 

I don&apos;t update the wiki so we need someone to do that.  I could update it if needed but I don&apos;t understand what changes specifically need to be made.  I would need help from someone relating the information from Liam into the actual wiki page.  

In the ref-manual, there are two FAQ entries that deal with proxy: 14.12 and 14.22.  You can see these in the FAQ section (http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#faq)

Regarding 14.12, it says:

  Most source fetching by the OpenEmbedded build system is done by wget 
  and you therefore need to specify the proxy settings in a .wgetrc file 
  in your home directory. Here are some example settings:

     http_proxy = http://proxy.yoyodyne.com:18023/
     ftp_proxy = http://proxy.yoyodyne.com:18023/
                
  The Yocto Project also includes a site.conf.sample file that shows how to 
  configure CVS and Git proxy servers if needed. 

Would we just replace the two example settings with:

  export SOCKS_SERVER=`server:port`
  unset http_proxy
  unset https_proxy
  unset ftp_proxy

Regarding FAQ 14.22.  It looks to me like that would not change?  Again, I am no expert on this stuff so I need some guidance.  

These are the only two areas in the YP doc set I believe would be impacted for this issue.  Comments?

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58459</commentid>
    <comment_count>2</comment_count>
    <who name="Liam R. Howlett">liam.howlett</who>
    <bug_when>2016-02-02 16:20:14 +0000</bug_when>
    <thetext>No, we should not just replace the example.  These are two different types of proxies.

We should leave what is there but add another topic about the socks type of proxy.

Perhaps something like:

  Most source fetching by the OpenEmbedded build system is done by wget 
  and you therefore need to specify the proxy settings in a .wgetrc file 
  in your home directory. Below are some example settings for different
  proxy types.

  Http/FTP proxy:
     http_proxy = http://proxy.yoyodyne.com:18023/
     ftp_proxy = http://proxy.yoyodyne.com:18023/

  socks proxy:
     export SOCKS_SERVER=`server:port`
     unset http_proxy
     unset https_proxy
     unset ftp_proxy
                
  The Yocto Project also includes a site.conf.sample file that shows how to 
  configure CVS and Git proxy servers if needed. 

===============

Should the site.conf.sample be updated as well?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58460</commentid>
    <comment_count>3</comment_count>
    <who name="Liam R. Howlett">liam.howlett</who>
    <bug_when>2016-02-02 16:24:26 +0000</bug_when>
    <thetext>Scott, is this enough information to unblock your work on the bug?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58588</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-04 16:23:20 +0000</bug_when>
    <thetext>Thanks, 

I will see where I can work that into the docs... I could add a new FAQ entry specifically to address it.  I will send a review link when I get something in.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58595</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-04 16:47:55 +0000</bug_when>
    <thetext>Liam,

After looking more closely at your suggestion, I see that you meant to add another example to the existing 14.12 FAQ entry.  Take a look at 14.12 in http://www.yoctoproject.org/docs/temp/ref-manual/ref-manual.html#faq and let me know.  It is basically verbatim to what you suggested.  I did assume that the line:

export SOCKS_SERVER=`server:port`

should have &quot;server&quot; and &quot;port&quot; as user-input values so you will see that they are both formatted in italics, which indicate real values must be provided.

Let me know if this works.

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58597</commentid>
    <comment_count>6</comment_count>
    <who name="Liam R. Howlett">liam.howlett</who>
    <bug_when>2016-02-04 16:53:51 +0000</bug_when>
    <thetext>Hello Scott,

This looks good with one caviate:

/etc/wgetrc has an entry that is not in the wiki for HTTPS.  I noticed this since the socks example has an unset for https_proxy

See below (from /etc/wgetrc):

# You can set the default proxies for Wget to use for http, https, and ftp.
# They will override the value in the environment.
#https_proxy = http://proxy.yoyodyne.com:18023/
#http_proxy = http://proxy.yoyodyne.com:18023/
#ftp_proxy = http://proxy.yoyodyne.com:18023/


I think this should be added to the non-socks configuration example.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58598</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-04 16:58:48 +0000</bug_when>
    <thetext>Liam, 

Ok - I have added that to the example.  You can see it at http://www.yoctoproject.org/docs/temp/ref-manual/ref-manual.html#faq for 4.12.  I will mark this as RESOLVED now and set the doc flag to &quot;done.&quot;  

Thanks for you help!

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58634</commentid>
    <comment_count>8</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2016-02-05 11:04:40 +0000</bug_when>
    <thetext>Verified on http://www.yoctoproject.org/docs/temp/ref-manual/ref-manual.html#idm45853935249216</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>