IT Glue

How to configure the Domotz IT Glue integration

Domotz IT Glue integration

Domotz network management software includes an integration with IT Glue documentation software.

The Domotz IT Glue Integration streamlines the documentation of networks by automatically sending the device and network details discovered by Domotz to IT Glue, and viceversa synchronize the Configurations into the Domotz Device entities.

Domotz will discover devices including device details like model, MAC address, location, zone, software version, IP addresses and more and automatically send these details directly to IT Glue.

This integration with IT Glue allows you to synchronize the following data between Domotz and IT Glue:

  • Domotz Agents and Devices
  • IT Glue Organizations and Configurations

Learn more about the Domotz integration with IT Glue documentation management IT software.

On IT Glue: How to set-up the Domotz IT Glue integration

Before starting to connect an integration, you need to generate an API Key following these steps:

  1. Login to your IT Glue dashboard
  2. Select the API Keys tab from the section Account
  3. Click on the + button under the Custom API Keys section and add a Name (e.g. Domotz)
  4. Click on Generate API Key to generate a new API Key to configure the IT Glue integration on Domotz

Domotz IT Glue integration screenshot 1

Keep track of the API Key generated, which will be used in the next step.

Important Note: Domotz cloud will connect to the IT Glue cloud from the following IP addresses:
– 52.71.132.221 for all the users based in North America
– 52.48.78.120 for all the users based on Europe, APAC and Rest of World

If you are using IP Restriction feature on your IT Glue instance, make sure to whitelist the above IP Addresses used exclusively by Domotz.

On Domotz: How to set-up the Domotz IT Glue integration

  1. Login to your Domotz system
  2. Select the menu Services under the Account Settings section
  3. Select IT Glue from the list of available documentation services you would see on your screen

Domotz IT Glue integration screenshot 2

4. Insert the API key generated on the IT Glue dashboard and then click on the Connect button:

Domotz IT Glue integration screenshot 3

5. After the API key validation, you would see the following page with the list of the Domotz Agents available to match with the IT Glue Organizations:

Domotz IT Glue integration screenshot 5

Note: Expired agents or agents granted by the collaboration system won’t be shown on this list.

How to associate Domotz and IT Glue Items

In this section, you can match Domotz Agents and Devices with IT Glue Organizations and Configurations.

To link a Domotz Agent to an IT Glue Organization, click on the + button under your IT Glue Organizations list:

Domotz IT Glue integration screenshot 6

A pop-up window will appear where you can select the IT Glue Organization you would like to link to a Domotz Agent:

Domotz IT Glue integration screenshot 7

If you want to set the Location for this specific association, choose Select Location and then click on the Link Organization button.
Setting the location is not required but optional and you can change it at any time.

The pop-up window will be closed and after few seconds the information about the linked Organization will be shown, including the number of Domotz Devices matched with the IT Glue Configurations:

Domotz IT Glue integration screenshot 8

Important Note: The match between Domotz Devices and IT Glue Configurations includes results only from your Domotz Devices marked as important.

Note: The automatic match between Domotz Devices and IT Glue Configurations is based on the MAC Address or on the IP Address of the IT Glue Configuration, in case no MAC Address is defined on it.

How to manage the matching between Domotz Devices and IT Glue Configurations

In this section, you can link or unlink Domotz Devices and IT Glue Configurations.

Match the configuration

  • To manually match a Domotz device with an IT Glue configuration, click on the number of matched devices:
Domotz IT Glue integration screenshot 9
  • To link a configuration to a Domotz Device without any match, click on the + Match Configuration button:
Domotz IT Glue integration screenshot 10

A pop-up window will appear from where you can create a new IT Glue Configuration or select an existing one and then link it to the Domotz Device:

  • To allow Domotz to link the Domotz Device to a new IT Glue Configuration (created by Domotz itself), select Create New Configuration and then click on Save.
  • To link the Domotz Device to an existing IT Glue Configuration, select it from the list and then click on Save:
