The Preupgrade Assistant
The Preupgrade Assistant is a framework designed to run the Preupgrade Assistant modules, which analyze the system for possible in-place upgrade limitations. It is based on a modular system, with each module performing a separate test, checking for package removals, incompatible obsolete packages, changes in libraries, users, groups, services, or incompatibilities of command-line options or configuration files. It is able to execute post-upgrade scripts to finalize complex tasks after the system upgrade. Apart from performing the in-place upgrades, the Preupgrade Assistant is also capable of migrating the system. It then produces a report, which assists you in performing the upgrade itself by outlining potential problem areas and by offering suggestions about mitigating any possible incompatibilities. The Preupgrade Assistant utility is a Red Hat Upgrade Tool prerequisite for completing a successful in-place upgrade to the next major version of Red Hat Enterprise Linux.
Building a Preupgrade Assistant package
- Create the primary packaging source by entering:
python setup.py sdist --formats=gztar. Note: The other packaging sources are in the
- Build an RPM package by using a specfile in the
rpmbuild -bs packaging/preupgrade-assistant.spec \ --define "_sourcedir `pwd`/packaging/sources"
Executing the Preupgrade Assistant
- Install the preupgrade-assistant package.
- The Preupgrade Assistant requires modules. Either create your own modules by following the tutorial described below, or find modules for Red Hat Enterprise Linux in the Preupgrade Assistant Modules repository.
- Run the
preupgcommand with root privileges.
Running unit tests
- Enter the
python setup.py testcommand.
Learning how to write modules
To learn how to write modules for the Preupgrade Assistant, see the tutorial located in the
See our guidelines on how to contribute to this project.