On this page:

Summary

Connectors are used to connect to other 1E and third party systems and populate repositories. For example, syncing inventory data from Configuration Manager into an inventory repository.

The following inventory connectors are provided by Tachyon out-of-the-box.

Please refer to Third party data sources below for supported versions of software used by these connectors, and other prerequisites.

Add a new connector

  1. Navigate to Settings→Configuration→Connectors.
  2. Click the Add button.

  3. In the Add Connector popup select the required Connector type from the list of connector types.

  4. Once you've made a selection the Add connector popup will be populated with the fields appropriate to the selected Connector type.
  5. Enter the relevant connector configuration details including Connector name
  6. Click Add
  7. A new connector will be added with the selected details.

You should use a naming convention for connector names:

<connector type> <scope>

Scope describes where data is coming from or what it's being used for. For example Demo, Test, Lab, Q2 Audit.

When a new connector is saved a new action is defined in Tachyon. This new action will have a name of the form: Sync Data - xxxx, where xxxx will be the name of the connector.

In order to sync the data from the connector's data source to a selected repository you will need to either:

  1. To execute a manual sync action, please refer to Execute a connector sync action below.
  2. To schedule a sync action, please refer to Schedules page.

 

Delete a connector

To delete a connector:

  1. Select the connector you want to delete from the list of Connectors by checking the box at the left-hand end of the connector's row.
  2. Click the Delete button.
  3. In the Delete connector popup you will be asked if you want to proceed and delete the selected connector.
  4. To delete, click the Yes, delete connector button.


Test a connector

Once a new connector has been added the next step is normally to test that the details you have entered enable you to connect to the specified data source.

  1. Select the connector you want to test from the list of Connectors by checking the box at the left-hand end of the connector's row.
  2. Click the Test button.
  3. The Test status column for the connector will display a clock icon  indicating that the test has been queued for executing.
  4. If the test succeeds Test status will display a check icon  and the Last tested column will display the date and time the test succeeded.
  5. If the test fails the Test status will display a failed icon  and you'll need to check the details you entered for the connector.


Execute a connector sync action

The Execute button allows you to manually run an action. To schedule an action, please refer to Schedules page.

  1. Click the Execute button.
  2. In the Execute action popup subsequently displayed, use the Repository menu to select the inventory repository you want to populate. 
  3. Once the repository has been selected you can then select the action to run. In the case of inventory repositories the actions will be restricted to inventory related actions. For a connector you will be looking for an action with the form Sync Data - <connector name>.
  4. For inventory syncs you have the option to check the Clean Sync checkbox. 

    Clean Sync causes deletion of existing data previously imported by the selected combination of action and repository. Data imported by any other connector actions is left intact and consolidated with new data. To clear all data from a repository, please refer to Repositories page: Clearing data from a repository.

    If Clean Sync checkbox is not checked then an incremental sync occurs, consolidating new data with old. IAn incremental sync is quicker than a clean sync.

    Clean Sync will prevent the Management Groups feature and applications such as Patch Success from working until the sync is complete and new data has been consolidated. This operation should only be performed if you need a clean sync or are experiencing problems with sync times taking too long.

  5. Click the Execute button in the Execute action popup to start the sync.
  6. A popup appears momentarily informing you that the Sync has started and you can monitor progress in the Process log.
  7. When the sync starts a number of actions are queued to be performed on the selected repository. To check the progress of the sync actions:
    1. Navigate to the Monitoring→Process log page.
    2. Here you can see the sequence of actions that have been queued for the selected repository related to the Sync Data action selected. 
    3. When each action has finished running you'll see a check icon   appear in the Status column if it succeeds or a failed icon   if it fails. 
  8. Once all the actions have succeeded you can check the results. To do this:
    1. Navigate to the Monitoring→Sync log page.
    2. This displays the items that have been added to the selected repository as a result of running the sync.


The Execute button is also avilable on the Settings→Monitoring→Process Log page.

Third party data sources

The following table shows the supported versions of software used by the Tachyon out-of-box connectors.

ConnectorProductNotes

ServiceNow

  • ServiceNow Jakarta release

Please refer to the ServiceNow connector page for prerequisites.

System Center Configuration Manager

  • CB 2002
  • CB 1910
  • CB 1906
  • CB 1902
  • CB 1810
  • CB 1806
  • CB 1802
  • CB 1710

Please refer to the System Center Configuration Manager connector page for prerequisites.

Tachyon

  • Tachyon 4.0
Please refer to the Tachyon connector page for prerequisites.

vCenter

  • VMware PowerCLI 11.1.0

VMware PowerCLI 11.1.0 (code.vmware.com/web/dp/tool/vmware-powercli/11.1.0) must be installed on the Tachyon Master server (where the SLA Integrate Services Agent service is hosted) before you can configure and use the vCenter connector. Earlier or later versions of PowerCLI are not supported and may cause errors. VMware PowerCLI is freeware and was previously known as vSphere PowerCLI.

VMware PowerCLI supports multiple versions of VMware vCenter Server. For details, please refer to the VMware compatibility matrix using the following link: https://www.vmware.com/resources/compatibility/sim/interop_matrix.php#interop&2=&106=

Please refer to the vCenter connector page for configuration details.