- 1 Installing and removing software
- 2 Installing updates: MageiaUpdate
- 3 Making more applications available
- 4 Advanced use: the console software management applications
- 5 Advanced use: Backports and candidate updates
- 6 Advanced use: other ways to install software
- 7 Third party repositories
- 8 Rebuilding a source RPM from a later Mageia release
- 9 Installing from source code
Installing and removing software
drakrpm (or rpmdrake) is the graphical tool for installing and removing software, including updates, and managing online and physical media repositories. You can launch rpmdrake in several different ways:
- From Start/Application menu > Install & Remove Software
- From the MCC : Start menu > Tools > System Tools > Configure Your Computer, go to the Software Management tab, and click the appropriate option (they all launch rpmdrake in various different modes)
- From a terminal, you can run rpmdrake, rpmdrake-remove, MageiaUpdate or drakrpm-edit-media to launch the various rpmdrake modes. You must have administrator privileges. See this page for instructions on running commands with administrator privileges.
The Mageia Control Center entry is labelled Install & Remove Software, and these methods launch rpmdrake with the Packages with GUI filter pre-selected.
rpmdrake-remove (from the console) launches rpmdrake with the Installed search filter pre-selected, which is most convenient for removing packages.
Browse Available Software (in the system menus) launches rpmdrake without administrator privileges, which means you will only be able to browse what software is installed and available, you will not be able to install or remove packages.
If you selected the link to install or add software, you can change the view of the software listed by using the drop down lists at the top left hand corner of the window. The options in the first drop down list are All, Metapackages, Packages with GUI, All updates, Security updates, Bugfixes updates, General updates and Backports.
- Metapackages are packages which contain no files, but only exist in order to depend on other packages. To see how this works, consider the task-gnome metapackage. This package contains no files, but it depends on all the packages necessary to provide the full GNOME desktop environment. This allows you to simply install the task-gnome package, which will cause all the packages needed for GNOME to work to be installed - far easier than finding and installing them one by one. The Metapackages view shows you only packages of this type.
- The Packages with GUI view shows you only packages for actual GUI applications. This is useful if you're just looking for a program and don't want to be confused by entries for non-application packages.
- The various Updates views show you only the various types of official update packages.
- Backports shows you only packages from the /backports repositories, which contain (unsupported) packages of newer versions of certain applications than were originally provided for any given release. For more information on what the /backports repositories are and how to use them, see here.
The second drop down box allows you to switch between showing all packages both installed and not yet installed, only installed packages, or only not yet installed packages.
Enter the search term in the search box at the top right hand side of the screen to identify the name of the application you wish to install. By default, you will be searching in the names of available packages. If you click on the magnifying glass icon, you can change to searching in the summaries or descriptions of available packages, or in the lists of files they contain. Results will appear in the box below the search term. Once you have checked all the applications you wish to install, click the "Apply" button to install them. If other packages must be installed in order for the packages you selected to function correctly, rpmdrake will alert you to this now and allow you to either continue the installation including the required packages, or cancel.
If you search for an application and find a check in the box to the left of the application name, this signifies that the application is already installed on your Mageia system. Also note the color-coded icons in the far right column of the file window labelled "Status". These icons represent the selected-for-installation, installed, or to-be-removed status of packages.
To remove software that has already been installed, uncheck the box in the left-hand column of the package listing window where the check appears. This will mark that application for removal or uninstallation. Similar to the installation process, if another application must be uninstalled to fulfil your removal request, you will be warned of the other packages to be removed. You will also be prompted to accept the removal of all packages. If you do not accept the removal of all packages, none of the packages will be removed. Once you have marked all the applications you wish to remove, click the 'Apply' button to remove them.
Installing updates: MageiaUpdate
Just as with any computer, you should update your Mageia system regularly. The MageiaUpdate tool is provided for this purpose. Like rpmdrake, MageiaUpdate can be run in several ways. From the Mageia Control Center, go to the Software Management tab, and click on 'Update your system' or you can run MageiaUpdate directly via the command MageiaUpdate.
The first time you run MageiaUpdate, it will ask your permission to connect to the Mageia servers in order to download a list of sites from which it can download updates. If you give your permission, it will then ask you which mirror site to use. Pick one close to your geographical location. MageiaUpdate will then connect to the site, download a list of available updates, and present you with a list of all available updates for packages installed on your system. All security and bugfix updates will be pre-selected.
Note about kernel updates
When the kernel is updated you will see more boot entries in GRUB, the boot loader, menu, that's because kernels are installed in parallel, i.e. a new kernel isn't going to replace an old one.
The entries on the GRUB menu will change when a new kernel is installed as follows:
- The default entry Boot Mageia... will always boot the last installed kernel
- A separate entry will be created for the old kernel
- Another separate entry will be created for the new kernel
This is a fail-safe measure as a new kernel mightn't boot for one reason or another, in that case you can always boot the system using the old kernel, to investigate/fix why the new one doesn't work. Once you're satisfied that the new kernel works correctly, you can safely uninstall the older one(s); kernels are rpm packages so uninstall them using the GUI, rpmdrake (aka "install & remove software") or urpme from terminal, uninstalling a kernel will automatically remove its entry from the GRUB menu.
Making more applications available
If you installed from a CD or DVD edition of Mageia and did not enable Internet software repositories during the installation process, you will have access only to the software included on your CDs or DVD(s). There are so many applications available for Mageia that they cannot all fit on the CD or DVD editions. Therefore you may find some applications you wish to install are not found when you search in rpmdrake.
This does not mean you cannot easily gain access to these applications, however. With the help of another utility, you can configure your system to use a public Mageia mirror site as an application repository, and access the entire range of applications available.
The first time you run the rpmdrake utility (aka Install & Remove Software), it will offer to set up these public repositories for you. If you agree, it will walk you through a simple process to add these repositories. Also if you install Mageia using the LiveCD edition these repositories will be added automatically when you boot the installed system for the first time if there's an active internet connection available.
You may have to enable the Non-free media sources from the Mageia Control Center > Software Management > Configure media sources for install and update. You would need to enable the Non-free and Non-free Updates repositories.
Do you have the online software repositories set up correctly?
You can find out if you have the online repositories set up correctly by looking in Mageia Control Centre -> Software Management -> Configure media sources for install and update, or using this command:
urpmq --list-media active
That command lists only enabled repositories so you will see more media sources listed in 'Configure media sources for install and update' but not activated by default. This is normal.
You should have these activated:
on a 64 bit installation you should also have
Core 32bit Release
Core 32bit Updates
Non-free 32bit Release
Non-free 32bit Updates
If you wish to use software (such as audio/video codecs) that may be subject to patent claims, activate;
and also on a 64 bit installation:
Tainted 32bit Release
Tainted 32bit Updates
Setting up the online sources
If you don't have the above repositories then you can add them manually by following these steps:
- Open the Mageia Control Centre -> Software Management -> 'Configure media sources for install and update'.
- Now click the Add button on the right hand side.
- When asked select Full set of sources in the pop-up window that appears.
- Click 'yes' when asked if it is OK to contact the Mageia web site to retrieve the mirror list.
Once the process is complete, you can run rpmdrake as described above, and you will have access to a wider range of applications.
Adding a specific Media Mirror
Using the above method will add the repos using the MIRRORLIST, it doesn't add a single mirror but uses a dynamic way to switch between mirrors depending on:
- which mirrors are geographically closer to you and
- which mirrors are faster as the default downloader, aria2, is configured to check for a minimum speed limit
Also using the MIRRORLIST, it downloads, if possible, the same file from three different servers at the same time.
If you're having trouble using with the MIRRORLIST (e.g. it defaults to a slow or faulty mirror) you can still add a specific media mirror, usually you manually pick up a mirror you know from past experience to be reliable and reasonably up-to-date.
To do so follow these steps:
- Open the Mageia Control Centre -> Software Management -> Configure media sources for install and update
- Now open File -> Add a specific media mirror
- When asked select Full set of sources in the pop-up window that appears.
- Click 'yes' when asked if it is OK to contact the Mageia website to retrieve the mirror list
- When the mirror list appears, choose a mirror close to your geographical location (or a mirror you know is reliable).
that's it, you've just added a specific media mirror.
Before making a final choice, it's advisable to check that the mirror that you are planning to use is up-to-date, using this page: http://mirrors.mageia.org/status
Advanced use: the console software management applications
As a complement to the graphical software management applications discussed above, there is a range of console software management applications which share the same software repositories (so you can use either the console applications, the graphical applications, or switch between the two). A full explanation of these applications is outside the scope of this page. More information is available at this page.
Briefly, they consist of:
urpmi is the software installation tool. It must be used with root privileges. Invoke it simply with urpmi packagename to install a package and all its dependencies. If you enter an incomplete package name it will perform a search and make suggestions. Another useful command you can use is urpmi --auto-update, which will update the list of available packages from all repositories, and install any available updates.
urpme is the software removal tool. It must be used with root privileges. Invoke it simply with urpme packagename to remove a package and any packages that depend on it. If you enter an incomplete package name it will perform a search and make suggestions.
More about removing packages and their no longer needed dependencies, including a warning about how urpme --auto-orphans can ruin your installation if you don't take the explained precautions, can be found in Removing packages
urpmq and urpmf
urpmq and urpmf are the search tools. They can be used with regular user privileges. Generally speaking, use urpmf to find what package contains a particular file, and urpmq for all other search operations. Called with no parameters, urpmq will search package names. Refer to the man pages for further information.
urpmscan and urpmseek: Searching for packages Debian-alike
urpmscan: Create a file called urpmscan with the following content and move it to /usr/bin
#! /bin/bash urpmf -i --uniq --description "$1" | grep '^[[:alnum:]].*:$' | sed s/\:// | sort
chmod 755 /usr/bin/urpmscan
echo alias urpmseek\=\"urpmf -i --uniq --summary\" >> /etc/bashrc
urpmi.addmedia and urpmi.removemedia
These are the tools for adding and removing software repositories. Refer to the manpage for the necessary parameters. This site will help you generate urpmi.addmedia commands to add commonly used repositories: mirrors list
Advanced use: Backports and candidate updates
There are several official software repositories for Mageia. For a full list and description of all the available repositories see Software management.
The backports repositories contain new versions of packages: updates that are provided simply to keep the package up to date or add new features, rather than to fix bugs or security issues.
The testing repositories contain candidate update packages. When a bug is identified in a package in Mageia, the package maintainer builds a package which should resolve the problem, and uploads it to the appropriate /testing repository (depending on which section the package is in). At this point, users who have experienced the issue can install the candidate update to help test that it truly resolves the problem and does not cause any other problems. They can report their findings to the relevant bug at https://bugs.mageia.org.
If you followed the steps in #Making more applications available above, or added Internet repositories during the installation process, the release and updates repositories for each section will be configured on your system and enabled.
The testing and backports repositories for each section will be configured on your system but disabled (they are disabled by default to ensure you do not install packages from these repositories by accident, since they could potentially not work as well as those from the release and updates repositories). To use these repositories, simply run the Software Media Manager as discussed in #Making more applications available and check the boxes to enable them. We recommend that you do not leave either repository permanently enabled, but enable them if you wish to install a specific package from them, install the package, and then disable them again.
If you choose to enable /backports and/or /testing repositories, you should also update the lists of available software regularly, as the packages in these repositories are updated regularly. You can do this by using the 'Update media' option on the 'File' menu.
Advanced use: other ways to install software
Occasionally, you may come across an application you wish to run which is not available from any of the official Mageia repositories, or you may have a strong need for a newer version of an application than is available from the official repositories. In these cases, you may wish to use another method of installing software.
Take a look then on the Wiki page Ways to install programs which shows other ways to get and run programs in Mageia, for example as AppImage, Flatpak or other.
Third party repositories
You may come across third party package repositories for Mageia, of which there are several. These may carry newer versions of applications than are available in the official repositories, or applications that are not available in the official repositories at all.
In general we advise you to use the official repositories whenever possible, but if you truly need an application or version that is not available from the official repositories, using a third party repository is a safer option than using a package for a different distribution, or installing from source code.
Mageia cannot provide any support for packages provided by third parties: if you encounter problems while using such packages, please request support from the third party provider. We strongly recommend that you first check whether an application is available in the official repositories and if it is, use that package, even if it is not the absolute latest version of the application. Having the latest (perhaps broken) version is not as important as having a package that works. People spent time to check that applications in the official repositories work, and if you find problems, they can be reported to Bugzilla and corrected for everyone. If you need the latest version, it may (or may not for good reasons) be available as a backport, but do not count on it: begin with what's available and enjoy.
Rebuilding a source RPM from a later Mageia release
If the package or version you require is not available from an official or third party repository for your release of Mageia, but is available in a later release of Mageia (including cauldron), you may try to recompile the source RPM from the later release on your release. You will be able to find the source RPM on any official Mageia mirror, in the /SRPMS subdirectory of the release where the package is available. See the instructions in Packaging for beginners
Installing from source code
If the application or version you require is not available from any official or third party repository, you may be forced to install it by downloading the raw source code, compiling it, and installing it to your system. This is the least preferred method of installing software and should only be used if you have no other option.