Sorry for the inconvenience. Chance of typos in templates, the navigation header should be functional for most versions of the handbook.
Potential remains for unforeseen breakage primarily in the handbook portion of the wiki.
Notice will be up until above verified and no other troubles found from recent modifications.
Burning the Installation Media/9.2
(Sorry for the inconvenience)
Once you have downloaded and verified the PC-BSD file, you will need to burn it to the correct media. This section demonstrates how to do so using several different applications and operating systems. It assumes that you have downloaded the correct ISO file for your media (CD or DVD), that your CD or DVD reader is capable of burning, and that you have inserted a blank or rewritable disk into the burner.
Burning the CD/DVD ISO File on Windows
Several burning applications are available for Windows. This section will demonstrate how to use Windows 7's Disc Image Burner, ImgBurn, and InfraRecorder.
Windows 7 Disc Image Burner
Windows 7 has built-in support for writing ISO images to disc. Right-click on the .iso file in Windows Explorer and select Open with ➜ Windows Disc Image Burner to open the screen shown in Figure 2.7.1a. Click "Burn" to write the disc. See the Microsoft article Burn a CD or DVD from an ISO file for more detailed instructions.
Figure 2.7.1a: Windows Disc Image Burner
ImgBurn is an easy to use image burner for Windows that is available for free download. After installing and launching ImgBurn, select "Write image file to disk" from the main menu, seen in Figure 2.7.1b:
Figure 2.7.1b: Initial ImgBurn Screen
You can then use File ➜ Browse for a source file... to select the .iso file to burn; once selected, your screen should look similar to Figure 2.7.1c. Click the Write icon in the lower left corner to begin the burn.
Figure 2.7.1c: Selecting the Source File (.iso) and Destination (burner) in ImgBurn
ImgBurn will provide a status bar to indicate the progress of the burn. When it is finished, ImgBurn will eject the burner tray then reclose it in order to verify the burn. If the tray does not return itself, which may occur on a laptop, push the tray back in if you wish to verify the burn.
Figure 2.7.1d: Initial InfraRecorder Screen
InfraRecorder will display a screen where you can browse to the location of the PC-BSD image. Once selected, you will be presented with an options screen shown in Figure 2.7.1e:
Figure 2.7.1e: Burn Options in InfraRecorder
You can accept the defaults and click OK to start the burn. When finished, the burner tray will open and a dialog box will appear indicating that the burning process has finished.
Burning the CD/DVD ISO File on a BSD or Linux System
This section demonstrates how to burn the installation ISO on a Linux or BSD system using the following tools: K3B, Brasero, and growisofs.
NOTE: depending upon your Linux distribution, K3B may or may not be included with the installation of KDE. If it does not appear in the KDE application launcher, you should be able to install it using your operating system's software management system. On a FreeBSD system, you can install the K3B package. If you are running an older version of KDE, use the pkg_add -r k3b command. If you are running KDE4, use the pkg_add -r k3b-kde4 command instead. On a PC-BSD system, you can install the K3B PBI using Using AppCafe™.
To burn your ISO, launch K3B and click "Tools ➜ Burn Image...". Figure 2.7.2a demonstrates this screen on a KDE4 system. On a KDE3 system, the menu item may appear as "Burn DVD ISO Image...".
Figure 2.7.2a: Selecting the Burn Image Tool Within K3B
A new window, seen in Figure 2.7.2b, will launch. Click the blue folder to browse to the location of your .iso file.
Figure 2.7.2b: K3B's Burn Image Screen
Once your file is listed, click the "Start" button. K3B will automatically eject the media once the burn is complete.
Brasero is an easy to use burning application included with the GNOME desktop. A PBI is also available within AppCafe™. To launch Brasero within GNOME, click Applications ➜ Multimedia ➜ Brasero Disk Burner and the dialog window shown in Figure 2.7.2c will be displayed.
Figure 2.7.2c: Brasero's Initial Screen
If you click on Burn image ➜ Click here to select a disk image, you will be able to select your .iso file. Once selected, click "Open" to return to the screen seen in Figure 2.7.2d:
Figure 2.7.2d: Viewing the Image to Burn and the DVD Hardware Properties Within Brasero
The name and size of your .iso file should appear and Brasero will indicate the size of the media. The lower portion of Figure 2.7.2d shows the menu that appears if you click on the Properties button. You can change these options if you wish, but it is fine to keep the default settings. When you are ready, click the "Burn" button and Brasero will burn your ISO.
If you are familiar with using the command line on a FreeBSD or PC-BSD system, you can use the growisofs command line utility to burn the DVD. This utility is included with the dvd+rw-tools FreeBSD port which is installed by default on a PC-BSD system. If that software is not yet installed on a FreeBSD system, issue this command as the superuser:
pkg_add -r dvd+rw-tools
Depending upon the type of DVD burner hardware, you may have to configure the system to use it. If the device is ATAPI (i.e. not USB or SCSI), the ATAPI driver must be loaded. The superuser can issue this command:
If you just get your prompt back, the driver successfully loaded. If you get the message "kldload: can't load atapicam: File exists", this means that the driver was already loaded. If the device is USB or SCSI, no additional drivers need to be loaded if you are running the generic FreeBSD kernel. After inserting the DVD media into the device, you can start the burn using this command:
growisofs -Z /dev/cd0=PCBSD9.0-RELEASE-x86-DVD.iso
If your device is not the first CD device, change the number 0 accordingly. If your ISO has a different name, substitute the correct name in the command shown above.
Burning the CD/DVD ISO File on a Mac OSX System
To burn the ISO on a Mac OSX system, go to Finder ➜ Applications ➜ Utilities ➜ Disk Utility. With a blank media inserted into the burner, highlight the device representing the CD/DVD writer and click the Burn button. This will open up a browser where you can select the ISO that you with to burn. In the example shown in Figure 2.7.3a, the DVD ISO has been selected and the device is a Sony DVD writer.
Figure 2.7.3a: Using Disk Utility on Mac OSX
Once the ISO is highlighted, click the Burn button. A pop-up message will indicate that the device is ready to burn. Click burn once more and Disk Utility will write the ISO to the CD/DVD media.
Creating a Bootable USB from an ISO using UNetbootin
CURRENTLY DOES NOT WORK -- RETEST WITH http://forums.freebsd.org/showthread.php?t=9853
UNetbootin is a utility that converts an ISO to a bootable USB. This ability is handy if you don't have a CD/DVD device and prefer to use a graphical utility to manipulate an ISO rather than the command line dd utility to burn an .img file. To use UNetbootin you will need to download a PC-BSD ISO file (CD or DVD) and a USB thumb drive large enough to hold that file.
UNetbootin downloads are available for Windows, Mac OSX, and Linux. This section demonstrates how to create a bootable USB using a Windows 7 system.
After downloading and launching UNetbootin, you should see the screen shown in Figure 2.7.4a.
Figure 2.7.4a: Selecting the ISO in UNetbootin
In the Diskimage section, use the ... browse button to locate the ISO that you downloaded. Insert the USB thumb drive and ensure that the drive letter for the USB thumb drive is the same as the one shown in Windows Explorer. Click the OK button to extract and copy the files to the thumb drive. The application will tell you when it is finished. You can now reboot the system with the USB thumb drive inserted to start the PC-BSD installer.
NEEDS MODIFICATION OF SOMETHING FOR THIS TO WORK
Writing an IMG File to USB
To write an .img.bz2 file you will need the following:
- a utility that can extract bz2 zipped files
- a utility that can write the image to a USB media; the utility that you use will depend upon your operating system
- a USB thumb drive or hard drive large enough to hold the image.
Once the image is written, boot from the removable device and proceed with the installation. If you are using the boot-only image, you will also need to refer to the section Install PC-BSD Over a Network as this image requires an Internet connection to download the rest of the files needed to complete the installation of PC-BSD.
NOTE: if the system does not boot from the removable device, check the boot order in your system BIOS.
Writing the IMG File on a Linux or BSD System
If you selected to download an .img.bz2 file instead of an ISO, you can write the image file to a flash card or removable USB drive using the bunzip2 and dd command line utilities on a BSD or Linux system. On a FreeBSD system, the superuser can use these commands to extract the specified image and write it to the first plugged in USB device:
bunzip2 PCBSD9.0-RELEASE-x86-USBFULL.img.bz2 dd if=PCBSD9.0-RELEASE-x86-USBFULL.img of=/dev/da0 bs=64k conv=sync 63200+0 records in 63200+0 records out 4141875200 bytes transferred in 1395.261087 secs (2968531 bytes/sec)
When using the dd command:
- if= refers to the input file to be written; it should end with an .img extension
- of= refers to the output file (the device name of the flash card or removable USB drive); increment the number in the name if it is not the first USB device
- bs= refers to the block size
- conv=sync pads the final block so it is the specified block size
NOTE for Linux users: if you type mount with the USB stick inserted, you will see two or more device nodes corresponding to the USB stick. For example, /dev/sdc and /dev/sdc1, where /dev/sdc1 corresponds to the primary partition of the USB stick. Before using the dd command, ensure that the usb stick is first unmounted. When using the dd command, remember to use /dev/sdc (device node without the number) as the option for the output file of=. Once the dd completes, you might not be able to mount the USB stick on Linux as Linux has very limited support for UFS, the BSD file system that gets created on the USB stick.
Writing the IMG File on a Windows System
When downloading win32-image-writer, download the latest version that ends in -binary.zip and use a utility such as WinZip or 7zip to unzip the executable.
To extract the PC-BSD image file using 7-Zip, browse to the location containing your downloaded .img.bz2 file, as seen in Figure 2.7.4a.
Figure 2.7.4a: Using 7-Zip to Extract Image File
Click the Extract button and browse to the location where you would like to save the extracted image. Once extracted, your image will end in .img and is now ready to be written to a USB device using the win32-image-writer application.
If you launch win32-image-writer.exe, it will start the Win32 Disk Imager utility, shown in Figure 2.7.4b. Use the browse button to browse to the location of the .img file. Insert a USB thumb drive and select its drive letter (in this example, drive F). Click the Write button and the image will be written to the USB thumb drive.
Figure 2.7.4b: Using Win32 Disk Imager to Write the Image
Writing the IMG File on a Mac OSX System
To extract the .img.bz2 file on a Mac system, use Finder to browse to the location of the file, as seen in Figure 2.7.4c.
Figure 2.7.4c: Extracting the Image on Mac
Simply double-click the file to extract it to the .img format. Finder will create a second file with the .img extension.
To burn that .img file, insert a USB stick and open Terminal. Run the diskutil list command to find out the device name of the USB disk, unmount the USB disk, then use dd to write the image to the "raw" disk (rdisk). In the following example, an 8GB USB stick has a device name of /dev/disk1 and a raw device name of /dev/rdisk1.
diskutil list /dev/disk0 #: TYPE NAME SIZE IDENTIFIER 0: GUID_partition_scheme *500.1 GB disk0 1: EFI 209.7 MB disk0s1 2: Apple_HFS Macintosh HD 499.2 GB disk0s2 3: Apple_Boot Recovery HD 650.0 MB disk0s3 /dev/disk1 #: TYPE NAME SIZE IDENTIFIER 0: FDisk_partition_scheme *8.0 GB disk1 1: DOS_FAT_32 UNTITLED 8.0 GB disk1s1
diskutil unmountDisk /dev/disk1 Unmount of all volumes on disk1 was successful
sudo dd if=/Users/dru/Downloads/PCBSD9.0RELEASE-x86-USBFULL.img of=/dev/rdisk1 bs=4m Password: 375+0 records in 375+0 records out 1572864000 bytes transferred in 86.742798 secs (18132502 bytes/sec)