Chapter 4. Using RPM to Upgrade Packages

Table 4-1. rpm -U Command Syntax

rpm -U (or --upgrade)options file1.rpmfileN.rpm
Parameters
file1.rpmfileN.rpm One or more RPM package files (URLs OK)
Upgrade-specific Options Page
-h (or --hash) Print hash marks ("#") during upgrade[a] the section called -h: Perfect for the Impatient in Chapter 2
--oldpackage Permit "upgrading" to an older package the section called --oldpackage: Upgrade To An Older Version
--test Perform upgrade tests only[a] the section called --test: Perform Installation Tests Only in Chapter 2
--excludedocs Do not install documentation[a] the section called --excludedocs: Do Not Install Documentation For This Package in Chapter 2
--includedocs Install documentation[a] the section called --includedocs: Install Documentation For This Package in Chapter 2
--replacepkgs Replace a package with a new copy of itself[a] the section called --replacepkgs: Install the Package Even If Already Installed in Chapter 2
--replacefiles Replace files owned by another package[a] the section called --replacefiles: Install the Package Even If It Replaces Another Package's Files in Chapter 2
--force Ignore package and file conflicts the section called --force: The Big Hammer
--percent Print percentages during upgrade[a] the section called --percent: Not Meant for Human Consumption in Chapter 2
--noscripts Do not execute pre- and post-install scripts the section called --noscripts: Do Not Execute Install and Uninstall Scripts
--prefix <path> Relocate package to <path> if possible[a] the section called --prefix <path>: Relocate the package to <path>, if possible in Chapter 2
--ignorearch Do not verify package architecture[a] the section called --ignorearch: Do Not Verify Package Architecture in Chapter 2
--ignoreos Do not verify package operating system[a] the section called --ignoreos: Do Not Verify Package Operating System in Chapter 2
--nodeps Do not check dependencies[a] the section called --nodeps: Do Not Check Dependencies Before Installing Package in Chapter 2
--ftpproxy <host> Use <host> as the FTP proxy[a] the section called --ftpproxy <host>: Use <host> As Proxy In FTP-based Installs in Chapter 2
--ftpport <port> Use <port> as the FTP port[a] the section called --ftpport <port>: Use <port> In FTP-based Installs in Chapter 2
General Options Page
-v Display additional information[a] the section called Getting a bit more feedback with -v in Chapter 2
-vv Display debugging information[a] the section called Getting a lot more information with -vv in Chapter 2
--root <path> Set alternate root to <path>[a] the section called --root <path>: Use <path> As An Alternate Root in Chapter 2
--rcfile <rcfile> Set alternate rpmrc file to <rcfile>[a] the section called --rcfile <rcfile>: Use <rcfile> As An Alternate rpmrc File in Chapter 2
--dbpath <path> Use <path> to find the RPM database [a] the section called --dbpath <path>: Use <path> To Find RPM Database in Chapter 2
Notes:
a. This option behaves identically to the same option used with rpm -i. Please see Chapter 2 for more information on this option.

rpm -U — What Does it Do?

If there was one RPM command that could win over friends, it would be RPM's upgrade command. After all, anyone who has ever tried to install a newer version of any software knows what a traumatic experience it can be. With RPM, though, this process is reduced to a single command: rpm -U. The rpm -U command (--upgrade is equivalent) performs two distinct operations:

  1. Installs the desired package.

  2. Erases all older versions of the package, if any exist.

If it sounds to you like rpm -U is nothing more than an rpm -i command (see Chapter 2) followed by the appropriate number of rpm -e commands, (see Chapter 3) you'd be exactly right. In fact, we'll be referring back to those chapters as we discuss rpm -U, so if you haven't skimmed those chapters yet, you might want to do that now.

While some people might think it's a "cheap shot" to claim that RPM performs an upgrade when in fact it's just doing the equivalent of a couple of other commands, in fact, it's a very smart thing to do. By carefully crafting RPM's package installation and erasure commands to do the work required during an upgrade, it makes RPM more tolerant of misuse by preserving important files even if an upgrade isn't being done.

If RPM had been written with a very "smart" upgrade command, and the install and erase commands couldn't handle upgrade situations at all, installing a package could overwrite a modified configuration file. Likewise, erasing a package would also mean that config files could be erased. Not a good situation! However, RPM's approach to upgrades makes it possible to handle even the most tricky situation — having multiple versions of a package install simultaneously.

Config file magic

