How to map Auvik tenants to ServiceNow companies and locations for the Auvik - ServiceNow CMDB integration?

Auvik tenants are mapped to ServiceNow CMDB companies and locations, so that new Configuration Items (CIs) are properly associated. Note:

• If the ServiceNow instance is domain-separated, you may have to refresh the page to see the updated Domain field.
• When you are in a specific ServiceNow domain scope, you will only see tenant rows mapped to the current domain and the global domain. 

Add a new tenant mapping

Edit a tenant mapping

Disable a tenant mapping

Add a new tenant mapping

1. In ServiceNow, navigate to Service Graph Connector -> Auvik -> Auvik Tenants.
2. Select the ServiceNow company to map to
   • Go to the tenant row you want to map.
   • Double click the cell under the Company column to edit.
   • Using the dropdown, select the desired ServiceNow company to map to.
   • Click the checkmark icon to save. The Domain will automatically populate based on the selected company.
3. (Optional) Select the ServiceNow location to map to
   • Go to the tenant row you want to map.
   • Double click the cell under the Location column to edit.
   • Using the dropdown, select the desired ServiceNow location to map to.
   • Click the checkmark icon to save.
4. Enable the tenant mapping
   • Go to the tenant row you want to map.
   • Double click the cell under the Active column to edit.
   • Using the dropdown, select true.
   • Click the checkmark icon to save.

Note: Mapping a global site or multi-site will have no impact on its descendants. They are included for informational purposes only. 

If Enable Delta Sync is set to Yes, perform the following to sync devices from the new tenant:

1. Disable existing active tenant mappings.
2. Disable delta sync (see How to update device sync options for Auvik / ServiceNow CMDB integration?)
3. Manually run a device sync (see How to manually run a device and tenant sync for Auvik / ServiceNow CMDB integration?).
4. Re-enable the tenants from step 1.
5. Restore the Enable Delta Sync setting.

Note: If you do not want to run a full sync on all tenants, turn off the sync on the existing active tenants and turn them back on after the manual sync has completed.

Edit a tenant mapping

1. In ServiceNow, navigate to Service Graph Connector -> Auvik -> Auvik Tenants.
2. (Optional) Select the new ServiceNow company to map to
   • Go to the tenant row you want to edit.
   • Double click the cell under the Company column.
   • Using the dropdown, select the desired ServiceNow company to map to.
   • Click the checkmark icon to save. The Domain will automatically populate based on the selected company.
3. (Optional) Select the new ServiceNow location to map to
   • Go to the tenant row you want to edit.
   • Double click the cell under the Location column.
   • Using the dropdown, select the desired ServiceNow location to map to.
   • Click the checkmark icon to save.
4. Enable the tenant mapping
   • Go to the tenant row you want to edit.
   • Double click the cell under the Active column to edit.
   • Using the dropdown, select true.
   • Click the checkmark icon to save.

To update all existing CIs, so that the Company and Location attributes are updated with the new mapping:

1. Disable delta sync (see How to update device sync options for Auvik / ServiceNow CMDB integration?)
2. Manually run a device sync (see How to manually run a device and tenant sync for Auvik / ServiceNow CMDB integration?).
3. Restore the Enable Delta Sync setting.

Disable a tenant mapping

1. In ServiceNow, navigate to Service Graph Connector -> Auvik -> Auvik Tenants.
2. Go to the tenant row you want to disable.
3. Double click the cell under the Active column.
4. Using the dropdown, select false.
5. Click the checkmark icon to save.

Disabling a global site or multi-site will have no impact on its descendants. They are included for informational purposes only. 

Note: Deleted Auvik tenant rows will be re-added on the next Auvik Tenant sync with the Active field set to false.