cchtml.com - User contributions [en]

Ubuntu Feisty Installation Guide

2007-05-03T02:34:07Z

68.100.28.201: /* Enable "restricted" Repository */

The [[:Category:Releases|latest]] fglrx driver supports Radeon 9500+ and the X-series cards up to X1900.

==Pre-Installation Checks==
=== Enable "restricted" Repository ===
Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

<leave specific things to check here please>

=== Disable Composite Extension ===
In Ubuntu Feisty the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "0"
EndSection</pre>
}}
*Note: Xubuntu does not have gedit. The default text editor in Xubuntu is called mousepad.
*Note: Kubuntu does not have gedit. The default text editor in Kubuntu is called Kate. Another option is to use nano.

== Installation ==
===Method 1: Install the Driver the Ubuntu Way===
<pre>
sudo apt-get update
sudo apt-get install linux-restricted-modules-$(uname -r) #Okay if it is already installed
sudo apt-get install xorg-driver-fglrx
sudo depmod -a
</pre>

If the system complains about dependencies, use the Synaptic Package Manager (under System>Administration>Synaptic Package Manager) to download python2.4 and all the packages upon which it is depended

===Method 2: Install the 8.36.5 Driver Manually===

*Note: ''This is just an alternative installation method for the section above. It might help if you still get 'DRI missing' errors.''

:*NOTE: This driver is now prepared for 2.6.20 kernels!

Download the ATI driver installer: [https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.36.5-x86.x86_64.run ati-driver-installer-8.36.5-x86.x86_64.run](this installer is for 32bit '''and''' 64bit systems), taking care of which version needs for your [[Hardware|device]].

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

There is a detailled manual with screenshots at [https://wiki.ubuntu.com/AddingRepositoriesHowto Ubuntu Wiki].

By default, Ubuntu does not enable the Universe and Multiverse repositories. But they include some important programs and codecs, so it is highly recommended to activate them.

''Install necessary tools:''
<pre>
sudo apt-get update
sudo apt-get install module-assistant build-essential fakeroot dh-make debhelper debconf libstdc++5 linux-headers-$(uname -r)
</pre>

''Create .deb packages:''
<pre>
sudo bash ati-driver-installer-8.36.5-x86.x86_64.run --buildpkg Ubuntu/feisty
</pre>

''Blacklist old fglrx module from linux-restricted-modules:''

*Note: You only need to do this if you've installed the driver from Method 1 above.

As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.28.8), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

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

''Install .deb packages:''
<pre>
sudo dpkg -i xorg-driver-fglrx_8.36.5-1*.deb
sudo dpkg -i fglrx-kernel-source_8.36.5-1*.deb
sudo dpkg -i fglrx-amdcccle_8.36.5-1*.deb
</pre>

''Remove any old fglrx debs from /usr/src/:''
<pre>
sudo rm /usr/src/fglrx-kernel*.deb
</pre>

''Fix broken dependencies''
*Note: ''You only need to do this if you have installed previous versions of these drivers using this method before.''
<pre>
sudo apt-get -f install
</pre>

''Compile the kernel module:''
<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!
''NOTE'': The fglrx source code now prepared for 2.6.20.

