Setting up connectors

The following minimum requirements are required for an on-premises connector server:

• Microsoft Server operating system that is compatible with the Ivanti Neurons Agent installation
• Intel Core i7 processor at 2.5 GHz
• 8 GB of RAM
• 40 GB of disk space
• Broadband internet connection

1. Log into your Ivanti Neurons account as Administrator.

2. In the left navigation pane, click Admin > Connectors.
   
   

3. Click the Create new connector button.
   
   

4. On the Available Connectors page, click the Download Neurons Agent button to download the Ivanti Neurons Agent with the Infrastructure Agents policy, which has the Connector Server capability enabled by default. Alternatively, create an Agent Policy with the Connector Server capability and install using that. For more details refer to Agent Policies.
   The download dialog appears. Click Download.
   

5. On a server in your environment that has access to the source application, run the executable that you downloaded. This will install the agent with the policy. For information on firewall requirements, refer to Required URLs, IP addresses and ports.

6. Return to your Neurons web session. It may take a few minutes for the connector server to appear on the Connector Servers page. Once it does, you can add connectors to start gathering data from specific sources at specific times. See the next section for setting up a connector.

1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector Servers.
2. Find the connector server in the list that you want to add a connector to, and click Add Connector. Use the Cloud option to add a cloud connector for a cloud-hosted service.
   
3. From the available connectors list, select the type of connector to create.

The Jamf Pro connector requires that you enable an option in Jamf Pro before setting it up in Neurons. For details, see Jamf Pro connector. Likewise, some Microsoft cloud connectors require that you create an app in Entra ID before use. For details, see Creating apps in Entra ID for Microsoft connectors.

4. Configure the options for the connector. For details about individual connectors, see the full list at the bottom of this topic.
5. To run the connector immediately, click Save and Run at the top right of the page.
   or
   To save the connector and not have it run until its scheduled time, select the Active check box and click Save.
6. To monitor the progress of your connectors, set the toggle at the top of the page to Connectors. The list of connectors shows the current status, number of records processed and the number of records that failed to import, as well as last run, next run, and scan duration. The import can take hours if there's a lot of data.

You can also view imported records on the Devices page. For details, see Devices.

1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
2. Find the connector that you want to change and click the  icon in the column to the far right.
3. Select Run now. The connector syncs all current data.

For on-premises connectors, Ivanti Neurons automatically downloads a log file to the following path each time the connector runs: C:\ProgramData\Ivanti\Ivanti Cloud Agent\Logs.

This path is located on the connector server (i.e., the host server that has the connector engine installed and where the connector runs from). The path contains numerous Ivanti Neurons log files – look for the Collector.Engine.log file.

For cloud connectors, you can download a zip file containing the log files for a given connector. Depending on the amount of data collated, the download may take a bit of time to complete.

1. Click Admin > Connectors to open the list of configured connectors.
2. Locate the connector you want to view a log file for.
3. Scroll to the end of the row, click the options menu ( ), then select Log.

At the start of the download, a pop-up dialog will briefly open stating that the logs are being collated. Some browsers will continue the download without issue. If a pop-up blocker is enabled for your browser, you may see a message that the pop-up is blocked and needs to be approved. In this case, you will need to approve pop-ups from ivanticloud.com before downloading the zip file again.

The zip file will download to your browser’s configured download location. The filename will contain a timestamp (year, month, day) from when the download occurred (for example, Connector_4718c622_202409171647_logs.zip).

You can delete the data that was imported by a connector into Ivanti Neurons. This action will wipe any data that was imported by a given connector, but will leave all other data that was discovered, inventoried, or imported by other connectors you have set up. If the only data for a particular record was imported by the given connector, then the entire record will be deleted.

You can also wipe imported data as part of the procedures for deleting a connector or uninstalling a connector server.

1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
2. Find the connector that you want to wipe data from and click the  icon in the column to the far right.
3. Select Wipe Data.

1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
2. Find the connector that you want to change and click the  icon in the column to the far right.
3. Select Disable or Delete:

   • If disabling, you can re-enable the connector by going to the same menu and selecting Enable.

   • If deleting, it's recommended that you also select Wipe Data, which will delete all of the data that was imported by the connector. If you don't select this option, the data will become orphaned; the records will have no active data source but still exist in the system. If you choose not to wipe the data now, you can delete the orphaned records at a later date. For details, see the procedure below.

1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector servers.
2. Find the connector server that you want to uninstall and click the icon at the top right corner.

3. To wipe all data imported by the listed connectors, select Wipe Data. If you don't select this option after uninstalling the connector server and associated connectors, the data retrieved by the connectors will remain in Ivanti Neurons as orphaned without an active data source. To delete these records at a later date, see the procedure below.

4. Click Delete or Delete all.

If you did not wipe your data during the process of deleting a connector, you may find that records imported by that connector still display in Ivanti Neurons. These records are considered orphaned; they have no active data source but still exist in the system.

If your Ivanti Neurons database contains orphaned records, a yellow banner will display on the Connectors page alerting you to those records. You can click Show me to filter the results down to just those orphaned records. You can then delete that data from the system by clicking the options menu in each row and selecting Wipe Data.