# Migration tool

This tool is required if you have migrated your portal from flow 5 to flow 6, but your Flow 6 environment differs from Flow 5.

It supports migrating *Connectors, Workflows, Roles, News Viewer Comments*

**1.** Complete a portal migration by following the steps in: [Upgrade](https://help.novacuraflow.com/6.11/installation-and-upgrade/upgrade-installation)

**2.** Open the Migration Tool folder

Set up the Migrate5To6.exe.config file with:

* Appsettings
* ssoCommonSecret: enter {ssoCommonSecret} found in your novacura flow server web.config file.
* serverLogin value: flow user with portal admin rights".
* ConnectionStrings
* Data Source: Path to the the 5 Portal sql server.
* Initial Catalog: Name of the 5 Portal database.
* user id: login to access database.
* password: password to the user id.
* The second connection string also needs to be configured, it works the same way but it's the receiving end. Which means here you type in the portal 6 server/database.
* Client
* Endpoint address: change everything before /PortalAPI to your novacura flow server e.g "<http://myserver/Novacura.Flow.6.Server/PortalAPI/PortalUsersAccessService.svc>"

Do the same for both endpoint addresses in Client and save your modified .config file&#x20;

![Configuration Example](https://543770944-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPTgZOYmpJka4jqs1v%2F-M-oWq2Ej4uPnieA9PJY%2F-M-oXSPgSOXWobnxteF-%2Fhelp_root_installation_migtoolconfig.png?alt=media\&token=657f7b1c-1b3e-4610-b7d0-baa0625a6639)

**3.** Migrate portal 5 to portal 6

Run the Migrate5To6.exe tool

Click on Test flow 5 DB and Test Portal 6 db to make sure the .config file is set up correctly.

**Migrating Connectors**

1. Click on Load Flow 5 Connectors And Load Flow 6 Connectors
2. Choose the flow 5 connector that is being used somewhere in the flow 5 portal.
3. Choose the corresponding flow 6 connector that should be used in the flow 6 portal.
4. Click on the >> button to map the connectors.
5. Repeat this for every connector you wish to migrate and map to flow 6.

![](https://543770944-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPTgZOYmpJka4jqs1v%2F-M-oWq2Ej4uPnieA9PJY%2F-M-oXfm-tQTNmpY6ChwF%2Fhelp_root_installation_connectors.png?alt=media\&token=287bd5d2-0fa9-4e97-b7f4-09dba15e380c)

**Migrating Roles**

1. Click on Load Flow 5 Roles And Load Flow 6 Roles
2. Choose the flow 5 role that is being used somewhere in the flow 5 portal.
3. Choose the corresponding flow 6 role that should be used in the flow 6 portal.
4. Click on the >> button to map the roles.
5. Repeat this for every role you wish to migrate and map to flow 6.

![](https://543770944-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPTgZOYmpJka4jqs1v%2F-M-oWq2Ej4uPnieA9PJY%2F-M-oXjXM6x4tJCDCz-3g%2Fhelp_root_installation_roles.png?alt=media\&token=876f1d66-d5b5-43d8-b547-2afa80870ff4)

**Migrating Workflows**

1. Click on Load Flow 5 portlets.
2. Click on Load Flow 6 Workflows.
3. Select a portlet to display the workflows used by the portlet.
4. Select and input which kind of flow 5 workflow and it's parameters in the corresponding text box.
5. Select which flow 6 workflow that corresponds to that operation press the >> button which will fill the necessary text boxes with information.
6. Click on Save Workflows for selected portlet.

![](https://543770944-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPTgZOYmpJka4jqs1v%2F-M-oWq2Ej4uPnieA9PJY%2F-M-oXzMHUc9ScTECvjmB%2Fhelp_root_installation_workflows.png?alt=media\&token=6f888858-7c1b-4d35-95c6-d2c3fde00822)

**Migrating News Viewer Comments**

1. Click on Find users
2. Click on Save comments users, it can only map when the user names match between environments.

\
&#x20;*Contact <product.support@novacura.com> for support if the upgrade fails.*