Difference between pages "Reporting Bugs" and "Wim42gnu's-setup"

From Funtoo
(Difference between pages)
Jump to navigation Jump to search
m (Remove note template, its too big, and distracts from the content.)
 
 
Line 1: Line 1:
The Funtoo community's goal is to provide a seamless and problem-free computing experience, and we take all bugs seriously. Please use the following resources for reporting bugs, technical support, and troubleshooting assistance:
WIM42GNU's Funtoo Setup


=== Collecting Info ===
This is for everybody who might have seen my funtoo setup and liked it!
Before submitting bugs collect information about your system, & problem.
This is also for myself to keep track on my system. I have used most of the Linux distributions out there and I am currently most happy with funtoo.
My reasons are:
# Gentoo/Funtoo is a rolling release distribution, meaning you only have to install it once and update it frequently.
# Gentoo/Funtoo is only what you make out of it, no unnesecary rubish like in Ubuntu, OpenSuse or Fedora will be installed by default. In the mean time being aware that Gentoo/Funtoo is for advanced users not careing that much about GUIs for Settings or Configs.
# Gentoo/Funtoo runs fast due to multiple reasons. (Compiling your own software,USE-Flags,...)
# Philosophy, one would think that Slackware would suite me most (KISS,Unix) but the fact is that these distributions require you more energy and time to work with. I want to get my jobs done, not careing to much about the system. It is okay to have tools that do things for you as long they are designed well - like in funtoo.


