CRUX : Home

Home :: Documentation :: Download :: Development :: Community :: Wiki :: Ports :: Bugs :: Links :: About

Appendix

Troubleshooting

Many common problems are answered in the FAQ document, so if you experience problems please check whether http://crux.nu/Main/Faq contains answers to your questions already.

If you have further questions, there's a dedicated mailing list for CRUX, and an IRC channel. Actual information about these can be found on the Community page of our wiki.

GRUB installation

Precaution

Installing a new boot manager is like modifying the partition table using fdisk or installing a new system kernel. Please create a rescue boot disk first!

CRUX comes with a heavily patched version of grub. Use it at your own risk!

Installation

After installation you need to copy the stage files to /boot/grub/:

# cp /usr/share/grub/i386-pc/* /boot/grub/

(Of course, you can choose another location as described above but this guide assumes that you use /boot/grub. Normally you need only the files stage1 and stage2. Please read the grub documentation if you don't know why: http://www.uruk.org/orig-grub/ and http://www.gnu.org/software/grub/manual/grub.html)

Now it's time to create your own "boot menu":

# # Copy sample file
# cp /boot/grub/grub.conf.sample /boot/grub/grub.conf
# # Modify it for your system 
# vi /boot/grub/grub.conf

For more information about setting up your own grub boot menu file: http://www.gnu.org/software/grub/manual/grub.html#Configuration

Last but not least, install/enable the boot manager:

# # Run grub
# grub
grub> root (hdX,Y)
grub> setup (hdX)
grub> quit

Please correct the path and device names according to your configuration. Also see http://www.gnu.org/software/grub/manual/grub.html#Installation. In the example above, X and Y need to be replaced with your hard drive and grub partition.