Installation Troubleshooting/9.2

From PC-BSD Wiki
Revision as of 06:24, 11 August 2012 by Vater (Talk | contribs)

Jump to: navigation, search

(Sorry for the inconvenience)

Installing PC-BSD is usually an easy process that "just works". However, sometimes you will run into a problem. This section will look at solutions to the most common installation problems.


Installation Starts But Fails

The PC-BSD installer creates a log which keeps a record of all the steps that completed as well as any errors. When an installation error occurs, the PC-BSD installer will ask if you would like to generate an error report. If you click Yes, a pop-up message will ask if you would like to save the error log to a USB stick. Type y and insert a FAT formatted USB thumb drive to copy the log.

While in the installer, you can read this log to see what went wrong. Right-click an area on the desktop outside of the installation window and select xterm from the menu. You can read the log with this command:

more /tmp/pc-sysinstall.log

If you can't figure out how to fix the error or believe that you have discovered an installation bug, send the log that was saved to the USB stick to the txt=Missing Link[1] mailing list.

System Doesn't Boot Into the Installer

If the installer doesn't make it to the initial GUI installer screen, try unplugging as many devices as possible, such as webcams, scanners, printers, USB mice and keyboards. If this solves the problem, plug in one piece of hardware at a time, then reboot. This will help you pinpoint which device is causing the problem.

If your computer freezes while probing hardware and unplugging extra devices does not fix the problem, it is possible that the installation media is corrupt. If the checksum on the file you downloaded is correct, try reburning the file at a lower speed.

If the system freezes and you suspect that the video card is causing the system to freeze, review your system's BIOS settings. If there is a setting for video memory, set it to its highest value. Also check to see if the BIOS is set to prefer built-in graphics or a non-existent graphics card. On some systems this is determined by the order of the devices listed; in this case, make sure that the preferred device is listed first. If you cannot see your BIOS settings you may need to move a jumper or remove a battery to make it revert to the default of built-in graphics; check your manual or contact your manufacturer for details.

If that change did not help, try rebooting and selecting option "7. Escape to loader prompt" from the boot menu shown in Figure 4.9a.

Figure 4.9a: PC-BSD Installer Boot Menu


Selecting this option will open the boot loader prompt where you can type the following commands:

disable-module vesa
set module_path=/boot/kernel;/boot/modules;CONSOLE

Those commands will disable the vesa splash screen before attempting to boot the installer.

A not uncommon cause for problems is the LBA (Logical Block Addressing) setting in the BIOS. If your PC is not booting up before or after installation, check your BIOS and turn LBA off (do not leave it on automatic).

If the SATA settings in your BIOS are set to "compatibility" mode, try changing this setting to "AHCI". If the system hangs with a BTX error, try turning off AHCI in the BIOS.

USB Keyboard Doesn't Work in Installer

If the USB keyboard is non-functional, check if there is an option in your BIOS for legacy support in relation to the keyboard or to USB, or both. Enabling this feature in your BIOS may solve this issue.

Getting Help

If none of the above has fixed your problem, search the txt=Missing Link[2] to see if a solution exists, try a web search, or check the section on Finding Help.


Personal tools