readme-burning-isos/F-7/en_US README-BURNING-ISOS.xml, NONE, 1.1 doc-entities.xml, NONE, 1.1 rpm-info.xml, NONE, 1.1

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/readme-burning-isos/F-7/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv29981/F-7/en_US

Added Files:
	README-BURNING-ISOS.xml doc-entities.xml rpm-info.xml 
Log Message:
Branch F-7 content as of 2007-05-31


--- NEW FILE README-BURNING-ISOS.xml ---
<?xml version='1.0' encoding='UTF-8'?>

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [

<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;
<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;

]>

<article id="making-discs">
  <title>Making &DISTRO; Discs</title>

  <section id="sn-introduction">
    <title>Introduction</title>
    <para>
      The &DISTRO; distribution is provided in the form of ISO 9660
      standard filesystem images. You can copy these ISO images onto
      either CDROM or DVD media to produce a bootable disc.
    </para>
    <para>
      Before you can install &DISTRO; on a computer, you must
      transfer, or <firstterm>burn</firstterm>, the ISO files to blank
      disc media (CD-R/RW or DVD-R/RW). This document describes the
      procedure for burning these files using a few common tools. This
      document assumes that you have no experience with Linux, and that
      you are using Microsoft Windows for the purpose of downloading and
      burning the files.
    </para>
  </section>

  <section id="sn-downloading">
    <title>Downloading</title>
    <para>
      The ISO files are large, and it may take a long time to download
      them, especially using a dial-up modem. You may want to use a
      download manager.
    </para>
    <section id="sn-choosing-cd-or-dvd">
      <title>Choosing CD or DVD</title>
      <para>
        &DISTRO; is distributed on multiple CD-sized ISO image files,
	or a single DVD-sized ISO image file. You can use the single DVD
	ISO file if your computer meets the following requirements:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            It has a DVD-writable or DVD-rewritable drive
          </para>
        </listitem>
        <listitem>
          <para>
            It has a NTFS drive with sufficient space to hold the image
	    file
          </para>
        </listitem>
      </itemizedlist>
      <para>
        To write the DVD ISO file to a disc, your computer needs to have
	a drive that will write to DVD media. If your computer has a
	drive that only writes CD media and not DVD media, download the
	CD-sized files instead.
      </para>
      <para>
        Some file systems cannot store files larger than 2 GB, such as
	the DVD image. The commonly-used NTFS file system does not have
	this limitation, but many other non-NTFS formats do, such as
	FAT32. To check the format of a drive under Windows such as
	<systemitem>C:</systemitem>, select the
	<guilabel>Start</guilabel> menu and then <guilabel>My
	  Computer</guilabel>. Right-click the drive you want to check,
	and choose <guilabel>Properties</guilabel>. The resulting dialog
	displays the format for that file system. If you do not have an
	NTFS drive with enough free space, download the CD-sized files
	instead.
      </para>
      <para>
        Create a new directory where you can download all of these
	files. You need approximately 700 MiB of free space available
	for each CD-sized ISO file, or approximately 3.5 GiB for the
	DVD-sized ISO file. This document assumes you have downloaded
	the files to the folder <filename class="directory">C:\Documents
	  and Settings\Owner\My Documents\My
	  Downloads\&DISTRO;</filename>.
      </para>
    </section>
    <section id="sn-choosing-iso-files">
      <title>Choosing the ISO Files</title>
      <para>
        The exact files you need from the download server depend upon
	your system and the version of &DISTRO; you are downloading.
	The files you need are named in the form of
	<filename>FC-<replaceable><version></replaceable>-<replaceable><arch></replaceable>-disc<replaceable><count></replaceable>.iso</filename>, 
	where "<replaceable><version></replaceable>" is the
	version of &DISTRO; you wish to download,
	"<replaceable><arch></replaceable>" is your computer's
	processor architecture, and
	"<replaceable><count></replaceable>" is the disc number
	for each of the installation CDs.
      </para>
      <para>
        The computer processor architecture is usually
	<systemitem>i386</systemitem> for 32-bit PCs, including the
	Pentium and Athlon processor families.  The architecture is
	usually <systemitem>x86_64</systemitem> for 64-bit PCs,
	including the Athlon 64 processor family.  The architecture is
	usually <systemitem>ppc</systemitem> for PowerPC computers,
	including most of Apple's Mac offerings. If in doubt, your
	system probably requires the <systemitem>i386</systemitem>
	versions.
      </para>
      <para>
        If you are downloading &DISTRO; &DISTROVER; for a Pentium 4
	computer, for example, you need these files:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            <filename>&FCXVERSPIN;-i386-disc1.iso</filename>
          </para>
        </listitem>
        <listitem>
          <para>
            <filename>&FCXVERSPIN;-i386-disc2.iso</filename>
          </para>
        </listitem>
        <listitem>
          <para>
            <filename>&FCXVERSPIN;-i386-disc3.iso</filename>
          </para>
        </listitem>
        <listitem>
          <para>
            <filename>&FCXVERSPIN;-i386-disc4.iso</filename>
          </para>
        </listitem>
        <listitem>
          <para>
            <filename>&FCXVERSPIN;-i386-disc5.iso</filename>
          </para>
        </listitem>
      </itemizedlist>
      <para>
        Or, if you prefer to install from a single DVD, you only need
	this file:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            <filename>&FCXVERSPIN;-i386-DVD.iso</filename>
          </para>
        </listitem>
      </itemizedlist>
      <para>
        You may also need the <code>SHA1SUM</code> file to verify that
	the files you have downloaded are complete and correct.
      </para>
    </section>
  </section>

  <section id="sn-validating-files">
    <title>Validating the Files</title>
    <para>
      Errors can occur during the download, even if your download
      manager reports none. Therefore it is <emphasis role='strong'>very
	important</emphasis> to check that the files have not been
      corrupted in any way. This is the purpose of the
      <filename>SHA1SUM</filename> file. It contains one line for each
      of the available ISO files with a content verification code called
      a <firstterm>hash</firstterm> computed from the original ISO files.
    </para>
    <para>
      <note>
        <title>BitTorrent Automatic Error Checking</title>
        <para>
          <application>BitTorrent</application> automatically performs
	  this error checking during downloads. If your
	  <application>BitTorrent</application> application reports all
	  files have been successfully downloaded, you can safely skip
	  this step.
        </para>
      </note>
    </para>
    <section id="sn-validating-in-windows">
      <title>Validating in the Windows Graphical Environment</title>
      <para>
        There are a number of free (as in cost) products available for
	file validation and hashing that have point and click
	interfaces. Here are links to a few of them:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            HashCalc: <ulink url='http://www.slavasoft.com/hashcalc/'/>
          </para>
        </listitem>
        <listitem>
          <para>
            eXpress CheckSum Calculator (XCSC): <ulink
	      url='http://www.irnis.net/soft/xcsc/'/>
          </para>
        </listitem>
      </itemizedlist>
      <para>
        Follow the instructions provided to install the program. When
	you run the program, use the file selection tools provided to
	select your downloaded ISO image files. Then select the SHA-1
	algorithm for calculation, and run the tool. The program takes
	some time to complete, since it must read the entire ISO file.
      </para>
      <para>
        Open the file <filename>SHA1SUM</filename> with a text editor,
	such as <application>WordPad</application>, to display its
	contents. Make sure the hash displayed by the hash tool for
	<emphasis role='strong'>each</emphasis> of the downloaded ISO
	files <emphasis role='strong'>exactly</emphasis> matches the
	corresponding hash in the <filename>SHA1SUM</filename> file.
      </para>
      <para>
        If all of the hashes match, you can then burn the ISO files to
	media. If a file does not match, you may have to download it
	again.
      </para>
      <para>
        <important>
          <title>CAVEAT EMPTOR</title>
          <para>
            The &FP; and &FORMAL-RHI;. have no control over
	    external sites such as the ones listed above, or the
	    programs they provide.
          </para>
        </important>
      </para>
    </section>
    <section id="sn-validating-in-windows-cmd">
      <title>Validating at the Windows Command Prompt</title>
      <para>
        To check the files using the command prompt, you need to
	download the program <filename>sha1sum.exe</filename>.  For
	instructions and the link to download the program, refer to
	<ulink
	  url='http://lists.gnupg.org/pipermail/gnupg-announce/2004q4/000184.html'/>.
      </para>
      <para>
        The <filename>sha1sum.exe</filename> program computes and
	displays hashes. To use it, save
	<filename>sha1sum.exe</filename> to the same directory as the
	ISO files. Select <guilabel>Run...</guilabel> from the Start
	menu and then enter <userinput>cmd</userinput> for the name of
	the program to start a <application>Command Prompt</application>
	window. Then change into the download directory. Run
	<command>sha1sum</command> with each ISO file like this:
      </para>
      <screen>cd "C:\Documents and Settings\Owner\My Documents\My Downloads\&DISTRO;"