===Configure the Driver===
*Note: An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc. '''I suggest that you do it the manual way if you patched the module, aticonfig --initial didn't work for me. Another alternative is aticonfig --initial --force
<pre>
sudo aticonfig --initial
</pre>
Then:
<pre>
sudo aticonfig --overlay-type=Xv
</pre>

===Finish the Installation===
Now save any open document and reboot your system:
<pre>
sudo shutdown -r now
</pre>
*Note: An '''alternative''' to rebooting is to restart the X Server by pressing your CTRL+ALT+BACKSPACE keys. You must remove any old kernel modules such as "drm" "radeon" or "fglrx" using the "rmmod" command. Example: <code>sudo rmmod fglrx</code>

== Post-Installation Checks ==
===Verifying===
Run the following command to check its output to ensure the fglrx driver is installed properly:
<pre>
$fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: MOBILITY RADEON 9700 Generic
OpenGL version string: 2.0.6458 (8.36.5)
</pre>

=== Additional configure with aticonfig tool ===
You can even more configure the driver with the '''aticonfig''' tool, more information can be found at [[Configuring]].

For example: 
* use powerplay option to switch power state for battery friendly or performance mode
* use dual head or one big desktop mode
* turn second monitor on/off on the fly

==Ubuntu-specific Issues==

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

=== If suspend is not working ===

If after fglrx installation suspend stops working, meaning it suspends not start and just gives black screen. Then changing a few options is reported to work for some hardware ([https://launchpad.net/ubuntu/+source/linux-restricted-modules-2.6.20/+bug/84991 Bug 84991 ]).

For ATI X700:
{{Box File|/etc/default/acpi-support|
<pre>
SAVE_VBE_STATE=false
POST_VIDEO=true
USE_DPMS=false
</pre>
}}

For ATI X1300:
{{Box File|/etc/default/acpi-support|
<pre>
POST_VIDEO=false
</pre>
}}

For ATI X1400, no combination of /etc/default/acpi-support settings has been found to work.

=== BigDesktop not working after login ===

BigDesktop Works on GDM login screen, but not after window manager loads

System > Prefrences > Screen Resolution

Select the resolution that is a combination of both screen resolutions wide and your height.

==See Also==
*[[Frequently Asked Questions]]
*[[Performance Issues]]
*[http://www.petitiononline.com/x200MLin/petition.html Petition for better ATI/AMD Radeon XPRESS 200M Linux Drivers]
{{VCT}}
[[Category:Installation Documentation]]

Ubuntu Feisty Installation Guide

2007-05-03T02:32:59Z

68.100.28.201: /* Enable "restricted" Repository */

The [[:Category:Releases|latest]] fglrx driver supports Radeon 9500+ and the X-series cards up to X1900.

==Pre-Installation Checks==
=== Enable "restricted" Repository ===
Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

=== Disable Composite Extension ===
In Ubuntu Feisty the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "0"
EndSection</pre>
}}
*Note: Xubuntu does not have gedit. The default text editor in Xubuntu is called mousepad.
*Note: Kubuntu does not have gedit. The default text editor in Kubuntu is called Kate. Another option is to use nano.

== Installation ==
===Method 1: Install the Driver the Ubuntu Way===
<pre>
sudo apt-get update
sudo apt-get install linux-restricted-modules-$(uname -r) #Okay if it is already installed
sudo apt-get install xorg-driver-fglrx
sudo depmod -a
</pre>

If the system complains about dependencies, use the Synaptic Package Manager (under System>Administration>Synaptic Package Manager) to download python2.4 and all the packages upon which it is depended

===Method 2: Install the 8.36.5 Driver Manually===

*Note: ''This is just an alternative installation method for the section above. It might help if you still get 'DRI missing' errors.''

:*NOTE: This driver is now prepared for 2.6.20 kernels!

Download the ATI driver installer: [https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.36.5-x86.x86_64.run ati-driver-installer-8.36.5-x86.x86_64.run](this installer is for 32bit '''and''' 64bit systems), taking care of which version needs for your [[Hardware|device]].

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

There is a detailled manual with screenshots at [https://wiki.ubuntu.com/AddingRepositoriesHowto Ubuntu Wiki].

By default, Ubuntu does not enable the Universe and Multiverse repositories. But they include some important programs and codecs, so it is highly recommended to activate them.

''Install necessary tools:''
<pre>
sudo apt-get update
sudo apt-get install module-assistant build-essential fakeroot dh-make debhelper debconf libstdc++5 linux-headers-$(uname -r)
</pre>

''Create .deb packages:''
<pre>
sudo bash ati-driver-installer-8.36.5-x86.x86_64.run --buildpkg Ubuntu/feisty
</pre>

''Blacklist old fglrx module from linux-restricted-modules:''

*Note: You only need to do this if you've installed the driver from Method 1 above.

As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.28.8), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

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

''Install .deb packages:''
<pre>
sudo dpkg -i xorg-driver-fglrx_8.36.5-1*.deb
sudo dpkg -i fglrx-kernel-source_8.36.5-1*.deb
sudo dpkg -i fglrx-amdcccle_8.36.5-1*.deb
</pre>

''Remove any old fglrx debs from /usr/src/:''
<pre>
sudo rm /usr/src/fglrx-kernel*.deb
</pre>

''Fix broken dependencies''
*Note: ''You only need to do this if you have installed previous versions of these drivers using this method before.''
<pre>
sudo apt-get -f install
</pre>

''Compile the kernel module:''
<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!
''NOTE'': The fglrx source code now prepared for 2.6.20.

===Configure the Driver===
*Note: An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc. '''I suggest that you do it the manual way if you patched the module, aticonfig --initial didn't work for me. Another alternative is aticonfig --initial --force
<pre>
sudo aticonfig --initial
</pre>
Then:
<pre>
sudo aticonfig --overlay-type=Xv
</pre>

===Finish the Installation===
Now save any open document and reboot your system:
<pre>
sudo shutdown -r now
</pre>
*Note: An '''alternative''' to rebooting is to restart the X Server by pressing your CTRL+ALT+BACKSPACE keys. You must remove any old kernel modules such as "drm" "radeon" or "fglrx" using the "rmmod" command. Example: <code>sudo rmmod fglrx</code>

== Post-Installation Checks ==
===Verifying===
Run the following command to check its output to ensure the fglrx driver is installed properly:
<pre>
$fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: MOBILITY RADEON 9700 Generic
OpenGL version string: 2.0.6458 (8.36.5)
</pre>

=== Additional configure with aticonfig tool ===
You can even more configure the driver with the '''aticonfig''' tool, more information can be found at [[Configuring]].

For example: 
* use powerplay option to switch power state for battery friendly or performance mode
* use dual head or one big desktop mode
* turn second monitor on/off on the fly

==Ubuntu-specific Issues==

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

=== If suspend is not working ===

