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.

• Create the primary packaging source by entering: python setup.py sdist --formats=gztar. Note: The other packaging sources are in the packaging/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"
  

• 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 preupg command with root privileges.

• Enter the python setup.py test command.

To learn how to write modules for the Preupgrade Assistant, see the tutorial located in the doc/module_writing_tutorial file.

See our guidelines on how to contribute to this project.