Difference between pages "Installation Troubleshooting" and "Help:Funtoo Editing Guidelines"

(Difference between pages)
 
 
Line 1: Line 1:
This page shows you how to troubleshoot issues with your Funtoo Linux installation.
+
This guide is meant to serve as a reference for those who are interested in helping improve the Funtoo wiki.  
 
+
== 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. It should now look like this:
+
  
 +
== Kernelop ==
 +
To display kernel options, we encourage you to use the <tt>kernelop</tt> template. To use the <tt>kernelop</tt> template, create an entry similar to the following example:
 
<pre>
 
<pre>
"Funtoo Linux genkernel" {
+
{{kernelop
        kernel kernel[-v]
+
| <br> | <pre>
        initrd initramfs[-v]
+
kernel options
        params += real_root=auto
+
<&#47;pre>}}
        params += nomodeset
+
}  
+
 
</pre>
 
</pre>
  
Now, save your changes and run <tt>boot-update</tt>:
+
Adding this entry will give you the following output:  
 
+
{{kernelop
<console>
+
| <br> | <pre>
(chroot) # ##i##boot-update
+
kernel options
</console>
+
</pre>}}
  
Now, exit the chroot, unmount filesystems and reboot following the [[#boot failure|boot failure]] instructions.
+
More examples:
 +
* [[Fglrx]]
 +
* [[Acpid]]
 +
* [[Microcode]]
  
[[Category:HOWTO]]
+
[[Category:Wiki Development]]
[[Category:Install]]
+

Revision as of 23:37, 17 February 2014

This guide is meant to serve as a reference for those who are interested in helping improve the Funtoo wiki.

Kernelop

To display kernel options, we encourage you to use the kernelop template. To use the kernelop template, create an entry similar to the following example:

{{kernelop
| <br> | <pre>
kernel options
</pre>}}

Adding this entry will give you the following output:


More examples: