# Migrating a Dashboard

{% hint style="info" %}
*Check out the walk-through on how to import a Dashboard using the GIT Migration option.*
{% endhint %}

<figure><img src="https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FWSXJ85tPCa34VXb86HzP%2Fgit%20import.gif?alt=media&#x26;token=dec6e5c1-73a0-4949-be64-b2dabe6dc794" alt=""><figcaption></figcaption></figure>

* Navigate to the ***Admin Module.*** &#x20;
* Click the ***Menu*** icon to open the admin menu panel.  &#x20;

![Accessing the Admin module](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FBNpDE5CaMEwHYaNzWegt%2Fimage.png?alt=media\&token=99be4685-8d38-4306-bf27-f4d11f875d48)

* Click the ***GIT Migration*** option from the Menu Panel.

&#x20;     ![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FMtEqQawwNtr2ht67JueH%2Fimage.png?alt=media\&token=63b53279-21e1-4035-bf5e-7dbbb5d69f5b)

* Click the ***Import file*** option that appears.&#x20;

&#x20;    ![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FSUQLVU5RkLcvjp5RvJsJ%2Fimage.png?alt=media\&token=c859274d-c41f-4dc1-a45b-5a95978b4175)                                                   &#x20;

* Click the ***Import*** option that appears on the next page.&#x20;

&#x20;      ![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FrCfn7DhtUyjGZUmc9f6s%2Fimage.png?alt=media\&token=5b2c1f8c-7888-49b4-a4d2-329dab9a99d7)

* The ***Migration-Document Import*** screen appears.
* Select the ***New VCS*** for the ***Version Control Configuration***.
* The ***Select a Module*** drop-down menu bar appears at the top-right side of the screen.     &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FIK8pG0OkYVyyW0cKMRYH%2Fimage.png?alt=media\&token=f434962c-087a-4914-9bfe-3b04affe23f4)

* Select the ***Dashboard*** module.
* A list of the exported dashboards appears on the left side of the page.                                            &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FzUI89KcGrdtyNghZO7Gs%2Fimage.png?alt=media\&token=f19d7ebf-def3-4559-8c45-9168a1c4594f)

* Use the search bar to search for a dashboard. (Ex. Migration)
* The customized list appears based on the searched term.                                          &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FKx5U9o5GZ1cbyCt1pvrs%2Fimage.png?alt=media\&token=6d0f39b0-8f8e-4677-8d4f-133ad9082202)

* Select a dashboard and click to open the details.
* The various versions (if available in the GIT) of the selected dashboard appear.                                               &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2Fudg3yxkvFPltZeaZLrW5%2Fimage.png?alt=media\&token=56d294a2-7741-4bfd-af89-3f4ec4a16854)

* Select a version using the checkbox.
* Some more information about the selected dashboard gets displayed.
* Click the ***Migrate*** option.                                                                       &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FsDbOtq2hR1dR0S4VnOsi%2Fimage.png?alt=media\&token=db6619f4-c4d8-42cf-8227-bdca6ed4870b)

* The ***Data Connector Details*** dialog window appears to configure a data connector.&#x20;
* The user gets two choices to configure the data connector:

&#x20;    &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FqWmPzrptd3W37TOQo6pr%2Fimage.png?alt=media\&token=0d1fd875-bd0b-47a6-8bd4-c06c61fb99da)

#### Use Existing Connector

* Let the checkmark be in the given checkbox to use an existing connector.
* Select a data connector from the drop-down menu.
* Click the ***Save*** option to save the configured data connector details.&#x20;

&#x20;      ![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2Fy7sqymyJztRca5ZhlGA0%2Fimage.png?alt=media\&token=1ae00184-3d44-4fb2-9a2a-96663f1adca2)

{% hint style="info" %} <mark style="color:green;">Please Note:</mark> *When the selected Dashboard displays multiple connectors, the user must select them all with the **Use Existing Connector** option to load all the charts under the selected Dashboard.*
{% endhint %}

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FMwnMaU9IDQVVdleCcpZt%2Fimage.png?alt=media\&token=2621da84-cb43-46f2-bf88-b40229a82571)

#### Create a New Data Connector:&#x20;

* Select the ***Create New Connector*** option.
* Provide the required details: Username, Password, PI/Host, Database Name
* Click the ***Save*** option.     &#x20;

&#x20;     ![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2F8Rf3jBWe1Gi3CL3ue1jK%2Fimage.png?alt=media\&token=5d68d519-3664-4100-9518-341a8daa3949)                                                              &#x20;

* A notification message appears, and the selected dashboard gets migrated to the Designer module.

&#x20;     ![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FoRhjMwAcbkLXWEeKmfOA%2Fimage.png?alt=media\&token=f4d02228-29eb-412e-a085-a489f776c4f7)

* Navigate to the ***Designer*** module.
* The migrated dashboard gets added to the ***Manage*** section.   &#x20;

![](https://972575688-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRYq1HgffNfbnIMWPu1D5%2Fuploads%2FTV93DqiJ5ny0Y5sC6Sv7%2Fimage.png?alt=media\&token=1be70db5-98bb-426b-9904-83d22eb8c603)

{% hint style="info" %}
&#x20;<mark style="color:green;">Please Note:</mark> *Click the **GIT Export** icon to export the selected dashboard to GIT. All the exported Dashboards can be imported using the Import File option of the GIT Migration.*
{% endhint %}