Ubuntu Hardy Installation Guide: Difference between revisions

From cchtml.com
No edit summary
m (Protected "Ubuntu Hardy Installation Guide": Excessive vandalism (‎[edit=autoconfirmed] (indefinite) ‎[move=autoconfirmed] (indefinite)))
 
(177 intermediate revisions by 94 users not shown)
Line 1: Line 1:
==Pre-Installation Checks==
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.
=== Enable "restricted" Repository ===
Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!


System > Administration > Software Sources.  Check "Proprietary Drivers for Devices (Restricted)" box.
After installation, in GNOME or Kubuntu, '''turn off visual effects''' or you will notice a flicker in OpenGL.




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


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


=== Method 1: Install the driver the Ubuntu Way ===
$ sudo apt-get install linux-restricted-modules-generic restricted-manager


This will install the current driver in Ubuntu's repository. It may be older than the one AMD has released, but as of writing, Catalyst 8.4 is in the repositories. It would seem that Ubuntu gets new builds for the Catalyst drivers a few weeks after AMD releases them.
$ sudo apt-get install xorg-driver-fglrx


<pre>
$ sudo depmod -a
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.
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'll may need to edit Xorg.conf:
After this, you may need to edit Xorg.conf:


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


In the device section, if it is not already there add:
In the device section, if it is not already there add:
Line 38: Line 34:
Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:
Then to make sure Xorg is set up correctly, you'll have to let aticonfig "initialize" it:


<pre>
{{Box Terminal|
sudo aticonfig --initial -f
$ sudo aticonfig --initial -f
</pre>
}}


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


<pre>
{{Box Terminal|
fglrxinfo
$ fglrxinfo
</pre>
}}


