Difference between revisions of "Catalyst Repository"

From Manjaro Linux
Jump to: navigation, search
(conflicting dependencies)
m (Step 2: Enable the Testing Repositories: typo)
Line 66: Line 66:
  
  
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 '''REPSOSITORIES''' section near the bottom of the configuration file. The repository names themselves will also be enclosed in square brackets. They are:
+
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]
 
* [basis]
Line 138: Line 138:
 
*'''nano''': Press CTRL and 'x' to exit, 'y' to save, and <enter> to finish, or
 
*'''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.
 
*'''gedit''': Select the 'save' option and then close the window.
 
  
 
=Prepare the System for Catalyst Drivers=
 
=Prepare the System for Catalyst Drivers=

Revision as of 10:29, 9 April 2013

Introduction

Since the introduction of 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.

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 must 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.
#

[catalyst]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

[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 -testing 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] (64-bit installations only)
  • [multilib] (64-bit installations only)


An example of the repositories section has been provided below, with the necessary amendments to the repository names coloured in green 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-testing]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

[platform-testing]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

[addon-testing]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

[extra-testing]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

[community-testing]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

# If you want to run 32 bit applications on your x86_64 system,
# enable the multilib repositories as required here.

[basis-multilib-testing]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist

[multilib-testing]
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>