svn commit: r46664 - head/en_US.ISO8859-1/articles/hubs

Brad Davis brd at FreeBSD.org
Thu May 7 14:48:36 UTC 2015


Author: brd
Date: Thu May  7 14:48:35 2015
New Revision: 46664
URL: https://svnweb.freebsd.org/changeset/doc/46664

Log:
  Add small section explaining we are not allowing public mirrors of packages and possible workarounds.
  
  Reviewed by:	decke

Modified:
  head/en_US.ISO8859-1/articles/hubs/article.xml

Modified: head/en_US.ISO8859-1/articles/hubs/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/hubs/article.xml	Thu May  7 13:59:45 2015	(r46663)
+++ head/en_US.ISO8859-1/articles/hubs/article.xml	Thu May  7 14:48:35 2015	(r46664)
@@ -328,6 +328,27 @@
       <screen>&prompt.user; <userinput>rsync -vaHz --delete rsync://bit0.us-west.freebsd.org/FreeBSD-www-data/ /usr/local/www/</userinput>
       </screen>
    </sect2>
+   <sect2 xml:id="mirror-pkgs">
+     <title>Mirroring Packages</title>
+     <para>Due to very high requirements of bandwidth, storage and
+       adminstration the &os; Project has decided not to allow public
+       mirrors of packages.  For sites with lots of machines, it might
+       be advantagous to run a caching HTTP proxy for the &man.pkg.8;
+       process.  Alternatively specific packages and their dependencies
+       can be fetched by running something like the following:</para>
+
+     <screen>&prompt.user; <userinput>pkg fetch -d -o <replaceable>/usr/local/mirror</replaceable> <replaceable>vim</replaceable></userinput></screen>
+
+     <para>Once those packages have been fetched, the repository metadata must be generated by running:</para>
+
+     <screen>&prompt.user; <userinput>pkg repo <replaceable>/usr/local/mirror</replaceable></userinput></screen>
+
+     <para>Once the packages have been fetched and the metadata for the
+       repository has been generated, serve the packages up to the
+       client machines via HTTP.  For additional information see the
+       man pages for &man.pkg.8;, specifically the pkg-repo(8) page.
+     </para>
+   </sect2>
    <sect2 xml:id="mirror-how-often">
      <title>How often should I mirror?</title>
      <para>


More information about the svn-doc-all mailing list