Attachments

advanced/Collector Reference Guide

1. NEXThink Collector MSI Parameters Reference

1.1. Mandatory Parameters

These following two parameters are mandatory and must be set when installing the NEXThink Collector MSI. If they are missing, the NEXThink Collector installation will fail.

Option Name

Default value

Description

DRV_IP

-

Set to the Engine IP address or DNS name

DRV_PORT

-

Set to the Engine port number

1.2. Optional Parameters

Non-mandatory options with their default value and description

Option Name

Default Value

Description and possible values

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_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_CRASHGUARD

3

Specifies the maximum Crash Guard count can reach before Collector driver loading is being canceled at boot-time. If set to 0, the Crash Guard feature will be disabled

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 will not report any windows freeze and hung problem.
(This will result in Finder not displaying any information about "application not responding".)

1.3. 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.

Note: 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