Domotz IT Glue integration screenshot 11

Bulk creation of IT Glue Configurations

In case more than one IT Glue Configuration has to be created at once, for example, if Domotz is used to set up an IT Glue Organization from scratch, the operation can be sped up using the multi-select option next to each row, and the Pick an action button.

Domotz IT Glue integration screenshot 12

To manually unlink already matched Configuration:

  • Click on the button the number of Domotz Devices matched with the IT Glue Configurations:
Domotz IT Glue integration screenshot 13
  • Then click on the button x next to the configuration as shown in the screenshot below:
Domotz IT Glue integration screenshot 14

Important note: There is no confirmation requested before unlinking the Configuration.

How to set up the synchronization

In this section, you will learn how to set-up the synchronization manually or automatically.

In addition, we’ll cover how to define the synchronization direction between the Domotz Agents and the IT Glue Organizations for each field.

Manual Synchronization

To start the manual synchronization, select the desired Agent and then click on the Sync now button:

Domotz IT Glue integration screenshot 15

Note: Only a Domotz Agent already linked to an IT Glue Organization can be selected.

A pop-up window will appear where the user can select the direction of the synchronization between the Domotz Agents and Devices and the IT Glue Organizations and Configurations.

The user has the following options:

  • Synchronization from Domotz to IT Glue:
    If you click on the Domotz > IT Glue button, the information stored on the Domotz Devices will override the information on the IT Glue Configuration.
  • Synchronization from IT Glue to Domotz:
    If you click on the IT Glue > Domotz button, the information stored on the IT Glue Configuration will override the information on the Domotz Devices.
  • Customized synchronization:
    If you click on the Fields Custom Direction button, you can choose the synchronization direction for every single field from the Custom Match Fields Configuration window.
Domotz IT Glue integration screenshot 16

As soon as the user chooses an option for the synchronization, a message In progress will appear next to the Organization name.

  • In case of success of the synchronization, the system will display Last Sync time:
Domotz IT Glue integration screenshot 17
  • In case of an error during the synchronization, the system will display a message Failed Sync and the time of the last successful synchronization:
Domotz IT Glue integration screenshot 18

Note: In case of an error for the synchronization, we invite the user to contact our Support team support@domotz.com

Automatic Synchronization

The automatic synchronization occurs every 12 hours.

To enable the automatic synchronization, click on the toggle on the Sync column, then confirm the operation on the confirmation pop-up.

Domotz IT Glue integration screenshot 19

As soon as the sync toggle is enabled, a new automatic synchronization will occur within the next 5 minutes.

Note: In case of an error during the automatic synchronization, the system will display a message Failed Sync next to the organization name and the automatic synchronization will be disabled.

The automatic synchronization is only based on the direction specified for each field between Domotz and IT Glue.

The user can define the direction of the automatic synchronization from the Match Fields configuration section.

Match Fields configuration

In this section the user can define or disable the synchronization direction of every field:

  • To define or change the synchronization direction of a field, click on the button under the Direction column, for example, Domotz to IT Glue >>.
  • To disable the synchronization between the Domotz and IT Glue fields, click on the toggle on the right side of a desired field to switch it off.

However, some of the fields have their mandatory synchronization direction from Domotz to IT Glue: Current Status, MAC Address, IP Address (First IP), Hostname, which cannot be changed:

Domotz IT Glue integration screenshot 20

Important Note: The match Domotz & IT Glue Fields configuration displayed on this page, will be the one used for every automatic synchronization in terms of the selected synchronization direction.

How to remove the integration between Domotz and IT Glue

To completely disconnect the integration with IT Glue from Domotz, select the Manage Integration tab on the Services – IT Glue section, then click on the Remove Integration button and the integration will be removed:

Domotz IT Glue integration screenshot 21
Updated on July 23, 2021

Was this article helpful?