cchtml.com - User contributions [en]

Ubuntu Feisty Installation Guide

2007-09-03T20:14:46Z

83.225.118.195: /* If suspend is not working */

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!

System > Administration > Software Sources. Check "Proprietary Drivers for Devices (Restricted)" box.

=== 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>gksu 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

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

*Note: Xubuntu does not have gedit. The default text editor in Xubuntu is called mousepad.
<pre>gksu mousepad /etc/X11/xorg.conf</pre>
*Note: Kubuntu does not have gedit. The default text editor in Kubuntu is called Kate.
<pre>kdesu kate /etc/X11/xorg.conf</pre>
Another option is to use nano directly from the terminal.
<pre>sudo nano /etc/X11/xorg.conf</pre>

== 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 your preferred package manager to download python2.4 and, if necessary, its dependencies.

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

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

Download the ATI driver installer:
[https://www2.ati.com/drivers/linux/ati-driver-installer-8.40.4-x86.x86_64.run ati-driver-installer-8.40.4-x86.x86_64.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.

There is a detailed 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-generic
</pre>

''Create .deb packages:''
<pre>
sudo bash ati-driver-installer-8.40.4-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.

Ubuntu/Gnome users type in:
<pre>gksu gedit /etc/default/linux-restricted-modules-common</pre>

Kubuntu/KDE users type in:
<pre>kdesu kate /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.40.4-1*.deb \
fglrx-kernel-source_8.40.4-1*.deb \
fglrx-amdcccle_8.40.4-1*.deb
</pre>

*Note: 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 recieve 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 pacakge:

<pre>
sudo apt-get install -f
</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>

It's necessary, because sometimes this file is written by other packages, and so there's no 3D acceleration.

''Create the following folder''

<pre>
sudo mkdir /lib/modules/$(uname -r)/volatile
</pre>

''Create a symbolic link''

<pre>
sudo ln -s /lib/modules/$(uname -r)/misc/fglrx.ko /lib/modules/$(uname -r)/volatile/fglrx.ko
</pre>

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

===Configure the Driver===
*Note: I've found that using Method 2 can sometime cause problems when you reach this step. If you've used method 2 to install the Drivers. Please reboot before carrying out this step, or else you may experience problems.

*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. Another alternative is '''aticonfig --initial --force''' if you encounter issues with the first command.
<pre>
sudo aticonfig --initial
</pre>
Then:
<pre>
sudo aticonfig --overlay-type=Xv
</pre>
*Note: Is there an alternative to the previous step?

===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: ATI MOBILITY RADEON 9600/9700 Series
OpenGL version string: 2.0.6650 (8.40.4)
</pre>
The <code>OpenGL vendor string</code> should read '''ATI''' and not '''Mesa'''.

If you see a message like 'Xlib: extension "XFree86-DRI" missing on display ":1.0"' then you may have to add the following to /etc/X11/xorg.conf (see [http://ubuntuforums.org/showthread.php?t=292642#post1714920]):
{{Box File|/etc/X11/xorg.conf|
<pre>
Section "Extensions"
Option "Composite" "0"
EndSection
</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: <br>
* 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 and ATI X1100 on Acer Aspire 5051:
{{Box File|/etc/default/acpi-support|
<pre>
SAVE_VBE_STATE=false
POST_VIDEO=true
USE_DPMS=false
</pre>
}}

For ATI X1300 and the ATI X1400 on a Dell Inspiron 9400, also for ATI X1600 on Asus Z96J (using install method 2):
{{Box File|/etc/default/acpi-support|
<pre>
POST_VIDEO=false
</pre>
}}

==See Also==
*[[Frequently Asked Questions]]
*[[Performance Issues]]
*[[Troubleshooting]]
*[http://www.petitiononline.com/x200MLin/petition.html Petition for better ATI/AMD Radeon XPRESS 200M Linux Drivers]
* [http://ubuntuforums.org/showpost.php?p=2221323&postcount=162 ati radeon xpress 200m install method]
{{VCT}}
[[Category:Installation Documentation]]

Ubuntu Edgy Installation Guide

2007-09-03T20:13:34Z

83.225.118.195: /* If suspend and hibernate not working */

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

==Pre-Installation Checks==
=== Enable "restricted" Repository ===
To do this in GNOME, go to your System Menu > Administration > Software Sources. Place a check next to "Proprietary drivers for devices (restricted)," click Close, click Reload, and let the application update the package list.

To do this in XFCE, go to your Applications > System > Software Sources. Place a check next to "Proprietary drivers for devices (restricted)," click Close, click Reload, and let the application update the package list.

If you use KDE, go to K > System > Adept Manager Manage Packages. Enter your password. Go to Adept > Manage Repositories. Right Click everything that starts with deb or deb-src and select enable. Select fetch updates and you are good to go!

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

Section "ServerFlags"
Option "AIGLX" "off"
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 (or vim).

== Installation ==
===Method 1: Install the 8.34.8 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
</pre>
Continue to "Configure the Driver" below.

===Method 2: Install the 8.38.6 Driver Manually===
*Note: ''This is just an alternative installation method for the section above. It might help if you still get 'DRI missing' errors.''

Download the ATI driver installer: [https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.38.6-x86.x86_64.run ati-driver-installer-8.38.6-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 [http://www.ubuntux.org/node/71 ''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 fakeroot dh-make debhelper debconf libstdc++5 linux-headers-$(uname -r)
</pre>

''Create .deb packages:''
<pre>
bash ati-driver-installer-8.38.6-x86.x86_64.run --buildpkg Ubuntu/edgy
</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.38.6-1*.deb
sudo dpkg -i fglrx-kernel-source_8.38.6-1*.deb
sudo dpkg -i fglrx-amdcccle_8.38.6-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 -ae
</pre>

'''IMPORTANT''': You have to recompile the kernel module after each kernel update!
''NOTE'': the new ATI driver (8.36.5) now support kernel 2.6.20!

===Configure the Driver===
<pre>
sudo aticonfig --initial
</pre>
*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.
<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. If you do not reboot, you must remove any old kernel modules such as "drm" "radeon" or "fglrx" using the "rmmod" command. Example: <code>rmmod fglrx</code> <br/>''If this sounds difficult, or you don't know which modules are "Modules such as..." then stick to rebooting ;)''

== 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
OpenGL version string: 2.0.6400 (8.35.5)
</pre>
If you do not see ATI as your vendor, then there are ways to [[Troubleshooting|troubleshoot installation]].

=== 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: <br>
* 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 and hibernate not working ===

If after fglrx installation suspend and hibernate stop working. I mean it suspends and hibernates but does not start and just gives black screen. Then put POST_VIDEO to false:
{{Box File|/etc/default/acpi-support|
<pre># Should we attempt to warm-boot the video hardware on resume?
POST_VIDEO=false</pre>
}}

or try this other (works for X700 and X1100):

{{Box File|/etc/default/acpi-support|
<pre># Should we attempt to warm-boot the video hardware on resume?
SAVE_VBE_STATE=false
POST_VIDEO=true
USE_DPMS=false</pre>
}}

==See Also==
*[[Frequently Asked Questions]]
*[[Performance Issues]]

=== Permalinks to guides for older driver versions ===

* [http://wiki.cchtml.com/index.php?title=Ubuntu_Edgy_Installation_Guide&oldid=3402 Ubuntu Edgy Installation Guide of driver v8.33.6]
* [http://wiki.cchtml.com/index.php?title=Ubuntu_Edgy_Installation_Guide&oldid=3541 Ubuntu Edgy Installation Guide of driver v8.34.8]

{{VCT}}
[[Category:Installation Documentation]]