background image

APPENDIX A: Troubleshooting

This appendix will walk you through fixing your Debian install if you encounter either a 

blinking cursor or black screen when you try to boot Debian for the first time.  This error is due to a 
bug in both GRUB, which is the boot loader, and the Debian Installer which does not report a particular
error from GRUB when it is installed on your boot drive for the first time. The fix is fairly simple and 
will not take much time.

1. Insert the CD or the USB disk you used as your Debian install disk and restart or power on your

computer.  Boot from your Debian install disk the same way you did in step 1 of Chapter 1D.

2.  When the following screen appears, insert the USB key that you are using to boot your newly 

installed Debian operating system.  Then use your arrow keys to navigate to “Advanced 
options” and press “enter.”

3. On the next screen, use your arrow keys to navigate to “Rescue mode” and press “enter.”

APPENDIX A: Troubleshooting
background image

4. On the next screen that appears, choose the default language you want to use and press “enter.”

APPENDIX A: Troubleshooting
background image

5. On the next screen, choose your default location and press “enter.”

APPENDIX A: Troubleshooting
background image

6. On the following screen, choose the settings for your keyboard layout and press “enter.” Debian

will likely make a recommendation based on your earlier language choice which you should 

APPENDIX A: Troubleshooting
background image

7. The Install process will now perform a number of tasks and attempt to automatically configure 

your network.  If you are using a wired connection, everything will likely be configured 
automatically and you can continue to the next step.  If you also have a wireless network card, 
you may be prompted by the installer to choose the network card to use. If prompted to choose 
a “primary network interface,” select “eth0” and press “enter.”

While not recommended, if you are going to use a wireless connection for the installation 
process, choose “wlan0,” press “enter” and continue through the various prompts that will ask 
for your wireless network name (SSID), password, etc. During this step, you may get a warning 
stating that you need to install firmware from a disk in order to get the wireless card working 
properly.  If prompted to do that, choose “no,” and use a wired connection instead. You can 
search for your corresponding wireless drivers, in addition to the instructions for installing 
them, later.

8. Eventually you will be prompted to “enter the hostname for this system.”  Leave this as the 

default which is “debian” and press “enter.”

APPENDIX A: Troubleshooting
background image

9. The next prompt will ask you for your “domain name.”  Leave this blank and press “enter.”

10. You may be asked to select a time zone.  If prompted for such, select your corresponding time 


11. The Debian rescue mode will eventually detect your encrypted hard drive and prompt you for 

the password.  Type in the passphrase you selected in Chapter 2A or 2B to encrypt your hard 

APPENDIX A: Troubleshooting
background image

12. The next screen will ask you to select your root file system.  Select “/dev/debian-vg/root” and 

press “enter.”

13. The next screen will inform you that the installed system appears to use a separate /boot 

partition and will ask you if you want to mount it.  Select “Yes” and press “enter.”

14. On the next screen, choose “Execute a shell in /dev/debian-vg/root” and press “enter.”

APPENDIX A: Troubleshooting
background image

15. On the next screen, select “Continue” and press “enter.”

16. You will now be at a command line prompt next to a “#” symbol.  You need to find out the 

device name for /boot. Type “df -h” and press “enter.”

Look at the output from the above command and find the line that contains “/boot.”  The device
name you need to make note of is at the start of the line that ends with “/boot.”  It will look 
like /dev/sdX1.”  

NOTE: Your device may have a different name than what is used as the example in this guide.  
For purposes of this guide, /dev/sdX is “/dev/sdb.”

APPENDIX A: Troubleshooting
background image

17. Next, you need to find the starting drive sector for /dev/sdX1. Type “fdisk -l /dev/sdX” and 

press “enter.” 

NOTE: “/dev/sdX” represents the name of the device you took note of in the previous step. In 
the image below, “/dev/sdb” represents the USB disk.  Thus, replace '/dev/sdX” with the name 
of the device you noted in the previous step. Do not include the number after the device name in
this step. In should be “/dev/sdX” and not “/dev/sdX1.”

The output will show a number under the “Start” column next to device “/dev/sdX1.” Make 
note of the number and subtract it by one.  For example, in the screen show below, the number 
is “2048.”  Thus, subtracting one from the number, the number to make note of is “2047” 
because 2048 – 1 = 2047.  It is extremely important to remember to subtract the number 
under “Start” by one!  If you do not remember to do this, you will overwrite extra data 
that may make your system unbootable.

APPENDIX A: Troubleshooting
background image

18. Next, you will overwrite the sectors on your boot drive that are preventing the installation of 

GRUB. You will need the number you made not of in the last step. 
Type “dd if=/dev/zero of=/dev/sdX seek=1 count=NumberNotedFromLastStep” and press 

NOTE: “/dev/sdX” represents the name of the device you took note of in step 16. In the image 
below, “/dev/sdb” represents the USB disk.  Thus, replace '/dev/sdX” with the name of the 
device you noted in the previous step. Do not include the number after the device name in this 
step. In should be “/dev/sdX” and not “/dev/sdX1.”  Also, replace 
“NumberNotedFromLastStep” with the number you noted in step 17.  For the purposes of this 
guide in the example below, the command is “dd if=/dev/zero of=/dev/sdX seek=1 
 Therefore, please be careful and make sure 
you get this step right.


19. Now, install the Grub bootloader.  Type “grub-install --target=i386-pc /dev/sdX” and press 


NOTE: “/dev/sdX” represents the name of the device you took note of in step 16. In the image 
below, “/dev/sdb” represents the USB disk.  Thus, replace '/dev/sdX” with the name of the 
device you noted in the previous step. Do not include the number after the device name in this 
step. In should be “/dev/sdX” and not “/dev/sdX1.”

20. Nex

t, type “exit” and press “enter.”  This will take you back to the Recovery Mode menu driven 

APPENDIX A: Troubleshooting
background image

21. When you reach the next screen, remove your Debian installer disk, whether it is a CD or USB 

drive. Then, use your arrow keys to navigate to “Reboot the system” and press “enter.”

You have completed this section. When your computer is first starting up, you need to boot  
from your “/boot” Debian USB Flash Drive. Thus, you need to get to a boot menu.  The method
for doing this differs on various computers.  For example, on a Dell, the boot menu is usually 
activated by pressing the F12 key as the computer is first starting up. On others, it can be the 
ESC key.  On whatever platform you use, once you get to a boot menu, select the USB flash 
drive that you just installed GRUB to in this section. Then, depending on where in the guide 
you were instructed to use this appendix, continue from 



 19 in Chapter 2A




 65 in