From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 01:20:34 2010 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0B22E1065674 for ; Tue, 20 Jul 2010 01:20:34 +0000 (UTC) (envelope-from glen.j.barber@gmail.com) Received: from mail-vw0-f54.google.com (mail-vw0-f54.google.com [209.85.212.54]) by mx1.freebsd.org (Postfix) with ESMTP id AFC888FC12 for ; Tue, 20 Jul 2010 01:20:33 +0000 (UTC) Received: by vws19 with SMTP id 19so6707711vws.13 for ; Mon, 19 Jul 2010 18:20:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:subject:content-type; bh=qiI+M/FVVwF0NPsKsmRCvpbliQ68U6phZJV85l5BB8Q=; b=DOd1ifTNrCA/CV6KC20k6rG0OUF/VrTYlwFXujwDWv9Ku4i3EyCswKz/A2Zz3xKbtM Aytls5Yl1k0Vrc0BJqJOsIaljOSpK1zJxN8CP3gx1YiISXagqwPfRT0S549aBiomo/iW 168QKyy2zMu5v2FwhWfBMSfL5AQcuI+7eZJZE= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject :content-type; b=FSik4oQuExfeerTwBbJrxjViokSBZyIoO2l7A1KaFExjQRsQGXzTqR2rx9aQV+BXyQ q2/ro2peMrBaNU2u18DVIxUM9mIng0cQuhR0yarKt/kfmL9k+7FY/zGUPnUGBPFvTXlk g/0k9CS5+5FCmDTrLUpfMEebDNBxsd0CyUoQ4= Received: by 10.220.95.199 with SMTP id e7mr3590502vcn.278.1279588823165; Mon, 19 Jul 2010 18:20:23 -0700 (PDT) Received: from schism.local (c-71-230-240-241.hsd1.pa.comcast.net [71.230.240.241]) by mx.google.com with ESMTPS id e31sm14605866vbm.17.2010.07.19.18.20.20 (version=SSLv3 cipher=RC4-MD5); Mon, 19 Jul 2010 18:20:21 -0700 (PDT) Message-ID: <4C44F9D3.9060009@gmail.com> Date: Mon, 19 Jul 2010 21:20:19 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.4) Gecko/20100608 Thunderbird/3.1 MIME-Version: 1.0 To: doc@FreeBSD.org Content-Type: multipart/mixed; boundary="------------020702060101010000010008" Cc: Subject: docs/147347: [patch][handbook] Request for comments on memstick install instructions 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, 20 Jul 2010 01:20:34 -0000 This is a multi-part message in MIME format. --------------020702060101010000010008 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Hi, I have modified the install chapter.sgml documentation, adding instructions on installing from a USB memory stick. The patch is attached, and publicly available at: http://www.glenbarber.us/docs/handbook.install.sgml.diff The section is currently modeled after the floppy disk install section, which I did not remove as 7.3-RELEASE still contains the floppy disks on the CD; though I noted floppy disk images were not included in 8.0 and newer. I'd like to get feedback from the documentation community before filing a PR. Best regards, -- Glen Barber --------------020702060101010000010008 Content-Type: text/plain; x-mac-type="0"; x-mac-creator="0"; name="handbook.install.sgml.diff" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="handbook.install.sgml.diff" --- chapter.sgml.orig 2010-07-19 17:03:42.763886000 -0400 +++ chapter.sgml 2010-07-19 20:59:44.468894778 -0400 @@ -630,6 +630,10 @@ + A USB Memory Stick + + + A DOS partition on the same computer @@ -695,6 +699,13 @@ Acquire the Boot Floppy Images + + + Please note, as of &os; release 8.0, floppy disk + images are no longer available. Please see below for + instructions on how to install &os; using a USB memory + stick. + The boot disks are available on your installation media in the floppies/ directory, and @@ -799,6 +810,72 @@ + To create a bootable memory stick, follow these steps: + + + + Acquire the Memory Stick Image + + The memory stick image can be downloaded from the + ISO-IMAGES/ directory from + ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<arch>/ISO-IMAGES/<version>/&rel.current;-RELEASE-<arch>-memstick.img. + Replace <arch> and + <version> + with the architecture and the version number + which you want to install, respectively. + For example, the memory stick images for + &os;/&arch.i386; &rel.current;-RELEASE are available + from . + + The memory stick image has a .img extension. + The ISO-IMAGES/ directory contains a number of + different images, and the ones you will need to use depends on the + version of FreeBSD you are installing, and in some cases, the + hardware you are installing to. + + + Before proceeding, back up the + data you currently have on your USB stick, as this + procedure will erase it. + + + + + Prepare the Memory Stick + + + The example below lists /dev/da0 + as the target device from which you will be booting. Be + very careful that you have the correct device as the + output target, or you may destroy your existing + data. + + + Replacing da0 with the + device your memory stick shows up as, erase the current + data from the memory stick. + + &prompt.root; dd if=/dev/zero of=/dev/da0 bs=1k count=1 +&prompt.root; bsdlabel -Bw da0 auto +&prompt.root; newfs -L &os; /dev/da0 + + + + Write the Image File to the Memory Stick + + The .img file is + not a regular file you copy to the + memory stick. It is an image of the complete contents of + the disk. This means that you cannot + simply copy files from one disk to another. Instead, you + must use &man.dd.1; to write the images directly to the + disk: + + &prompt.root; dd if=&rel.current;-RELEASE-&arch.i386;-memstick.img of=/dev/da0 bs=10240 conv=sync + + + + You are now ready to start installing FreeBSD. --------------020702060101010000010008--