Difference between revisions of "Catalyst Repository"

From Manjaro Linux
Jump to: navigation, search
m (Step 2: Enable the Testing Repositories: typo)
(Removed everything; suggested changes to pacman.conf are outdated and fail; everything is in the basis repo; other page has working instructions; have no idea how to replace this page with a redirect.)
Line 1: Line 1:
= Introduction =
+
= Notice =
  
Since the introduction of '''[http://www.x.org/wiki/ Xorg-Server]''' version 1.14, unfortunately Arch-Linux no longer supports the use of AMD Catalyst graphics cards. This is because AMD seem to be focusing exclusively on Xorg-Server version 1.13, which is used by the Ubuntu distribution.
+
As of the recent restructuring of repositories, this page & its instructions are no longer applicable. Please see [[Catalyst]] instead for up-to-date information and installation instructions.
 
+
However, the Manjaro Team are continuing to support systems using Catalyst graphics cards, and so have provided a separate repository for this purpose. Those who need to install proprietary drivers for Catalyst graphics cards must therefore enable access to this repository by adding it to their '''pacman configuration file'''.
+
 
+
 
+
=Enabling Access to the Catalyst Repositories=
+
 
+
You will need to first open your terminal in order to edit the pacman configuration file. The syntax of the command to do this is:
+
 
+
sudo [text editor] /etc/pacman.conf
+
 
+
 
+
For example, if you wish to edit the file within the terminal using nano (a standard terminal-based text editor) then enter:
+
 
+
sudo nano /etc/pacman.conf
+
 
+
Otherwise - if you have installed the full version of Manjaro (i.e. not the NET-Edition) - you may find it easier to use the pre-installed gedit text editor instead. This will open the configuration file up as a document, making it easier to read and edit. To use gedit instead, the command is:
+
 
+
sudo gedit /etc/pacman.conf
+
 
+
Once the pacman configuration file has been opened, three steps will be required to install your catalyst driver. Don't worry if the contents of this file seem complex and intimidating, as only two steps are required, and the amendments themselves are very simple and straightforward.
+
 
+
 
+
==Step 1: Add the Catalyst Repository==
+
 
+
{{note|The catalyst repository <u>must</u> be the first one in the list, directly above the '''basis''' repository.}}
+
 
+
+
The Catalyst repository must be added to REPOSITORIES section, which is itself located at the bottom of the pacman configuration file. Again, it must also be the first repository listed in this section, directly above the '''basis''' repository. The lines to be added to the configuration file are as follows:
+
 
+
[catalyst]
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
 
+
 
+
An example has been provided below where the repositories section has been amended to enable access to the catalyst repository. This amendment has been coloured in green for illustrative purposes:
+
 
+
# Repository entries are of the format:
+
#      [repo-name]
+
#      Server = ServerName
+
#      Include = IncludePath
+
#
+
# The header [repo-name] is crucial - it must be present and
+
# uncommented to enable the repo.
+
#
+
+
<font color="green">'''[catalyst]'''</font color>
+
<font color="green">'''SigLevel = PackageRequired'''</font color>
+
<font color="green">'''Include = /etc/pacman.d/mirrorlist'''</font color>
+
+
[basis]
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
 
+
 
+
Once your amendments have been completed, the second step is to '''enable the testing repositories'''.
+
 
+
 
+
==Step 2: Enable the Testing Repositories==
+
 
+
{{note|The new catalyst repository can be left just as it is. No need to amend this one!}}
+
 
+
{{warning|The ''[basis-multilib]'' and ''[multilib]'' repository names only need to be amended for 64-bit (x86_64) Manjaro installations, as they are used to provide 32-bit software packages. '''Do not alter, amend, or remove the hashes ('#') from these repository names for 32-bit (i686) installations of Manjaro'''.}}
+
 
+
 
+
The final step is to replace the names of the default stable repositories used with those of the testing repositories, to use those instead. All that is required is to amend the names of the existing repositories by adding '''<font color="green">-testing</font color>''' at the end of each of them. All repository names will be located in the '''REPOSITORIES''' section near the bottom of the configuration file. The repository names themselves will also be enclosed in square brackets. They are:
+
 
