cchtml.com - User contributions [en]

Ubuntu Hardy Installation Guide

2008-06-23T20:31:12Z

87.202.8.232: /* Method 2: Manual Method (installing Catalyst 8.6) */

== Installation ==

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

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

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

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

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

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

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

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

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

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

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

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

<pre>
fglrxinfo
</pre>

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

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

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

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

=== Method 2: Manual Method (installing Catalyst 8.6) ===
this installer is for 32bit '''and''' 64bit systems)

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

Switch to the directory you downloaded this into and the run the following. (Make sure ''universe'' and ''multiverse'' are enabled in your repository sources).

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

This installs the dependencies for the installer.

If you are using the x86_64 architecture (64 bit), be sure to inst "ia32-libs" before proceeding!
Also, if you have a problem getting the libGL.so.1, create a symbolic link to it:
<pre>
sudo ln -s /usr/lib/libGL.so.1.2 /usr/lib/libGL.so.1
</pre>

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

Now use the following command to create the .deb files you will be using for installation:

<pre>
sudo sh ati-driver-installer-8-6-x86.x86_64.run --buildpkg Ubuntu/hardy
</pre>

Now we have to blacklist the driver in Ubuntu's repository, so that the new driver will be used.

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

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

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

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

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

Install .debs:

<pre>
sudo dpkg -i xorg-driver-fglrx_8.501*.deb fglrx-kernel-source_8.501*.deb fglrx-amdcccle_8.501*.deb
</pre>

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

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

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

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

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

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

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

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

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

Now you'll have to edit your xorg.conf
<pre>sudo gedit /etc/X11/xorg.conf</pre>
and add the following line to the Device section (if it does not already exist):
<pre>Section "Device"
[...]
Driver "fglrx"
[...]
EndSection</pre>
Save and exit, then run
<pre>sudo aticonfig --initial -f</pre>
in a terminal. If it does not error you should be fine. Finally, reboot the computer and type
<pre>
fglrxinfo
</pre>
into the terminal. If the vendor string contains ATI, you have installed the driver successfully.

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

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

:*Remove the package xserver-xgl.
::'''Explanation:''' If you installed this previously in order to make compiz work, it will not allow direct rendering on your display. You can check out if this is what it causing the problem by running
::<pre>DISPLAY=:0 glxinfo | grep render</pre>
::If it returns an ATI renderer, it means that xgl is being displayed indirectly on the display 1. (Taken from [http://ubuntuforums.org/showthread.php?t=740287])
::'''Warning:''' This might make your compiz stop working as it is configured to use XGL. A solution might be to run the Envy script in order to configure compiz.
::Also, if Compiz stopped working due to "Composite" problem, check that
<pre>
Section "Extensions"
Option "Composite" "Enable"
EndSection
</pre>
::is set.

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

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

== Specific Issues ==

=== Hang at logout ===

If you experience hangs when logging out (of X) try disabling atieventsd with this command:

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

=== Suspend/Hibernation ===

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

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

<pre>
SAVE_VBE_STATE=false

POST_VIDEO=false

ENABLE_LAPTOP_MODE=false
</pre>

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

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

[[Category:Installation Documentation]]

Ubuntu Dapper Installation Guide

2006-05-30T00:00:40Z

87.202.30.249: /* HP zt3000 / Compaq nx7000 */

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

=== 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 aticonfig --initial
sudo aticonfig --overlay-type=Xv
</pre>

Reboot.

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 9700 Generic
OpenGL version string: 2.0.5814 (8.25.18)
</pre>

=== Troubleshooting ===

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

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

*You can force early loading of the fglrx module by adding it to /etc/modules

*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''

== Method 2: Generating/Installing Ubuntu packages for the 8.25.18 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 ===

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

''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 gcc-3.3-base
</pre>

''Create .deb packages:''

<pre>
chmod +x ati-driver-installer-8.25.18-x86.run
./ati-driver-installer-8.25.18-x86.run --buildpkg Ubuntu/dapper
</pre>

''Install .deb packages:''

<pre>
sudo dpkg -i xorg-driver-fglrx_8.25.18-1_i386.deb
sudo dpkg -i fglrx-kernel-source_8.25.18-1_i386.deb
sudo dpkg -i fglrx-control_8.25.18-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 module:''

<pre>
sudo module-assistant prepare,update
sudo module-assistant build,install fglrx
</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>

Now Reboot.

Yes, a real reboot. Restarting X only '''will not work'''!

=== 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.5814 (8.25.18)
</pre>

=== Troubleshooting ===

==== General ====

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

==== HP Notebook PC ====

If you have an HP Notebook Computer (or Compaq) such as the HP dv5029dvus 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.

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

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

[[Category:Installation Documentation]]