Collector MSI parameters reference table

Contents

Collector MSI parameters reference table

Mandatory parameters

Option Name Default value Description
DRV_IP - Set the Engine IP or DNS name
DRV_PORT - Set the Engine port number

Optional parameters

Option Name Default value Description
CFG_INSTALL 1 Install the Nxtcfg tool for changing the configuration of the Collector from the command line. 1: install, 0: do not install
CPL_INSTALL 0 Install the Collector Control Panel extension. 1: install, 0: do not install
DRV_ACTIVATE_DMP 0 Specifies whether the target system should be configured for generating memory dumps in case of STOP message (Blue Screen). Its value can be 0 (disabled), 1 (full memory dump), 2 (kernel memory dump) and 3 (memory minidump). The recommended value is 2 (kernel memory dump).
  • This is a non-reversible setting: it will not be rolled back to its initial value after uninstalling Collector 3.
  • The MSI package will not change the system setting for a less verbose memory dump setting (e.g. if current setting is to generate kernel memory dumps and DRV_ACTIVATE_DMP is set to 3 (memory minidump), no action will be performed)
DRV_BFBD 0 Delay in seconds during initialization of the driver before we start sending UDP packets to the Engine. Maximum value: 240 (4 min)
DRV_CRASHGUARD 3 Specifies the maximum Crash Guard count can reach before the Collector driver loading is being cancelled at boot-time. If set to 0, the Crash Guard feature will be disabled
DRV_DESC 0 Delay Engine communication Socket Creation : To avoid having the traffic blocked by certain firewalls, the Collector socket layer is created during the last initialization steps. [1: enable, 0: disable]
DRV_FORCE_LOADING 0 If this property is set to 1, the Collector driver will be loaded after installation without having to wait for a computer restart. It is highly recommended to reboot the machine as many information may not be visible to the Engine if the Collector driver is loaded during installation. If an older Nexthink driver is present on the system, this option will have no effect. : 1: load Collector, 0 : no loading.

Warning: changing the load order of the machines installed on your machine may cause interoperability issues with other installed software. Please have a look at the Collector Release Notes and make appropriate tests before using this option network-wide.

DRV_LOGSIZE 32MB Addition of log rotation when enabling DRV_LOGMODE for the logging [Range for value: 1 -> 512 (Mb)].
DRV_REACTIVATION 96 Reactivate the collector after a given time. The max value is 8766 --1 year.
DRV_TAG 0 Assign to any installer to help you organize and remember the creator of the installation. Possibles values are 0 to 255.
DRV_LOGMODE 0 Specifies the logging mode. Possible values are 0, 1 and 2, meaning Silent, Verbose and Debug, respectively. 2 (Debug) is not recommended.
DRV_FORCE_SERVER 0 Specifies the installation on server. Possible values are 0, 1. If set to 1, the collector will be install on Windows Server.
DRV_DWEF 0 Disables Windows enumerate functionality. Possible values are 0, 1. If set to 1, the Collector does not report any Windows freeze or hung problems.

(This will result in the Finder not displaying any information about "application not responding".)

DRV_CGPI 0 “Crash Guard Protection Interval Value”. It is the time since boot in minutes after which we save the crash guard info to the registry.
DRV_MSS 1472 Maximum size of the UDP packet for transfers between the Collector and the Engine.
DRV_WEB_AND_CLOUD_DATA 1 Gather Web and Cloud information. Default value is 1 to gather and send the data (only if you have purchased the Web and Cloud module). Set to 0 for not recording the web connections of devices.
DRV_WEB_AND_CLOUD_HOSTS - List of comma separated host names for which to send the full URL of each web request. Requires the Web and Cloud module and the parameter DRV_WEB_AND_CLOUD_DATA to be set to 1.
DRV_DSPS 1 Disable SMB print notifications. Starting from version 5.2.8.0, the Collector does not report SMB prints by default. Set the option to 0 to enable SMB print reporting. Set to 1 to disable it.

Windows parameters

Option Name Default value Description
ARPNOREMOVE - Setting the ARPNOREMOVE property disables the Add or Remove Programs functionality in Control Panel that removes the product. For Windows 2000, this disables the Remove button for the product from the Add or Remove Programs in Control Panel. For earlier operating systems, this has the effect of removing the product from the list of installed products on the Add or Remove Programs in Control Panel.
ARPNOREPAIR - Set the ARPNOREPAIR property to disable the Repair button in the Programs Wizard.
ARPSYSTEMCOMPONENT - Setting the ARPSYSTEMCOMPONENT property to 1 using the command line or a transform prevents the application from being displayed in the Add or Remove Programs list of Control Panel.
ARPNOMODIFY 1 Setting the ARPNOMODIFY property disables Add or Remove Programs functionality in Control Panel that modifies the product. For Windows 2000, this disables the Modify button for the product in Add or Remove Programs in Control Panel. On earlier operating systems, clicking the Add or Remove Programs button uninstalls the product rather than entering the maintenance mode wizard.

Note: the Collector MSI package does not support this feature. ARPNOMODIFY must bet set to 1.

REBOOT - The REBOOT property suppresses certain prompts for a restart of the system. An administrator typically uses this property with a series of installations to install several products at the same time with only one restart at the end.

The ForceReboot and ScheduleReboot actions inform the installer to prompt the user to restart the system. The installer can also determine that a restart is necessary whether there are any ForceReboot or ScheduleReboot actions in the sequence. For example, the installer automatically prompts for a restart if it needs to replace any files in use during the installation.

You can suppress certain prompts for restarts by setting the REBOOT property as follows.

REBOOT = Force Always prompt for a restart at the end of the installation. The UI always prompts the user with an option to restart at the end. If there is no user interface, and this is not a multiple-package installation, the system automatically restarts at the end of the installation. If this is a multiple-package installation, there is no automatic restart of the system and the installer returns ERROR_SUCCESS_REBOOT_REQUIRED.

REBOOT = Suppress Suppress prompts for a restart at the end of the installation. The installer still prompts the user with an option to restart during the installation whenever it encounters the ForceReboot action. If there is no user interface, the system automatically restarts at each ForceReboot. Restarts at the end of the installation (for example, caused by an attempt to install a file in use) are suppressed.

REBOOT = ReallySuppress Suppress all restarts and restart prompts initiated by ForceReboot during the installation. Suppress all restarts and restart prompts at the end of the installation. Both the restart prompt and the restart itself are suppressed. For example, restarts at the end of the installation, caused by an attempt to install a file in use, are suppressed.

Note: in unattended execution mode, all choices are silently accepted. For example, if REBOOT=Force, the computer will automatically be rebooted after the MSI package installation.

When using REBOOT=ReallySuppress parameter, most likely, you would be interested in combining it with the Collector DRV_FORCE_LOADING parameter to activate the Collector just after the MSI installation - Collector activation right after installation works only for new installations only, see DRV_FORCE_LOADING above.

The operations described in this article should only be performed by a Nexthink Engineer or a Nexthink Certified Partner.

If you need help or assistance, please contact your Nexthink Certified Partner.