+
* [basis]
+
* [platform]
+
* [addon]
+
* [extra]
+
* [community]
+
* [basis-multilib] <font color="red">(64-bit installations only)</font color>
+
* [multilib] <font color="red">(64-bit installations only)</font color>
+
 
+
 
+
An example of the repositories section has been provided below, with the necessary amendments to the repository names '''<font color="green">coloured in green</font>''' for illustrative purposes:
+
 
+
#
+
# REPOSITORIES
+
- can be defined here or included from another file
+
#  - pacman will search repositories in the order defined here
+
#  - local/custom mirrors can be added here or in separate files
+
#  - repositories listed first will take precedence when packages
+
#    have identical names, regardless of version number
+
#  - URLs will have $repo replaced by the name of the current repo
+
#  - URLs will have $arch replaced by the name of the architecture
+
#
+
# Repository entries are of the format:
+
#      [repo-name]
+
#      Server = ServerName
+
#      Include = IncludePath
+
#
+
# The header [repo-name] is crucial - it must be present and
+
# uncommented to enable the repo.
+
#
+
+
[catalyst]
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
'''[basis<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
'''[platform<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
'''[addon<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
'''[extra<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
'''[community<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
<font color="red"># If you want to run 32 bit applications on your x86_64 system,</font color>
+
<font color="red"># enable the multilib repositories as required here.</font color>
+
+
'''[basis-multilib<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
+
'''[multilib<font color="green">-testing</font color>]'''
+
SigLevel = PackageRequired
+
Include = /etc/pacman.d/mirrorlist
+
 
+
 
+
Once your amendments have been completed, save your changes and close the configuration file by:
+
 
+
*'''nano''': Press CTRL and 'x' to exit, 'y' to save, and <enter> to finish, or
+
*'''gedit''': Select the 'save' option and then close the window.
+
 
+
=Prepare the System for Catalyst Drivers=
+
 
+
Once the appropriate amendments have been made to the pacman configuration file, it will be necessary to update your system in order to prepare it to use Catalyst drivers. To do so, enter the following command into the terminal:
+
 
+
sudo pacman -Syyuu mhwd-db-catalyst
+
 
+
 
+
Once complete, a Catalyst driver can now be installed.
+
 
+
 
+
=Install Catalyst Driver=
+
 
+
{{warning|The pacman configuration file must have been amended first, followed by a full system upgrade prior to attempting to install a Catalyst driver.}}
+
 
+
 
+
All the preparations complete, enter the following command in the terminal to automatically detect and install the appropriate Catalyst driver:
+
 
+
sudo mhwd -a pci nonfree 0300
+
 
+
 
+
Following the installation, reboot your system for the changes to take effect.
+
 
+
=Troubleshoot=
+
==libdri.so exists in filesystem==
+
 
+
{{error|failed to prepare transaction (conflicting files)
+
::    xorg-server: /usr/lib/xorg/modules/extensions/libdri.so exists in filesystem}}
+
 
+
It's safe and advised to overwrite these files. The symlinks were previously created from post_install by the xorg-server and nvidia-utils packages. It is advised to install xorg-server first by using:
+
 
+
sudo pacman -Sfyyuu xorg-server
+
 
+
After which you can upgrade the rest of your system.
+
 
+
==conflicting dependencies==
+
{{error|failed to prepare transaction (conflicting dependencies)
+
::    xf86-video-ati and xorg-server are in conflict (xorg-server<1.14.0)}}
+
 
+
Not all free drivers are supported by this new repository. Please uninstall any free drivers with:
+
 
+
  sudo mhwd -r pci video-ati
+
 
+
You may need to remove some packages with pacman:
+
 
+
  sudo pacman -Rs <pkg-name>
+

Revision as of 20:21, 18 August 2013

Notice

As of the recent restructuring of repositories, this page & its instructions are no longer applicable. Please see Catalyst instead for up-to-date information and installation instructions.