Note: for Software Distribution, see this article.

JetPatch can automatically discover installed software and find out whether they are deployed, running, and whats their configuration.  This feature is available for either patch or agent management environments. There are two aspects in Tools Discovery:

• Collect data on connected endpoints
• Upload Discovery File to view env. status 

Collect Software and Applications data on connected endpoints

You can discover data on installed software and applications running in your environment. The data discovered is in JSON format and includes the agent Name, OS family, and agent version. In order to collect and download the data please follow the next steps: 

STEP 1: Enabling the suggested discovery JSON (enabled by default in 4.2.5+)

1. SSH JetPatch Application Server
2. Stop Tomcat (service tomcat stop)
3. vi /usr/share/tomcat/default/conf/intigua.properties
4. Add the following settings:

# Enable / Disable data collection
ep.data.collection.enabled=true

5. Save and Exit 

6. Restart tomcat (run command service tomcat restart) 

STEP 2: Download Suggested Discovery file

1. After enabling the above, please wait at least 20 minutes, then log in to JetPatch platform
2. Go to Agents & Tools > Tools Catalog
3. Click on the Tools Discovery button > 'Download suggested discovery file'. 

Note: the suggested discovery file will download all Linux Package Names and all Windows Upgrade Codes that are installed on the connected endpoints

Creating and uploading the discovery JSON

JetAgent can also discover agents based on agent configurations and parameters. In order to do so, a JSON file with specific properties is needed. Follow the next steps to discover installed software using a discovery file:

STEP 1: Create a JSON discovery File

The JSON file should include the following fields: 

1. “name” (mandatory) - The name of the software.
2. “searchBy” (mandatory) - has to include at least one “searchBy” parameters:
   • packageName (valid for Linux) - searching for DEB/RPM packages installed with the same name
   • upgradeCode (valid for Windows) 
     • "SOFTWARE\\\\Microsoft\\\\Windows\\\\CurrentVersion\\\\Installer\\\\UpgradeCodes" - for example
   • productID (valid for Windows) - we are searching equivalent names in keys under:
     • "SOFTWARE\\\\Microsoft\\\\Windows\\\\CurrentVersion\\\\Installer\\\\UserData\\\\S-1-5-18\\\\Products"
     • "SOFTWARE\\\\Microsoft\\\\Windows\\\\CurrentVersion\\\\Uninstall"
     • "SOFTWARE\\\\Wow6432Node\\\\Microsoft\\\\Windows\\\\CurrentVersion\\\\Uninstall"
   • services (valid for Windows and Linux) - list of services.
   • registry (valid for Windows) - list of registries key
3. “configParams” (optional) - the user can configure it to extract the software configuration. This field should include:
   1. “name” (mandatory if configParams is exist) - The name of the requested configuration
   2. “type” (mandatory if configParams is exist) The type of the parameter (Need to check which types is valid here)
   3. “fromFile” (mandatory if “fromRegistry” is missing) -
      1. “filename” - the file name to extract the configuration
      2. “linePrefix” - the prefix of the line to extract the configuration value from. (we will extract all the string after the prefix provided)
   4. “fromRegistry” (mandatory if “fromFile” is missing) -
      1. “key”
      2. “value”

Please find the 'fully_discovery.json' file below for more references. The Discovery file includes the following agents and applications discovery: VMTools, Chrome, Adobe Acrobat Reader, Mcafee-agent, SCCM, fireeye, SCOM, Qualys, Loginsight, Zabbix and IEM. 

STEP 2: Upload JSON to JetAgent Portal 

1. Go to Agents & Tools > Tools Catalog
2. Click on the Tools Discovery button > 'Upload discovery file'. 

Note: each upload will override the previous discovery file.  In order to clear the results, please upload an empty JSON file and wait for the ep.data.collection.full-scan-delay-hours property sync (default 168 hours).  You can set ep.data.collection.full-scan-delay-hours to 1 hour temporarily to clear the file faster (note: in JetPatch 4.2.8 an empty JSON file alone will clear results).

Environment load changes

After the JSON discovery file is uploaded, the data should appear in system in several places (please wait at least ten minutes)

1. New Applications and Tools should appear in Tools Catalog with an 'unmanaged icon'. Drill down to see how many servers in your environment are running unmanaged tools. 

Note: unmanaged tools from JSON must be present on at least one endpoint for it to show up on tools catalog 

2. Data on specific servers appears in Servers tab.

• Log in to JetPatch server
• Go to Servers tab > Table Settings 
• Select the 'unmanaged' columns  
• You will now be able to see the servers which are running the software agents you have selected in step 3. 
• Hover on the Tool icon to view the discovery date & time.  
• To collect more statistics you can generate a CSV report. 

Additional Properties 

# Define max iteration if collect fails
ep.data.collection.failed.iterations.max=10
ep.data.collection.tasks-limit=100
ep.data.collection.run-failed-after-mins=30
ep.data.collection.enable-periodical-full-scan=true
ep.data.collection.full-scan-delay-hours=168