In-place upgrade architecture and workflow

The upgrade Workflow and architecture of the upgrade process is quite complex. The following pages provide detailed description of the most important components.

For the general architecture of the leapp framework see Building blocks and architecture in framework documentation.

Contents:

• Phases of the Upgrade Workflow
  • Choosing a Phase for an Actor
    • Inhibiting the Upgrade of an Incompatible System
    • Modifying Incompatible Configuration during the Upgrade
  • Phases Overview
    • Old System
      • FactsCollectionPhase
      • ChecksPhase
      • TargetTransactionFactsCollectionPhase
      • TargetTransactionCheck
      • ReportsPhase
      • DownloadPhase
      • InterimPreparationPhase
    • Interim System
      • InitRamStartPhase
      • LateTestsPhase
      • PreparationPhase
      • RPMUpgradePhase
      • ApplicationsPhase
      • ThirdPartyApplicationsPhase
      • FinalizationPhase
    • Target System
      • FirstBootPhase
• Leapp dracut modules and upgrade initramfs
  • Preparing the generation of initramfs
    • Including custom dracut and kernel modules
  • Generating the initramfs
  • Network in initramfs
  • Debugging inside initramfs
• Target userspace creator
  • Scratch container
    • When we want to modify the source system, but we also don’t want to
      • An important detail in how is the Scratch container set up
      • A comprehensive example of what is mounted where in the scratch container
    • Target repositories and how are they obtained
    • Broken symbolic links