Changing WinCollect configuration from the command prompt

You can change the configuration of a WinCollect agent from the command prompt of the Windows host.

After the initial installation of a WinCollect agent on a Windows host, you can change the configuration by using the installhelper.exe file that is located in the <WinCollect_installation_path>/bin.

The following configuration parameters can be modified:
Table 1. Modifiable configuration parameters
Parameter Description
Authentication Token Authorizes the WinCollect service, for example, AUTH_TOKEN=af111ff6-4f30-11eb-11fb-1fc1 17711111
Password Update a password in the AgentConfig.xml configuration file. Specify the Login.Handle and new password, separated by a colon.

For example, 1:MyNewPassword.
Update password with file Update a set of passwords in the AgentConfig.xml configuration file, by using an external file. Specify the Login.Handle and new password, separated by a colon, one per line.

For example, 1:MyNewPassword.
Local IP Use this setting to select the IP address that is displayed for all log sources on systems with multiple network interface cards (NIC).
Originating Computer Use this setting to select the IP address that is displayed only for Windows events on systems with multiple NICs.
Version Update the AgentConfig.xml version number.
The installHelper.exe file has the following update flags:
Table 2. InstallHelper update flags
   
-h [--help] Provides detailed information on the installHelper.exe usage options.
-P [ --update-password ]

Update a password in the AgentConfig.xml configuration file. Specify the Login.Handle and new password, colon separated.

For example, 1:MyNewPassword.

Note: The password is in plain text.
-F [ --update-password-with-file ]

Update a set of passwords in the AgentConfig.xml configuration file by using an external file. Specify the Login.Handle and new password, separated by a colon, one per line.

For example, 1:MyNewPassword.

Note: Make sure you erase the input file or keep it secured.
-T [ --update-auth-token ] The new authentication token to be used to communicate with the configuration server.
-L [localIP] Use this setting to select the IP address that is displayed for all log sources on systems with multiple network interface cards (NIC).

For example, installerhelper.exe -L 192.0.2.0
-O [OrigComputer] Use this setting to select the IP address that is displayed for Windows events on systems with multiple NICs.

For example, installerhelper.exe -O 198.51.100.0
Note: Changing LocalIP also changes the OriginatingComputer value in the WinCollect syslog header, but does not change the Log Source Identifier. If you do not change the value of the LocalIP, but add another value in for the OriginatingComputer, it overrides the LocalIP value after the agent restarts.
For example, to change an authorization token for a WinCollect agent, type the following command in the command prompt of the Windows host:
<WinCollect_installation_path>/bin/installHelper.exe -T <authorization_token>