Enabling Cross-Engine Finder features
Overview
Starting from V6.19, the Cross-Engine Finder features let you target multiple Engines at the same time or, in some use cases, target an Engine that is different from the one to which the Finder is connected.
The Cross-Engine features impact the following Finder areas:
Investigations
User view
Device view
Service view
Search
Auto-complete
Because the Cross-Engine features for search and auto-complete are especially demanding in terms of connectivity and system load, they can be enabled separately.
Prerequisites
The connectivity between Nexthink components and the total number of devices determine the Cross-Engine features that can be enabled in your setup. Find below the configurations and values required to enable each level of the Cross-Engine features:
The Portal and the Engines are located in the same data center or have equivalent connectivity.
There is a good connectivity between Finder and Portal to enable:
Basic features
A bandwidth of 10 Mbps between Finder and Portal allows for the basic Cross-Engine features to be enabled (investigations, device view, user view, and service view across multiple Engines).
Search
A bandwidth of 50 Mbps or higher between Finder and Portal allows for the intermediate set of Cross-Engine features to be enabled (the basic features plus the search).
Auto-complete
A bandwidth of 100 Mbps or higher between Finder and Portal,
where the total number of devices is below 50 K, allows for the full set of Cross-Engine features to be enabled (the basic features plus the search and the auto-complete).
where the total number of devices is above 50 K, contact Nexthink Support.
Keep the Cross-Engine features disabled if the prerequisites are not met.
Enabling the Cross-Engine Finder features from the Web Console
To enable the Cross-Engine Finder features:
Log in to the Web Console of the primary Appliance as administrator.
Click the FINDER tab at the top of the window.
In the General section, tick one of the following options under Cross-Engine Finder:
Disabled: To disable all Cross-Engine features. This is the default option.
Enable investigations, device view, user view and service view across multiple Engines: To enable the targeting of multiple Engines when executing investigations or when analyzing the user and service views, as well as the ability to see the device view of devices that reside in another Engine.
Enable investigations, device view, user view, service view and search across multiple Engines: To enable the search over all Engines in addition to the basic Cross-Engine features already present in the previous option.
Enable investigations, device view, user view, service view, search and auto-complete across multiple Engines: To enable word completion from every Engine in addition to the search and the basic Cross-Engine features already present in the previous option. Limit the data retrieved for word completion with the additional settings of this option.
Click SAVE to permanently store your choice. The Portal is restarted if you modified the setting.
Limiting auto-complete data
The Finder uses auto-complete data to give you smarter search results and let you write your investigations faster and with higher confidence. However, loading too much auto-complete data may have an impact in the responsiveness of the Finder, specially during logon.
To keep the amount of retrieved auto-complete data under control, adapt the following settings when you activate the full set of Cross-Engine features:
While auto-complete data is always retrieved for all users and devices, filter the auto-complete data retrieved for other objects by most recently seen:
Domains seen in the last (number of days)
Other objects seen in the last (number of days)
Adjust the number of days for domains and other objects:
Increase the value to get more auto-complete data.
Decrease the value if you notice a negative impact of auto-complete data in the responsiveness of the Finder.
Individually disabling the Cross-Engine Finder features
Even when the Cross-Engine features are globally enabled in the Web Console, you may want to individually disable these features on some specific computers that run the Finder.
Disabling the Cross-Engine features can improve the performance of the Finder in environments with limited network bandwidth for users that do not need multi-Engine data, either because they usually work exclusively with one Engine or because their view is restricted to one Engine only.
To disable the Cross-Engine features for a single user, modify a value in the registry:
On the computer where the Finder is installed, press Win+R to open the Run box.
Type in regedit and press Enter to launch the Registry Editor.
Browse the Windows registry in the Registry Editor and select the key HKEY_CURRENT_USER\Software\Nexthink.
If the value CrossEngineDisabled does not exist in the key:
Right-click the area on the right-hand side of the Registry Editor that holds the list of values for the key.
Select New -> DWORD (32-bit) Value from the context menu.
Type in CrossEngineDisabled as the name of the value.
Right-click the value with the name CrossEngineDisabled to change its data.
Select Modify... in the context menu. The dialog to edit the value shows up.
Set the value of the field Value data to 1 in the dialog.
Click OK.
Setting the maximum number of Cross-Engine investigation results in the Finder
When the Cross-Engine features are enabled in the Finder, the List (all entities) view lets you examine the results of an investigation over all available Engines. Because the Finder receives answers from multiple Engines, which are gathered by the Portal, the potential number of results are higher than those of a single Engine. By default, the List (all entities) view displays a maximum number of 10 000 results.
To modify the maximum number of results displayed in the List (all entities) view of the Finder:
Log in to the CLI of the primary Appliance.
Optional: If the Portal has no explicit configuration file, that is, if portal.conf does not exist in folder /var/nexthink/portal/conf, create it by copying the defaults from the sample configuration file:
sudo -u nxportal cp /var/nexthink/portal/conf/portal.conf.sample \
/var/nexthink/portal/conf/portal.conf
Edit the configuration file of the Portal :
sudo vi /var/nexthink/portal/conf/portal.conf
Add the following line at the end of the configuration file. Change the default value of 10 000 results to the desired value:
globalconfig.portal.finder-selector.max-rows = 10000
Save your changes and exit the
vi
editor::wq
Restart the Portal for the new limit to apply:
sudo systemctl restart nxportal
Individually modifying the maximum number of Cross-Engine results in the Finder
Besides the global configuration, each Finder user may individually set the maximum number of Cross-Engine results displayed in the List (all entities) view.
To change the maximum number of Cross-Engine results in the List (all entities) view for a single user, modify a value in the registry:
On the computer where the Finder is installed, press Win+R to open the Run box.
Type in regedit and press Enter to launch the Registry Editor.
Browse the Windows registry in the Registry Editor and select the key HKEY_CURRENT_USER\Software\Nexthink.
If the value CrossEngineMaxResults does not exist in the key:
Right-click the area on the right-hand side of the Registry Editor that holds the list of values for the key.
Select New -> DWORD (32-bit) Value from the context menu.
Type in CrossEngineMaxResults as the name of the value.
Right-click the value with the name CrossEngineMaxResults to change its data.
Select Modify... in the context menu. The dialog to edit the value shows up.
Set the value of the field Value data to the number of maximum desired results.
Click OK.
RELATED TASK
Last updated