← Back to branch summary

~ubuntu-branches/ubuntu/quantal/apt-cacher-ng/quantal-backports

« back to all changes in this revision

Viewing changes to doc/html/howtos.html

  • Committer: Bazaar Package Importer
  • Author(s): Eduard Bloch
  • Date: 2010-07-28 01:17:33 UTC
  • mfrom: (1.1.24 upstream)
  • Revision ID: james.westby@ubuntu.com-20100728011733-kocsb0jjhzu76ees
Tags: 0.5.1-1
http://bugs.debian.org/590291
* New upstream version
  + header inclusion cleanup (closes: #590291)
  + kfreebsd related fixes
  + long outstanding user interface fixes and various regression fixes

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/howtos.html
21
21
<li><a href="#jigdo">7.4 JIGDO usage</a></li>
22
22
<li><a href="#debug">7.5 Debugging</a></li>
23
23
<li><a href="#prob-proxy">7.6 Avoid use of apt-cacher-ng for certain hosts</a></li>
 
24
<li><a href="#howto-dontcache1">7.7 Avoid caching for certain domains or certain file types</a></li>
 
25
<li><a href="#howto-faster">7.8 How to make big download series faster</a></li>
24
26
</ul></li>
25
27
</ul>
26
28
<h1><a name="howtos"></a>Chapter 7: HOWTOs and FAQ</h1>
191
193
3 and 4: limited debug information is written to apt-cacher.err
192
194
</li>
193
195
<li>
194
 
5: much more debug information written to apt-cacher.err (requires a special binary, see above)
 
196
5: much more debug information written to apt-cacher.err (requires a special debug binary, see <a href="troublefaq.html#prob-freeze">section 8.2</a>)
195
197
</li>
196
198
<li>
197
199
11: like 5 but all Debug marks are printed to the log, including anonymous marks for code flow tracking.
202
204
</p>
203
205
<h2><a name="prob-proxy"></a>7.6 Avoid use of apt-cacher-ng for certain hosts</h2>
204
206
<p>
205
 
Sometimes clients might not to use apt-cacher-ng for certain hosts while accessing all others through it. Such hosts can be marked for direct access in apt configuration, e.g. in <em>/etc/apt/apt.conf</em>:
 
207
Sometimes clients might need to access some remote side directly to do some non-file-transfer oriented work but still passing the data through configured apt-cacher-ng proxy. Such remote hosts can be marked for direct access in apt configuration, e.g. in <em>/etc/apt/apt.conf</em>:
206
208
</p>
207
209
<pre><code>Acquire::HTTP::Proxy::archive.example.org "DIRECT";
208
210
//or Acquire::HTTP::Proxy::archive.example.org  "other.proxy:port"
209
211
</code></pre>
 
212
<h2><a name="howto-dontcache1"></a>7.7 Avoid caching for certain domains or certain file types</h2>
 
213
<p>
 
214
Sometimes clients to download through apt-cacher-ng but the data shall not be stored on the harddisk of the server. To get it, use the DontCache directive (see examples for details) to define such files.
 
215
</p>
 
216
<h2><a name="howto-faster"></a>7.8 How to make big download series faster</h2>
 
217
<p>
 
218
Symptom: A common situation is a periodic download of hundreds of files through apt-cacher-ng where just a half is present in the cache. Although caching works fine, there are visible delays on some files during the download.
 
219
</p>
 
220
<p>
 
221
Possible cause and relief: the download from the real mirror gets interrupted while apt-cacher-ng delivers a set of files from the internal cache. While the connection is suspended, it times out and needs to be recreated when a miss occurs, i.e. apt-cacher-ng has to fetch more from the remote mirror. A workaround to this behaviour is simple, provided that the remote mirror can handle long request queues: set the pipelining depth to a very high value in apt.conf file or one of its replacement files in /etc/apt/apt.conf.d/. With something like:
 
222
</p>
 
223
<p>
 
224
<code>Acquire::http { Pipeline-Depth "200"; } </code>
 
225
</p>
 
226
<p>
 
227
there is a higher chance to get the server connection "preheated" before a stall occurs.
 
228
</p>
210
229
 
211
230
<hr><address>Comments to <a href='mailto:blade@debian.org'>blade@debian.org</a>
212
231
<br>