Difference between pages "Installation Troubleshooting" and "Template:Trim"

(Difference between pages)
 
(Added a template to support Template:Package. Inspired and adapted from a similar template done by the folks over at Gentoo wiki.)
 
Line 1: Line 1:
This page shows you how to troubleshoot issues with your Funtoo Linux installation.
+
<includeonly>{{#if: {{{1|}}}|{{ {{{|safesubst:}}}#if:1|{{{1|}}}}}|{{Error|Trim|unnamed}}}}</includeonly><noinclude>{{Documentation}}</noinclude>
 
+
== Boot failure ==
+
 
+
If you did not get a <tt>login:</tt> prompt, it's possible that your install was not successful. You can reboot from the live CD and bind-mount your existing installation without repartitioning or recreating filesystems, chroot inside, and then check your system to ensure everything is configured properly:
+
 
+
<console>
+
# ##i##mkdir /mnt/funtoo
+
# ##i##mount /dev/sda4 /mnt/funtoo
+
# ##i##mount /dev/sda1 /mnt/funtoo/boot
+
# ##i##cd /mnt/funtoo
+
# ##i##mount --bind /proc proc
+
# ##i##mount --bind /dev dev
+
# ##i##cp /etc/resolv.conf etc/
+
# ##i##env -i HOME=/root TERM=$TERM PATH='/bin:/sbin:/usr/bin:/usr/sbin' chroot /mnt/funtoo
+
</console>
+
 
+
Once you are done making changes, leave the chroot, unmount mounted filesystems, and reboot:
+
 
+
<console>
+
(chroot) # ##i##exit
+
# ##i##umount /mnt/funtoo/boot /mnt/funtoo/dev /mnt/funtoo/proc /mnt/funtoo
+
# ##i##reboot
+
</console>
+
 
+
If you continue to experience difficulties getting Funtoo Linux to boot properly, please ask for help in the [http://forums.funtoo.org/ forums].
+
 
+
== Debugging system startup ==
+
 
+
<tt>/etc/rc.conf</tt> contains system settings related to the system initialization scripts. If you are experiencing problems with the system startup scripts, you may find it beneficial to set <tt>rc_logger</tt> to <tt>YES</tt>. This will instruct OpenRC to launch a logging daemon to log the entire rc process to <tt>/var/log/rc.log</tt>.
+
 
+
== Graphics Corruption at boot ==
+
 
+
If you experience graphics corruption issues at boot time, you may be experiencing an issue with the [http://fedoraproject.org/wiki/Features/KernelModesetting Kernel Mode Setting subsystem], known as KMS. To resolve this problem, boot from the live CD again [[#boot failure|following the steps above]]. Then, from within the chroot, edit <tt>/etc/boot.conf</tt> and add the line "<tt>params += nomodeset</tt>" to the "<tt>Funtoo Linux genkernel</tt>" section. Your <tt>/etc/boot.conf</tt> should now look like this:
+
 
+
<pre>
+
"Funtoo Linux genkernel" {
+
        kernel kernel[-v]
+
        initrd initramfs[-v]
+
        params += real_root=auto
+
        params += nomodeset
+
}  
+
</pre>
+
 
+
Now, save your changes and run <tt>boot-update</tt>:
+
 
+
<console>
+
(chroot) # ##i##boot-update
+
</console>
+
 
+
Now, exit the chroot, unmount filesystems and reboot following the [[#boot failure|boot failure]] instructions.
+
 
+
[[Category:HOWTO]]
+
[[Category:Install]]
+
[[Category:Official Documentation]]
+

Latest revision as of 23:28, 10 January 2014

[create]

Template-info.png Template Documentation

To use this template insert {{Template:Trim}} into the page you wish to use it on and the page you wish.

This template does not have documentation, please add it