If after fglrx installation suspend stops working, meaning it suspends not start and just gives black screen. Then changing a few options is reported to work for some hardware ([https://launchpad.net/ubuntu/+source/linux-restricted-modules-2.6.20/+bug/84991 Bug 84991 ]).

For ATI X700:
{{Box File|/etc/default/acpi-support|
<pre>
SAVE_VBE_STATE=false
POST_VIDEO=true
USE_DPMS=false
</pre>
}}

For ATI X1300:
{{Box File|/etc/default/acpi-support|
<pre>
POST_VIDEO=false
</pre>
}}

For ATI X1400, no combination of /etc/default/acpi-support settings has been found to work.

=== BigDesktop not working after login ===

BigDesktop Works on GDM login screen, but not after window manager loads

System > Prefrences > Screen Resolution

Select the resolution that is a combination of both screen resolutions wide and your height.

==See Also==
*[[Frequently Asked Questions]]
*[[Performance Issues]]
*[http://www.petitiononline.com/x200MLin/petition.html Petition for better ATI/AMD Radeon XPRESS 200M Linux Drivers]
{{VCT}}
[[Category:Installation Documentation]]

Ubuntu Feisty Installation Guide

2007-05-03T02:32:10Z

68.100.28.201: /* Enable "restricted" Repository */

The [[:Category:Releases|latest]] fglrx driver supports Radeon 9500+ and the X-series cards up to X1900.

==Pre-Installation Checks==
=== Enable "restricted" Repository ===
Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

Ummm, how do you do that???

=== Disable Composite Extension ===
In Ubuntu Feisty the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "0"
EndSection</pre>
}}
*Note: Xubuntu does not have gedit. The default text editor in Xubuntu is called mousepad.
*Note: Kubuntu does not have gedit. The default text editor in Kubuntu is called Kate. Another option is to use nano.

== Installation ==
===Method 1: Install the Driver the Ubuntu Way===
<pre>
sudo apt-get update
sudo apt-get install linux-restricted-modules-$(uname -r) #Okay if it is already installed
sudo apt-get install xorg-driver-fglrx
sudo depmod -a
</pre>

If the system complains about dependencies, use the Synaptic Package Manager (under System>Administration>Synaptic Package Manager) to download python2.4 and all the packages upon which it is depended

===Method 2: Install the 8.36.5 Driver Manually===

*Note: ''This is just an alternative installation method for the section above. It might help if you still get 'DRI missing' errors.''

:*NOTE: This driver is now prepared for 2.6.20 kernels!

Download the ATI driver installer: [https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.36.5-x86.x86_64.run ati-driver-installer-8.36.5-x86.x86_64.run](this installer is for 32bit '''and''' 64bit systems), taking care of which version needs for your [[Hardware|device]].

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

There is a detailled manual with screenshots at [https://wiki.ubuntu.com/AddingRepositoriesHowto Ubuntu Wiki].

By default, Ubuntu does not enable the Universe and Multiverse repositories. But they include some important programs and codecs, so it is highly recommended to activate them.

''Install necessary tools:''
<pre>
sudo apt-get update
sudo apt-get install module-assistant build-essential fakeroot dh-make debhelper debconf libstdc++5 linux-headers-$(uname -r)
</pre>

''Create .deb packages:''
<pre>
sudo bash ati-driver-installer-8.36.5-x86.x86_64.run --buildpkg Ubuntu/feisty
</pre>

''Blacklist old fglrx module from linux-restricted-modules:''

*Note: You only need to do this if you've installed the driver from Method 1 above.

As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.28.8), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

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

''Install .deb packages:''
<pre>
sudo dpkg -i xorg-driver-fglrx_8.36.5-1*.deb
sudo dpkg -i fglrx-kernel-source_8.36.5-1*.deb
sudo dpkg -i fglrx-amdcccle_8.36.5-1*.deb
</pre>

''Remove any old fglrx debs from /usr/src/:''
<pre>
sudo rm /usr/src/fglrx-kernel*.deb
</pre>

''Fix broken dependencies''
*Note: ''You only need to do this if you have installed previous versions of these drivers using this method before.''
<pre>
sudo apt-get -f install
</pre>

''Compile the kernel module:''
<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!
''NOTE'': The fglrx source code now prepared for 2.6.20.

===Configure the Driver===
*Note: An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc. '''I suggest that you do it the manual way if you patched the module, aticonfig --initial didn't work for me. Another alternative is aticonfig --initial --force
<pre>
sudo aticonfig --initial
</pre>
Then:
<pre>
sudo aticonfig --overlay-type=Xv
</pre>

===Finish the Installation===
Now save any open document and reboot your system:
<pre>
sudo shutdown -r now
</pre>
*Note: An '''alternative''' to rebooting is to restart the X Server by pressing your CTRL+ALT+BACKSPACE keys. You must remove any old kernel modules such as "drm" "radeon" or "fglrx" using the "rmmod" command. Example: <code>sudo rmmod fglrx</code>

== Post-Installation Checks ==
===Verifying===
Run the following command to check its output to ensure the fglrx driver is installed properly:
<pre>
$fglrxinfo
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: MOBILITY RADEON 9700 Generic
OpenGL version string: 2.0.6458 (8.36.5)
</pre>

=== Additional configure with aticonfig tool ===
You can even more configure the driver with the '''aticonfig''' tool, more information can be found at [[Configuring]].

For example: 
* use powerplay option to switch power state for battery friendly or performance mode
* use dual head or one big desktop mode
* turn second monitor on/off on the fly

==Ubuntu-specific Issues==

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

=== If suspend is not working ===

If after fglrx installation suspend stops working, meaning it suspends not start and just gives black screen. Then changing a few options is reported to work for some hardware ([https://launchpad.net/ubuntu/+source/linux-restricted-modules-2.6.20/+bug/84991 Bug 84991 ]).

For ATI X700:
{{Box File|/etc/default/acpi-support|
<pre>
SAVE_VBE_STATE=false
POST_VIDEO=true
USE_DPMS=false
</pre>
}}

For ATI X1300:
{{Box File|/etc/default/acpi-support|
<pre>
POST_VIDEO=false
</pre>
}}

For ATI X1400, no combination of /etc/default/acpi-support settings has been found to work.

=== BigDesktop not working after login ===

BigDesktop Works on GDM login screen, but not after window manager loads

System > Prefrences > Screen Resolution

Select the resolution that is a combination of both screen resolutions wide and your height.

==See Also==
*[[Frequently Asked Questions]]
*[[Performance Issues]]
*[http://www.petitiononline.com/x200MLin/petition.html Petition for better ATI/AMD Radeon XPRESS 200M Linux Drivers]
{{VCT}}
[[Category:Installation Documentation]]

Linspire

2006-12-10T04:53:22Z

68.100.23.63:

Linspire, a highly customized commercial Linux distribution derived from Debian, supports the RADEON series using the fglrx driver which is included.

The kernel drivers fglrx and agpgart are auto-detected when the card is installed. Full DRI support has been verified on a system with a VIA KM400 chipset using a generic RADEON 9200SE video card.

{{VCT}}

[[Category: Distributions]]

Linspire

2006-12-10T04:52:34Z

68.100.23.63:

Ubuntu Edgy Installation Guide

2006-11-05T17:55:56Z

68.100.55.193: /* OpenGL driver still showing Mesa */

In Ubuntu Edgy you can choose between two methods of installing the proprietary ATI driver. If you are new to linux you should use the first method as it is a lot easier than the second one and will work well in most cases. The second method describes how to install the very latest driver version, but requires some additional work and knowledge.

== Method 1: Installing Edgy's Included Driver (8.28.8)==

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

=== Disable Composite Extension ===

In Ubuntu Edgy the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "Disable"
EndSection</pre>
}}

=== Installing the driver ===

Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

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

Now Reboot your system:

<pre>
sudo shutdown -r now
</pre>

An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc.

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

=== Troubleshooting for Method 1 ===

*The output of '''dmesg | grep fglrx''' and /var/log/Xorg.0.log are most useful when looking for errors. You should really include this when you are asking for help somewhere.

*If you used Method 2 before, you have to unblacklist fglrx again by editing ''/etc/default/linux-restricted-modules-common''. You may have to run '''sudo lrm-manager''' afterwards.

*See [[#Troubleshooting for both Methods|Troubleshooting for both Methods]]

 

== Method 2: Generating/Installing Ubuntu packages for the new 8.30.3 drivers in Ubuntu Edgy Manually ==

The new fglrx driver supports Radeon '''9'''500+ (older cards will not work!) and the X-series cards up to X1900.

=== Disable Composite Extension ===

In Ubuntu Edgy the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "Disable"
EndSection</pre>
}}

=== Blacklist old fglrx module from linux-restricted-modules ===

As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.28.8), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

<pre>sudo gedit /etc/default/linux-restricted-modules-common</pre>
Edit ''DISABLED_MODULES'' to include fglrx
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

=== Installing the new driver ===

Download the ATI driver installer: [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.30.3.run ati-driver-installer-8.30.3.run] (this installer is for 32bit '''and''' 64bit systems)

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

''Install necessary tools:''

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

''Create .deb packages:''

<pre>
sudo ln -sf bash /bin/sh
bash ati-driver-installer-8.30.3.run --buildpkg Ubuntu/edgy
sudo ln -sf dash /bin/sh
</pre>

''Install .deb packages:''

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

''Remove any old fglrx debs from /usr/src/:''

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

''Compile the kernel module:''

<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
sudo aticonfig --overlay-type=Xv
</pre>

'''Note:'''
You could also edit your ''/usr/X11/xorg.conf'' file to change your driver to '''fglrx''' then run:

<pre>
sudo aticonfig --overlay-type=Xv
</pre>

This way your ''xorg.conf'' file will stay clean.

''Now Reboot:''

<pre>
sudo shutdown -r now
</pre>

=== Confirm that it worked ===

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

<pre>
$ glxinfo | grep render
direct rendering: Yes
</pre>

If your direct rendering is disabled, you may have to symlink the dri folder:

<pre>
sudo mkdir /usr/X11R6/lib/modules
sudo ln -s /usr/lib/dri /usr/X11R6/lib/modules/
</pre>

=== Troubleshooting for Method 2===

==== xorg.conf ====

The '''aticonfig --initial''' command will not update the xorg.conf file if it already has a "fglrx" Device section.
However, you may force aticonfig to generate default Monitor, Device, and Screen sections with the following command:

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

 

== Troubleshooting for both Methods ==

=== General ===

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

=== OpenGL driver still showing Mesa ===

If fglrxinfo shows:

<pre>
OpenGL vendor string: Mesa project: www.mesa3d.org
</pre>

Then you are not using the ATI driver for OpenGL. Make sure to disable the Composite extension by adding the following block in your xorg.conf.

<pre>
Section "Extensions"
Option "Composite" "disable"
EndSection
</pre>

=== DRI does not work although the fglrx module is loaded ===

Make sure the Composite extension is disabled, add this to your /etc/X11/xorg.conf file:
<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection
</pre>

=== Module isn't loaded ===
If the fglrx module isn't loaded try to add ''fglrx'' to /etc/modules on a new line. See also [https://launchpad.net/distros/ubuntu/+bug/63912 bug 63912].

{{Box File|/etc/modules|
<pre>
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.

fglrx
</pre>
}}

=== 2D speed ===

If you suffer from slow 2D speed it might help to set
Option "XaaNoOffscreenPixmaps"
in the fglrx device section of ''/etc/X11/xorg.conf''

=== Is the rebooting really necessary? ===

No.

However, rebooting is the easiest method to ensure that the kernel module(s) from the old driver are unloaded and the fglrx module is loaded instead. If you don't want to reboot for some reason, you may manually shut down Xorg, unload any old "drm", "radeon" or "fglrx" modules and then start Xorg again.

Note: if ''modprobe fglrx'' can't find the ''fglrx'' module, try rebuilding your kernel module dependency:

<pre>
sudo depmod -a
</pre>

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

Ubuntu Edgy Installation Guide

2006-11-05T17:37:57Z

68.100.55.193: /* OpenGL driver still showing Mesa */

In Ubuntu Edgy you can choose between two methods of installing the proprietary ATI driver. If you are new to linux you should use the first method as it is a lot easier than the second one and will work well in most cases. The second method describes how to install the very latest driver version, but requires some additional work and knowledge.

== Method 1: Installing Edgy's Included Driver (8.28.8)==

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

=== Disable Composite Extension ===

In Ubuntu Edgy the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "Disable"
EndSection</pre>
}}

=== Installing the driver ===

Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

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

Now Reboot your system:

<pre>
sudo shutdown -r now
</pre>

An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc.

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

=== Troubleshooting for Method 1 ===

*The output of '''dmesg | grep fglrx''' and /var/log/Xorg.0.log are most useful when looking for errors. You should really include this when you are asking for help somewhere.

*If you used Method 2 before, you have to unblacklist fglrx again by editing ''/etc/default/linux-restricted-modules-common''. You may have to run '''sudo lrm-manager''' afterwards.

*See [[#Troubleshooting for both Methods|Troubleshooting for both Methods]]

 

== Method 2: Generating/Installing Ubuntu packages for the new 8.30.3 drivers in Ubuntu Edgy Manually ==

The new fglrx driver supports Radeon '''9'''500+ (older cards will not work!) and the X-series cards up to X1900.

=== Disable Composite Extension ===

In Ubuntu Edgy the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "Disable"
EndSection</pre>
}}

=== Blacklist old fglrx module from linux-restricted-modules ===

As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.28.8), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

<pre>sudo gedit /etc/default/linux-restricted-modules-common</pre>
Edit ''DISABLED_MODULES'' to include fglrx
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

=== Installing the new driver ===

Download the ATI driver installer: [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.30.3.run ati-driver-installer-8.30.3.run] (this installer is for 32bit '''and''' 64bit systems)

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

''Install necessary tools:''

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

''Create .deb packages:''

<pre>
sudo ln -sf bash /bin/sh
bash ati-driver-installer-8.30.3.run --buildpkg Ubuntu/edgy
sudo ln -sf dash /bin/sh
</pre>

''Install .deb packages:''

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

''Remove any old fglrx debs from /usr/src/:''

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

''Compile the kernel module:''

<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
sudo aticonfig --overlay-type=Xv
</pre>

'''Note:'''
You could also edit your ''/usr/X11/xorg.conf'' file to change your driver to '''fglrx''' then run:

<pre>
sudo aticonfig --overlay-type=Xv
</pre>

This way your ''xorg.conf'' file will stay clean.

''Now Reboot:''

<pre>
sudo shutdown -r now
</pre>

=== Confirm that it worked ===

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

<pre>
$ glxinfo | grep render
direct rendering: Yes
</pre>

If your direct rendering is disabled, you may have to symlink the dri folder:

<pre>
sudo mkdir /usr/X11R6/lib/modules
sudo ln -s /usr/lib/dri /usr/X11R6/lib/modules/
</pre>

=== Troubleshooting for Method 2===

==== xorg.conf ====

The '''aticonfig --initial''' command will not update the xorg.conf file if it already has a "fglrx" Device section.
However, you may force aticonfig to generate default Monitor, Device, and Screen sections with the following command:

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

 

== Troubleshooting for both Methods ==

=== General ===

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

=== OpenGL driver still showing Mesa ===

If fglrxinfo shows:

<pre>
OpenGL vendor string: Mesa project: www.mesa3d.org
</pre>

Then you are not using the ATI driver for OpenGL. XGL will not work.

TODO: Who ever has a good solution to this, please add here.

=== DRI does not work although the fglrx module is loaded ===

Make sure the Composite extension is disabled, add this to your /etc/X11/xorg.conf file:
<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection
</pre>

=== Module isn't loaded ===
If the fglrx module isn't loaded try to add ''fglrx'' to /etc/modules on a new line. See also [https://launchpad.net/distros/ubuntu/+bug/63912 bug 63912].

{{Box File|/etc/modules|
<pre>
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.

fglrx
</pre>
}}

=== 2D speed ===

If you suffer from slow 2D speed it might help to set
Option "XaaNoOffscreenPixmaps"
in the fglrx device section of ''/etc/X11/xorg.conf''

=== Is the rebooting really necessary? ===

No.

However, rebooting is the easiest method to ensure that the kernel module(s) from the old driver are unloaded and the fglrx module is loaded instead. If you don't want to reboot for some reason, you may manually shut down Xorg, unload any old "drm", "radeon" or "fglrx" modules and then start Xorg again.

Note: if ''modprobe fglrx'' can't find the ''fglrx'' module, try rebuilding your kernel module dependency:

<pre>
sudo depmod -a
</pre>

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

Ubuntu Edgy Installation Guide

2006-11-05T17:37:29Z

68.100.55.193: /* Troubleshooting for both Methods */

In Ubuntu Edgy you can choose between two methods of installing the proprietary ATI driver. If you are new to linux you should use the first method as it is a lot easier than the second one and will work well in most cases. The second method describes how to install the very latest driver version, but requires some additional work and knowledge.

== Method 1: Installing Edgy's Included Driver (8.28.8)==

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

=== Disable Composite Extension ===

In Ubuntu Edgy the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "Disable"
EndSection</pre>
}}

=== Installing the driver ===

Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

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

Now Reboot your system:

<pre>
sudo shutdown -r now
</pre>

An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc.

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

=== Troubleshooting for Method 1 ===

*The output of '''dmesg | grep fglrx''' and /var/log/Xorg.0.log are most useful when looking for errors. You should really include this when you are asking for help somewhere.

*If you used Method 2 before, you have to unblacklist fglrx again by editing ''/etc/default/linux-restricted-modules-common''. You may have to run '''sudo lrm-manager''' afterwards.

*See [[#Troubleshooting for both Methods|Troubleshooting for both Methods]]

 

== Method 2: Generating/Installing Ubuntu packages for the new 8.30.3 drivers in Ubuntu Edgy Manually ==

The new fglrx driver supports Radeon '''9'''500+ (older cards will not work!) and the X-series cards up to X1900.

=== Disable Composite Extension ===

In Ubuntu Edgy the Composite extension is enabled by default, however, ''fglrx'' does not yet support Composite with DRI. In order to to disable Composite you have to edit the ''xorg.conf'' file:
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add these lines at the end of the file:
{{Box File|/etc/X11/xorg.conf|
<pre>Section "Extensions"
Option "Composite" "Disable"
EndSection</pre>
}}

=== Blacklist old fglrx module from linux-restricted-modules ===

As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.28.8), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

<pre>sudo gedit /etc/default/linux-restricted-modules-common</pre>
Edit ''DISABLED_MODULES'' to include fglrx
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

=== Installing the new driver ===

Download the ATI driver installer: [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.30.3.run ati-driver-installer-8.30.3.run] (this installer is for 32bit '''and''' 64bit systems)

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

''Install necessary tools:''

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

''Create .deb packages:''

<pre>
sudo ln -sf bash /bin/sh
bash ati-driver-installer-8.30.3.run --buildpkg Ubuntu/edgy
sudo ln -sf dash /bin/sh
</pre>

''Install .deb packages:''

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

''Remove any old fglrx debs from /usr/src/:''

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

''Compile the kernel module:''

<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
sudo aticonfig --overlay-type=Xv
</pre>

'''Note:'''
You could also edit your ''/usr/X11/xorg.conf'' file to change your driver to '''fglrx''' then run:

<pre>
sudo aticonfig --overlay-type=Xv
</pre>

This way your ''xorg.conf'' file will stay clean.

''Now Reboot:''

<pre>
sudo shutdown -r now
</pre>

=== Confirm that it worked ===

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

<pre>
$ glxinfo | grep render
direct rendering: Yes
</pre>

If your direct rendering is disabled, you may have to symlink the dri folder:

<pre>
sudo mkdir /usr/X11R6/lib/modules
sudo ln -s /usr/lib/dri /usr/X11R6/lib/modules/
</pre>

=== Troubleshooting for Method 2===

==== xorg.conf ====

The '''aticonfig --initial''' command will not update the xorg.conf file if it already has a "fglrx" Device section.
However, you may force aticonfig to generate default Monitor, Device, and Screen sections with the following command:

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

 

== Troubleshooting for both Methods ==

=== General ===

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

=== OpenGL driver still showing Mesa ===

If fglrxinfo shows:

<pre>
OpenGL vendor string: Mesage project: www.mesa3d.org
</pre>

Then you are not using the ATI driver for OpenGL. XGL will not work.

TODO: Who ever has a good solution to this, please add here.

=== DRI does not work although the fglrx module is loaded ===

Make sure the Composite extension is disabled, add this to your /etc/X11/xorg.conf file:
<pre>
Section "Extensions"
Option "Composite" "Disable"
EndSection
</pre>

=== Module isn't loaded ===
If the fglrx module isn't loaded try to add ''fglrx'' to /etc/modules on a new line. See also [https://launchpad.net/distros/ubuntu/+bug/63912 bug 63912].

{{Box File|/etc/modules|
<pre>
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.

fglrx
</pre>
}}

=== 2D speed ===

If you suffer from slow 2D speed it might help to set
Option "XaaNoOffscreenPixmaps"
in the fglrx device section of ''/etc/X11/xorg.conf''

=== Is the rebooting really necessary? ===

No.

However, rebooting is the easiest method to ensure that the kernel module(s) from the old driver are unloaded and the fglrx module is loaded instead. If you don't want to reboot for some reason, you may manually shut down Xorg, unload any old "drm", "radeon" or "fglrx" modules and then start Xorg again.

Note: if ''modprobe fglrx'' can't find the ''fglrx'' module, try rebuilding your kernel module dependency:

<pre>
sudo depmod -a
</pre>

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

Ubuntu Dapper Installation Guide

2006-09-09T19:42:26Z

68.100.138.11: /* HP Notebook dv5029us / dv5040us / zv6000 / dv8000 */

In Ubuntu Dapper you can choose between two methods of installing the proprietary ATI driver. If you are new to linux you should use the first method as it is a lot easier than the second one and will work well in most cases. The second method describes how to install the very latest driver version, but requires some additional work and knowledge.

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

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

Unfortunately OpenGL seems to be broken for R200 cards (everything below Radeon 9500) in this driver version. The [[#Troubleshooting for Method 1|Troubleshooting]] section describes how to fix this '''after''' xorg-driver-fglrx is installed.

=== Installing the driver ===

Make sure the ''restricted'' repository is enabled in ''/etc/apt/sources.list'' or this guide will not work!

Help on enabling repositories can be found at https://help.ubuntu.com/community/Repositories/Ubuntu.

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

Now Reboot your system:

<pre>
sudo shutdown -r now
</pre>

An '''alternative''' to the '''aticonfig --initial''' command is to edit ''/etc/X11/xorg.conf'' and replace the string "ati" with "fglrx" in the "Device" section. This way you won't lose your old "Screen" and "Monitor" settings. Afterwards you can use aticonfig for setting overlay etc.

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

=== Troubleshooting for Method 1 ===

*The output of '''dmesg | grep fglrx''' and /var/log/Xorg.0.log are most useful when looking for errors. You should really include this when you are asking for help somewhere.

* Unfortunately OpenGL seems to be broken for R200 cards (everything below Radeon 9500) in this driver version which results in messages like
:<pre>[fglrx] API ERROR: could not register entrypoint for Uniform2iARB</pre>
:and similar when running OpenGL applications. This may be fixed by replacing ''/usr/lib/libGL.so.1.2'' with ''libGL.so.1.2'' from the previous driver version (8.24.8). To do so download this file: [http://files.covertprestige.info/important/libGL.so.1.2 libGL.so.1.2] and then copy it to the ''/usr/lib/'' directory.

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

*AMD64 users: It may also be necessary to update /etc/profile if using GDM. Update the $LIBGL_DRIVERS_PATH variable to point to the dri path above.

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

*If you used Method 2 before, you have to unblacklist fglrx again by editing ''/etc/default/linux-restricted-modules-common''

*If the screen is coming up blank on startup, start in recovery mode then try editing your /etc/X11/xorg.conf file to remove this line
: <pre>Load "extmod"</pre>
: and optionally replace it with this
<pre>SubSection "extmod"
Option "omit XVideo"
Option "omit XVideo-MotionCompensation"
Option "omit XFree86-VidModeExtension"
EndSubSection</pre>

*See [[#Troubleshooting for both Methods|Troubleshooting for both Methods]]

 

== Method 2: Generating/Installing Ubuntu packages for the 8.28.8 drivers in Ubuntu Dapper Manually ==

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

=== Blacklist old fglrx module from linux-restricted-modules ===
As ubuntu's ''linux-restricted-modules'' package includes the fglrx module from an old driver version (8.25.18), we have to blacklist this module to make sure the new kernel module which is needed by the new driver will be used instead.

<pre>sudo gedit /etc/default/linux-restricted-modules-common</pre>
Edit ''DISABLED_MODULES'' to include fglrx
{{Box File|/etc/default/linux-restricted-modules-common|
<pre>DISABLED_MODULES="fglrx"</pre>
}}

=== Installing the new driver ===

Download the ATI driver installer: [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.28.8.run ati-driver-installer-8.28.8.run] (this installer is for 32bit '''and''' 64bit systems)

This guide refers to the 32bit version of the driver. The installation procedure for 64bit should be the same as for 32bit, except the filenames of the created .deb packages will differ slightly and you have to install the ''ia32-libs'' package which can be done with apt-get or synaptic.

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

''Install necessary tools:''

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

''Create .deb packages:''

<pre>
bash ati-driver-installer-8.28.8.run --buildpkg Ubuntu/dapper
</pre>

''Install .deb packages:''

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

''Remove any old fglrx debs from /usr/src/:''

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

''Compile the kernel module:''

<pre>
sudo module-assistant prepare
sudo module-assistant update
sudo module-assistant build fglrx
sudo module-assistant install fglrx
sudo depmod -a
</pre>

'''Note''': You have to recompile the kernel module after each kernel update!

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
sudo aticonfig --overlay-type=Xv
</pre>

''Reboot:''

<pre>
sudo shutdown -r now
</pre>

=== Confirm that it worked ===

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

=== Troubleshooting for Method 2===

==== Problems with module-assistant ====

If module-assistant is unable to build the module you may have to provide a Makefile.cpu file:
<pre>
cd /usr/src
sudo touch kernel-headers-(version)/arch/i386/Makefile.cpu
cd /usr/src/linux
sudo make scripts/
</pre>

==== xorg.conf ====

The '''aticonfig --initial''' command will not update the xorg.conf file if it already has a "fglrx" Device section.
However, you may force aticonfig to generate default Monitor, Device, and Screen sections with the following command:

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

==== Upgrade from Breezy ====
If method 2 doesn't work first time round, and you have upgraded from a Breezy installation, try this:

Remove previous versions of the fglrx driver:
<pre>
sudo dpkg -r fglrx-control
sudo dpkg -r fglrx-kernel-source
sudo dpkg -r xorg-driver-fglrx
</pre>

dpkg will list dependencies for xorg-driver-fglrx which will need up be removed, for example:

<pre>
sudo dpkg -r fglrx-kernel
sudo dpkg -r fglrx-kernel-2.6.12-10-686-smp
sudo dpkg -r xorg-driver-fglrx
</pre>

Proceed with method 2

 

== Troubleshooting for both Methods ==

=== General ===

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

Also, '''LIBGL_DEBUG=verbose glxinfo''' can display missing files you can 'fix' by linking directories.

=== 2D speed ===

If you suffer from slow 2D speed it might help to set
Option "XaaNoOffscreenPixmaps"
in the fglrx section of ''/etc/X11/xorg.conf''

=== Is the rebooting really necessary? ===

No.

However, rebooting is the easiest method to ensure that the kernel module(s) from the old driver are unloaded and the fglrx module is loaded instead. If you don't want to reboot for some reason, you may manually shut down Xorg, unload any old "drm", "radeon" or "fglrx" modules and then start Xorg again.

=== HP Notebook dv5029us / dv5040us / zv6000 / dv8000 ===

If you have an HP Notebook Computer (or Compaq) such as the HP dv5029us, dv5040us or zv6000 series, it is needed to modify the BIOS configuration. It seems for some reason using sideport memory (the card's onboard memory only) leads to an apparent system crash although the logs show successful initialization of DRI. It is needed to run the BIOS setup screen, go to memory options, and select UMA+Sideport memory and assign a value to it (I assigned an extra 128M from the system RAM). Boot the computer and the fglrx driver will work. FGLRX version is 8.24.8 on an i386 Ubuntu Dapper install.

* Ubuntu FGLRX drivers 8.25.18, do not work properly on the dv5029us (Radeon Xpress 200M) as of this writing (5/30/2006). It is needed to revert to 8.24.8 for this specific computer in order to get proper 3D acceleration, and 2D with no tearing off.

** ATI Driver 8.26.18, does not work with the Radeon Express 200M. Some HP/Compaq laptops only have working 3D support with ONLY UMA video memory( Sideport+UMA won't work ). This is due to a 1 year old flaw in the ATI driver. If you want to use your onboard/Sideport memory, you can only get 2D support by adding [ Option "no_dri" "yes"] to the fglrx driver section of /etc/X11/xorg.conf

* jul-22-2006, marciowb wrote: I have a HP Pavilion zv6000 - a notebook computer with AMD64 - and it have a ATI Radeon Xpress 200M with 128MB of dedicated memory (Sideport) and it accepts to use shared memory (UMA), also. But if I try to use Sideport or Sideport+UMA the 3D acceleration fails and/or my computer hangs. It works fine if I configure its BIOS to use only UMA, including with a good 3D acceleration performance. Configured to use only UMA it works with the ATI Driver 8.26.18 and 8.25.18, but I was unable to do it works the ATI Driver 8.24.8. I tried several times to use 8.24.8 but it doesn't seem to work with 3D acceleration, only 2D. I see the Xorg.log file the fglrx driver fails to load the DRI driver. I used the Kubuntu with the Linux kernel 2.6.15-26-amd64-generic.

* aug-7-2006, mde wrote: I have an HP dv8120ca / dv8000 laptop with a Radeon Xpress 200M. After installing the 8.27.10 driver, no matter what I set the bios to (128 UMA+Sideport or just Sideport, UMA Only is not an option in my bios), I get the black screen/99% cpu usage problem. I have tried to contact ATI to complain about this bug... Their response: "ATI does not provide direct technical support for laptops/notebooks at this current time (telephone or email). If you require direct technical support please contact the system manufacturer of your laptop/notebook.". To contact ati's linux driver feedback team and request they fix the problem, go to [[https://support.ati.com/ https://support.ati.com/]]. I have written a template letter you can use for your submission should you so desire. It is available at [[http://www.rhthm.com/ati/ http://www.rhthm.com/ati/]]. ''''

=== HP zt3000 / Compaq nx7000 ===
Beginning with ATI driver version 8.19, the drivers fail to properly detect modelines that are compatible with the LCD screen of the HP zt3000 (and equivalent Compaq nx7000 model), and they must be inserted into xorg.conf manually. For the 1680x1050 LCD screen, inserting the following modelines into the "Monitor" section works:
Modeline "640x350" 119.12 640 1728 1760 1840 350 1052 1058 1080
Modeline "640x400" 119.12 640 1728 1760 1840 400 1052 1058 1080
Modeline "720x400" 119.12 720 1728 1760 1840 400 1052 1058 1080
Modeline "640x480" 119.12 640 1728 1760 1840 480 1052 1058 1080
Modeline "800x600" 119.12 800 1728 1760 1840 600 1052 1058 1080
Modeline "1024x768" 119.12 1024 1728 1760 1840 768 1052 1058 1080
Modeline "1152x864" 119.12 1152 1728 1760 1840 864 1052 1058 1080
Modeline "1280x960" 119.12 1280 1728 1760 1840 960 1052 1058 1080
Modeline "1280x1024" 119.12 1280 1728 1760 1840 1024 1052 1058 1080
Modeline "832x624" 119.12 832 1728 1760 1840 624 1052 1058 1080
Modeline "1280x768" 119.12 1280 1728 1760 1840 768 1052 1058 1080
Modeline "1280x800" 119.12 1280 1728 1760 1840 800 1052 1058 1080
Modeline "1152x768" 119.12 1152 1728 1760 1840 768 1052 1058 1080
Modeline "1400x1050" 119.12 1400 1728 1760 1840 1050 1052 1058 1080
Modeline "1440x900" 119.12 1440 1728 1760 1840 900 1052 1058 1080
Modeline "1600x1024" 119.12 1600 1728 1760 1840 1024 1052 1058 1080
Modeline "1680x1050" 119.12 1680 1728 1760 1840 1050 1052 1058 1080

If you have the "1920x1200" version of the HP zt3000 the Modeline is:
Modeline "1920x1200" 150.75 1920 2016 2048 2185 1200 1202 1208 1235

If you have the "1280x800" version of the HP zt3000 the Modeline should be:
ModeLine "1280x800" 69.8 1280 1336 1368 1440 800 802 808 823 -hsync -vsync

** If the above ModeLine still makes the screen flicker (as it did in my zt3000) use the following ModeLine
ModeLine "1280x800" 70.875 1280 1336 1368 1440 800 802 808 823 -hsync +vsync

If you have the compaq nx7010 with 1280x800 screen then the following modeline should work:
Modeline "1280x800" 70.875 1280 1320 1352 1456 800 801 804 820 +hsync +vsync
This was determined using powerstrip in windows.

When using a Compaq NX7010 (Radeon R250Lf Mobility M9) with 1650x1050 screen, powerstrip gives the following working params (CApiTAlisation important), just use one single ModeLine:
ModeLine "1650x1050" 121.500 1680 1712 1800 1872 1050 1051 1054 1065 +Hsync +Vsync
On the Compaq NX7010, be sure to copy the 8.24.8 libGL.so.1.2 as in Troubleshooting for Method 1 above.

''Note: This line will also work on the Compaq X1000 series''

=== Revert to Xorg driver ===

If (for any reason) the fglrx install fails, you can revert to the Xorg driver by executing
<pre>sudo dpkg-reconfigure xserver-xorg</pre>
and selecting the "ati" driver, or simply restoring the previous /etc/X11/xorg.conf file, if you made a backup.

You also need to remove the xorg-driver-fglrx or your manually installed drivers to get the 3D acceleration back, since it is provided by file /usr/lib/libGL.so.1.2 which belongs to libgl1-mesa package and which is moved to backup and replaced at the installation of xorg-driver-fglrx (or the manually built) package. In case the removal of the fglrx drivers fails to restore the file from libgl1-mesa, you have to reinstall the package by running:

<pre>sudo apt-get install --reinstall libgl1-mesa</pre>

Ubuntu Breezy Installation Guide

2006-08-11T13:25:40Z

68.100.101.98: /* Installing the new driver */

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

The fglrx driver supports Radeon 8500+ and the X-series cards (see [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/linux_8.16.20.html#173867 release notes]). When running the dpkg-reconfigure commands you can accept the defaults whenever you aren't sure.

=== Installing the driver ===

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

''64-bit users:''

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

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

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

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

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

=== Troubleshooting ===

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

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

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

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

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

=== Remove existing fglrx driver ===

Remove Breezy's included drivers if they are installed:

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

Reboot.

*Note 1: If after reboot, your system hangs at a black screen before taking you to a graphical login - reboot to 'recovery mode' and edit /etc/X11/xorg.conf to use 'vesa' instead of 'ati'. Then continue with the steps below.

*Note 2: You can change your xorg.conf file to Option "vesa" BEFORE rebooting, so after rebooting you can have usable X (and skip Note 1). Remember that you HAVE to reboot (just restarting X will leave you with unusable X).

=== Installing the new driver ===

Download the ATI driver installer: [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.27.10-x86.run 32bit Installer]

This guide refers to the 32bit version of the driver. If you are using a x86_64 System you need the [http://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/64bit/ati-driver-installer-8.27.10-x86_64.run 64bit Installer]. The installation procedure should be the same as for 32bit, except some filenames will differ slightly.

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

''Install necessary tools:''

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

''Create .deb packages:''

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

''Install .deb packages:''

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

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

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

''Compile the kernel driver:''

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

''Update the xorg.conf file:''

<pre>
sudo aticonfig --initial
sudo aticonfig --overlay-type=Xv
</pre>

Reboot.

=== Confirm that it worked ===

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

(''renderer string'' depends on your hardware and may/will be different)

=== Troubleshooting ===

==== General ====

Look for error messages in /var/log/Xorg.0.log and kern.log.
If you receive the '''(EE) No devices detected''' error message, it is highly possible that you own a Radeon from the 7000-7500 series with the R100 chip, which the proprietary Linux drivers don't support.

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

[[Category:Installation Documentation]]