into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]
into a terminal. If the vendor string is not ATI, but Mesa, check [[#Removing Mesa drivers]]
Line 53: Line 49:
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''
To enable hardware accelerated video on pre-R500 cards, edit '''/etc/X11/xorg.conf''' to include the following lines without '''[...]'''


<pre>
{{Box File|/etc/X11/xorg.conf|
Section "Device"
Section "Device"
[...]
:[...]<br />
Driver "fglrx"
:Driver "fglrx"<br />
Option "VideoOverlay" "on"
:Option "VideoOverlay" "on"<br />
Option "OpenGLOverlay" "off"
:Option "OpenGLOverlay" "off"<br />
[...]
:[...]<br />
EndSection
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.
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 ===
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"
:[...]<br />
:Driver "fglrx"<br />
:Option "VideoOverlay" "off"<br />
:Option "OpenGLOverlay" "on"<br />
:Option "TexturedVideo" "off"<br />
:[...]<br />
EndSection
}}
 
== Method 2: Manual Install Method ==
 
Make sure ''universe'' and ''multiverse'' are enabled in your repository sources.
 
===''1. Install necessary build tools and libraries''===
{{Box Terminal|
$ sudo apt-get update<br />
$ sudo apt-get install build-essential cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)<br />
# If you are using the x86_64 architecture (64 bit, earlier known as amd64), install ia32-libs as well:<br />
$ sudo apt-get install ia32-libs
}}


Download the installer:
===''2. Download the latest Catalyst package.''===
[https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8-4-x86.x86_64.run ati-driver-installer-8-4-x86.x86_64.run] (this installer is for 32bit '''and''' 64bit systems)


==== Follow These Instructions Carefully ====
Download page: Catalyst {{catalystversion}}. This package contains both the 32-bit and 64-bit driver.


Switch to the directory you downloaded this into and the run the following. (Make sure ''universe'' and ''multiverse'' are enabled in your repository sources).
Open a terminal window and switch to the directory you downloaded the installer to.  
For example:<pre>cd Desktop</pre>


<pre>
'''or''' just use wget:
sudo apt-get update
{{Box Terminal|
sudo apt-get install build-essential fakeroot dh-make debhelper debconf libstdc++5 dkms linux-headers-$(uname -r)
$ wget http://www2.ati.com/drivers/linux/{{catalystfilename}}
</pre>
}}
 
===''3. Create .deb packages.''===
{{Box Terminal|
$ chmod +x {{catalystfilename}}


This installs the dependencies for the installer.
$ sh {{catalystfilename}} --buildpkg Ubuntu/hardy
}}
("hardy" is not a typo)


===''4. Add driver to kernel module blacklist.''===
'''NOTE''': This step is no longer necessary with fglrx 8.10 or 8.12. Just jump to step 5 in that case.


Using Synaptic, completely remove any packages containing "fglrx" in their name.
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.


If using 64bit make sure to collect package "ia32-libs" and " libGL.so.1" before proceeding!
{{Box Terminal|
$ sudo gedit /etc/default/linux-restricted-modules-common
}}


If you have a problem getting the libGL.so.1, create a symbolic link to it:
Add "fglrx" to the line "DISABLED_MODULES"
<pre>
{{Box File|/etc/default/linux-restricted-modules-common|
sudo ln -s /usr/lib/libGL.so.1.2 /usr/lib/libGL.so.1
<pre>DISABLED_MODULES="fglrx"</pre>
</pre>
}}


Remove any old fglrx .debs:
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.
<pre>
sudo rm /usr/src/fglrx-kernel*.deb
</pre>


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


Now use the following command to create the .deb files you will be using for installation:
$ 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.
sudo sh ati-driver-installer-8-4-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>


As an alternative, you can just use
===''5. Install .debs.''===
<pre>
sudo sh ./ati-driver-installer-8-4-x86.x86_64.run --buildpkg Ubuntu --autopkg
</pre>


'''For 32 Bits'''


Now we have to blacklist the driver in Ubuntu's repository. This is so it doesn't ever overwrite our installation.
{{Box Terminal|
$ sudo dpkg -i xorg-driver-fglrx_8.593-0ubuntu1_i386.deb fglrx-kernel-source_8.593-0ubuntu1_i386.deb fglrx-amdcccle_8.593-0ubuntu1_i386.deb
}}
''Using [http://en.wikipedia.org/wiki/Command_line_completion tab completion] can make this command easier.''


<pre>
Starting Catalyst version 8.10, installing the following package ensures compatibility with restricted drivers' manager:
sudo gedit /etc/default/linux-restricted-modules-common
</pre>


Add "fglrx" to the line "DISABLED_MODULES"
{{Box Terminal|
{{Box File|/etc/default/linux-restricted-modules-common|
$ sudo dpkg -i fglrx-modaliases_8.593-0ubuntu1_i386.deb
<pre>DISABLED_MODULES="fglrx"</pre>
}}
}}


64 bit systems should have the same behaviour.
{{Box Terminal|
sudo dpkg -i fglrx-modaliases_8.593-0ubuntu1_amd64.deb
}}


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.4) is in use.
'''For 64 Bits'''


You may also need to edit the file (if it exists):
{{Box Terminal|
<pre>sudo gedit /etc/modprobe.d/blacklist-restricted</pre>
$ sudo dpkg -i xorg-driver-fglrx_8.593-0ubuntu1_amd64.deb fglrx-kernel-source_8.593-0ubuntu1_amd64.deb fglrx-amdcccle_8.593-0ubuntu1_amd64.deb
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.
}}
''Using [http://en.wikipedia.org/wiki/Command_line_completion tab completion] can make this command easier.''


Install .debs:
=== Additional 64-bit instructions ===


<pre>
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:
sudo dpkg -i xorg-driver-fglrx_8.476*.deb fglrx-kernel-source_8.476-0*.deb fglrx-amdcccle_8.476-0*.deb
</pre>


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


==== Additional 64-bit instructions ====
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.593*.deb fglrx-kernel-source_8.593-0*.deb fglrx-amdcccle_8.593-0*.deb
}}


If you have a 64 bit install, the above dpkg command will likely 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:
When installing the packages, if <tt>xorg-driver-fglrx_8.593</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>
<pre>
sudo apt-get install -f
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>
</pre>


Catalyst 8.4 on 64-bit systems requires the ''--force-overwrite'' command in the above ''dpkg'' command:
Fix it by doing the following:
{{Box Terminal|
$ sudo sh {{catalystfilename}} --extract driver<br />
$ cd driver/arch/x86_64/usr/X11R6/lib64<br />
$ sudo ln -s libfglrx_gamma.so.1.0 libfglrx_gamma.so.1<br />
$ cd ../../../../../<br />
$ sudo sh ati-installer.sh -- --buildpkg Ubuntu/hardy<br />
}}
 
If you get this error from modprobe fglrx:
<pre>
<pre>
sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.476*.deb fglrx-kernel-source_8.476-0*.deb fglrx-amdcccle_8.476-0*.deb
ERROR: firegl_stub_register failed
</pre>
</pre>


When installing the packages, if <tt>xorg-driver-fglrx_8.476</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 it by doing:
{{Box Terminal|
$ sudo rmmod radeon<br />
$ sudo rmmod drm<br />
$ sudo modprobe fglrx<br />
}}


=== Finishing the Install: Configuration ===


