Follow these steps to migrate the Hybrid Connector to a new server when you upgrade the operating system of the server or virtual machine where it runs.
Before you start, check the Hybrid Connector migration requirements.
Supported operating systems
- New installations of the Hybrid Connector require Windows Server 2022 or Windows Server 2025. Windows Server 2019 is no longer supported for new deployments.
- If you already run the Hybrid Connector on Windows Server 2019, it continues to work as usual. However, we recommend that you migrate to Windows Server 2022 or 2025 to keep your deployment supported.
Use a replacement virtual machine for the migration
Because the Hybrid Connector runs in a Windows Server container that must match the Windows Server version of the host, every move to a more recent Windows Server version follows the same procedure, whatever your starting version. This applies, for example, when you move from Windows Server 2019 to 2022 or 2025, and from Windows Server 2022 to 2025.
To migrate a Hybrid Connector:
- Create a new virtual machine that runs the target Windows Server version.
- Configure a new Hybrid Connector installation on the replacement virtual machine.
- Decommission the previous virtual machine.
In-place OS upgrades are not supported
Always migrate to a new virtual machine. Upgrading the operating system of the existing virtual machine is not supported for Hybrid Connector migrations.
Follow the migration procedure
Use the documented migration procedure to deploy and configure the replacement Hybrid Connector before you retire the existing deployment.