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 thepackaging/sources/folder. - Build an RPM package by using a specfile in the
packaging/folder: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 doc/module_writing_tutorial file.
Contributing
See our guidelines on how to contribute to this project.