Gentoo Installation Guide

From cchtml.com
Revision as of 21:07, 21 July 2006 by 211.117.125.251 (talk)

Orginally found on the Gentoo Wiki, the GNU Free Documentation license allows me to copy/paste it here.

Introduction

This guide should help you install and configure the proprietry graphics drivers from ATI. This guide applies for ALL versions of fglrx - it was made before the (rather dramatic) 8.8.25 January 05 release, but it is maintained such that all versions should work.

Kernel Configuration

Get into menuconfig (cd /usr/src/your-kernel && make menuconfig) and check the following:

Code: menuconfig 
Loadable Module Support --->
 [*] Enable loadable module support
   [*]   Module unloading 

Processor type and features  --->
 [*] MTRR (Memory Type Range Register) support

Device Drivers --->
 Character Devices ---> 
  <M> /dev/agpgart (AGP Support)  
    <M> Your_AGP_Chipset_Here
  [ ] Direct Rendering Manager (XFree86 4.1.0 and higher DRI support)

 Graphics support --->
  [ ]  Support for framebuffer devices

Kernel Hacking --->
  [ ] Kernel debugging

Sync your kernel menuconfig with the selected portions posted here. (note: you can compile /dev/agpgart & your agp chipset [most likely ati-agp] into the kernel if you want.)

Please be aware that -mm and -rc(1,2,3,4,...) kernels often break fglrx due to unexpected changes in syntax, etc. If you want to use ati-drivers, use the stock gentoo-sources or at the very least, a STABLE 2.4 or 2.6 kernel!

Don't forget to compile, install, and reboot into the kernel. Directions for this are beyond the scope of this file; if you need help recompiling the kernel, click here.

Grabbing a Driver Set

For installation it will be easier to drop out of X to a command prompt. Do this using whatever command your Window Manager uses. I use fluxbox so it's just rightclick -> fluxbox menu -> exit. For KDE or GNOME it's probably just a matter of logging out. When all else fails, hit CTL+ALT+BACKSPACE to kill the X server ungracefully. If the X server only reboots or for some reason you've disabled this hotkey, log in as root and type init 3 to bring the system run level down.

Thanks to portage, installing the drivers is easy. If you have not already done it recently, start by synchronising your portage tree: 

emerge --sync

Getting the latest drivers will probably mean unmasking them. 

echo "media-video/ati-drivers ~arch" >> /etc/portage/package.keywords
echo "media-video/ati-drivers-extra ~arch" >> /etc/portage/package.keywords

Replace <~arch> with your system architecture; it's going to be either ~x86 or ~amd64, the only two CPU architectures supported by the ATI driver.

Now let's install the drivers. ati-drivers-extra is a (god-awful) control panel for the driver you probably won't use; you can leave that part out if you want, but for completeness we mention it here. 

su -
emerge -av ati-drivers ati-drivers-extra

The next step is switch to the ATi OpenGL subsytem: 

(#opengl-update ati)
eselect opengl set ati
(very important!)(opengl-update is deprecated)

Configure X: First, make a standart config file. 

xorgconfig

For a single screen 

aticonfig --initial --input=/etc/X11/xorg.conf

For a dual head, second screen is {left|right|above|below} 

aticonfig --initial=dual-head --input=/etc/X11/xorg.conf --screen-layout={left|right|above|below}

Adapt input with your path to xorg's conf file

If for some reason this command doesn't work, then try manually executing from its default location: 

/opt/ati/bin/aticonfig [...]

Now, let's get back into X. 

startx

Open up a command prompt and run: 

fglrxinfo

If the OpenGL vendor string says "ATI Technologies," then congrats! You've got the drivers working and hardware acceleration going great. If not...read on...

Troubleshooting

Config Files

By default, the driver uses the Internal AGPGART. Sometimes the internal one doesn't work, and you will have to use the one provided with the kernel. Search your xorg.conf for the line that has the option "UseInternalAGPGART." Simply change the "yes" to "no."

File: xorg.conf 
Option "UseInternalAGPGART" "no"


Now simply add the modules to /etc/modules.autoload.d/kernel-2.x where x is your kernel version.

Add the following (ORDER IS VERY IMPORTANT);

File: /etc/modules.autoload.d/kernel-2.x 
agpgart
intel-agp # change intel-agp to your chipset. eg: via-agp, nvidia-agp sis-agp.
fglrx

Finally, run 

modules-update

Then you can reboot and everything should work. If you have are having problems, check dmesg and /var/log/Xorg.0.log for more info.

Blank screen or monitor turning off after startx

Versions of ati-drivers >= 8.16.20 have an issue with this that's easily corrected by inserting:

File: xorg.conf 
    Option "ForceMonitors" "notv"

in the device section of xorg.conf (discussed here: http://bugs.gentoo.org/show_bug.cgi?id=103028)


Check if you have a non-DDC monitor connected via VGA/HD15 connector. If so change your xorg.conf:

File: xorg.conf 
#   Option "DesktopSetup"               "0x00000000"
    Option "MonitorLayout"              "NONE, CRT"
    Option "IgnoreEDID"                 "off"
    Option "HSync2"                     "30-85"
    Option "VRefresh2"                  "50-160"
#   Option "ScreenOverlap"              "0"

where HSync2 and VRefresh2 are your monitor parameters.


Also, try changing the MonitorLayout option. The default is "AUTO, AUTO", which is to say X will attempt to autodetect what kind of monitor you've got on the first and second display heads. This can theoretically fail (though I have never observed it). Try changing it around a bit. For example, if you have an LCD and no secondary monitor, change the line to read:

File: xorg.conf 
    Option "MonitorLayout"              "TMDS, NONE"

if you have a CRT, simply replace "TMDS" with "CRT".

Crashes on startup

If you are unable to use any 3d applications and get this error instead: 

FGLTexMgr: open of shared memory object failed (Function not implemented)
__FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!!
fglX11AllocateManagedSurface: __FGLTexMgrCreateObject failed!!
FGLTexMgr: open of shared memory object failed (Function not implemented)
__FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!!
fglX11AllocateManagedSurface: __FGLTexMgrCreateObject failed!!
FGLTexMgr: open of shared memory object failed (Function not implemented)
__FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!!

Then you do not have tmpfs mounted on /dev/shm, which the driver requires. To mount this, add to following line to /etc/fstab (if it isn't there already):

File: /etc/fstab 
tmpfs     /dev/shm           tmpfs        defaults            0 0

Then just do a: 

mount /dev/shm

If the drivers still crap out on you, or for example you get a black screen on X init, try going into your system BIOS and change graphics-related stuff around. Believe it or not, for me my 9800 gives a black screen on X init if I have the AGP Aperture set at anything other than 128MB. I don't know what causes this, and I don't care; I'm just relating to you how I overcame my problem ;)

Also, whenever you update your compiler, you must recompile your kernel otherwise you won't be able to insert the fglrx module. Note that recompiling your kernel means you must also unmerge/emerge ati-drivers!

Duplicate symbol errors in X log

If you are unable to start X or X fails to load the fglrx driver and you have multiple symbol errors in your Xorg log, chances are that you have compiled X with the dlloader flag. This flag can not be used with the fglrx driver. To fix this problem, remove the dlloader flag by editing your /etc/portage/package.use file as follows:

File: /etc/portage/pakage.use 
x11-base/xorg-x11 -dlloader

Now re-emerge the xorg-x11 package and reinstall the fglrx driver.

Crashes on the exit of X.org / X won't shutdown

Perform the following if you can get the fglrx drivers working with hardware acceleration, but are suffering from a complete system crash when trying to quit X. You should boot into your system, login, then start on this. You don't need to boot into X, and shouldn't need to edit your xorg.conf file (as fglrx is already setup as the driver and working)

You've emerged the "stable" version of the ati-drivers, these are out of date -- remove them (emerge --unmerge ati-drivers), to add the most recent you should either add them to the keywords file (/etc/portage/package.keywords) or emerge your local ebuild (emerge /usr/portage/x11-drivers/ati-drivers/ati-drivers-8.22.5.ebuild) if you're told it requires a dependency, emerge the local e-build for that, then try again. (usually eselect-opengl is required.) Once you have the most recent ati-drivers emerged, run (eselect opengl set ati). Now you can (startx) and hopefully quit without any problems.

See Also


[1] pictures of trainspotting [2] pictures of trains in melbourne [3] pictures of traditional dutch windmills [4] pictures of tracy mcgrady dunking [5] pictures of tracy mcgrady [6] pictures of toy poodles [7] pictures of tornadoes cyclones [8] pictures of toranto [9] pictures of topless women [10] pictures of topless and braless women [11] pictures of tooth decay [12] pictures of tony hawk games [13] pictures of tomato plant problems [14] pictures of tom guiry [15] pictures of tokyo in the past [16] pictures of toilet paper [17] pictures of tinea pedis [18] pictures of tinea capitis [19] pictures of till lindemann [20] pictures of tigger from winnie the pooh [21] pictures of tigger [22] pictures of tigers mating [23] pictures of tiger [24] pictures of tidal waves [25] pictures of thyroid gland [26] pictures of thunder muntian in walt disney [27] pictures of three brides of dracula [28] pictures of thomas and friends [29] pictures of thissle tattoos [30] pictures of third eye paintball [31] pictures of therapist [32] pictures of thedarfur genocide [33] pictures of the zodiac signs [34] pictures of the x man wolverine [35] pictures of the wold trade center [36] pictures of the wild west [37] pictures of the wild life of a jaguar [38] pictures of the white oak [39] pictures of the whipple procedure [40] pictures of the volcano diamond head [41] pictures of the victims of the columbine shootings [42] pictures of the versailles palace [43] pictures of the uss texas [44] pictures of the us capitol building [45] pictures of the united states flag [46] pictures of the u s army s uniform [47] pictures of the truman doctrine [48] pictures of the tropical savanna [49] pictures of the tropical rainforests [50] pictures of the townshend act [51] pictures of the tobacco plant [52] pictures of the three types of clouds [53] pictures of the sun in the sky [54] pictures of the story of the minotaur [55] pictures of the stonehenge [56] pictures of the std chlamydia [57] pictures of the state tree of hawaii [58] pictures of the star of david [59] pictures of the spotted skunk [60] pictures of the ride jaws [61] pictures of the red power ranger [62] pictures of the qutering act [63] pictures of the prime merdian in england [64] pictures of the pony midnight majic [65] pictures of the pomo indians [66] pictures of the planet earth [67] pictures of the pentagon at 911 [68] pictures of the ozone depletion [69] pictures of the omha zoo [70] pictures of the oklahoma city bombing [71] pictures of the ocean from maine [72] pictures of the ocean floor [73] pictures of the ocean and woods [74] pictures of the obese [75] pictures of the northern mockingbird [76] pictures of the new york yankees [77] pictures of the native flowers in the philippines [78] pictures of the muscular system [79] pictures of the movie tripple x [80] pictures of the movie the odyssey [81] pictures of the movie planet of the apes [82] pictures of the movie hocus pocus [83] pictures of the monkees [84] pictures of the monitor and merrimack [85] pictures of the misfits [86] pictures of the milky way [87] pictures of the middle east culture [88] pictures of the medieval times [89] pictures of the march on washington [90] pictures of the lipicia stud farm [91] pictures of the laughing man [92] pictures of the largest turtles [93] pictures of the largest shark in te bahamas [94] pictures of the la lakers players [95] pictures of the kennedy children [96] pictures of the judicial branch of government [97] pictures of the island of st lucia [98] pictures of the island of monte cristo [99] pictures of the irish symbol [100] pictures of the irish flag [101] pictures of the integumentary system [102] pictures of the horse pegasus [103] pictures of the holy spirit [104] pictures of the holocaust concentration camps [105] pictures of the historical mcintyre house [106] pictures of the han dynasty flag [107] pictures of the group b2k [108] pictures of the greek goddess hera [109] pictures of the greek goddess aphrodite [110] pictures of the great wall of china from space [111] pictures of the great gatsby [112] pictures of the grand canyon [113] pictures of the gotti boys [114] pictures of the gobi desert [115] pictures of the globe theatre [116] pictures of the fresham 15 [117] pictures of the flagof usa [118] pictures of the five themes of geography [119] pictures of the first peanuts comic strip [120] pictures of the first kodak camera [121] pictures of the first continental congress [122] pictures of the electric chair [123] pictures of the eiffle tower [124] pictures of the dust bowl [125] pictures of the duke basketball team [126] pictures of the dinosaur scelidosaurus [127] pictures of the deep blue sea [128] pictures of the darfur genocide [129] pictures of the crab nebula [130] pictures of the country poland [131] pictures of the country band rascal flats on tour [132] pictures of the columbia space shuttle exploding [133] pictures of the colosseum s door [134] pictures of the colosseum from the movie gladiator [135] pictures of the coffee tree [136] pictures of the climate [137] pictures of the cell cycle [138] pictures of the care bears [139] pictures of the calgary zoo [140] pictures of the brown swiss ox [141] pictures of the brooklyn bridge [142] pictures of the black sea [143] pictures of the black power fist [144] pictures of the birth of venus [145] pictures of the berlin war [146] pictures of the bay of pigs invasion [147] pictures of the battle of the atlantic [148] pictures of the battle of stalingrad [149] pictures of the battle of hastings 1066 [150] pictures of the band metallica [151] pictures of the band avenged sevenfold [152] pictures of the autoban [153] pictures of the artist mystikal [154] pictures of the artist eminem [155] pictures of the arora borialis [156] pictures of the apostle [157] pictures of the apache trail [158] pictures of the ancient mayans [159] pictures of the ancient greek goddess aphrodite [160] pictures of the anasazi people [161] pictures of the amityville house [162] pictures of the american peregrine falcon [163] pictures of the amazon [164] pictures of the adena indians [165] pictures of the actress heather graham

Retrieved from "http://wiki.cchtml.com/index.php?title=Gentoo_Installation_Guide&oldid=993"