> For the complete documentation index, see [llms.txt](https://docs.cgpoly.io/door-system-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cgpoly.io/door-system-documentation/advanced/migration-tool.md).

# Migration Tool

<figure><img src="/files/5soBGmazrBoZqTC2Nhnq" alt=""><figcaption></figcaption></figure>

This powerful tool efficiently navigates through breaking changes, effortlessly adapting your actual SmartDoors while saving valuable development time.&#x20;

Say goodbye to tedious manual updates and hello to streamlined migrations with the Migration Tool. Get ready to upgrade your projects with ease and precision.

#### Where ?

You can find the Migration Tool in Tools > Door System > Migration Tool<br>

<figure><img src="/files/wvidOR16hgrQvbv86mRS" alt=""><figcaption><p>Migration Tool path</p></figcaption></figure>

When you install the v2 for the first time, the welcome modal is providing a shortcut to the Migration Tool as well.

<figure><img src="/files/t6smfobeLlWHYarzYIfw" alt=""><figcaption><p>Welcome modal</p></figcaption></figure>

#### How to use it ?

Migration Tool should only be used for migrating to v1 to v2!

If you just direclty Door System v2, without having worked with v1 in you project, you don't need it.

{% hint style="warning" %}
Please, consider performing a Backup of your project (eg: git) before using this tool as it may lead to undoable actions on your doors!
{% endhint %}

First, open the Migration Tool in a Scene / on a Prefab that contains SmartDoors to migrate.

Migration Tool will automatically find SmartDoors that need to migrate to v2.

<figure><img src="/files/n1zVBAIcbnADF41auPJG" alt=""><figcaption><p>Migration Tool found SmartDoors to migrate</p></figcaption></figure>

{% hint style="info" %}
You can click on doors listed in the dropdown to select them in your Scene
{% endhint %}

When you're ready, just click on "Migrate" button. \
It will perform the Migration immediatly.

Once Migration is complete, doors status are updated to tell you if anything wrong has been detected:<br>

<figure><img src="/files/FkF1o6WpsMoI4vq1IklX" alt=""><figcaption><p>Migration report</p></figcaption></figure>

{% hint style="info" %}
You can click on doors listed in the dropdown to select them in your Scene
{% endhint %}

Possible statuses are:

* <mark style="color:blue;">Waiting</mark>: Door can be migrated and is waiting for your action
* <mark style="color:blue;">In Progress</mark>: Door is being migrated
* <mark style="color:green;">Done</mark>: Migration succeed without any known issues
* <mark style="color:yellow;">Done With Warning</mark>: Migration succeed but it invites you to double check some settings
* <mark style="color:red;">Failed</mark>: Something went wrong, door has not been migrated

Most of the time, <mark style="color:yellow;">Done With Warning</mark> can be ignored, so do not worry if you can't find any errors on your doors ;)

Although Migration Tool has been made to handle most cases, **I invite you to always check your doors after a migration**.