While the rpm -i and rpm -e commands each do their part to keep config files straight, it is with rpm -U that the full power of RPM's config file handling shows through. There are no less than six different scenarios that RPM takes into account when handling config files.

In order to make the appropriate decisions, RPM needs information. The information used to decide how to handle config files is a set of three large numbers known as MD5 checksums. An MD5 checksum is produced when a file is used as the input to a complex series of mathematical operations. The resulting checksum has a unique property, in that any change to the file's contents will result in a change to the checksum of that file. [1] Therefore, MD5 checksums are a powerful tool for quickly determining whether two different files have the same contents or not.

In the previous paragraph, we stated that RPM uses three different MD5 checksums to determine what should be done with a config file. The three checksums are:

  1. The MD5 checksum of the file when it was originally installed. We'll call this the original file.

  2. The MD5 checksum of the file as it exists at upgrade time. We'll call this the current file.

  3. The MD5 checksum of the corresponding file in the new package. We'll call this the new file.

Let's take a look at the various combinations of checksums, see what RPM will do because of them, and discuss why. In the following examples, we'll use the letters X, Y, and Z in place of lengthy MD5 checksums.

Original file = X, Current file = X, New file = X

In this case, the file originally installed was never modified. [2] The file in the new version of the package is identical to the file on disk.

In this case, RPM installs the new file, overwriting the original. You may be wondering why go to the trouble of installing the new file if it's just the same as the existing one. The reason is that aspects of the file other than its name and contents might have changed. The file's ownership, for example, might be different in the new version.

Original file = X, Current file = X, New file = Y

The original file has not been modified, but the file in the new package is different. Perhaps the difference represents a bug-fix, or a new feature. It makes no difference to RPM.

In this case, RPM installs the new file, overwriting the original. This makes sense. If it didn't, RPM would never permit newer, modified versions of software to be installed! The original file is not saved, since it had not been changed. A lack of changes here means that no site-specific modifications were made to the file.

Original file = X, Current file = Y, New file = X

Here we have a file that was changed at some point. However, the new file is identical to the existing file prior to the local modifications.

In this case, RPM takes the viewpoint that since the original file and the new file are identical, the modifications made to the original version must still be valid for the new version. It leaves the existing, modified file in place.

Original file = X, Current file = Y, New file = Y

At some point the original file was modified, and those modifications happen to make the file identical to the new file. Perhaps the modification was made to fix a security problem, and the new version of the file has the same fix applied to it.

In this case, RPM installs the new version, overwriting the modified original. The same philosophy used in the first scenario applies here — although the file has not changed, perhaps some other aspect of the file has, so the new version is installed.

Original file = X, Current file = Y, New file = Z

Here the original file was modified at some point. The new file is different from both the original and the modified versions of the original file.

RPM is not able to analyze the contents of the files, and determine what is going on. In this instance, it takes the best possible approach. The new file is known to work properly with the rest of the software in the new package — at least the people building the new package should have insured that it does. The modified original file is an unknown: it might work with the new package, it might not. So RPM installs the new file.

BUT… The existing file was definitely modified. Someone made an effort to change the file, for some reason. Perhaps the information contained in the file is still of use. Therefore, RPM saves the modified file, naming it <file>.rpmsave, and prints a warning, so the user knows what happened:
warning: /etc/skel/.bashrc saved as /etc/skel/.bashrc.rpmsave
            
These five scenarios cover just about every possible circumstance, save one. The missing scenario?

Original file = none, Current file = ??, New file = ??

While RPM doesn't use checksums in this particular case, we'll describe it in those terms, for the sake of consistency. In this instance, RPM had not installed the file originally, so there is no original checksum.

Because the file had not originally been installed as part of a package, there is no way for RPM to determine if the file currently in place had been modified. Therefore, the checksums for the current file and the new file are irrelevant; they cannot be used to clear up the mystery.

When this happens, RPM renames the file to <file>.rpmorig, prints a warning, and installs the new file. This way, any modifications contained in the original file are saved. The system administrator can review the differences between the original and the newly installed files and determine what action should be taken.

As you can see, in the majority of cases RPM will automatically take the proper course of action when performing an upgrade. It is only when config files have been modified and are to be overwritten, that RPM leaves any post-upgrade work for the system administrator. Even in those cases, many times the modified files are not worth saving and can be deleted.

Notes

[1]

Actually, there's a one in 2128 chance a change will go undetected, but for all practical purposes, it's as close to perfect as we can get.

[2]

Or, as some sticklers for detail may note, it may have been modified, and subsequently those modifications were undone.