{{console|body=###i## emerge --info > /tmp/emergeinfo.txt}}


Towards the end of failed emerges are messages about build logs.  This is an example of a failed lvm2 emerge, your exact messages will vary.  Use your emerge output rather than the examples.
'''1. Install Funtoo'''


* The complete build log is located at '/var/tmp/portage/sys-fs/lvm2-2.02.111/temp/build.log'
''Follow the install instructions and setup a minimal system.''http://www.funtoo.org/Funtoo_Linux_Installation


==== IRC ====
Notice you will need to create/edit some configs in the installation prozess. Here are some of mine customizations:


The {{c|#funtoo}} IRC channel on freenode available for informal, real-time technical support and troubleshooting. Please use Funtoo channels rather than Gentoo channels for Funtoo Linux support.
a) <code>/etc/portage/make.conf</code>:
  CFLAGS="-O2 -march=native -pipe -fomit-frame-pointer"
  CXXFLAGS="${CFLAGS}"


To share information on irc use {{package|app-text/wgetpaste}}, and share links rather than posting directly to the channel.
  USE="qt3support theora libkms xa cdr dvd dvdr alsa ffmpeg -gnome gtk -qt4 -kde lm_sensors mp3 mp4 mozilla multilib png python sound udev usb unicode static-libs hddtemp -bluetooth mmx sse sse2 nvidia X pulseaudio udisks"


==== Support Forums ====
  EMERGE_DEFAULT_OPTS="--keep-going"
  FEATURES="-collision-protect ccache"
  CCACHE_SIZE="1G"
  PORTAGE_NICENESS=20
  PORTAGE_IONICE_COMMAND="ionice -c 3 -p \${PID}"
  #EMERGE_DEFAULT_OPTS="--jobs=12"
  MAKEOPTS="-j12" ''<--- Number of CPU cores *2 in my case works best.''


The following Web-based discussion resources are specifically created for community-based support and troubleshooting, and are monitored by the Funtoo Linux core team.  Under the new thread text area, attach the emerge info, and build logs directly to your posts rather than using wgetpaste links.  Wgetpaste links expire where the forums attached files are timeless.
  LANG="de_DE.UTF-8"
  LINGUAS="de" 
  ACCEPT_LICENSE="* -@EULA"
  INPUT_DEVICES="evdev"
  VIDEO_CARDS="nvidia"


* [http://forums.funtoo.org/forum/7-installation-help/ Installation Help]
b) <code>/etc/fstab</code>
* [http://forums.funtoo.org/forum/9-portage-help/ Portage Help]
* [http://forums.funtoo.org/forum/4-desktop-help/ Desktop Help]
* [http://forums.funtoo.org/forum/8-server-help/ Server Help]


=== Bug tracker ===
  # /etc/fstab: static file system information.
  #
  # The root filesystem should have a pass number of either 0 or 1.
  # All other filesystems should have a pass number of 0 or greater than 1.
  #
  # NOTE: If your BOOT partition is ReiserFS, add the notail option to opts.
  #
  # See the manpage fstab(5) for more information.
  #
  # <fs> <mountpoint> <type> <opts> <dump/pass>


We are using JIRA for tracking Funtoo Linux issues. See [http://bugs.funtoo.org bugs.funtoo.org] to access the bug tracker.
  /dev/sda1 /boot ext2 noauto,noatime 1 2
  #/dev/cdrom /mnt/cdrom auto noauto,ro 0 0
  /dev/mapper/vg-swap    none          swap      sw                              0 0
  /dev/mapper/vg-root    /            ext4      noatime,nodiratime,defaults    0 1
  /dev/sr0                /mnt/cdrom    auto      noauto,ro                      0 0
  /dev/mapper/vg-home    /home        ext4      noatime,nodiratime              0 0
''' tmpfs /var/tmp/portage tmpfs uid=portage,gid=portage,mode=0775,size=16048M,noatime 0 0'''


For information on how to properly use the bug tracker, see below.
for tmpfs see: http://www.funtoo.org/Funtoo_Filesystem_Guide,_Part_3


==== How To Report Bugs ====
c) Since I have an encrypted LVM, one needs an initramfs. I prefer the genkernel method.
    genkernel --kernel-config=/path/to/your/custom-kernel-config --no-mrproper --makeopts=-j5 --install --lvm --luks all
more here: http://www.funtoo.org/Rootfs_over_encrypted_lvm or use better-initramfs: http://www.funtoo.org/Initramfs


# First, {{CreateAccount}}.
'''2. Install your WindowManager or DesktopEnviroment'''
# Go to Issues -> Create Issue
# Set Issue Type to "Bug".
# For Summary, enter a clear description of the defect.
# For Description, enter:
## a clear, detailed description of the problem
## clear steps to reproduce the problem
## output of the failure
## a description of what you expected to happen instead of the failure
## attach emerge info, and build logs under bug description


When your issue is created, it will have a short name such as FL-17 that can be used to reference it.
''My favourite Window Manager at the time is i3 followed by xfce and openbox.''


Each issue is intended to track a specific defect in Funtoo Linux. Please respect the focus of each individual issue. Use the mailing lists and forums for general discussion.
'''i3 setup:'''


==== Bug Status ====
1) install these packages:
<console> emerge --ask i3 i3status dmenu lxappeareance
</console>
'' If you want to know what these packages are research them.''


When bugs are first reported, they are marked as ''Awaiting Review''. This means that they are waiting to be reviewed by staff. Once reviewed and possibly revised somewhat, they will be moved into ''Queued'' status. This means that the bug has been accepted and is in queue to being fixed. When a developer starts working on the bug, it will move to ''In Progress'' status. This means that the bug is being actively worked on. When the bug is resolved, it will move to ''Test/Integration'' status, which means that it will now be tested and fully integrated into Funtoo Linux. When it has been fully integrated into Funtoo Linux, it will be marked as ''Closed'', and the resolution will be set appropriately.
Config files:


There are a few other statuses that are used. ''Upstream Review'' is used when a bug is submitted to an upstream project and is awaiting review or feedback. '''Workaround''' is used when a short-term fix is used to resolve a problem, but a longer-term fix is also required. There is also a ''Community Discussion'' status. This status is used when we are actively requesting community feedback. In general, we want to use JIRA as a way to have a very focused discussion about a specific bug, so we don't want the bug comments to be used like forums posts as a type of general discussion. Use the forums for this.
1. xinitrc at <code>~/.xinitrc </code>
  exec ck-launch-session i3 --force-xinerama
''You only need --force-xinerama if you do have a nvidia grafics card.''


==== Fixing Bugs ====
2.  <code>~/.i3/config</code>


When developers fix bugs, they can reference the issue(s) being fixed in the git commit message, by saying something like "This fixes FL-22". The funtoo-overlay and other repositories are integrated with JIRA, so you will be able to see links to these commits by going to the ''Commits'' tab for the issue.
''specify window colors at the top of the file:''
  # class                border  backgr. text    indicator
  client.focused          #333333 #000000 #ffffff #000000
  client.focused_inactive #333333 #5f676a #ffffff #484e50
  client.unfocused        #333333 #222222 #888888 #292d2e
  client.urgent          #333333 #900000 #ffffff #900000


==== Upstream Bug Reporting ====
''specify the bar/workspace colors at the bottom of the file:''
 
  bar {
          status_command i3status
          # Bar color settings
          colors{
                  #background #000000
                  #statusline #ffffff
                  #separator  #666666
                  # Type            border  background font
                  focused_workspace  #008fff #007fff #ffffff
                  active_workspace  #333333 #5f676a #ffffff
                  inactive_workspace #333333 #222222 #888888
                  urgent_workspace  #aa0000 #990000 #ffffff
          }
  }


Please report all bugs to us first, so we are aware of the issue. We will handle reporting bugs to upstream projects, including Gentoo Linux.
 
 
 
 
Do not forget the keymap setting at <code>/etc/X11/xorg.conf</code> otherwise you need to use <code>setxkbmap</code>
  Section "InputClass"
    Identifier        "keyboard-all"
    Driver            "evdev"
    MatchIsKeyboard    "on"
  ''' Option        "XkbLayout" "de"'''
EndSection
 
'''additional software:'''
 
1) File Manager:
<console> emerge --ask thunar </console>
''thunar - filemanager that supports automounting''
''Make sure you create this rule: <code> /etc/polkit-1/rules.d/10-drives.rules</code>
  polkit.addRule(function(action, subject) {
  if (action.id.indexOf("org.freedesktop.udisks2.") == 0){
  return polkit.Result.YES;
  }
  }
  );
 
''Also you should have <code>udisk</code> installed''
 
2)

Revision as of 11:06, February 12, 2015

WIM42GNU's Funtoo Setup

This is for everybody who might have seen my funtoo setup and liked it! This is also for myself to keep track on my system. I have used most of the Linux distributions out there and I am currently most happy with funtoo. My reasons are:

  1. Gentoo/Funtoo is a rolling release distribution, meaning you only have to install it once and update it frequently.
  2. Gentoo/Funtoo is only what you make out of it, no unnesecary rubish like in Ubuntu, OpenSuse or Fedora will be installed by default. In the mean time being aware that Gentoo/Funtoo is for advanced users not careing that much about GUIs for Settings or Configs.
  3. Gentoo/Funtoo runs fast due to multiple reasons. (Compiling your own software,USE-Flags,...)
  4. Philosophy, one would think that Slackware would suite me most (KISS,Unix) but the fact is that these distributions require you more energy and time to work with. I want to get my jobs done, not careing to much about the system. It is okay to have tools that do things for you as long they are designed well - like in funtoo.


1. Install Funtoo

Follow the install instructions and setup a minimal system.http://www.funtoo.org/Funtoo_Linux_Installation

Notice you will need to create/edit some configs in the installation prozess. Here are some of mine customizations:

a) /etc/portage/make.conf:

 CFLAGS="-O2 -march=native -pipe -fomit-frame-pointer"
 CXXFLAGS="${CFLAGS}"
 USE="qt3support theora libkms xa cdr dvd dvdr alsa ffmpeg -gnome gtk -qt4 -kde lm_sensors mp3 mp4 mozilla multilib png python sound udev usb unicode static-libs hddtemp -bluetooth mmx sse sse2 nvidia X pulseaudio udisks"
 EMERGE_DEFAULT_OPTS="--keep-going"
 FEATURES="-collision-protect ccache"
 CCACHE_SIZE="1G"
 PORTAGE_NICENESS=20
 PORTAGE_IONICE_COMMAND="ionice -c 3 -p \${PID}"
 #EMERGE_DEFAULT_OPTS="--jobs=12" 
 MAKEOPTS="-j12" <--- Number of CPU cores *2 in my case works best.
 LANG="de_DE.UTF-8" 
 LINGUAS="de"  
 ACCEPT_LICENSE="* -@EULA" 
 INPUT_DEVICES="evdev"
 VIDEO_CARDS="nvidia"

b) /etc/fstab

 # /etc/fstab: static file system information.
 #
 # The root filesystem should have a pass number of either 0 or 1.
 # All other filesystems should have a pass number of 0 or greater than 1.
 #
 # NOTE: If your BOOT partition is ReiserFS, add the notail option to opts.
 #
 # See the manpage fstab(5) for more information.
 #
 # <fs>			<mountpoint>	<type>		<opts>		<dump/pass>
 /dev/sda1		/boot		ext2		noauto,noatime	1 2
 #/dev/cdrom		/mnt/cdrom	auto		noauto,ro	0 0
 /dev/mapper/vg-swap     none          swap      sw                              0 0
 /dev/mapper/vg-root     /             ext4      noatime,nodiratime,defaults     0 1
 /dev/sr0                /mnt/cdrom    auto      noauto,ro                       0 0
 /dev/mapper/vg-home     /home         ext4      noatime,nodiratime              0 0
 tmpfs		/var/tmp/portage	tmpfs	uid=portage,gid=portage,mode=0775,size=16048M,noatime	0 0

for tmpfs see: http://www.funtoo.org/Funtoo_Filesystem_Guide,_Part_3

c) Since I have an encrypted LVM, one needs an initramfs. I prefer the genkernel method.

   genkernel --kernel-config=/path/to/your/custom-kernel-config --no-mrproper --makeopts=-j5 --install --lvm --luks all 

