# 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**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cgpoly.io/door-system-documentation/advanced/migration-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.