svn commit: r48693 - head/en_US.ISO8859-1/books/handbook/jails

[Warren Block]

Author: wblock
Date: Thu Apr 21 01:56:43 2016
New Revision: 48693
URL: https://svnweb.freebsd.org/changeset/doc/48693

Log:
  Add a tip on setting ezjail to download packages using HTTP rather than
  FTP.  The content from the bug report was rewritten.
  
  PR:		208941
  Submitted by:	Dan Bright <freebsd at zaziork.com>

Modified:
  head/en_US.ISO8859-1/books/handbook/jails/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/jails/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/jails/chapter.xml	Wed Apr 20 22:07:36 2016	(r48692)
+++ head/en_US.ISO8859-1/books/handbook/jails/chapter.xml	Thu Apr 21 01:56:43 2016	(r48693)
@@ -1121,6 +1121,22 @@ Created clone interfaces: lo1.</screen>
 	  jail.  <filename>/var/ports</filename> inside each jail is
 	  also used as a work directory when building ports.</para>
       </tip>
+
+      <tip>
+	<para>The <acronym>FTP</acronym> protocol is used by default
+	  to download packages for the installation of the basejail.
+	  Firewall or proxy configurations can prevent or interfere
+	  with <acronym>FTP</acronym> transfers.  The
+	  <acronym>HTTP</acronym> protocol works differently and
+	  avoids these problems.  It can be chosen by specifying a
+	  full <acronym>URL</acronym> for a particular download mirror
+	  in <filename>/usr/local/etc/ezjail.conf</filename>:</para>
+
+	<programlisting>ezjail_ftphost=http://<replaceable>ftp.FreeBSD.org</replaceable></programlisting>
+
+	<para>See <xref linkend="mirrors-ftp"/> for a list of
+	  sites.</para>
+      </tip>
     </sect2>
 
     <sect2 xml:id="jails-ezjail-create">