Difference between pages "Usermap" and "Installation Troubleshooting"

(Difference between pages)
 
 
Line 1: Line 1:
'''To add yourself to the UserMap''', first [[Special:CreateAccount|create a Funtoo wiki account]]. Then log in and ''click on your username'' at the top of the screen. Then click ''Create with Form'' and enter your information, including at least one ''Role''.
+
This page shows you how to troubleshoot issues with your Funtoo Linux installation.
__NOCACHE__ 
+
 
{{#compound_query:[[Category:People]] [[Role type::Staff]];?Geoloc;icon=Purplemarker.png;limit=9999
+
== Boot failure ==
    |[[Category:People]][[Role type::Contributor]];?Geoloc;icon=Orangemarker.png;limit=9999
+
 
    |[[Category:People]][[Role type::User]];?Geoloc;icon=Greenmarker.png;limit=9999
+
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:
    |format=googlemaps3|height=500|type=terrain|zoom=2|minzoom=2}}
+
 
<div class="donate">
+
<console>
{| cellpadding="2"
+
# ##i##mkdir /mnt/funtoo
|-  
+
# ##i##mount /dev/sda4 /mnt/funtoo
! Description !! Marker !! Notes
+
# ##i##mount /dev/sda1 /mnt/funtoo/boot
|-
+
# ##i##cd /mnt/funtoo
| Staff Members || [[Image:Purplemarker.png|12px]] || Funtoo Staff (BDFL and Support Staff)
+
# ##i##mount --bind /proc proc
|-
+
# ##i##mount --bind /dev dev
| Contributors || [[Image:Orangemarker.png|12px]] || Funtoo Code Contributors
+
# ##i##cp /etc/resolv.conf etc/
|-
+
# ##i##env -i HOME=/root TERM=$TERM PATH='/bin:/sbin:/usr/bin:/usr/sbin' chroot /mnt/funtoo
| Users || [[Image:Greenmarker.png|12px]] || Funtoo Linux users
+
</console>
|}
+
 
</div>
+
Once you are done making changes, leave the chroot, unmount mounted filesystems, and reboot:
+
 
__NOEDITSECTION__
+
<console>
__NOTOC__
+
(chroot) # ##i##exit
__NOTITLE__
+
# ##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 00:26, 13 March 2014

This page shows you how to troubleshoot issues with your Funtoo Linux installation.

Boot failure

If you did not get a login: 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:

# mkdir /mnt/funtoo
# mount /dev/sda4 /mnt/funtoo
# mount /dev/sda1 /mnt/funtoo/boot
# cd /mnt/funtoo
# mount --bind /proc proc
# mount --bind /dev dev
# cp /etc/resolv.conf etc/
# env -i HOME=/root TERM=$TERM PATH='/bin:/sbin:/usr/bin:/usr/sbin' chroot /mnt/funtoo

Once you are done making changes, leave the chroot, unmount mounted filesystems, and reboot:

(chroot) # exit
# umount /mnt/funtoo/boot /mnt/funtoo/dev /mnt/funtoo/proc /mnt/funtoo 
# reboot

If you continue to experience difficulties getting Funtoo Linux to boot properly, please ask for help in the forums.

Debugging system startup

/etc/rc.conf 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 rc_logger to YES. This will instruct OpenRC to launch a logging daemon to log the entire rc process to /var/log/rc.log.

Graphics Corruption at boot

If you experience graphics corruption issues at boot time, you may be experiencing an issue with the Kernel Mode Setting subsystem, known as KMS. To resolve this problem, boot from the live CD again following the steps above. Then, from within the chroot, edit /etc/boot.conf and add the line "params += nomodeset" to the "Funtoo Linux genkernel" section. Your /etc/boot.conf should now look like this:

"Funtoo Linux genkernel" {
        kernel kernel[-v]
        initrd initramfs[-v]
        params += real_root=auto 
        params += nomodeset
} 

Now, save your changes and run boot-update:

(chroot) # boot-update

Now, exit the chroot, unmount filesystems and reboot following the boot failure instructions.