sha1sum.exe &FCXVERSPIN;-i386-disc1.iso</screen>
      <para>
        The program takes some time to complete, since it must read the
	entire ISO file.
      </para>
      <para>
        Open the file <filename>SHA1SUM</filename> with a text editor,
	such as <application>WordPad</application>, to display its
	contents. Make sure the hash displayed by
	<filename>sha1sum.exe</filename> for <emphasis
	  role='strong'>each</emphasis> of the downloaded ISO files
	<emphasis role='strong'>exactly</emphasis> matches the
	corresponding hash in the <filename>SHA1SUM</filename> file.
      </para>
      <para>
        If all of the hashes match, the ISO files can be burned to
	media. If a file does not match, you may have to download it
	again.
      </para>
    </section>
  </section>

  <section id="sn-burning">
    <title>Burning</title>
    <para>
      The process of burning a CD is not always obvious to the users of
      Windows. Windows applications often let users burn data discs by
      simply dragging the source files into a box and clicking the
      <guilabel>Burn</guilabel> button.
    </para>
    <para>
      In reality, though, the burning software performs two operations.
      First, it creates an ISO 9660 standard image, just like the ones
      used to install &DISTRO;, from the source files that were
      dragged into the box. Second, it transfers that ISO file onto the
      blank CD. If the original source file was already an ISO image,
      the resulting CD is not usable for installation purposes.
    </para>
    <para>
      To create the &DISTRO; installation CDs, <emphasis role='strong'>it
	is vital that you only perform the second step</emphasis> with
      the &DISTRO; ISO files. The steps required to do this using
      several popular CD burning applications are listed below.
    </para>
    <section id="sn-iso-recorder-v2">
      <title>Using The ISO Recorder V2 Power Toy</title>
      <para>
        Obtain and install the ISO Recorder power toy from the <ulink
	  url='http://isorecorder.alexfeinman.com/isorecorder.htm'/> web
	site.
      </para>
      <procedure>
        <step>
          <para>
            In <application>Explorer</application>, right click on the
	    first &DISTRO; ISO file
          </para>
        </step>
        <step>
          <para>
            In the context menu, select <guilabel>Copy image to
	      CD</guilabel>
          </para>
        </step>
        <step>
          <para>
            Follow the steps given by the <guilabel>CD Recording
	      Wizard</guilabel> pop-up
          </para>
        </step>
        <step>
          <para>
            Repeat for the remaining ISO files
          </para>
        </step>
      </procedure>
    </section>
    <section id="sn-roxio-emc7">
      <title>Using Roxio Easy Media Creator 7</title>
      <procedure>
        <step>
          <para>
            Start <guilabel>Creator Classic</guilabel>
          </para>
        </step>
        <step>
          <para>
            Select <guilabel>Other Tasks</guilabel>
          </para>
        </step>
        <step>
          <para>
            Select <guilabel>Burn from Disc Image File</guilabel>
          </para>
        </step>
        <step>
          <para>
            Choose the first &DISTRO; ISO file and burn it
          </para>
        </step>
        <step>
          <para>
            Repeat the above steps for each of the other ISO files
          </para>
        </step>
      </procedure>
    </section>
    <section id="sn-nero-burning-rom-5">
      <title>Using Nero Burning ROM 5</title>
      <procedure>
        <step>
          <para>
            Start the program
          </para>
        </step>
        <step>
          <para>
            Open the <guimenu>File</guimenu> menu
          </para>
        </step>
        <step>
          <para>
            Select <guimenuitem>Burn Image</guimenuitem>
          </para>
        </step>
        <step>
          <para>
            Choose the first &DISTRO; ISO file and burn it
          </para>
        </step>
        <step>
          <para>
            Repeat the above steps for each of the other ISO files
          </para>
        </step>
      </procedure>
    </section>
    <section id="sn-nero-express-6">
      <title>Using Nero Express 6</title>
      <procedure>
        <step>
          <para>
            Start the program
          </para>
        </step>
        <step>
          <para>
            Select <guilabel>Disc Image or Saved Project</guilabel>
          </para>
        </step>
        <step>
          <para>
            An <guilabel>Open</guilabel> dialog appears. Select the
	    first &DISTRO; ISO file. Click <guibutton>Open</guibutton>.
          </para>
        </step>
        <step>
          <para>
            The next screen allows you to select <guilabel>Writing
	      Speed</guilabel>. You should set this to 4x for DVD, or
	    16x for CD, for best performance.
          </para>
        </step>
        <step>
          <para>
            Click Next to Burn
          </para>
        </step>
        <step>
          <para>
            Repeat the steps above for the other ISO files
          </para>
        </step>
      </procedure>
    </section>
  </section>

  <section id="sn-testing-discs">
    <title>Testing Your Discs</title>
    <para>
      In order to be certain the CDs will work on your system, you may
      wish to burn only disc 1 and then perform the following process
      before burning the others:
    </para>
    <procedure>
      <step>
        <para>
          Following the directions from your computer's manufacturer,
	  make sure your computer's BIOS is set to boot from the CD
	  drive.
        </para>
      </step>
      <step>
        <para>
          Reboot the computer with disc 1 in the CD drive.  The boot
	  menu for the &DISTRO; installer appears.
	</para>
      </step>
      <step>
        <para>
          Press <emphasis role='strong'>Enter</emphasis>.
        </para>
      </step>
      <step>
        <para>
          Follow the directions on-screen until you are asked if you
	  would like to perform a media check.
        </para>
      </step>
      <step>
        <para>
          Conduct the check against the first disc. If the check
	  succeeds, your disc is correct.  At this point the installer
	  has changed nothing on your computer. Remove the &DISTRO;
	  installation disc and restart the system so that the computer
	  boots into Windows.
	</para>
      </step>
      <step>
	<para>
	  Burn the other three ISO images. After burning the other
	  discs, you can repeat the media check to test them all.
	</para>
      </step>
    </procedure>
  </section>

  <section id="sn-feedback">
    <title>Comments and Feedback</title>
    <para>
      If you have suggestions for this document, send an email to
      relnotes AT fedoraproject.org. We welcome directions for other
      tools and platforms.
    </para>
  </section>
