= RPM How-To for end users = [[PageOutline]] This section contains basic informations for end users about installing, upgrading and removing packages with YUM and RPM. == Handy YUM and RPM commands YUM is a command line tool used to install software packages from the remote repositories which involves automatic downloading of package files and all their requirements, subsequent unpacking and unattended installation of the package contents to the appropriate system directories. This tool is ideal for end users. Everything you need to know is a name of the package you want to install. ||'''yum install''' __pkg__ ||Install the latest version of the package named __pkg__ (including all packages it needs for its work, if any) ||'''yum remove''' __pkg__ ||Uninstall the package named __pkg__ (including all installed packages that need the removed one, if any) ||'''yum check-update''' ||List available updates (newer versions) for all installed packages ||'''yum update''' ||Install all available updates (if any) ||'''yum update''' __pkg__ ||Update only the package named __pkg__ (and packages it needs, if newer versions of them are required) ||'''yum info''' __pkg__ ||Show information about the package named __pkg__ ||'''yum search''' foobar ||Show all packages containing "foobar" in the name, summary or description fields ||'''yum list installed''' ||List all installed packages ||'''yum list avaliable''' foo* ||List all available packages with names starting with "foo" ||'''yum list''' *bar* ||List all packages containing "bar" in names (both installed and available) ||'''yum clean packages''' ||Delete all downloaded files containing installed packages (packages themselves are not uninstalled) ||'''yum clean metadata''' ||Delete RPM repository cache files (useful if you get strange errors about missing packages) RPM is a low-level tool used to perform operations on package files directly and also to query the local database of installed packages in cases where YUM doesn't provide the required information. End users rarely need to use this tool. ||||'''rpm -i''' __pkg-XYZ__.rpm ||Install the package contained in the file "__pkg-XYZ__.rpm" (all required packages must be already installed) ||'''rpm -qi -p''' __pkg-XYZ__.rpm ||'''rpm -qi''' __pkg__ ||Display information about the package file "__pkg-XYZ__.rpm" or about the installed package __pkg__ (name, version, etc.) ||'''rpm -qR -p''' __pkg-XYZ__.rpm ||'''rpm -qR''' __pkg__ ||Display the requirements of the package file "__pkg-XYZ__.rpm" or the installed package __pkg__ ||'''rpm -ql -p''' __pkg-XYZ__.rpm ||'''rpm -ql''' __pkg__ ||List all files contained in the package file "__pkg-XYZ__.rpm" or the installed package __pkg__ ||'''rpm -q --changelog -p''' __pkg-XYZ__.rpm ||'''rpm -q --changelog''' __pkg__ ||Print the list of changes provided by the version of the package contained in "__pkg-XYZ__.rpm" or by the installed package __pkg__ ||||'''rpm -qf''' /full/path/to/file ||Search for an installed package owning the file "/full/path/to/file" (e.g. "/@unixroot/bin/sh") You may find more detailed information about YUM and RPM using the following links: * YUM command manual page: http://linuxcommand.org/man_pages/yum8.html * RPM command manual page: http://www.rpm.org/max-rpm-snapshot/rpm.8.html * YUM website: http://yum.baseurl.org/ * RPM website: http://www.rpm.org/ == Platform selection for binaries == The default base architecture setting for RPM/YUM is the i386 platform; if you own a i686 CPU (PentiumPro and above), you can tell YUM to inspect i686 package list first, and fallback to i386 if none found. To enable i686, create a 'platform' text file in your %UNIXROOT%\etc\rpm directory with the following text in it: {{{ i686-OS/2-OS/2 }}} Binaries are getting built also for Pentium4 and above processors, use the following text to enable this: {{{ pentium4-OS/2-OS/2 }}} Access to pentium4 packages requires the latest YUM package. == Local RPM repository == Sometimes you may want to maintain a local repository of RPM packages (for example, if you want to organize your specific software or private data using RPM which you don't want to put to public RPM repositories) . This is fairly easy: 1. Install the createrepo package. 2. Add a file local.repo to /etc/yum/repos.d/ that contains: {{{ [local] name=My local repo baseurl=file:// enabled=1 }}} 3. Put your .rpm files to . 4. Execute {{{ sh -c "createrepo " }}} Note that RPM tools do not understand if it contains the drive specification. In this case you will have to add a kLIBC path rewriter entry that maps e.g. {{{/drives/p}}} to your {{{P:}}} drive and then {{{baseurl}}} will become {{{"file:///drives/p/temp/build/RPMS"}}} and for {{{createrepo}}} you will give {{{"/drives/p/temp/build/RPMS"}}}. == Note about upgrading from 2010 RPM builds == Newer RPM builds are now using Berkeley DB for storing package informations, while previous builds were using SqLite 3 for this task. Since SqLite support is being phased out, RPM moved to BDB. After updating you need to convert the old database to the new format: you can check this running {{{ rpm -qa }}} at the command prompt; you will get a SIGSEV error or a message about wrong database format: {{{ [E:\]rpm -qa rpmdb: __db_meta_setup: /@unixroot/var/lib/rpm/Packages: unexpected file type or format error: cannot open Packages index using db3 - Invalid argument (22) error: cannot open Packages database in /@unixroot/var/lib/rpm rpmdb: __db_meta_setup: /@unixroot/var/lib/rpm/Packages: unexpected file type or format error: cannot open Packages database in /@unixroot/var/lib/rpm }}} To upgrade the database, use the following command sequence: {{{ rpm --define '_dbapi 4' --rebuilddb mv /@unixroot/var/lib/rpm /@unixroot/var/lib/rpm.bak mv /@unixroot/var/lib/rpm.rebuild /@unixroot/var/lib/rpm }}} You can test operation running {{{ rpm -qa }}} you will get the list of installed packages. The older SqLite databases are now saved into mv /@unixroot/var/lib/rpm.bak, if everything is ok you can delete this directory.