• Products
  • Get started
  • Documentation
  • Resources

Configure Insight Discovery agents

How to configure Insight Discovery agents

Now that you have Insight Discovery agents installed on your system, you must enable Insight Discovery as a service to collect the data from the agents.

  1. Install Insight Discovery as a service. For more information, see this page.

  2. Configure Insight Discovery as a service. In the Optional Agent Settings, you must configure the following information:

    1. Agent Scan Interval - the interval, in minutes, before the Insight Discovery service checks with Insight Discovery Agents for new data. When the interval is reached, the service will perform a self restart to release the allocated memory that can not release during the service process is running. It will not affect a running scan, the restart will only executed when there is a free time slot between the configured scan settings. When it is configured to 0 the function is disabled.

    2. Agent IP Range - Here you can define the IP Range(s) that will be checked for available Discovery-Agents. Like the IP-Range at the Common-Setting you can define multiple Ranges.

    3. Agent TCP Port - The TCP Port of the available Agents in the configured IP Range.

    4. Agent Timeout - the default timeout for each connection to a remote agent. The default period is 3 seconds.

    5. Trigger Agents to Scan - select to immediately trigger all available agents at the configured range to start a local scan.

    6. Agent File-Transfer List - Select to configure files that will be synchronised with all available agents at the configured range. For example you can transfer pattern files from discovery/pattern/myCustomPattern.pat to agent/pattern/myCustomPattern.pat. This will also work if you made changes to your "source" files. You also can synchronize Agent-Configurations (Agents.cfg), by copying an Agent.cfg file to your main Discovery folder and choose it for synchronising.

How to edit advanced settings

Although it is possible to manually edit the settings for Insight Discovery agents, this is not recommended. If it is required, you can manually edit the following settings in the agent.cfg file.

 Setting

Configuration options

ScanLogLevel

With the "Normal"-Setting the Log file will only contain basic information's.

With the "Extended"-Setting the Log file will contain every information about the discovery scan.

With the "Debug"-Setting the Log file will contain very much Information that can help for support you by a Problem.

AgentPort

The default listener port is 51337, if you change that port you must also change the agent port in the Discovery-Tool configuration file (Discovery.cfg)

JustUseFirstIP

Default is "false" and the Agent will listen on any active network interface of the system.

If you set it to "true" the Agent will only listen on the first network interface.

DeleteLogsAfter

Here you can set the days after the logfiles will be deleted, default is 7 days.

DisableTCPListener

If you set it to "true" the Agent will not start the TCP-Listener,

it is useful when you use the direct copy option.

DirectCopyPath

If you want it is possible that the Agent directly copy the scan result files to another system (i.e. the Jira/Insight-System). You must use a full UNC-Path like "\\myserver\import\schemaname"

If these options are configured the Agent will transfer the result data as .xml file to the configured target path.

ScanInterval

Set the interval of performed scans in hours. Default is 24 hours.

How to force agents to transfer data to a target path

If you want to transfer the result data as an XML file to the configured target path you can add a SFTP transfer setting.

Add the following code to the agents.cfg file, inside of the <Settings> node:

1 2 3 4 5 6 7 <SFTPSettings> <ExportPath>192.168.2.2/discovery/import</ExportPath> <UserName>yourUser</UserName> <Password>mysecurepassword</Password> <TransferReties>5</TransferReties> <TranserRetryInterval>30</TranserRetryInterval> </SFTPSettings>

or use "Discovery_Agent.exe -setupsftp" (this will execute a small console configuration for the sftp transfer)

Please notice that the password will be encrypted during the first startup.

Last modified on Oct 10, 2021
Cached at 1:42 AM on Oct 16, 2021 |

Additional Help