From owner-svn-doc-all@FreeBSD.ORG Wed May 21 15:17:22 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 42263FF2; Wed, 21 May 2014 15:17:22 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 233B62064; Wed, 21 May 2014 15:17:22 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s4LFHMR9059904; Wed, 21 May 2014 15:17:22 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s4LFHLrP059903; Wed, 21 May 2014 15:17:21 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405211517.s4LFHLrP059903@svn.freebsd.org> From: Dru Lavigne Date: Wed, 21 May 2014 15:17:21 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44900 - head/en_US.ISO8859-1/books/handbook/bsdinstall X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 May 2014 15:17:22 -0000 Author: dru Date: Wed May 21 15:17:21 2014 New Revision: 44900 URL: http://svnweb.freebsd.org/changeset/doc/44900 Log: Editorial review of Prepare the Installation Media section. Describe the available installation files. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Wed May 21 15:13:37 2014 (r44899) +++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Wed May 21 15:17:21 2014 (r44900) @@ -431,116 +431,126 @@ Prepare the Installation Media - A &os; installation is started by booting the computer - with a &os; installation CD, - DVD, or USB memory - stick. The installer is not a program that can be run from - within another operating system. - - In addition to the standard installation media which - contains copies of all the &os; installation files, there is a - bootonly variant. Bootonly install media - does not have copies of the installation files, but downloads - them from the network during an install. The bootonly install - CD is consequently much smaller, and - reduces bandwidth usage during the install by only downloading - required files. + The &os; installer is not an application that can be run from + within another operating system. Instead, download a &os; + installation file, burn it to the media associated with its + file type and size (CD, + DVD, or USB), and boot + the system to install from the inserted media. - Copies of &os; installation media are available at &os; installation files are available at www.freebsd.org/where.html#download. - Also download CHECKSUM.SHA256 from the - same directory as the image file, and use it to check the + Each installation file's name includes the release version of + &os;, the architecture, and the type of file. For example, to + install &os; 10.0 on an &arch.amd64; system from a + DVD, download + FreeBSD-10.0-RELEASE-amd64-dvd1.iso, + burn this file to a DVD, and boot the + system with the DVD inserted. + + Several file types are available, though not all file + types are available for all architectures. The possible file + types are: + + + + -bootonly.iso: This is the smallest + installation file as it only contains the installer. A + working Internet connection is required during + installation as the installer will download the files it + needs to complete the &os; installation. This file should + be burned to a CD using a + CD burning application. + + + + -disc1.iso: This file contains all + of the files needed to install &os;, its source, and the + Ports Collection. It should be burned to a + CD using a CD + burning application. + + + + -dvd1.iso: This file contains all + of the files needed to install &os;, its source, and the + Ports Collection. It also contains a set of popular + binary packages for installing a window manager and some + applications so that a complete system can be installed + from media without requiring a connection to the Internet. + This file should be burned to a DVD + using a DVD burning application. + + + + -memstick.img: This file contains + all of the files needed to install &os;, its source, and + the Ports Collection. It should be burned to a + USB stick using the instructions + below. + + + + Also download CHECKSUM.SHA256 from the + same directory as the image file and use it to check the image file's integrity by calculating a - checksum. &os; provides &man.sha256.1; + checksum. &os; provides &man.sha256.1; for this, while other operating systems have similar programs. Compare the calculated checksum with the one shown in CHECKSUM.SHA256. The checksums must match exactly. If the checksums do not match, the file is - corrupt and should be discarded. + corrupt and should be downloaded again. - - If a copy of &os; already exists on - CD, DVD, or - USB memory stick, this section can be - skipped. - + + Burning an Image File to <acronym>USB</acronym> - &os; CD and DVD - images are bootable ISO files. Only one - CD or DVD is needed for - an install. Burn the ISO image to a - bootable CD or DVD using - the burning applications available with the current operating - system. On &os;, recording is provided by - cdrecord from - sysutils/cdrtools, installed from the Ports - Collection. - - To create a bootable memory stick, follow these - steps: - - - - Acquire the Memory Stick Image - - Memory stick images for &os; 9.0-RELEASE and - later can be downloaded from the - ISO-IMAGES/ - directory at - ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/arch/arch/ISO-IMAGES/version/&os;-version-RELEASE-arch-memstick.img. - Replace arch and - version with the architecture - and the version number to install, respectively. For - example, the memory stick images for - &os;/&arch.i386; 9.0-RELEASE are available from ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/&arch.i386;/ISO-IMAGES/9.0/&os;-9.0-RELEASE-&arch.i386;-memstick.img. - - - A different directory path is used for - &os; 8.X and earlier - versions. Details of download and installation of - &os; 8.X and earlier is - covered in . - - - The memory stick image has a .img - extension. The ISO-IMAGES/ directory - contains a number of different images, and the one needed - depends on the version of &os; being installed, and in - some cases, the target hardware. + Since the *.img file is an + image of the complete contents of a + memory stick, it cannot just be copied + to the target device. Several applications are available + for burning the *.img to a + USB stick. This section describes two + of these utilities. - Before proceeding, back up the - data on the USB stick, as this procedure will - erase it. + Before proceeding, back up any important + data on the USB stick as this procedure will + erase the existing data on the stick. - - - - Write the Image File to the Memory Stick - Using &os; to Write the Image + Using <command>dd</command> to Write the + Image - The example below shows + This example uses /dev/da0 as the target device - where the image will be written. Be very careful that - the correct device is used as the output target, as - this command will destroy existing data. + where the image will be written. Be very + careful that the correct device is used as + this command will destroy the existing data on the + specified target device. - Writing the Image with &man.dd.1; - - The .img file is - not a regular file. It is an - image of the complete contents of - the memory stick. It cannot be - copied like a regular file, but must be written - directly to the target device with &man.dd.1;: - - &prompt.root; dd if=&os;-9.0-RELEASE-&arch.i386;-memstick.img of=/dev/da0 bs=64k + The dd command-line utility is + included on BSD, Linux, and &macos; systems. To burn + the image using dd, insert the + USB stick and determine its device + name. Then, specify the name of the downloaded + installation file and the device name for the + USB stick. This example burns the + &arch.amd64; installation image to the first + USB device on an existing &os; + system. + + &prompt.root; dd if=FreeBSD-10.0-RELEASE-amd64-memstick.img of=/dev/da0 bs=64k + + Should this command fail, verify that the + USB stick is not mounted and that + the device name is for the disk, not a partition. + Depending upon the operating system, this command may + need to be issued using + sudo. @@ -549,7 +559,7 @@ Be sure to give the correct drive letter as the - output target, as existing data will be overwritten + existing data on the specified drive will be overwritten and destroyed. @@ -583,15 +593,9 @@ write the image file to the memory stick. - - - - - Installation from floppy disks is no longer - supported. - You are now ready to start installing &os;. +