> For the complete documentation index, see [llms.txt](https://docs.vega365.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vega365.com/xport/use-cases/one-step-upgrades.md).

# One Step Upgrades

Simplify complex multi-stage upgrades

## A Use Case Example

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2FdQYheAT3QDbQoXdxs0DH%2FXPort_Scene_xa_xb_2.png?alt=media&amp;token=3342c2cd-25ec-4314-a96b-e3fa94bd0dad" alt="" width="563"><figcaption></figcaption></figure>

### The Problem

A systems integrator must retire outdated servers running **XProtect Corporate 2017** while **upgrading the VMS to the 2025 release**. The enterprise’s policy and Milestone’s upgrade rules ([link](https://supportcommunity.milestonesys.com/s/article/upgrade-to-the-latest-XProtect-version-FAQ?language=en_US)) force a multi-step, in-place process.&#x20;

For example:

1. Install XProtect 2022 on the new destination server to host the incoming database.
2. Upgrade the source from 2017 to a supported 2022 release.
3. Back up the source’s SQL database, capturing the updated 2022 schema.
4. Restore that database into the destination’s XProtect 2022 instance.
5. Run the XProtect 2025 installer on the destination, moving from 2022 up to 2025.

This approach requires multiple maintenance windows, bridge-version patches, license key management, and rollback planning at each step.

### The Solution: XPort One-Step Migration Path

* Deploy XProtect 2025 on your new server—no intermediate versions required.
* Invoke XPort to retrieve roles, users, views, and devices directly from the 2017 system via API and deposit them in the destination.&#x20;
  * The media database can also be transferred, depending on the source and target versions. Check with <support@vega25.com>.
* Finish in one maintenance window.

This collapses five traditional steps into a **single, streamlined cut-over**.

### XPort Workflow recipe

A single run of the [Upgrade-Everything Workflow](https://docs.vega365.com/xport/user-manual/upgrade-everything-workflow.md)workflow.