more here: http://www.funtoo.org/Rootfs_over_encrypted_lvm or use better-initramfs: http://www.funtoo.org/Initramfs

2. Install your WindowManager or DesktopEnviroment

My favourite Window Manager at the time is i3 followed by xfce and openbox.

i3 setup:

1) install these packages:

 emerge --ask i3 i3status dmenu lxappeareance

If you want to know what these packages are research them.

Config files:

1. xinitrc at ~/.xinitrc

 exec ck-launch-session i3 --force-xinerama

You only need --force-xinerama if you do have a nvidia grafics card.

2. ~/.i3/config

specify window colors at the top of the file:

 # class                 border  backgr. text    indicator
 client.focused          #333333 #000000 #ffffff #000000
 client.focused_inactive #333333 #5f676a #ffffff #484e50
 client.unfocused        #333333 #222222 #888888 #292d2e
 client.urgent           #333333 #900000 #ffffff #900000

specify the bar/workspace colors at the bottom of the file:

 bar {
         status_command i3status
         # Bar color settings
         colors{
                 #background #000000
                 #statusline #ffffff
                 #separator  #666666
                 # Type             border  background font
                 focused_workspace  #008fff #007fff #ffffff
                 active_workspace   #333333 #5f676a #ffffff
                 inactive_workspace #333333 #222222 #888888
                 urgent_workspace   #aa0000 #990000 #ffffff
         }
 }




Do not forget the keymap setting at /etc/X11/xorg.conf otherwise you need to use setxkbmap

 Section "InputClass"
   Identifier         "keyboard-all"
   Driver             "evdev"
   MatchIsKeyboard    "on"
   Option         "XkbLayout" "de"

EndSection

additional software:

1) File Manager:

 emerge --ask thunar 

thunar - filemanager that supports automounting Make sure you create this rule: /etc/polkit-1/rules.d/10-drives.rules

 polkit.addRule(function(action, subject) {
 if (action.id.indexOf("org.freedesktop.udisks2.") == 0){
 return polkit.Result.YES;
 }
 }
 );

Also you should have udisk installed

2)