Leapp repository for RHEL 7 to RHEL 8 upgradeΒΆ
This is the official upstream documentation for the leapp repository for in-place upgrade (IPU) from RHEL 7 to RHEL 8. The homepage of the project is here.
Contents:
- How to create a Leapp actor for RHEL 7 to 8 upgrade
- Introduction
- Setting up the development environment
- Tools
- Creating an actor
- Including an actor in the RHEL 7 to 8 upgrade process
- Inter-actor communication
- Testing your new actor
- Writing tests for an actor
- Best practices
- Contributing actors to the Leapp project
- FAQ
- In which existing workflow phase should I place my new actor?
- How to stop the upgrade in case my actor finds a problem with the system setup?
- How to stop execution of my actor in case of an unexpected error?
- How does the logging work?
- What Python version my actor/tests code should be compatible with?
- How to add tests to my new actor?
- How to use libraries or data files in my new actor?
- Where can I report an issue or RFE related to the framework or other actors?
- Where can I seek help?
- How to properly inhibit the RHEL 7 to 8 upgrade process
- Environment variables for the el7toel8 repository
- LEAPP_GRUB_DEVICE
- LEAPP_NO_RHSM
- LEAPP_OVL_SIZE
- LEAPP_DEBUG
- LEAPP_VERBOSE
- LEAPP_CONFIG
- LEAPP_LOGGER_CONFIG
- LEAPP_ENABLE_REPOS
- LEAPP_SERVICE_HOST
- LEAPP_PROXY_HOST
- LEAPP_TARGET_PRODUCT_CHANNEL
- LEAPP_NO_NETWORK_RENAMING
- LEAPP_DATABASE_FORCE_SYNC_ON
- LEAPP_NO_INSIGHTS_REGISTER
- LEAPP_NO_RHSM_FACTS
- LEAPP_NOGPGCHECK
- LEAPP_TARGET_ISO
- LEAPP_UNSUPPORTED
- Development environment variables for the el7toel8 repository
- LEAPP_DEVEL_RPMS_ALL_SIGNED
- LEAPP_DEVEL_TARGET_RELEASE
- LEAPP_DEVEL_SKIP_CHECK_OS_RELEASE
- LEAPP_DEVEL_DM_DISABLE_UDEV
- LEAPP_DEVEL_SOURCE_PRODUCT_TYPE
- LEAPP_DEVEL_TARGET_PRODUCT_TYPE
- LEAPP_DEVEL_USE_PERSISTENT_PACKAGE_CACHE
- LEAPP_DEVEL_DATABASE_SYNC_OFF
- LEAPP_DEVEL_INITRAM_NETWORK
- LEAPP_DEVEL_KEEP_DISK_IMGS
- Deprecated functionality in the el7toel8 repository