From owner-freebsd-doc@FreeBSD.ORG Fri Oct 16 18:00:14 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 364E61065672 for ; Fri, 16 Oct 2009 18:00:14 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id E64CC8FC1B for ; Fri, 16 Oct 2009 18:00:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n9GI0DS9085433 for ; Fri, 16 Oct 2009 18:00:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n9GI0DUh085432; Fri, 16 Oct 2009 18:00:13 GMT (envelope-from gnats) Resent-Date: Fri, 16 Oct 2009 18:00:13 GMT Resent-Message-Id: <200910161800.n9GI0DUh085432@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jason Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0256A1065693 for ; Fri, 16 Oct 2009 17:55:17 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id E3A2B8FC16 for ; Fri, 16 Oct 2009 17:55:16 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n9GHtGhk036264 for ; Fri, 16 Oct 2009 17:55:16 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n9GHtGge036247; Fri, 16 Oct 2009 17:55:16 GMT (envelope-from nobody) Message-Id: <200910161755.n9GHtGge036247@www.freebsd.org> Date: Fri, 16 Oct 2009 17:55:16 GMT From: Jason To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/139681: [PATCH] new article on creating an internal FreeBSD Update Server X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Oct 2009 18:00:14 -0000 >Number: 139681 >Category: docs >Synopsis: [PATCH] new article on creating an internal FreeBSD Update Server >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Fri Oct 16 18:00:13 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Jason >Release: 7.2-RELEASE-p4 >Organization: Experts Exchange >Environment: No problem >Description: Update to my article. >How-To-Repeat: Not a problem. >Fix: Patch attached with submission follows: *** article.sgml.orig Thu Oct 15 10:48:39 2009 --- article.sgml Thu Oct 15 11:07:31 2009 *************** *** 1,5 **** --- 1,6 ---- + %articles.ent; FreeBSD Update Server"> ]> *************** *** 62,72 **** An ssh account on a remote machine to upload the distributed updates, &man.ssh.1;. ! A web server, with over half of the the space required for the build. For instance, my builds total 4G, and the webserver space needed to distribute updates is 2.6G. --- 63,73 ---- An ssh account on a remote machine to upload the distributed updates, &man.ssh.1;. ! An Apache web server, with over half of the the space required for the build. For instance, my builds total 4G, and the webserver space needed to distribute updates is 2.6G. *************** *** 78,88 **** Configuration: Installation & Setup ! Download the freebsd-update-server software. There is a tarball that can be downloaded, or you can csup projects-all, &man.csup.1;. Update scripts/build.conf appropriately for your environment. It is sourced during build and push operations. --- 79,89 ---- Configuration: Installation & Setup ! Download the freebsd-update-server software. There is a tarball that can be downloaded, or you can csup projects-all, &man.csup.1;. Update scripts/build.conf appropriately for your environment. It is sourced during build and push operations. *************** *** 173,184 **** cc -O2 -fno-strict-aliasing -pipe unstamp.c -o unstamp install findstamps ../bin install unstamp ../bin rm -f findstamps unstamp Generating RSA private key, 4096 bit long modulus ! ...............................................................................++ ! ..................++ e is 65537 (0x10001) Public key fingerprint: 27ef53e48dc869eea6c3136091cc6ab8589f967559824779e855d58a2294de9e --- 174,185 ---- cc -O2 -fno-strict-aliasing -pipe unstamp.c -o unstamp install findstamps ../bin install unstamp ../bin rm -f findstamps unstamp Generating RSA private key, 4096 bit long modulus ! ................................................................................++ ! ...................++ e is 65537 (0x10001) Public key fingerprint: 27ef53e48dc869eea6c3136091cc6ab8589f967559824779e855d58a2294de9e *************** *** 1188,1198 **** Updates for the current release of the &os; system you are updating, and what you want to upgrade to need to be built in order for your internal &os; Update Server to properly work. This is necessary for merging of files between the releases. ! You are not ready to test the updates you've uploaded. Update client's KeyPrint and ServerName in /etc/freebsd-update.conf, and perform updates as instructed in the &os; Update instructions in the handbook. Building a Patch --- 1189,1199 ---- Updates for the current release of the &os; system you are updating, and what you want to upgrade to need to be built in order for your internal &os; Update Server to properly work. This is necessary for merging of files between the releases. ! You are now ready to test the updates you've uploaded. Update client's KeyPrint and ServerName in /etc/freebsd-update.conf, and perform updates as instructed in the &os; Update instructions in the handbook. Building a Patch *************** *** 1983,1997 **** Add make -j NUMBER to scripts/build.subr to speed up your processing. I have found that adding flags to anything other than make buildworld and make obj can be unreliable. ! Create a firewall rule to block outgoing RST packets. Due to a bug noted in this posting by the the author of freebsd-update-server, you will have many many time-outs and fail to update a system without many pains along the way. I have found that the bug still exists in my adventures with this software. ! I haven't experimented with this just yet, however if you create an SRV record for your update server, and put others behind it with variable weights, that would be the equivalent of creating mirrors. Please read the source documentation, as well, as I have not experimented with all features of the software. --- 1984,2001 ---- Add make -j NUMBER to scripts/build.subr to speed up your processing. I have found that adding flags to anything other than make buildworld and make obj can be unreliable. ! Create a firewall rule to block outgoing RST packets. Due to a bug noted in this posting by the author of freebsd-update-server, you will have many time-outs and fail to update a system. ! If you create an appropriate DNS server SRV record for your update server, and put others behind it with variable weights, that would be the equivalent of creating mirrors. ! _http._tcp.update.myserver.com. IN SRV 0 2 80 host1.myserver.com. ! SRV 0 1 80 host2.myserver.com. ! SRV 0 0 80 host3.myserver.com. Please read the source documentation, as well, as I have not experimented with all features of the software. >Release-Note: >Audit-Trail: >Unformatted: