cchtml.com - User contributions [en]

Ubuntu Installation Guide

2006-03-15T14:31:41Z

84.160.161.183: /* Method 1: Installing Dapper's Included Driver (8.23.7) */

= Ubuntu 5.10 (Breezy Badger) =

== Method 1: Installing Breezy's Included Driver (8.16.20) ==

The fglrx driver supports Radeon 8500+ and the X-series cards (see [https://support.ati.com/ics/support/KBAnswer.asp?questionID=1176 release notes]). When running the dpkg-reconfigure commands you can accept the defaults whenever you aren't sure.

=== Installing the driver ===

''All Platforms:''
<pre>
sudo apt-get install xorg-driver-fglrx
sudo apt-get install linux-restricted-modules-$(uname -r) #Okay if it is already installed
sudo dpkg-reconfigure xserver-xorg #Select the fglrx driver and 64-bit users should deselect int10a
</pre>

''64-bit users:''

You have to downgrade to an older version of libdri.a due to an incompatilbity with the ATI drivers. [http://mail3.mpr.org/mlomker/libdri.a.gz Download it here]

Change to download directory:
<pre>
gunzip libdri.a.gz
sudo cp /usr/X11R6/lib/modules/extensions/libdri.a libdri.a.old
sudo cp libdri.a /usr/X11R6/lib/modules/extensions/
</pre>

If you wish to revert to any non-fglrx driver you will need to copy the libdri.a.old file back over the fglrx version.

''All platforms:'' Ctrl-Alt-Backspace to restart your desktop.

=== Confirm that it works ===
<pre>
$ fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: MOBILITY RADEON 9700 Generic
OpenGL version string: 1.3.5272 (X4.3.0-8.16.20)
</pre>

=== Troubleshooting ===

If you have a widescreen LCD display that is stuck at 1024x768 then it is probably the bug in the 8.16.20 driver that was fixed in 8.18.X (see the next section).

The output of '''dmesg | grep fglrx''' and /var/log/Xorg.0.log are most useful when looking for errors.

== Method 2: Generating/Installing Ubuntu packages for the newer 8.23.7 drivers in Breezy Badger ==

'''Important Warning:''' Installation of this driver requires removing the restricted-modules package in order to work. That package includes drivers for madwifi (Atheros wireless cards), nvidia cards, and a handful of other devices. I provide a work-around for the madwifi drivers, but you need to perform it before removing the restricted modules (jump to end of this this post).

When running the dpkg-reconfigure command you should answer the questions that you know and take the defaults for the rest. You might want to say ''no'' to the monitor detection--it has caused X-Windows to crash for some people.

=== Remove existing fglrx driver ===

Remove Breezy's included drivers if they are installed:

<pre>
sudo apt-get remove xorg-driver-fglrx
sudo apt-get remove fglrx-control
sudo apt-get remove linux-restricted-modules-$(uname -r)
sudo dpkg-reconfigure xserver-xorg #select the "ati" module
</pre>

Reboot.

=== Installing the new driver ===

Download the ATI driver installer: [https://support.ati.com/ics/support/default.asp?deptID=894&task=knowledge&folderID=27 Click here]

Change to the download directory. Make sure that you have the ''universe'' and ''multiverse'' repositories enabled in ''/etc/apt/sources.list'' before doing these steps. [http://mail3.mpr.org/mlomker/sources.list Sample sources.list].

''Install necessary tools:''

<pre>
sudo apt-get install gcc-3.4 module-assistant build-essential
sudo apt-get install fakeroot dh-make debconf libstdc++5 gcc-3.3-base
</pre>

''Create .deb packages:''

<pre>
chmod +x ati-driver-installer-8.23.7-i386.run
LANG=C LC_ALL=C ./ati-driver-installer-8.23.7-i386.run --buildpkg Ubuntu/breezy
</pre>

''Install .deb packages:''

<pre>
sudo dpkg -i xorg-driver-fglrx_8.23.7-1_i386.deb
sudo dpkg -i fglrx-control_8.23.7-1_i386.deb
sudo dpkg -i fglrx-kernel-source_8.23.7-1_i386.deb
</pre>

''Remove any old fglrx deb's from /usr/src/:''

<pre>
sudo rm /usr/src/fglrx-kernel*.deb
</pre>

''Compile the kernel driver:''

<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant a-i fglrx
</pre>

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
</pre>

Reboot.

=== Confirm that it worked ===

<pre>
$ fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: RADEON 9700 Generic
OpenGL version string: 2.0.5695 (8.23.7)
</pre>

=== Troubleshooting ===

==== General ====

Look for error messages in /var/log/Xorg.0.log and kern.log.

==== Madwifi Drivers in Breezy Badger ====
In order to continue using the [http://madwifi.org madwifi] driver you can do the following '''before''' removing the linux-restricted-modules package and rebooting.
<pre>
sudo cp /lib/modules/$(uname -r)/volatile/ath_hal.ko /lib/modules/$(uname -r)/kernel/
sudo depmod -a $(uname -r)
</pre>

= Ubuntu 6.04 (Dapper Drake) =

== Method 1: Installing Dapper's Included Driver (8.23.7) ==

The fglrx driver supports Radeon 8500+ and the X-series cards up to X850.

=== Installing the driver ===

<pre>
sudo apt-get install linux-restricted-modules-$(uname -r) #Okay if it is already installed
sudo apt-get install xorg-driver-fglrx
sudo aticonfig --initial
</pre>

Reboot.

=== Confirm that it works ===
<pre>
$ fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: RADEON 9700 Generic
OpenGL version string: 2.0.5695 (8.23.7)
</pre>

=== Troubleshooting ===

*The output of '''dmesg | grep fglrx''' and /var/log/Xorg.0.log are most useful when looking for errors.

*It might be necessary to create a symlink to get accelerated OpenGL:
:<pre>sudo ln -s /usr/lib/dri /usr/lib/xorg/modules/dri</pre>

*To ensure you automatically get the current ''linux-restricted-modules'' package with kernel updates, you should install the linux-restricted-modules-??? package matching your kernel-type (without version numer), e.g. ''linux-restricted-modules-386'', ''linux-restricted-modules-686'' or ''linux-restricted-modules-k7''.

== Method 2: Generating/Installing Ubuntu packages for the newer 8.23.7 drivers in Ubuntu Dapper ==

'''Important Change:''' Installation of this driver '''no longer requires''' removing the linux-restricted-modules package in order to work. There is a new blacklist feature in Ubuntu Dapper that you can use to go around this.

When running the dpkg-reconfigure command you should answer the questions that you know and take the defaults for the rest. You might want to say ''no'' to the monitor detection--it has caused X-Windows to crash for some people.

=== Remove existing fglrx driver ===

Blacklist fglrx module from linux-restricted-modules:

<pre>sudo gedit /etc/default/linux-restricted-modules-common</pre>
Edit ''DISABLED_MODULES'' to include fglrx

Remove Dapper's included fglrx drivers if they are installed:

<pre>
sudo apt-get remove xorg-driver-fglrx
sudo apt-get remove fglrx-control
sudo dpkg-reconfigure xserver-xorg #select the "ati" module
</pre>

Reboot.

=== Installing the new driver ===

Download the ATI driver installer: [https://support.ati.com/ics/support/default.asp?deptID=894&task=knowledge&folderID=27 Click here]

Change to the download directory. Make sure that you have the ''universe'' and ''multiverse'' repositories enabled in ''/etc/apt/sources.list'' before doing these steps.

''Install necessary tools:''

<pre>
sudo apt-get install module-assistant build-essential
sudo apt-get install fakeroot dh-make debconf libstdc++5 gcc-3.3-base
</pre>

''Create .deb packages:''

<pre>
chmod +x ati-driver-installer-8.23.7-i386.run
LANG=C LC_ALL=C ./ati-driver-installer-8.23.7-i386.run --buildpkg Ubuntu/dapper
</pre>

''Install .deb packages:''

<pre>
sudo dpkg -i xorg-driver-fglrx_8.23.7-1_i386.deb
sudo dpkg -i fglrx-control_8.23.7-1_i386.deb
sudo dpkg -i fglrx-kernel-source_8.23.7-1_i386.deb
</pre>

''Remove any old fglrx deb's from /usr/src/:''

<pre>
sudo rm /usr/src/fglrx-kernel*.deb
</pre>

''Compile the kernel driver:''

<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant a-i fglrx
</pre>

''Note'': If ''sudo module-assistant a-i fglrx'' doesn't work then run the following:

<pre>
sudo dpkg -i fglrx-kernel-source_8.23.7-1_i386.deb
sudo module-assistant build,install fglrx
</pre>

This is because the current fglrx kernel source package in Dapper is marked "newer" than the one created by the ATI Installer.

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
</pre>

Reboot.

=== Confirm that it worked ===

<pre>
$ fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: RADEON 9700 Generic
OpenGL version string: 2.0.5695 (8.23.7)
</pre>

=== Troubleshooting ===

==== General ====

Look for error messages in /var/log/Xorg.0.log and kern.log.

[[Category:Installation Documentation]]

Gentoo Installation Guide

2006-03-15T14:29:04Z

84.160.161.183: revert to 14:17, 4 March 2006 ; reason: spam

Orginally found on the [http://gentoo-wiki.com/HOWTO_ATI_Drivers 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.

*Note: If you are using an ATI 7500 Mobility (or such card that isn't supported by the ati-drivers) this HOWTO will not help. Instead use the ATI kernel drivers. See also: http://forums.gentoo.org/viewtopic-p-2137276.html#2137276

== Kernel Configuration ==

Get into menuconfig (cd /usr/src/your-kernel && make menuconfig) and check the following:
{{Box Code|menuconfig|<pre>
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
</pre>
}}
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, [http://gentoo-wiki.com/HOWTO_Compile_a_Kernel_Manually 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 {{Codeline|<~arch>}} with your system architecture; it's going to be either {{Codeline|~x86}} or {{Codeline|~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 -v 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:

fglrxconfig

If for some reason this command doesn't work (the script isn't found), then try manually executing the script from its default location:

/opt/ati/bin/fglrxconfig

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."

{{Box File|xorg.conf|
Option "UseInternalAGPGART" "no"
}}

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

Add the following (ORDER IS VERY IMPORTANT);
{{Box 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:
{{Box 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:
{{Box 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:

{{Box 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 {{filename|/etc/fstab}} (if it isn't there already):

{{Box 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:
{{Box 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 ==

*[http://ati.cchtml.com/ ATi Unofficial Bugzilla (occasionally monitored by ATi personnel)]
*Check out user Wedge_'s excellent ATI Radeon [http://odin.prohosting.com/wedge01/gentoo-radeon-faq.html FAQ here]

[[Category:Installation Documentation]]