==== 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
Run
<pre>sudo aticonfig --initial -f</pre>
 
Now you'll likely have to edit your xorg.conf (even if just to confirm the above command added the apropriate fglrx line):
<pre>sudo gedit /etc/X11/xorg.conf</pre>
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add the following line to the Device section (if it does not already exist):
and add the following line to the Device section (if it does not already exist).  Include the following lines without '''[...]''':  
<pre>Section "Device"
<pre>Section "Device"
[...]
[...]
Line 159: Line 214:
[...]
[...]
EndSection</pre>
EndSection</pre>
Save and exit, then run
Make the appropriate changes to "TexturedVideo" and "Overlay", etc., as described above in the "automatic section".
<pre>sudo aticonfig --initial -f</pre>
Save and exit, then  
in a terminal. If it does not error you should be fine. Finally, reboot the computer and type
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>
<pre>
fglrxinfo
fglrxinfo
</pre>
</pre>
into the terminal. If the vendor string contains ATI, you have installed the driver successfully.
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.
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 ===
=== Removing Mesa drivers ===
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, check:
If fglrxinfo reports that Indirect rendering by Mesa is in place, even though you have installed ATI driver, check:


:*Remove the package xserver-xgl.  
*Remove the package xserver-xgl.
::'''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>sudo apt-get remove xserver-xgl</pre>
::<pre>DISPLAY=:0 glxinfo | grep render</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
::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])
:<pre>DISPLAY=:0 glxinfo | grep render</pre>
::'''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.
: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])
::Also, if Compiz stopped working due to "Composite" problem, check that
 
