> 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/user-manual/upgrade-everything-workflow/step-by-step-user-guide/roles.md).

# Roles

Pick roles to migrate to the destination

## Overview

We begin with role migration to ensure that later objects are created within a role's context. For example, when a device is migrated later, device access permissions are assigned for each role that the destination already recognizes.&#x20;

Follow the next steps to migrate roles.

{% stepper %}
{% step %}

### Start

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2Ffn2ZZMvFmNdXgkX0wPnc%2Froles.png?alt=media&amp;token=ecc9a13c-05b9-4978-8144-06140e79be11" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select Roles to Migrate

1. Select roles in the source to transfer to the destination.&#x20;
2. Basic and Active Directory Users are migrated.&#x20;

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2Fqavn0TV163nHNKErogsN%2Fselect_roles.png?alt=media&amp;token=b676784d-9b75-4ba2-9e7c-edbaf5faff24" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Begin Migration

Click the Migrate button. Role migration typically takes a few seconds per role.

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2FBKWxiGGn4vm6vf2ciVHB%2FBegin_Migration.png?alt=media&amp;token=21e14521-73bf-4e64-985f-b9898661e31a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Finish

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2F050FmxN94hOaT4CGwPdp%2Froles_complete.png?alt=media&amp;token=8b82ecf2-18a1-4a94-b54f-671b3b0f0ff2" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}
