cchtml.com - User contributions [en]

Ubuntu Intrepid Installation Guide

2008-11-25T04:38:37Z

24.86.200.120: /* Additional 64-bit instructions */

= Installation Guide for Ubuntu Intrepid (v 8.10) =

== The three alternatives ==

ATI has a bad track-record when it comes to drivers for Linux. There are countless stories about black screens, hours of configuring X, installing drivers and swearing at the computer.
AMD has traditionally been a bit more Linux-friendly, so after AMD bought ATI, there has arised a slight hope for better drivers for ATI-cards on Linux.

However, creating better drivers takes some time, so while the people at AMD are doing their thing, people with ATI cards basically have these options:
# Use the open source drivers. These are stable and nice, but currently they have poor 3D-performance, if any. If that's not a problem, they are the Right Choice (tm).
# Use the restricted-driver management system that comes with Ubuntu to install the drivers (envy/jocky/"restricted" packages).
# Install the drivers manually. This should be your last resort, and may not even work.

= The open source drivers =
By default, one of the open source drivers are used. If this works for you, you don't need to change anything.

These comes with the X.org X server:
* vesa
* ati
* radeon
* radeonhd

The "ati" driver will automatically choose the best driver for your video card. There is no need to change it from "ati" or even create an xorg.conf file in most cases. The xorg.conf file is being deprecated.

= Installing the restricted drivers "the Ubuntu way" =

== Restricted Drivers Manager ==
For most users it won't be necessary to go into installation and configuration details of the driver. Ubuntu 8.10 (Intrepid) provides a notification saying that there are restricted drivers available. You just have to go there (Restricted Drivers Manager) and enable the "ATI accelerated graphics driver". Ubuntu will then install and configure the driver for you. If this did not provide the solution you were looking for, read ahead.

== Installation ==

Just use the hardware manager on the system menu (jockey-gtk), or this:

This will install the current driver in Ubuntu's repository. It is older than the one AMD has released, but will be supported by Ubuntu.
Note that there are different version-numbers for Catalyst itself and the amdccle program that comes with Catalyst!

{{Box Terminal|
sudo apt-get update 
sudo apt-get install linux-restricted-modules-generic restricted-manager 
sudo apt-get install xorg-driver-fglrx 
sudo depmod -a 
}}
Package restricted-manager is a virtual package. It comes with e.g. jockey-gtk. 
The second line may not be necessary as you may already have restricted modules installed. Run it just in case. If the third line fails, you probably don't have the restricted repository enabled. See Pre-Installation.

After this, you may need to edit Xorg.conf:

{{Box Terminal|
sudo gedit /etc/X11/xorg.conf 
sudo nano /etc/X11/xorg.conf #for kubuntu users
}}

In the device section, if it is not already there add:

{{Box File|/etc/X11/xorg.conf|
Driver "fglrx"
}}

Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:

{{Box Terminal|
sudo aticonfig --initial -f
}}

aticonfig must be used every time you change xorg.conf!

After this you should be able to restart your computer and have the driver working. To test type

{{Box Terminal|
fglrxinfo
}}

into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]

== Post-Installation Tweaks ==
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''

<pre>
Section "Device"
[...]
Driver "fglrx"
Option "VideoOverlay" "on"
Option "OpenGLOverlay" "off"
[...]
EndSection
</pre>

Note that when Visual Effects (Compiz) are active, flickering and artifacts may occur in OpenGL applications and hardware accelerated video windows (particularly with R300 chipset). To prevent this, disable Visual Effects.

= Installing the restricted drivers manually =
*Please note that for the current version 8.11 of the catalyst drivers, this method of installing with deb packages is broken in intrepid. Use the automated installation method instead.*
''If you are using the x86_64 architecture (64 bit), be sure to inst "ia32-libs" before proceeding!''

Make sure ''universe'' and ''multiverse'' are enabled in your repository sources.

===''1. Install necessary build tools.''===
{{Box Terminal|
sudo apt-get update 
sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
}}

===''2. Download the latest Catalyst package.''===

Download page: Catalyst {{catalystversion}}. This package contains both the 32-bit and 64-bit driver.

Open a terminal window and switch to the directory you downloaded the installer to. (Example: $ cd Desktop)

===''3. Create .deb packages.''===
{{Box Terminal|
sh {{catalystfilename}} --buildpkg Ubuntu/intrepid
}}

===''4. Add driver to kernel module blacklist.''===
The ATI driver must be added to the kernel module blacklist so that the new ATI driver will be used. If it is not blacklisted, the official Ubuntu repository version of the ATI driver will be loaded instead.

For Ubuntu

{{Box Terminal|
sudo gedit /etc/default/linux-restricted-modules-common
}}

For Kubuntu

{{Box Terminal|
sudo kwrite /etc/default/linux-restricted-modules-common
}}

Add "fglrx" to the line "DISABLED_MODULES"
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

Please note that after the modification above, the "Restricted Driver Manager" will signal "ATI accelerated graphics driver" not enabled (unticked). This is perfectly correct. At the end of the installation procedure it will signal in Status: "in use" (green light), but NOT enabled. It simply means that the fglrx module contained in the linux-restricted-modules package is not enabled, but another fglrx module ({{catalystversion}}) is in use.

You may also need to edit the file(s) (if they exist):

For Ubuntu

{{Box Terminal|
sudo gedit /etc/modprobe.d/blacklist-restricted 
sudo gedit /etc/modprobe.d/blacklist-local 
}}

For Kubuntu

{{Box Terminal|
sudo nano /etc/modprobe.d/blacklist-restricted 
sudo nano /etc/modprobe.d/blacklist-local
}}

Put a # in front of the line "blacklist fglrx", if it is present. Otherwise, the kernel module will not load automatically, and you will not get 3D acceleration.

===''5. Install .debs.''===
For 32-bit systems

{{Box Terminal|
sudo dpkg -i xorg-driver-fglrx_8.552-0ubuntu1_i386.deb fglrx-kernel-source_8.552-0ubuntu1_i386.deb fglrx-amdcccle_8.552-0ubuntu1_i386.deb
}}

or for 64-bit systems

