Before you can start migrating data from the current ConnectWise SOAP API to the REST API, you need to configure a new ConnectWise Manage security role and API member. Once that’s done, and you have a copy of the ConnectWise Manage API keys, you can proceed with migrating data.
NOTICE 1: Once migration has started, you won’t be able to update any settings for the Auvik / ConnectWise Manage integration. While the migration is happening, Auvik alerts and ConnectWise Manage tickets will continue to update.
NOTICE 2: Previously, when IP addresses were synced from Auvik to ConnectWise Manage, all IP addresses on the device would sync to a single default field. Due to a recent change in ConnectWise Manage, after your migration is complete, only a single IP address will sync into the default IP address field.
If you’d like all IP addresses associated to the device to be synced from Auvik into ConnectWise Manage, it is recommended that you create a new IP Address field question in ConnectWise Manage for the configuration, and map IP address in Auvik to the question.
- From the Auvik dashboard, click Integrations in the side navigation bar.
- In the displayed list of integrations, click the row for the ConnectWise Manage integration.
Step 1 - Authentication
To confirm the correct public or private API key was entered before saving, click the eye () in the public or private API key fields to show the API key. To hide the API key, click the eye (
) again.
- Paste in the public API key copied from the ConnectWise Manage API user screen.
- Paste in the private API key copied from the ConnectWise Manage API user screen.
- Click Test Connection to confirm your settings are accurate.
- Click Submit. Continue to Step 2.
Step 2 - Data sources
Step 2 runs a test of your data migration. But before the test can be run, you must first indicate how you want to deal with disabled clients.
If you have any disabled clients, they’ll be listed here. You can choose to enable the client or skip the client.
- Enabling: Navigate to All Clients and enable the disabled client. If the client is under a multi-client and both are disabled, you’ll need to re-enable both the multi-client and client.
- Skipping: Click Skip Client at the end of the row for the client. Repeat for each client to be skipped. If you choose to skip a client’s migration, the client will no longer be mapped. If you re-enable the client in the future, you’ll need to map the client to the appropriate ConnectWise Manage company.
You can only continue to Step 3 after all test migrations show 100%. For the test migrations to reach 100%, you must complete one of the two options for each disabled client.
The test migration isn’t expected to take long. If the test doesn’t complete within 10 minutes, contact our technical support team for help.
Step 3 - Migrate company mappings
We recommend migrating one or two sample clients before migrating all. This gives you time to check that the data is in good shape before migrating everything.
- In the displayed list of mapped clients to be migrated, find the client(s) you want to migrate. Check the box at the beginning of each row.
- Click Migrate.
- Click Dismiss to confirm the alert(s) should be dismissed.
Now that your clients have started migrating, you can either view the inventory migrated or create a test alert to confirm your integration settings.
If you have a number of clients to migrate and are manually checking them one by one, you can check the Verified? box next to each client. This helps you keep track of which clients have been checked and which still need to be checked.
View inventory
From the migrated company mappings table, click View inventory. The inventory details open in a new browser tab.
Create a test alert
Before you send a test alert, confirm that you don’t have an active maintenance window, as this will suppress the notification and the test will only partially work. We recommend you create at least one test alert to confirm the migration and integration settings.
- In the displayed list of migrated company mappings, find the client you want to create a test alert for. Check the box at the beginning of the row.
- Click Create test alert.
- Update or set the details for the test alert.
- Optional: Update the alert name and alert description.
- From the Notification Channels field, select the appropriate ConnectWise Manage notification channel to send the test alert to.
- Optional: Select a different severity level than what’s defaulted.
- From the Select a Device(s) field, select one or more devices you’d like to send a test alert for.
- Click Create test alert.
If you navigate to the client’s dashboard and click All Alerts from the side navigation, you’ll be able to see the test alert and the associated ConnectWise Manage ticket ID. If you don’t see a ConnectWise Manage ticket ID, and instead see Failed to send, contact our technical support team for help.
Now that the test is complete, don’t forget to dismiss the alert either in Auvik or ConnectWise Manage to remove it from your active queue.
Step 4 - Summary
You’re almost finished, but there’s one last thing we need to do to ensure the old Auvik - ConnectWise Manage configuration isn’t being called: We need to remove the integrator login that was created.
There are two options for removing the login. The one you choose will depend on how the integrator login was originally set up for the Auvik / ConnectWise Manage integration.
- Delete the integrator login: Use this option if you’ve created an integrator login specific to the Auvik / ConnectWise Manage integration.
- Remove the callback URL: Use this option if you’ve used an existing integrator login that’s being used by other systems as well as the Auvik / ConnectWise Manage integration.
Delete the integrator login
- Log into the ConnectWise Manage dashboard.
- From the navigation menu, click System, then Setup Tables.
- Under the table column, enter Integrator Login and click the row from the search results that come up.
- Click the row for the integrations integrator login.
- From the integrator login details, click the trash can (
).
- Click OK to confirm the deletion.
Remove the callback URL
- Log into the ConnectWise Manage dashboard.
- From the navigation menu, click System, then Setup Tables.
- Under the table column, enter Integrator Login and click the row from the search results that come up.
- Click the row for the integrator login used by the integration in Auvik.
- Scroll down to see the section called Service Ticket *.
- Clear the URL that’s listed.
- Click Save.
* If you’ve added the callback URL from Auvik in other locations, it needs to be removed from each of those locations as well.
Completing the migration
Remember to click Check here to confirm that the callback was removed. Now click Finish.
It might take upwards of 30 minutes to complete the re-syncing of inventory configurations. Don’t worry! New records won’t be created. We’re simply confirming the links between the systems to ensure the correct records are being kept current.