From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 22:13:06 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 52BB8106566B for ; Tue, 21 Aug 2012 22:13:06 +0000 (UTC) (envelope-from dhulme@gmail.com) Received: from mail-ob0-f182.google.com (mail-ob0-f182.google.com [209.85.214.182]) by mx1.freebsd.org (Postfix) with ESMTP id 1DC788FC08 for ; Tue, 21 Aug 2012 22:13:05 +0000 (UTC) Received: by obbun3 with SMTP id un3so491690obb.13 for ; Tue, 21 Aug 2012 15:13:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=VCuTO4X+YZ3fGESA6FPYjfq/VVf0LP72mMFY3klnLNg=; b=kb9ajxoiI4xR+qqX74xZnj2x3TrtmUEoigDXThcSXeCYVN7ylj6K9UnoNExei4Fup6 CrjjN+OqZPkMjQPA4j9FTsBJlhwt2N5YqOLDe7eKfYvqfrldVo3Ao49Gg00uZdD+ni1p yNkS3g8vxDM0akRGN7EWs7Y4Oaf56yd4xL0BrW6OXBECxpS0mMgiIsXbv7YXN7T0uPw0 NvwL9Tl/Pewo2QHWpI7W/cK18/ENOZECo4zXv3CchfqWo7gmFnYZodiNdSR4wkuIYmFO zfpGhgiOptgDaoeqk0A82+EdKy6e+4ZIDITvk21hLjCvF05dMDu3a4DeIQ/lCVjC2qL9 IhLg== MIME-Version: 1.0 Received: by 10.60.2.193 with SMTP id 1mr14088341oew.29.1345587184596; Tue, 21 Aug 2012 15:13:04 -0700 (PDT) Received: by 10.182.17.161 with HTTP; Tue, 21 Aug 2012 15:13:04 -0700 (PDT) Date: Tue, 21 Aug 2012 15:13:04 -0700 Message-ID: From: Dan Hulme To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1 Cc: Subject: http://www.freebsd.org/releases/9.0R/installation.html 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: Tue, 21 Aug 2012 22:13:06 -0000 It seems two things are missing from the update instructions, here. 1. First, is the issue that is mentioned here: http://lists.freebsd.org/pipermail/freebsd-stable/2011-October/064321.html =================================================== First, a minor change must be made to the freebsd-update code in order for it to accept file names appearing in FreeBSD 9.0 which contain the '%' and '@' characters; without this change, freebsd-update will error out with the message "The update metadata is correctly signed, but failed an integrity check". # sed -i '' -e 's/=_/=%@_/' /usr/sbin/freebsd-update =================================================== This information should be present in the installation instructions, else users (like myself) on Freebsd 8.2 will not be able to update to 9.0. 2. Second, is the issue of the src tree disappearing. The update notifies us that the src tree will be removed, due to a change in the "release packaging." This is fine, but is there some reason freebsd-update cannot download the sources on the next fetch? Even though freebsd-update.conf says to update src, it won't do it unless there is a src tree present. I recommend that the docs be updated to explain how to get your src tree back (and up to date with the current binaries from freebsd-update): =================================================== fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/9.0-RELEASE/src.txz tar -C / -xvzf src.txz rm src.txz freebsd-update fetch freebsd-update install =================================================== This is the first time I have used freebsd-update, and it is a great utility! I just would like to see the docs be detailed enough to make it possible for users like me to use it. Thanks! Dan