Ubuntu Feisty Installation Guide

2007-04-14T13:58:24Z

84.126.71.109:

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" "Disable"
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.
*Note: Use "0" instead of "Disable" if you get the black screen of death.

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

===Method 2: Install the Driver Manually===
*Note: ''This is an alternative installation method for the section above that works for 2.6.20.* kernels.''
*Note: ''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 fakeroot dh-make debhelper debconf libstdc++5
sudo apt-get install linux-headers-$(uname -r) wget
</pre>

''Download the ATI driver installer:''
<pre>
cd ~/
wget https://a248.e.akamai.net/f/674/9206/0/www2.ati.com/drivers/linux/ati-driver-installer-8.35.5-x86.x86_64.run
</pre>
*Note: This installer is for 32bit '''and''' 64bit systems), taking care of which version needs for your device.

''Delete any old fglrx packages in your home directory''
<pre>
sudo rm xorg-driver-fglrx*.deb
sudo rm fglrx-kernel-source*.deb
sudo rm fglrx-control*.deb
</pre>

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

''Install .deb packages:''
<pre>
sudo dpkg -i xorg-driver-fglrx*.deb
sudo dpkg -i fglrx-kernel-source*.deb
sudo dpkg -i fglrx-amdcccle*.deb
</pre>

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

''Patch #1 for 2.6.20.* kernels''

Note: Patch #1 was minimally successful by two ops using dv8000s with 8.34.8 fglrx driver. The first op reported no errors. The second had log-off and shutdown hangs when using log-off/shutdown buttons on KDE K-Menu. Typing "sudo shutdown -r now" or "sudo shutdown -P now" from terminal window worked ok. The patch was also tried on current 8.35.5 fglrx driver by the second op, but erred out during "sudo module-assistant build fglrx" command.

<pre>
cd ~/
wget http://darcs.frugalware.org/repos/frugalware-current/source/x11-extra/fglrx/fglrx-2.6.20.patch
cd /usr/src
sudo cp fglrx.tar.bz2 fglrx.tar.bz2-original
sudo tar -xvjf fglrx.tar.bz2
cd /usr/src/modules/fglrx
sudo patch -p0 < ~/fglrx-2.6.20.patch
cd /usr/src
sudo tar -cvjf fglrx.tar.bz2 modules/fglrx
</pre>

--or--

''Patch #2 for 2.6.20.* kernels''

Note: If you have already installed Patch #1, do not install Patch #2. Patch #2 was successful by the second op (above) using dv8000 with 8.35.5 fglrx driver with no log off or shutdown hangs. The 8.34.8 version of this patch was reported as successful on the Ubuntu forums by a third op also using a dv8000. The steps listed on the forum have been modified to conform to those already listed on this Wiki.

<pre>
cd ~/
wget http://whoopie.gmxhome.de/linux/patches/2.6.20/fglrx-8.35.5-for-2.6.20.patch
cd /usr/src
sudo cp fglrx.tar.bz2 fglrx.tar.bz2-original
sudo tar -xvjf fglrx.tar.bz2
cd /usr/src/modules/fglrx
sudo patch -p0 < ~/fglrx-8.35.5-for-2.6.20.patch
cd /usr/src
sudo tar -cvjf fglrx.tar.bz2 modules/fglrx
</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!

'''ALSO IMPORTANT''': The errors reported by the second op on Patch #1 are related to the way these patches interact with xorg. Patch #2 continued to work for the second op until xorg was upgraded. Afterwards the hangs on logoff and shutdown returned. Recommend uninstalling fglrx packages, reinstalling, and recompiling after an xorg upgrade to solve this issue.

===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>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.6400 (8.35.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: <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 ([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 and above:
{{Box File|/etc/default/acpi-support|
<pre>
POST_VIDEO=false
</pre>
}}

==See Also==
*[[Frequently Asked Questions]]
*[[Performance Issues]]
{{VCT}}
[[Category:Installation Documentation]]

cchtml.com - User contributions [en]

Ubuntu Feisty Installation Guide