= RPM How-To for end users =
[[PageOutline]]
Basic informations for end users about installing, upgrading and removing packages with RPM and YUM.

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