Plugin removal

When the move from Pulp 2 to Pulp 3 is done, the pulp-2to3-migration plugin is no longer needed.

It is recommended to remove the plugin because:

  • it will reach EOL sooner than other Pulp plugins. Having it installed will prevent the system from further upgrades.

  • it stores a lot of Pulp 2 data in the Pulp 3 database which was used during migration but is no longer needed and just takes space.

remove-plugin command use

In order to remove a Pulp plugin, just uninstalling it is not enough, first the remove-plugin command should be used.

  1. Stop all Pulp services.

  2. Run the remove-plugin command.

This step ensures that all data for this plugin is properly removed from the database.

Warning

If this step is skipped, other plugins might not function properly (e.g. repository removal will fail for the migrated repositories).

$ pulpcore-manager remove-plugin pulp_2to3_migration

  1. Uninstall the pulp-2to3-migration plugin.

Steps to uninstall depend on how it was originally installed (usually, via pip for PyPI installations or dnf for RPM installations)

Warning

It is very important to perform the uninstallation step for this plugin because it has relations and references to other Pulp plugins. If this step is skipped, other plugins might not function properly (e.g. repository removal will fail for the migrated repositories).

  1. Start Pulp services.

It is possible to install the plugin again following the standard process. Under the normal circumstances, there should be no need for it.