:'''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>
<pre>
Section "Extensions"
Section "Extensions"
Line 185: Line 252:
EndSection
EndSection
</pre>
</pre>
::is set.


:*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.
*Check for AGP and DRI errors in /var/log/Xorg.0.log like these are:
:<i>(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!                  *</i>
 
: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].
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].
Line 197: Line 295:
== Specific Issues ==
== Specific Issues ==


=== Hang at logout ===
===Segmentation Fault with glxinfo/fglrxinfo===
 
If you experience such errors (and have ''glxinfo'' report ''"Direct rendering"'' as ''No'' despite following the whole procedure without any errors) you may want to have a look at the '''Specific Issues''' chapter of the '''Ubuntu Gutsy Installation Guide''' [[http://wiki.cchtml.com/index.php/Ubuntu_Gutsy_Installation_Guide#If_you_get__.2Fusr.2FX11R6.2Flib.2Fmodules.2Fdri.2Ffglrx_dri.so_not_found]] as this may be due to missing links or wrong permissions.
 
That's cleared my thuohgts. Thanks for contributing.
 
=== 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>


If you experience hangs when logging out (of X) try disabling atieventsd with this command:
Resume from suspend failed when using dual monitor configuration in xorg.conf.
E.g. when using
<pre>
aticonfig --initial=dual-head --screen-layout=right
</pre>
Switching back to a single monitor configuration and restarting the xserver (though not beautiful) solves this.


<pre>sudo /usr/sbin/update-rc.d -f atieventsd remove</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>


=== Suspend/Hibernation does NOT work ===
[[Category:Installation Documentation]]

Latest revision as of 18:46, 30 January 2013

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.

Terminal Command

$ 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:

Terminal Command

$ sudo gedit /etc/X11/xorg.conf

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

File: /etc/X11/xorg.conf

Driver "fglrx"

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

Terminal Command

$ sudo aticonfig --initial -f

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

Terminal Command

$ 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 [...]

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.

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 and libraries

Terminal Command

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

# If you are using the x86_64 architecture (64 bit, earlier known as amd64), install ia32-libs as well:

$ sudo apt-get install ia32-libs

2. Download the latest Catalyst package.

Download page: Catalyst 15.12. 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.

For example:

cd Desktop

or just use wget:

Terminal Command

$ wget http://www2.ati.com/drivers/linux/radeon-crimson-15.12-15.302-151217a-297685e.zip

3. Create .deb packages.

Terminal Command

$ chmod +x radeon-crimson-15.12-15.302-151217a-297685e.zip

$ sh radeon-crimson-15.12-15.302-151217a-297685e.zip --buildpkg Ubuntu/hardy

("hardy" is not a typo)

4. Add driver to kernel module blacklist.

NOTE: This step is no longer necessary with fglrx 8.10 or 8.12. Just jump to step 5 in that case.

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.

Terminal Command

$ sudo gedit /etc/default/linux-restricted-modules-common

Add "fglrx" to the line "DISABLED_MODULES"

File: /etc/default/linux-restricted-modules-common
DISABLED_MODULES="fglrx"

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 (15.12) is in use.

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

Terminal Command

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

For 32 Bits

Terminal Command

$ sudo dpkg -i xorg-driver-fglrx_8.593-0ubuntu1_i386.deb fglrx-kernel-source_8.593-0ubuntu1_i386.deb fglrx-amdcccle_8.593-0ubuntu1_i386.deb

Using tab completion can make this command easier.

Starting Catalyst version 8.10, installing the following package ensures compatibility with restricted drivers' manager:

Terminal Command

$ sudo dpkg -i fglrx-modaliases_8.593-0ubuntu1_i386.deb

64 bit systems should have the same behaviour.

Terminal Command

sudo dpkg -i fglrx-modaliases_8.593-0ubuntu1_amd64.deb

For 64 Bits

Terminal Command

$ sudo dpkg -i xorg-driver-fglrx_8.593-0ubuntu1_amd64.deb fglrx-kernel-source_8.593-0ubuntu1_amd64.deb fglrx-amdcccle_8.593-0ubuntu1_amd64.deb

Using 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:

Terminal Command

$ sudo apt-get install -f

Catalyst 15.12 on 64-bit systems requires the --force-overwrite command in the above dpkg command:

Terminal Command

$ sudo dpkg -i --force-overwrite xorg-driver-fglrx_8.593*.deb fglrx-kernel-source_8.593-0*.deb fglrx-amdcccle_8.593-0*.deb

When installing the packages, if xorg-driver-fglrx_8.593 fails to install due to a diverted file conflict, you can fix the package with this procedure.

Fix for an error:

If you are having this error:

dpkg-shlibdeps: failure: couldn't find library libfglrx_gamma.so.1 needed by debian/xorg-driver-fglrx/usr/bin/fglrx_xgamma (its RPATH is '').

Fix it by doing the following:

Terminal Command

$ sudo sh radeon-crimson-15.12-15.302-151217a-297685e.zip --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

If you get this error from modprobe fglrx:

ERROR: firegl_stub_register failed

Fix it by doing:

Terminal Command

$ sudo rmmod radeon
$ sudo rmmod drm
$ sudo modprobe fglrx

Finishing the Install: Configuration

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

sudo aticonfig --initial -f

Now you'll likely have to edit your xorg.conf (even if just to confirm the above command added the apropriate fglrx line):

sudo gedit /etc/X11/xorg.conf

and add the following line to the Device section (if it does not already exist). Include the following lines without [...]:

Section "Device"
	[...]
	Driver		"fglrx"
	[...]
EndSection

Make the appropriate changes to "TexturedVideo" and "Overlay", etc., as described above in the "automatic section". Save and exit, then 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:

sudo aticonfig --input=/etc/X11/xorg.conf --tls=1

Finally, reboot the computer and type

fglrxinfo

into the terminal. If the vendor string contains ATI, you have installed the driver successfully. Release 8.8 looks like:

display: :0.0  screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: Radeon X1950 Series
OpenGL version string: 2.1.7873 Release


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.
sudo apt-get remove xserver-xgl
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
DISPLAY=:0 glxinfo | grep render
If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [1])
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
Section "Extensions"
	Option		"Composite"	"Enable"
EndSection




  • 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:
rmmod i82875p_edac
rmmod fglrx
rmmod intel-agp
rmmod agpgart
modprobe agpgart
modprobe intel-agp
modprobe fglrx
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:
blacklist i82875p_edac
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:
Terminal Command

$ 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: [2], [3], [4].

Specific Issues

Segmentation Fault with glxinfo/fglrxinfo

If you experience such errors (and have glxinfo report "Direct rendering" as No despite following the whole procedure without any errors) you may want to have a look at the Specific Issues chapter of the Ubuntu Gutsy Installation Guide [[5]] as this may be due to missing links or wrong permissions.

That's cleared my thuohgts. Thanks for contributing.

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:

SAVE_VBE_STATE=false

POST_VIDEO=false 

ENABLE_LAPTOP_MODE=false


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)

Section "Extensions"
        Option        "Composite"        "Disable"
EndSection

Section "ServerFlags"
       Option  "AIGLX" "off" 
EndSection

Resume from suspend failed when using dual monitor configuration in xorg.conf. E.g. when using

aticonfig --initial=dual-head --screen-layout=right

Switching back to a single monitor configuration and restarting the xserver (though not beautiful) solves this.

Error! This module/version combo is already installed

Simply uninstall the previous version before installing the new one with

sudo dkms remove -m fglrx -v 8.522 --all