How to create custom Preupgrade Assistant modules for upgrading from RHEL 6 to RHEL 7

IMPORTANT: Red Hat does not support the creation or troubleshooting of custom modules.

Prerequisites:

• The preupgrade-assistant-tools and preupgrade-assistant-el6toel7 packages are installed. See Upgrading from RHEL 6 to RHEL 7.

Creating a custom module

To create a new Preupgrade Assistant module:

1. In the default directory for the Preupgrade Assistant module sets, /usr/share/preupgrade/, run the preupg-content-creator utility.
2. Enter the module set name (it is recommended to use the RHEL6_7 module set provided by the preupgrade-assistant-el6toel7 package), the name for a group of modules (use the name 3rdparty), and the module name, a title, and a description.
3. Update the generated files within the module directory created in step 2 according to the module-writing tutorial located in the Content from github.com is not included.preupgrade-assistant GitHub repository.

Running a custom module

If you have included your module in the RHEL6_7 module set, your module will be automatically run when you use the preupg command.

If you have not used the RHEL6_7 module set, it means that you have created your custom module set with only one module. To run such a module set:

1. Use the preupg-xccdf-compose command, which checks if your content is properly created and if nothing is missing. This command also creates the [module-set]-results/all_xccdf.xml file.

   preupg-xccdf-compose [module-set]
   

2. Run the preupg binary as root:

   preupg -c [module-set]-results/all_xccdf.xml