{{Box Terminal|
sudo dpkg -i xorg-driver-fglrx_8.552-0ubuntu1_amd64.deb fglrx-kernel-source_8.552-0ubuntu1_amd64.deb fglrx-amdcccle_8.552-0ubuntu1_amd64.deb
}}
''Using [http://en.wikipedia.org/wiki/Command_line_completion tab completion] can make this command easier.''

== Additional 64-bit instructions ==

If you have a 64 bit install, the above dpkg command may complain that "Errors were encountered while processing: fglrx-amdcccle". This is because of a dependency of the amdccle package on 32 bit libraries. If you receive this error, issue the following command after the above dpkg command, which will force the installation of all of the 32 bit dependencies, and then the amdccle package:

{{Box Terminal|
sudo apt-get install -f
}}

Catalyst {{catalystversion}} on 64-bit systems requires the ''--force-overwrite'' command in the above ''dpkg'' command:
{{Box Terminal|
sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.552-0ubuntu1_amd64.deb fglrx-kernel-source_8.552-0ubuntu1_amd64.deb fglrx-amdcccle_8.552-0ubuntu1_amd64.deb
}}
''Using [http://en.wikipedia.org/wiki/Command_line_completion tab completion] can make this command easier.''

When installing the packages, if <tt>xorg-driver-fglrx_8.552</tt> fails to install due to a diverted file conflict, you can [http://emmetcaulfield.net/Tech/ATIv84+Hardy/ fix the package with this procedure].
If you get problems with dkms, you can patch the temporary sources and compile them yourself: http://www.phoronix.com/forums/showthread.php?t=12546

If you can't get past these problems, consider using Hardy and just upgrading the kernel manually and installing the packages you need from Intrepid. "EnvyNG" is also an idea.

== Finishing the Install: Configuration ==

'''If you've used fglrx previously, you will not need to do this.'''

Now you'll have to edit your xorg.conf

For Ubuntu

<pre>sudo gedit /etc/X11/xorg.conf</pre>

For Kubuntu

<pre>sudo nano /etc/X11/xorg.conf </pre>

and add the following line to the Device section (if it does not already exist). Include the following lines without '''[...]''':
<pre>Section "Device"
[...]
Driver "fglrx"
[...]
EndSection</pre>
Save and exit, then run
{{Box Terminal|
sudo aticonfig --initial -f
}}
in a terminal. If it doesn't give an error you should be good.

Some people find that changes to xorg.conf don't get used by the driver. To force the ati driver to adopt changes made to xorg.conf, type the following command:

{{Box Terminal|
sudo aticonfig <nowiki>--input=/etc/X11/xorg.conf --tls=1</nowiki>
}}

Finally, reboot the computer and type
{{Box Terminal|
fglrxinfo
}}
into the terminal. If the vendor string contains ATI, you have installed the driver successfully. Release 8.8 looks like:
<pre>
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: Radeon X1950 Series
OpenGL version string: 2.1.7873 Release
</pre>

Please note: Depending on the particular ATI card that you own, you may or may not automatically have all of the relevant driver features enabled. R500 and R600 cards (X1xxx, HD series, and newer) in particular will need TexturedVideo enabled in Xorg.conf (rather than the traditional VideoOverlay) in order to support Xv accelerated video playback.

== Finally ==
# Add tweaks as needed: http://ge.ubuntuforums.com/showthread.php?t=849422
# Restart X, if it doesn't work, you can use the "vesa", "radeon" or "radeonhd" driver in the mean time, until you make it work.
# If you downgraded X to make fglrx work: enter synaptic, make sure all packages with "xorg" and "x11" are locked so that you can update and upgrade without worries.

Done! Now run amdcccle, glxgears, warsow etc :)

= Issues =

== Couldn't find library libfglrx_gamma.so.1 ==
If you are having this error:
<pre>
dpkg-shlibdeps: failure: couldn't find library libfglrx_gamma.so.1 needed by debian/xorg-driver-fglrx/usr/bin/fglrx_xgamma (its RPATH is '').
</pre>

Fix it by doing the following:
<pre>
sudo sh ati-driver-installer-8-7-x86.x86_64.run --extract driver
cd driver/arch/x86_64/usr/X11R6/lib64
sudo ln -s libfglrx_gamma.so.1.0 libfglrx_gamma.so.1
cd ../../../../../
sudo sh ati-installer.sh -- --buildpkg Ubuntu/hardy
</pre>

== Mesa drivers ==
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, you might want to remove Mesa:

*Remove the package xserver-xgl.
:<pre>sudo apt-get remove xserver-xgl</pre>
:'''Explanation:''' If you installed this previously in order to make compiz work, it will not allow direct rendering on your display. You can check out if this is what it causing the problem by running
:<pre>DISPLAY=:0 glxinfo | grep render</pre>
:If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [http://ubuntuforums.org/showthread.php?t=740287])

:'''Warning:''' This might make your compiz stop working as it is configured to use XGL. A solution might be to run the Envy script in order to configure compiz. Or, if Compiz stopped working due to "Composite" problem, check that the following is set in the /etc/X11/xorg.conf
<pre>
Section "Extensions"
Option "Composite" "Enable"
EndSection
</pre>

----

*Check for AGP and DRI errors in /var/log/Xorg.0.log like these are:
:(EE) fglrx(0): [agp] unable to acquire AGP, error -1023
:(EE) fglrx(0): cannot init AGP
:(EE) fglrx(0): atiddxDriScreenInit failed, GPS not been initialized.
:(WW) fglrx(0): * DRI initialization failed! *

:If you have Intel 8285P and E7205 chipsets and AGP not detected then you have to remove the i82875p_edac module and restart a some others:
<pre>rmmod i82875p_edac
rmmod fglrx
rmmod intel-agp
rmmod agpgart
modprobe agpgart
modprobe intel-agp
modprobe fglrx</pre>

:Blacklist the modules e7xxx_edac so it doesn't start up again when booting - add the following line at the beginning of /etc/modprobe.d/blacklist:
:<pre>blacklist i82875p_edac</pre>

:This has been known to fix issues with -Mesa -AGP -DRI -Google earth and -suspend to RAM (s2ram).

:'''Explanation:''' http://openwetware.org/wiki/Computing/Linux/Ubuntu

----

*Check you are running the correct kernel.
:'''Explanation:''' If you're upgrading from Gutsy to Hardy in some instances the Grub bootloader does not get updated and the new kernel is not loaded.
:Run in a terminal:
:<pre>uname -r</pre>
:If the output starts with 2.6.22 or below you are not using the current kernel and the Ati drivers will not load properly.

If this doesn't help, try [[Ubuntu Gutsy Installation Guide#Verifying]], or other links: [http://wiki.cchtml.com/index.php/Troubleshooting#No_3D_acceleration], [http://www.thinkwiki.org/wiki/Problems_with_fglrx#Perpetual_Mesa_GLX_Indirect_on_Debian], [http://ubuntuforums.org/archive/index.php/t-475699.html].

== Hang at logout ==

If you experience hangs when logging out (of X) it is probably due to the /etc/ati/authatieventsd.sh script looking for X authorisation files in the wrong place when it starts up. You can kill the hanging authatieventsd.sh processes from a console tty to allow the shutdown of the X server. This can be fixed permanently with:

<pre>sudo mkdir -p /var/lib/xdm/authdir
sudo ln -s /var/run/xauth /var/lib/xdm/authdir/authfiles</pre>

If that doesn't work then you can disable atieventsd with this command:

<pre>sudo /usr/sbin/update-rc.d -f atieventsd remove</pre>

== Suspend/Hibernation ==

Suspend hibernation '''works''' with the latest driver.

For ATI X1400, to get the laptop to wake up from suspend, I had to change the following in /etc/default/acpi-support:

<pre>
SAVE_VBE_STATE=false

POST_VIDEO=false

ENABLE_LAPTOP_MODE=false
</pre>

For Radeon 3200, to wake up from suspend, I had to add the following lines to /etc/X11/xorg.conf:
(This settings is not good option, if you are using compiz-fusion or any other transparency-based thingie. Not working for HD 3850)

<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection

Section "ServerFlags"
Option "AIGLX" "off"
EndSection
</pre>

== Can't remove fglrx with dpkg ==

If dpkg really-really refuses to remove an older fglrx-package, it might be needed to edit /var/lib/dpkg/diversions and remove a few lines. This is a hack and should be avoided.

== This module/version combo is already installed ==

If you get this error-message, simply uninstall the previous version before installing the new one with:
<pre>
sudo dkms remove -m fglrx -v 8.522 --all
</pre>

[[Category:Installation Documentation]]

Ubuntu Hardy Installation Guide

2008-10-26T21:13:33Z

24.86.200.120:

For most users it won't be necessary to go into installation and configuration details of the driver. Ubuntu 8.04 (Hardy) provides a notification saying that there are restricted drivers available. You just have to go there (Restricted Drivers Manager) and enable the "ATI accelerated graphics driver". Ubuntu will then install and configure the driver for you. If this does not provide the optimal solution you were looking for, please read ahead.

After installation, in GNOME or Kubuntu, '''turn off visual effects''' or you will notice a flicker in OpenGL.

== Method 1: Install the driver the Ubuntu Way ==

This will install the current driver in Ubuntu's repository. It is older than the one AMD has released, but will be supported by the Ubuntu people. Catalyst 8.3 is in the repositories.

{{Box Terminal|
$ sudo apt-get update

$ sudo apt-get install linux-restricted-modules-generic restricted-manager

$ sudo apt-get install xorg-driver-fglrx

$ sudo depmod -a
}}

The second line may not be necessary as you may already have restricted modules installed. Run it just in case. If the third line fails, you probably don't have the restricted repository enabled. See Pre-Installation.

After this, you may need to edit Xorg.conf:

{{Box Terminal|
$ sudo gedit /etc/X11/xorg.conf
}}

In the device section, if it is not already there add:

{{Box File|/etc/X11/xorg.conf|
Driver "fglrx"
}}

Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:

{{Box Terminal|
$ sudo aticonfig --initial -f
}}

After this you should be able to restart your computer and have the driver working. To test type

{{Box Terminal|
$ fglrxinfo
}}

into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]

==== Post-Installation Tweaks ====
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''

{{Box File|/etc/X11/xorg.conf|
Section "Device"
:[...] 
:Driver "fglrx" 
:Option "VideoOverlay" "on" 
:Option "OpenGLOverlay" "off" 
:[...] 
EndSection
}}

Note that when Visual Effects (Compiz) are active, flickering and artifacts may occur in OpenGL applications and hardware accelerated video windows (particularly with R300 chipset). To prevent this, disable Visual Effects.

On newer cards the options below enables Visual Effects and video to be played without flicker. The Textured video option can be turned on, but this can cause flicker or diagonal artifacts when playing videos.

{{Box File|/etc/X11/xorg.conf|
Section "Device"
:[...] 
:Driver "fglrx" 
:Option "VideoOverlay" "off" 
:Option "OpenGLOverlay" "on" 
:Option "TexturedVideo" "off" 
:[...] 
EndSection
}}

== Method 2: Manual Install Method ==

Make sure ''universe'' and ''multiverse'' are enabled in your repository sources.

===''1. Install necessary build tools.''===
{{Box Terminal|
$ sudo apt-get update 
$ sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
}}

<pre>
sudo apt-get update
sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
</pre>

(package '''cdbs''' is required starting with Catalyst 8.8). On my machine it was installed during the package build process following the below command.

Now use the following command to run the 8.10 setup wizard. Note that the debs are no longer required with 8.10 and that success will be achieved using the actual installer by making the run file an executable.
<pre>sudo chmod -x ati-driver-installer-8-10-x86.x86_64.run
</pre>
<pre>
sudo sh ati-driver-installer-8-10-x86.x86_64.run </pre>

Open a terminal window and switch to the directory you downloaded the installer to.
For example:<pre>cd Desktop</pre>

===''3. Create .deb packages.''===
{{Box Terminal|
$ sh {{catalystfilename}} --buildpkg Ubuntu/hardy
}}
("hardy" is not a typo)

If that command does not work, download the driver itself from the official site (ati.com) and move it to your home folder (/home/<username>)

If that command fails to find libGL.so.1, check your /usr/lib directory for libGL.so with:
<pre>
ls /usr/lib/libGL*
</pre>
If you can see libGL.so in that list then:
<pre>
sudo ln -s /usr/lib/libGL.so /usr/lib/libGL.so.1
</pre>
and Repeat
<pre>
sh ati-driver-installer-8-10-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>
Now we have to blacklist the driver in Ubuntu's repository, so that the new driver will be used.

{{Box Terminal|
$ sudo gedit /etc/default/linux-restricted-modules-common
}}

Add "fglrx" to the line "DISABLED_MODULES"
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

Please note that after the modification above, the "Restricted Driver Manager" will signal "ATI accelerated graphics driver" not enabled (unticked). This is perfectly correct. At the end of the installation procedure it will signal in Status: "in use" (green light), but NOT enabled. It simply means that the fglrx module contained in the linux-restricted-modules package is not enabled, but another fglrx module ({{catalystversion}}) is in use.

You may also need to edit the file(s) (if they exist):
{{Box Terminal|
$ sudo gedit /etc/modprobe.d/blacklist-restricted
$ sudo gedit /etc/modprobe.d/blacklist-local
}}

Put a # in front of the line "blacklist fglrx", if it is present. Otherwise, the kernel module will not load automatically, and you will not get 3D acceleration.

===''5. Install .debs.''===

{{Box Terminal|
$ sudo dpkg -i xorg-driver-fglrx_8.542-0ubuntu1_i386.deb fglrx-kernel-source_8.542-0ubuntu1_i386.deb fglrx-amdcccle_8.542-0ubuntu1_i386.deb
}}
''Using [http://en.wikipedia.org/wiki/Command_line_completion tab completion] can make this command easier.''

=== Additional 64-bit instructions ===

If you have a 64 bit install, the above dpkg command may complain that "Errors were encountered while processing: fglrx-amdcccle". This is because of a dependency of the amdccle package on 32 bit libraries. If you receive this error, issue the following command after the above dpkg command, which will force the installation of all of the 32 bit dependencies, and then the amdccle package:

{{Box Terminal|
$ sudo apt-get install -f
}}

Catalyst {{catalystversion}} on 64-bit systems requires the ''--force-overwrite'' command in the above ''dpkg'' command:
{{Box Terminal|
$ sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.522*.deb fglrx-kernel-source_8.522-0*.deb fglrx-amdcccle_8.522-0*.deb
}}

When installing the packages, if <tt>xorg-driver-fglrx_8.522</tt> fails to install due to a diverted file conflict, you can [http://emmetcaulfield.net/Tech/ATIv84+Hardy/ fix the package with this procedure].

===Fix for an error:===
If you are having this error:
<pre>
dpkg-shlibdeps: failure: couldn't find library libfglrx_gamma.so.1 needed by debian/xorg-driver-fglrx/usr/bin/fglrx_xgamma (its RPATH is '').
</pre>

Fix it by doing the following:
{{Box Terminal|
$ sudo sh ati-driver-installer-8-7-x86.x86_64.run --extract driver
$ cd driver/arch/x86_64/usr/X11R6/lib64
$ sudo ln -s libfglrx_gamma.so.1.0 libfglrx_gamma.so.1
$ cd ../../../../../
$ sudo sh ati-installer.sh -- --buildpkg Ubuntu/hardy
}}

=== Finishing the Install: Configuration ===

If you've used fglrx previously, you will not need to do this.

Now you'll have to edit your xorg.conf
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add the following line to the Device section (if it does not already exist). Include the following lines without '''[...]''':
<pre>Section "Device"
[...]
Driver "fglrx"
[...]
EndSection</pre>
Save and exit, then run
<pre>sudo aticonfig --initial -f</pre>
in a terminal. If it does not error you should be fine.

Some people find that changes to xorg.conf don't get used by the driver. To force the ati driver to adopt changes made to xorg.conf, type the following command:
<pre>
sudo aticonfig --input=/etc/X11/xorg.conf --tls=1
</pre>
Finally, reboot the computer and type
<pre>
fglrxinfo
</pre>
into the terminal. If the vendor string contains ATI, you have installed the driver successfully. Release 8.8 looks like:
<pre>
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: Radeon X1950 Series
OpenGL version string: 2.1.7873 Release
</pre>

Please note: Depending on the particular ATI card that you own, you may or may not automatically have all of the relevant driver features enabled. R500 and R600 cards (X1xxx, HD series, and newer) in particular will need TexturedVideo enabled in Xorg.conf (rather than the traditional VideoOverlay) in order to support Xv accelerated video playback.

=== Removing Mesa drivers ===
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, check:

*Remove the package xserver-xgl.
:<pre>sudo apt-get remove xserver-xgl</pre>
:'''Explanation:''' If you installed this previously in order to make compiz work, it will not allow direct rendering on your display. You can check out if this is what it causing the problem by running
:<pre>DISPLAY=:0 glxinfo | grep render</pre>
:If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [http://ubuntuforums.org/showthread.php?t=740287])

:'''Warning:''' This might make your compiz stop working as it is configured to use XGL. A solution might be to run the Envy script in order to configure compiz. Or, if Compiz stopped working due to "Composite" problem, check that the following is set in the /etc/X11/xorg.conf
<pre>
Section "Extensions"
Option "Composite" "Enable"
EndSection
</pre>

----

*Check for AGP and DRI errors in /var/log/Xorg.0.log like these are:
:(EE) fglrx(0): [agp] unable to acquire AGP, error -1023
:(EE) fglrx(0): cannot init AGP
:(EE) fglrx(0): atiddxDriScreenInit failed, GPS not been initialized.
:(WW) fglrx(0): * DRI initialization failed! *

:If you have Intel 8285P and E7205 chipsets and AGP not detected then you have to remove the i82875p_edac module and restart a some others:
<pre>rmmod i82875p_edac
rmmod fglrx
rmmod intel-agp
rmmod agpgart
modprobe agpgart
modprobe intel-agp
modprobe fglrx</pre>

:Blacklist the modules e7xxx_edac so it doesn't start up again when booting - add the following line at the beginning of /etc/modprobe.d/blacklist:
:<pre>blacklist i82875p_edac</pre>

:This has been known to fix issues with -Mesa -AGP -DRI -Google earth and -suspend to RAM (s2ram).

:'''Explanation:''' http://openwetware.org/wiki/Computing/Linux/Ubuntu

----

*Check you are running the correct kernel.
:'''Explanation:''' If you're upgrading from Gutsy to Hardy in some instances the Grub bootloader does not get updated and the new kernel is not loaded.
:Run in a terminal:
{{Box Terminal|
$ uname -r
}}
:If the output starts with 2.6.22 or below you are not using the current kernel and the Ati drivers will not load properly.

If this doesn't help, try [[Ubuntu Gutsy Installation Guide#Verifying]], or other links: [http://wiki.cchtml.com/index.php/Troubleshooting#No_3D_acceleration], [http://www.thinkwiki.org/wiki/Problems_with_fglrx#Perpetual_Mesa_GLX_Indirect_on_Debian], [http://ubuntuforums.org/archive/index.php/t-475699.html].

== Specific Issues ==

=== Hang at logout ===

If you experience hangs when logging out (of X) it is probably due to the /etc/ati/authatieventsd.sh script looking for X authorisation files in the wrong place when it starts up. You can kill the hanging authatieventsd.sh processes from a console tty to allow the shutdown of the X server. This can be fixed permanently with:

<pre>sudo mkdir -p /var/lib/xdm/authdir
sudo ln -s /var/run/xauth /var/lib/xdm/authdir/authfiles</pre>

If that doesn't work then you can disable atieventsd with this command:

<pre>sudo /usr/sbin/update-rc.d -f atieventsd remove</pre>

=== Suspend/Hibernation ===

Suspend hibernation '''works''' with the latest driver.

For ATI X1400, to get the laptop to wake up from suspend, I had to change the following in /etc/default/acpi-support:

<pre>
SAVE_VBE_STATE=false

POST_VIDEO=false

ENABLE_LAPTOP_MODE=false
</pre>

For Radeon 3200, to wake up from suspend, I had to add the following lines to /etc/X11/xorg.conf:
(This settings is not good option, if you are using compiz-fusion or any other transparency-based thingie. Not working for HD 3850)

<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection

Section "ServerFlags"
Option "AIGLX" "off"
EndSection
</pre>

=== Error! This module/version combo is already installed ===

Simply uninstall the previous version before installing the new one with
<pre>
sudo dkms remove -m fglrx -v 8.522 --all
</pre>

[[Category:Installation Documentation]]

Ubuntu Hardy Installation Guide

2008-10-19T10:18:13Z

24.86.200.120: /* Follow These Instructions Carefully */

== Installation ==

For most users it won't be necessary to go into installation and configuration details of the driver. Ubuntu 8.04 (Hardy) provides a notification saying that there are restricted drivers available. You just have to go there (Restricted Drivers Manager) and enable the "ATI accelerated graphics driver". Ubuntu will then install and configure the driver for you. If this does not provide the optimal solution you were looking for, please read ahead.

After installation, in GNOME or Kubuntu, '''turn off visual effects''' or you will notice a flicker in OpenGL.

=== Method 1: Install the driver the Ubuntu Way ===

This will install the current driver in Ubuntu's repository. It is older than the one AMD has released, but will be supported by the Ubuntu people. Catalyst 8.3 is in the repositories.

<pre>
sudo apt-get update
sudo apt-get install linux-restricted-modules-generic restricted-manager
sudo apt-get install xorg-driver-fglrx
sudo depmod -a
</pre>

The second line may not be necessary as you may already have restricted modules installed. Run it just in case. If the third line fails, you probably don't have the restricted repository enabled. See Pre-Installation.

After this, you may need to edit Xorg.conf:

<pre>
sudo gedit /etc/X11/xorg.conf
</pre>

In the device section, if it is not already there add:

{{Box File|/etc/X11/xorg.conf|
Driver "fglrx"
}}

Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:

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

After this you should be able to restart your computer and have the driver working. To test type

<pre>
fglrxinfo
</pre>

into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]

==== Post-Installation Tweaks ====
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''

<pre>
Section "Device"
[...]
Driver "fglrx"
Option "VideoOverlay" "on"
Option "OpenGLOverlay" "off"
[...]
EndSection
</pre>

Note that when Visual Effects (Compiz) are active, flickering and artifacts may occur in OpenGL applications and hardware accelerated video windows (particularly with R300 chipset). To prevent this, disable Visual Effects.

=== Method 2: Manual Method (installing Catalyst 8.8 or 8.9) ===

wget https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8-9-x86.x86_64.run

(this installer is for 32bit '''and''' 64bit systems)

==== Follow These Instructions Carefully ====

If you are using the x86_64 architecture (64 bit), be sure to inst "ia32-libs" before proceeding!

Make sure ''universe'' and ''multiverse'' are enabled in your repository sources.

Switch to the directory you downloaded the installer to.

<pre>
sudo apt-get update
sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
</pre>

(package '''cdbs''' is required starting with Catalyst 8.8). On my machine it was installed during the package build process following the below command.

Now use the following command to run the 8.10 setup wizard. Note that the debs are no longer required with 8.10 and that success will be achieved using the actually installer by making the run file an executable.
<pre>sudo chmod -x ati-driver-installer-8-10-x86.x86_64.run
</pre>
<pre>
sudo sh ati-driver-installer-8-10-x86.x86_64.run </pre>

Then follow the wizard and select install automatically.

Then:

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

And you are done. The rest of what follows is outdated.....

If that command does not work, download the driver itself from the official site (ati.com) and move it to your home folder (/home/<username>)

If that command fails to find libGL.so.1, check your /usr/lib directory for libGL.so with:
<pre>
ls /usr/lib/libGL*
</pre>
If you can see libGL.so in that list then:
<pre>
sudo ln -s /usr/lib/libGL.so /usr/lib/libGL.so.1
</pre>
and Repeat
<pre>
sh ati-driver-installer-8-10-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>
Now we have to blacklist the driver in Ubuntu's repository, so that the new driver will be used.

<pre>
sudo gedit /etc/default/linux-restricted-modules-common
</pre>

Add "fglrx" to the line "DISABLED_MODULES"
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

Please note that after the modification above, the "Restricted Driver Manager" will signal "ATI accelerated graphics driver" not enabled (unticked). This is perfectly correct. At the end of the installation procedure it will signal in Status: "in use" (green light), but NOT enabled. It simply means that the fglrx module contained in the linux-restricted-modules package is not enabled, but another fglrx module (8.8) is in use.

You may also need to edit the file(s) (if they exist):
<pre>sudo gedit /etc/modprobe.d/blacklist-restricted
sudo gedit /etc/modprobe.d/blacklist-local</pre>

Put a # in front of the line "blacklist fglrx", if it is present. Otherwise, the kernel module will not load automatically, and you will not get 3D acceleration.

Install .debs. If there are no other versions of the driver in the same folder, you can save yourself some typing work:
<pre>
sudo dpkg -i xorg-driver-fglrx_*.deb fglrx-kernel-source_*.deb fglrx-amdcccle_*.deb
</pre>
Otherwise, do not use wildcards. You can use this methode in any case.
<pre>
sudo dpkg -i xorg-driver-fglrx_8.532-0ubuntu1_i386.deb fglrx-kernel-source_8.532-0ubuntu1_i386.deb fglrx-amdcccle_8.532-0ubuntu1_i386.deb
</pre>

==== Additional 64-bit instructions ====

If you have a 64 bit install, the above dpkg command may complain that "Errors were encountered while processing: fglrx-amdcccle". This is because of a dependency of the amdccle package on 32 bit libraries. If you receive this error, issue the following command after the above dpkg command, which will force the installation of all of the 32 bit dependencies, and then the amdccle package:

<pre>
sudo apt-get install -f
</pre>

Catalyst 8.8 on 64-bit systems requires the ''--force-overwrite'' command in the above ''dpkg'' command:
<pre>
sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.522*.deb fglrx-kernel-source_8.522-0*.deb fglrx-amdcccle_8.522-0*.deb
</pre>

When installing the packages, if <tt>xorg-driver-fglrx_8.522</tt> fails to install due to a diverted file conflict, you can [http://emmetcaulfield.net/Tech/ATIv84+Hardy/ fix the package with this procedure].

====Fix for an error:====
If you are having this error:
<pre>
dpkg-shlibdeps: failure: couldn't find library libfglrx_gamma.so.1 needed by debian/xorg-driver-fglrx/usr/bin/fglrx_xgamma (its RPATH is '').
</pre>

Fix it by doing the following:
<pre>
sudo sh ati-driver-installer-8-7-x86.x86_64.run --extract driver
cd driver/arch/x86_64/usr/X11R6/lib64
sudo ln -s libfglrx_gamma.so.1.0 libfglrx_gamma.so.1
cd ../../../../../
sudo sh ati-installer.sh -- --buildpkg Ubuntu/hardy
</pre>

==== Finishing the Install: Configuration ====

If you've used fglrx previously, you will not need to do this.

Now you'll have to edit your xorg.conf
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add the following line to the Device section (if it does not already exist). Include the following lines without '''[...]''':
<pre>Section "Device"
[...]
Driver "fglrx"
[...]
EndSection</pre>
Save and exit, then run
<pre>sudo aticonfig --initial -f</pre>
in a terminal. If it does not error you should be fine.

Some people find that changes to xorg.conf don't get used by the driver. To force the ati driver to adopt changes made to xorg.conf, type the following command:
<pre>
sudo aticonfig --input=/etc/X11/xorg.conf --tls=1
</pre>
Finally, reboot the computer and type
<pre>
fglrxinfo
</pre>
into the terminal. If the vendor string contains ATI, you have installed the driver successfully. Release 8.8 looks like:
<pre>
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: Radeon X1950 Series
OpenGL version string: 2.1.7873 Release
</pre>

Please note: Depending on the particular ATI card that you own, you may or may not automatically have all of the relevant driver features enabled. R500 and R600 cards (X1xxx, HD series, and newer) in particular will need TexturedVideo enabled in Xorg.conf (rather than the traditional VideoOverlay) in order to support Xv accelerated video playback.

=== Removing Mesa drivers ===
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, check:

*Remove the package xserver-xgl.
:<pre>sudo apt-get remove xserver-xgl</pre>
:'''Explanation:''' If you installed this previously in order to make compiz work, it will not allow direct rendering on your display. You can check out if this is what it causing the problem by running
:<pre>DISPLAY=:0 glxinfo | grep render</pre>
:If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [http://ubuntuforums.org/showthread.php?t=740287])

:'''Warning:''' This might make your compiz stop working as it is configured to use XGL. A solution might be to run the Envy script in order to configure compiz. Or, if Compiz stopped working due to "Composite" problem, check that the following is set in the /etc/X11/xorg.conf
<pre>
Section "Extensions"
Option "Composite" "Enable"
EndSection
</pre>

----

*Check for AGP and DRI errors in /var/log/Xorg.0.log like these are:
:(EE) fglrx(0): [agp] unable to acquire AGP, error -1023
:(EE) fglrx(0): cannot init AGP
:(EE) fglrx(0): atiddxDriScreenInit failed, GPS not been initialized.
:(WW) fglrx(0): * DRI initialization failed! *

:If you have Intel 8285P and E7205 chipsets and AGP not detected then you have to remove the i82875p_edac module and restart a some others:
<pre>rmmod i82875p_edac
rmmod fglrx
rmmod intel-agp
rmmod agpgart
modprobe agpgart
modprobe intel-agp
modprobe fglrx</pre>

:Blacklist the modules e7xxx_edac so it doesn't start up again when booting - add the following line at the beginning of /etc/modprobe.d/blacklist:
:<pre>blacklist i82875p_edac</pre>

:This has been known to fix issues with -Mesa -AGP -DRI -Google earth and -suspend to RAM (s2ram).

:'''Explanation:''' http://openwetware.org/wiki/Computing/Linux/Ubuntu

----

*Check you are running the correct kernel.
:'''Explanation:''' If you're upgrading from Gutsy to Hardy in some instances the Grub bootloader does not get updated and the new kernel is not loaded.
:Run in a terminal:
:<pre>uname -r</pre>
:If the output starts with 2.6.22 or below you are not using the current kernel and the Ati drivers will not load properly.

If this doesn't help, try [[Ubuntu Gutsy Installation Guide#Verifying]], or other links: [http://wiki.cchtml.com/index.php/Troubleshooting#No_3D_acceleration], [http://www.thinkwiki.org/wiki/Problems_with_fglrx#Perpetual_Mesa_GLX_Indirect_on_Debian], [http://ubuntuforums.org/archive/index.php/t-475699.html].

== Specific Issues ==

=== Hang at logout ===

If you experience hangs when logging out (of X) it is probably due to the /etc/ati/authatieventsd.sh script looking for X authorisation files in the wrong place when it starts up. You can kill the hanging authatieventsd.sh processes from a console tty to allow the shutdown of the X server. This can be fixed permanently with:

<pre>sudo mkdir -p /var/lib/xdm/authdir
sudo ln -s /var/run/xauth /var/lib/xdm/authdir/authfiles</pre>

If that doesn't work then you can disable atieventsd with this command:

<pre>sudo /usr/sbin/update-rc.d -f atieventsd remove</pre>

=== Suspend/Hibernation ===

Suspend hibernation '''works''' with the latest driver.

For ATI X1400, to get the laptop to wake up from suspend, I had to change the following in /etc/default/acpi-support:

<pre>
SAVE_VBE_STATE=false

POST_VIDEO=false

ENABLE_LAPTOP_MODE=false
</pre>

For Radeon 3200, to wake up from suspend, I had to add the following lines to /etc/X11/xorg.conf:
(This settings is not good option, if you are using compiz-fusion or any other transparency-based thingie. Not working for HD 3850)

<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection

Section "ServerFlags"
Option "AIGLX" "off"
EndSection
</pre>

=== Error! This module/version combo is already installed ===

Simply uninstall the previous version before installing the new one with
<pre>
sudo dkms remove -m fglrx -v 8.522 --all
</pre>

[[Category:Installation Documentation]]

Ubuntu Hardy Installation Guide

2008-10-19T10:17:02Z

24.86.200.120: /* Follow These Instructions Carefully */

== Installation ==

For most users it won't be necessary to go into installation and configuration details of the driver. Ubuntu 8.04 (Hardy) provides a notification saying that there are restricted drivers available. You just have to go there (Restricted Drivers Manager) and enable the "ATI accelerated graphics driver". Ubuntu will then install and configure the driver for you. If this does not provide the optimal solution you were looking for, please read ahead.

After installation, in GNOME or Kubuntu, '''turn off visual effects''' or you will notice a flicker in OpenGL.

=== Method 1: Install the driver the Ubuntu Way ===

This will install the current driver in Ubuntu's repository. It is older than the one AMD has released, but will be supported by the Ubuntu people. Catalyst 8.3 is in the repositories.

<pre>
sudo apt-get update
sudo apt-get install linux-restricted-modules-generic restricted-manager
sudo apt-get install xorg-driver-fglrx
sudo depmod -a
</pre>

The second line may not be necessary as you may already have restricted modules installed. Run it just in case. If the third line fails, you probably don't have the restricted repository enabled. See Pre-Installation.

After this, you may need to edit Xorg.conf:

<pre>
sudo gedit /etc/X11/xorg.conf
</pre>

In the device section, if it is not already there add:

{{Box File|/etc/X11/xorg.conf|
Driver "fglrx"
}}

Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:

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

After this you should be able to restart your computer and have the driver working. To test type

<pre>
fglrxinfo
</pre>

into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]

==== Post-Installation Tweaks ====
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''

<pre>
Section "Device"
[...]
Driver "fglrx"
Option "VideoOverlay" "on"
Option "OpenGLOverlay" "off"
[...]
EndSection
</pre>

Note that when Visual Effects (Compiz) are active, flickering and artifacts may occur in OpenGL applications and hardware accelerated video windows (particularly with R300 chipset). To prevent this, disable Visual Effects.

=== Method 2: Manual Method (installing Catalyst 8.8 or 8.9) ===

wget https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8-9-x86.x86_64.run

(this installer is for 32bit '''and''' 64bit systems)

==== Follow These Instructions Carefully ====

If you are using the x86_64 architecture (64 bit), be sure to inst "ia32-libs" before proceeding!

Make sure ''universe'' and ''multiverse'' are enabled in your repository sources.

Switch to the directory you downloaded the installer to.

<pre>
sudo apt-get update
sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
</pre>

(package '''cdbs''' is required starting with Catalyst 8.8). On my machine it was installed during the package build process following the below command.

Now use the following command to run the 8.10 setup wizard. Note that the debs are no longer required with 8.10 and that success will be achieved using the actually installer by making the run file an executable.
<pre>sudo chmod -x ati-driver-installer-8-10-x86.x86_64.run
</pre>
<pre>
sh ati-driver-installer-8-10-x86.x86_64.run </pre>

Then follow the wizard and select install automatically.

Then:

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

And you are done. The rest of what follows is outdated.....

If that command does not work, download the driver itself from the official site (ati.com) and move it to your home folder (/home/<username>)

If that command fails to find libGL.so.1, check your /usr/lib directory for libGL.so with:
<pre>
ls /usr/lib/libGL*
</pre>
If you can see libGL.so in that list then:
<pre>
sudo ln -s /usr/lib/libGL.so /usr/lib/libGL.so.1
</pre>
and Repeat
<pre>
sh ati-driver-installer-8-10-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>
Now we have to blacklist the driver in Ubuntu's repository, so that the new driver will be used.

<pre>
sudo gedit /etc/default/linux-restricted-modules-common
</pre>

Add "fglrx" to the line "DISABLED_MODULES"
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

Please note that after the modification above, the "Restricted Driver Manager" will signal "ATI accelerated graphics driver" not enabled (unticked). This is perfectly correct. At the end of the installation procedure it will signal in Status: "in use" (green light), but NOT enabled. It simply means that the fglrx module contained in the linux-restricted-modules package is not enabled, but another fglrx module (8.8) is in use.

You may also need to edit the file(s) (if they exist):
<pre>sudo gedit /etc/modprobe.d/blacklist-restricted
sudo gedit /etc/modprobe.d/blacklist-local</pre>

Put a # in front of the line "blacklist fglrx", if it is present. Otherwise, the kernel module will not load automatically, and you will not get 3D acceleration.

Install .debs. If there are no other versions of the driver in the same folder, you can save yourself some typing work:
<pre>
sudo dpkg -i xorg-driver-fglrx_*.deb fglrx-kernel-source_*.deb fglrx-amdcccle_*.deb
</pre>
Otherwise, do not use wildcards. You can use this methode in any case.
<pre>
sudo dpkg -i xorg-driver-fglrx_8.532-0ubuntu1_i386.deb fglrx-kernel-source_8.532-0ubuntu1_i386.deb fglrx-amdcccle_8.532-0ubuntu1_i386.deb
</pre>

==== Additional 64-bit instructions ====

If you have a 64 bit install, the above dpkg command may complain that "Errors were encountered while processing: fglrx-amdcccle". This is because of a dependency of the amdccle package on 32 bit libraries. If you receive this error, issue the following command after the above dpkg command, which will force the installation of all of the 32 bit dependencies, and then the amdccle package:

<pre>
sudo apt-get install -f
</pre>

Catalyst 8.8 on 64-bit systems requires the ''--force-overwrite'' command in the above ''dpkg'' command:
<pre>
sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.522*.deb fglrx-kernel-source_8.522-0*.deb fglrx-amdcccle_8.522-0*.deb
</pre>

When installing the packages, if <tt>xorg-driver-fglrx_8.522</tt> fails to install due to a diverted file conflict, you can [http://emmetcaulfield.net/Tech/ATIv84+Hardy/ fix the package with this procedure].

====Fix for an error:====
If you are having this error:
<pre>
dpkg-shlibdeps: failure: couldn't find library libfglrx_gamma.so.1 needed by debian/xorg-driver-fglrx/usr/bin/fglrx_xgamma (its RPATH is '').
</pre>

Fix it by doing the following:
<pre>
sudo sh ati-driver-installer-8-7-x86.x86_64.run --extract driver
cd driver/arch/x86_64/usr/X11R6/lib64
sudo ln -s libfglrx_gamma.so.1.0 libfglrx_gamma.so.1
cd ../../../../../
sudo sh ati-installer.sh -- --buildpkg Ubuntu/hardy
</pre>

==== Finishing the Install: Configuration ====

If you've used fglrx previously, you will not need to do this.

Now you'll have to edit your xorg.conf
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add the following line to the Device section (if it does not already exist). Include the following lines without '''[...]''':
<pre>Section "Device"
[...]
Driver "fglrx"
[...]
EndSection</pre>
Save and exit, then run
<pre>sudo aticonfig --initial -f</pre>
in a terminal. If it does not error you should be fine.

Some people find that changes to xorg.conf don't get used by the driver. To force the ati driver to adopt changes made to xorg.conf, type the following command:
<pre>
sudo aticonfig --input=/etc/X11/xorg.conf --tls=1
</pre>
Finally, reboot the computer and type
<pre>
fglrxinfo
</pre>
into the terminal. If the vendor string contains ATI, you have installed the driver successfully. Release 8.8 looks like:
<pre>
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: Radeon X1950 Series
OpenGL version string: 2.1.7873 Release
</pre>

Please note: Depending on the particular ATI card that you own, you may or may not automatically have all of the relevant driver features enabled. R500 and R600 cards (X1xxx, HD series, and newer) in particular will need TexturedVideo enabled in Xorg.conf (rather than the traditional VideoOverlay) in order to support Xv accelerated video playback.

=== Removing Mesa drivers ===
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, check:

*Remove the package xserver-xgl.
:<pre>sudo apt-get remove xserver-xgl</pre>
:'''Explanation:''' If you installed this previously in order to make compiz work, it will not allow direct rendering on your display. You can check out if this is what it causing the problem by running
:<pre>DISPLAY=:0 glxinfo | grep render</pre>
:If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [http://ubuntuforums.org/showthread.php?t=740287])

:'''Warning:''' This might make your compiz stop working as it is configured to use XGL. A solution might be to run the Envy script in order to configure compiz. Or, if Compiz stopped working due to "Composite" problem, check that the following is set in the /etc/X11/xorg.conf
<pre>
Section "Extensions"
Option "Composite" "Enable"
EndSection
</pre>

----

*Check for AGP and DRI errors in /var/log/Xorg.0.log like these are:
:(EE) fglrx(0): [agp] unable to acquire AGP, error -1023
:(EE) fglrx(0): cannot init AGP
:(EE) fglrx(0): atiddxDriScreenInit failed, GPS not been initialized.
:(WW) fglrx(0): * DRI initialization failed! *

:If you have Intel 8285P and E7205 chipsets and AGP not detected then you have to remove the i82875p_edac module and restart a some others:
<pre>rmmod i82875p_edac
rmmod fglrx
rmmod intel-agp
rmmod agpgart
modprobe agpgart
modprobe intel-agp
modprobe fglrx</pre>

:Blacklist the modules e7xxx_edac so it doesn't start up again when booting - add the following line at the beginning of /etc/modprobe.d/blacklist:
:<pre>blacklist i82875p_edac</pre>

:This has been known to fix issues with -Mesa -AGP -DRI -Google earth and -suspend to RAM (s2ram).

:'''Explanation:''' http://openwetware.org/wiki/Computing/Linux/Ubuntu

----

*Check you are running the correct kernel.
:'''Explanation:''' If you're upgrading from Gutsy to Hardy in some instances the Grub bootloader does not get updated and the new kernel is not loaded.
:Run in a terminal:
:<pre>uname -r</pre>
:If the output starts with 2.6.22 or below you are not using the current kernel and the Ati drivers will not load properly.

If this doesn't help, try [[Ubuntu Gutsy Installation Guide#Verifying]], or other links: [http://wiki.cchtml.com/index.php/Troubleshooting#No_3D_acceleration], [http://www.thinkwiki.org/wiki/Problems_with_fglrx#Perpetual_Mesa_GLX_Indirect_on_Debian], [http://ubuntuforums.org/archive/index.php/t-475699.html].

== Specific Issues ==

=== Hang at logout ===

If you experience hangs when logging out (of X) it is probably due to the /etc/ati/authatieventsd.sh script looking for X authorisation files in the wrong place when it starts up. You can kill the hanging authatieventsd.sh processes from a console tty to allow the shutdown of the X server. This can be fixed permanently with:

<pre>sudo mkdir -p /var/lib/xdm/authdir
sudo ln -s /var/run/xauth /var/lib/xdm/authdir/authfiles</pre>

If that doesn't work then you can disable atieventsd with this command:

<pre>sudo /usr/sbin/update-rc.d -f atieventsd remove</pre>

=== Suspend/Hibernation ===

Suspend hibernation '''works''' with the latest driver.

For ATI X1400, to get the laptop to wake up from suspend, I had to change the following in /etc/default/acpi-support:

<pre>
SAVE_VBE_STATE=false

POST_VIDEO=false

ENABLE_LAPTOP_MODE=false
</pre>

For Radeon 3200, to wake up from suspend, I had to add the following lines to /etc/X11/xorg.conf:
(This settings is not good option, if you are using compiz-fusion or any other transparency-based thingie. Not working for HD 3850)

<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection

Section "ServerFlags"
Option "AIGLX" "off"
EndSection
</pre>

=== Error! This module/version combo is already installed ===

Simply uninstall the previous version before installing the new one with
<pre>
sudo dkms remove -m fglrx -v 8.522 --all
</pre>

[[Category:Installation Documentation]]

Ubuntu Hardy Installation Guide

2008-10-19T09:51:52Z

24.86.200.120: /* Follow These Instructions Carefully */ updated for catalyst 8.10

== Installation ==

For most users it won't be necessary to go into installation and configuration details of the driver. Ubuntu 8.04 (Hardy) provides a notification saying that there are restricted drivers available. You just have to go there (Restricted Drivers Manager) and enable the "ATI accelerated graphics driver". Ubuntu will then install and configure the driver for you. If this does not provide the optimal solution you were looking for, please read ahead.

After installation, in GNOME or Kubuntu, '''turn off visual effects''' or you will notice a flicker in OpenGL.

=== Method 1: Install the driver the Ubuntu Way ===

This will install the current driver in Ubuntu's repository. It is older than the one AMD has released, but will be supported by the Ubuntu people. Catalyst 8.3 is in the repositories.

<pre>
sudo apt-get update
sudo apt-get install linux-restricted-modules-generic restricted-manager
sudo apt-get install xorg-driver-fglrx
sudo depmod -a
</pre>

The second line may not be necessary as you may already have restricted modules installed. Run it just in case. If the third line fails, you probably don't have the restricted repository enabled. See Pre-Installation.

After this, you may need to edit Xorg.conf:

<pre>
sudo gedit /etc/X11/xorg.conf
</pre>

In the device section, if it is not already there add:

{{Box File|/etc/X11/xorg.conf|
Driver "fglrx"
}}

Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:

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

After this you should be able to restart your computer and have the driver working. To test type

<pre>
fglrxinfo
</pre>

into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]

==== Post-Installation Tweaks ====
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''

<pre>
Section "Device"
[...]
Driver "fglrx"
Option "VideoOverlay" "on"
Option "OpenGLOverlay" "off"
[...]
EndSection
</pre>

Note that when Visual Effects (Compiz) are active, flickering and artifacts may occur in OpenGL applications and hardware accelerated video windows (particularly with R300 chipset). To prevent this, disable Visual Effects.

=== Method 2: Manual Method (installing Catalyst 8.8 or 8.9) ===

wget https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8-9-x86.x86_64.run

(this installer is for 32bit '''and''' 64bit systems)

==== Follow These Instructions Carefully ====

If you are using the x86_64 architecture (64 bit), be sure to inst "ia32-libs" before proceeding!

Make sure ''universe'' and ''multiverse'' are enabled in your repository sources.

Switch to the directory you downloaded the installer to.

<pre>
sudo apt-get update
sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
</pre>

(package '''cdbs''' is required starting with Catalyst 8.8). On my machine it was installed during the package build process following the below command.

Now use the following command to create the .deb files you will be using for installation:
<pre>
sh ati-driver-installer-8-10-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>

If that command does not work, download the driver itself from the official site (ati.com) and move it to your home folder (/home/<username>)

If that command fails to find libGL.so.1, check your /usr/lib directory for libGL.so with:
<pre>
ls /usr/lib/libGL*
</pre>
If you can see libGL.so in that list then:
<pre>
sudo ln -s /usr/lib/libGL.so /usr/lib/libGL.so.1
</pre>
and Repeat
<pre>
sh ati-driver-installer-8-10-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>
Now we have to blacklist the driver in Ubuntu's repository, so that the new driver will be used.

<pre>
sudo gedit /etc/default/linux-restricted-modules-common
</pre>

Add "fglrx" to the line "DISABLED_MODULES"
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

Please note that after the modification above, the "Restricted Driver Manager" will signal "ATI accelerated graphics driver" not enabled (unticked). This is perfectly correct. At the end of the installation procedure it will signal in Status: "in use" (green light), but NOT enabled. It simply means that the fglrx module contained in the linux-restricted-modules package is not enabled, but another fglrx module (8.8) is in use.

You may also need to edit the file(s) (if they exist):
<pre>sudo gedit /etc/modprobe.d/blacklist-restricted
sudo gedit /etc/modprobe.d/blacklist-local</pre>

Put a # in front of the line "blacklist fglrx", if it is present. Otherwise, the kernel module will not load automatically, and you will not get 3D acceleration.

Install .debs. If there are no other versions of the driver in the same folder, you can save yourself some typing work:
<pre>
sudo dpkg -i xorg-driver-fglrx_*.deb fglrx-kernel-source_*.deb fglrx-amdcccle_*.deb
</pre>
Otherwise, do not use wildcards. You can use this methode in any case.
<pre>
sudo dpkg -i xorg-driver-fglrx_8.532-0ubuntu1_i386.deb fglrx-kernel-source_8.532-0ubuntu1_i386.deb fglrx-amdcccle_8.532-0ubuntu1_i386.deb
</pre>

==== Additional 64-bit instructions ====

If you have a 64 bit install, the above dpkg command may complain that "Errors were encountered while processing: fglrx-amdcccle". This is because of a dependency of the amdccle package on 32 bit libraries. If you receive this error, issue the following command after the above dpkg command, which will force the installation of all of the 32 bit dependencies, and then the amdccle package:

<pre>
sudo apt-get install -f
</pre>

Catalyst 8.8 on 64-bit systems requires the ''--force-overwrite'' command in the above ''dpkg'' command:
<pre>
sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.522*.deb fglrx-kernel-source_8.522-0*.deb fglrx-amdcccle_8.522-0*.deb
</pre>

When installing the packages, if <tt>xorg-driver-fglrx_8.522</tt> fails to install due to a diverted file conflict, you can [http://emmetcaulfield.net/Tech/ATIv84+Hardy/ fix the package with this procedure].

====Fix for an error:====
If you are having this error:
<pre>
dpkg-shlibdeps: failure: couldn't find library libfglrx_gamma.so.1 needed by debian/xorg-driver-fglrx/usr/bin/fglrx_xgamma (its RPATH is '').
</pre>

Fix it by doing the following:
<pre>
sudo sh ati-driver-installer-8-7-x86.x86_64.run --extract driver
cd driver/arch/x86_64/usr/X11R6/lib64
sudo ln -s libfglrx_gamma.so.1.0 libfglrx_gamma.so.1
cd ../../../../../
sudo sh ati-installer.sh -- --buildpkg Ubuntu/hardy
</pre>

==== Finishing the Install: Configuration ====

If you've used fglrx previously, you will not need to do this.

Now you'll have to edit your xorg.conf
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add the following line to the Device section (if it does not already exist). Include the following lines without '''[...]''':
<pre>Section "Device"
[...]
Driver "fglrx"
[...]
EndSection</pre>
Save and exit, then run
<pre>sudo aticonfig --initial -f</pre>
in a terminal. If it does not error you should be fine.

Some people find that changes to xorg.conf don't get used by the driver. To force the ati driver to adopt changes made to xorg.conf, type the following command:
<pre>
sudo aticonfig --input=/etc/X11/xorg.conf --tls=1
</pre>
Finally, reboot the computer and type
<pre>
fglrxinfo
</pre>
into the terminal. If the vendor string contains ATI, you have installed the driver successfully. Release 8.8 looks like:
<pre>
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: Radeon X1950 Series
OpenGL version string: 2.1.7873 Release
</pre>

Please note: Depending on the particular ATI card that you own, you may or may not automatically have all of the relevant driver features enabled. R500 and R600 cards (X1xxx, HD series, and newer) in particular will need TexturedVideo enabled in Xorg.conf (rather than the traditional VideoOverlay) in order to support Xv accelerated video playback.

=== Removing Mesa drivers ===
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, check:

*Remove the package xserver-xgl.
:<pre>sudo apt-get remove xserver-xgl</pre>
:'''Explanation:''' If you installed this previously in order to make compiz work, it will not allow direct rendering on your display. You can check out if this is what it causing the problem by running
:<pre>DISPLAY=:0 glxinfo | grep render</pre>
:If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [http://ubuntuforums.org/showthread.php?t=740287])

:'''Warning:''' This might make your compiz stop working as it is configured to use XGL. A solution might be to run the Envy script in order to configure compiz. Or, if Compiz stopped working due to "Composite" problem, check that the following is set in the /etc/X11/xorg.conf
<pre>
Section "Extensions"
Option "Composite" "Enable"
EndSection
</pre>

----

*Check for AGP and DRI errors in /var/log/Xorg.0.log like these are:
:(EE) fglrx(0): [agp] unable to acquire AGP, error -1023
:(EE) fglrx(0): cannot init AGP
:(EE) fglrx(0): atiddxDriScreenInit failed, GPS not been initialized.
:(WW) fglrx(0): * DRI initialization failed! *

:If you have Intel 8285P and E7205 chipsets and AGP not detected then you have to remove the i82875p_edac module and restart a some others:
<pre>rmmod i82875p_edac
rmmod fglrx
rmmod intel-agp
rmmod agpgart
modprobe agpgart
modprobe intel-agp
modprobe fglrx</pre>

:Blacklist the modules e7xxx_edac so it doesn't start up again when booting - add the following line at the beginning of /etc/modprobe.d/blacklist:
:<pre>blacklist i82875p_edac</pre>

:This has been known to fix issues with -Mesa -AGP -DRI -Google earth and -suspend to RAM (s2ram).

:'''Explanation:''' http://openwetware.org/wiki/Computing/Linux/Ubuntu

----

*Check you are running the correct kernel.
:'''Explanation:''' If you're upgrading from Gutsy to Hardy in some instances the Grub bootloader does not get updated and the new kernel is not loaded.
:Run in a terminal:
:<pre>uname -r</pre>
:If the output starts with 2.6.22 or below you are not using the current kernel and the Ati drivers will not load properly.

If this doesn't help, try [[Ubuntu Gutsy Installation Guide#Verifying]], or other links: [http://wiki.cchtml.com/index.php/Troubleshooting#No_3D_acceleration], [http://www.thinkwiki.org/wiki/Problems_with_fglrx#Perpetual_Mesa_GLX_Indirect_on_Debian], [http://ubuntuforums.org/archive/index.php/t-475699.html].

== Specific Issues ==

=== Hang at logout ===

If you experience hangs when logging out (of X) it is probably due to the /etc/ati/authatieventsd.sh script looking for X authorisation files in the wrong place when it starts up. You can kill the hanging authatieventsd.sh processes from a console tty to allow the shutdown of the X server. This can be fixed permanently with:

<pre>sudo mkdir -p /var/lib/xdm/authdir
sudo ln -s /var/run/xauth /var/lib/xdm/authdir/authfiles</pre>

If that doesn't work then you can disable atieventsd with this command:

<pre>sudo /usr/sbin/update-rc.d -f atieventsd remove</pre>

=== Suspend/Hibernation ===

Suspend hibernation '''works''' with the latest driver.

For ATI X1400, to get the laptop to wake up from suspend, I had to change the following in /etc/default/acpi-support:

<pre>
SAVE_VBE_STATE=false

POST_VIDEO=false

ENABLE_LAPTOP_MODE=false
</pre>

For Radeon 3200, to wake up from suspend, I had to add the following lines to /etc/X11/xorg.conf:
(This settings is not good option, if you are using compiz-fusion or any other transparency-based thingie. Not working for HD 3850)

<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection

Section "ServerFlags"
Option "AIGLX" "off"
EndSection
</pre>

=== Error! This module/version combo is already installed ===

Simply uninstall the previous version before installing the new one with
<pre>
sudo dkms remove -m fglrx -v 8.522 --all
</pre>

[[Category:Installation Documentation]]