</article>

<!--
Local variables:
mode: xml
fill-column: 72
End:
-->


--- NEW FILE doc-entities.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE entities SYSTEM
"../../../docs-common/common/entities/entities.dtd">
<entities>
  <title>Document-specific entities</title>
  <group name="General">
    <entity name="FCXHYP">
      <comment>Short version of distro and optional hyphen</comment>
      <text><use entity="FCX"/></text>
    </entity>
    <entity name="FCXVER">
      <comment>Short version of distro name and version</comment>
      <text><use entity="FCXHYP"/><use entity="DISTROVER"/></text>
    </entity>
    <entity name="FCSPIN">
      <comment>Name of primary ISO spin</comment>
      <text>Prime</text>
    </entity>
    <entity name="FCXVERSPIN">
      <comment>Prefix for ISO file names</comment>
      <text><use entity="FCXVER"/>-<use entity="FCSPIN"/></text>
    </entity>
  </group>
</entities>


--- NEW FILE rpm-info.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE rpm-info PUBLIC "-//Fedora//DTD Docs RPM-INFO V1.0//EN"
"http://docs.fedoraproject.org/dtds/rpm-info.dtd">
<rpm-info>
  <colophon>
    <worker id="fdp" wholename="Fedora Documentation Project"
      email="fedora-docs-list at redhat.com" surname="Project" firstname="Fedora
      Documentation" initials="fdp"/>
    <worker id="PaulWFrields" wholename="Paul W. Frields"
      email="stickster at gmail.com" surname="Frields" firstname="Paul"
      othername="W." initials="PWF"/>
  </colophon>
  <author worker="fdp"/>
  <editor worker="PaulWFrields"/>
  <license>
    <rights>OPL</rights>
    <version>1.0</version>
  </license>
  <copyright>
    <year>2006</year>
    <year>2007</year>
    <holder>Red Hat, Inc. and others</holder>
  </copyright>
  <title>Burning ISO Images to Disc</title>
  <desc>How to download ISO images and create CD and DVD media</desc>
  <changelog order="newest-first">
    <revision date="2007-05-21" number="7.0.0">
      <author worker="PaulWFrields"/>
      <details>F7 final release</details>
    </revision>
  </changelog>
</rpm-info>