BES Client MSI Editing Tool

You can use the latest version of the BESClientSetupMSI.exe tool to operate on the BigFix Client MSI package (BigFixAgent.msi) as follows:

  • Store an updated masthead in the MSI package, enabling the BigFix Client to start up using the latest configuration parameters of the BigFix deployment.
  • Store the BigFix Relay information in the MSI package, leading the BigFix Client to connect to that Relay at first start. If the Relay is an authenticating Relay, it is also possible to specify the password that the BigFix Client will have to use for the Manual key exchange.
  • Verify whether or not the masthead and the manual key exchange password stored in the MSI package match the specified values.
BES Client MSI Editing Tool usage for storing values:
BESClientSetupMSI.exe [ /relayserver1 <relay URL> [ /secureregistration <password> ] ] <masthead file path> <client installer path> [ /silent ]
BES Client MSI Editing Tool usage for verifying values:
BESClientSetupMSI.exe /verify [ /secureregistration <password> ] <masthead file path> <client installer path> [ /silent ]
where:
  • /relayserver1 <relay URL> is an optional argument that allows storing the information about the BigFix Relay to which the BigFix Client will have to connect to at first start. If this argument is not specified, the BigFix Client will attempt connection to the BigFix Server as specified in the masthead.
  • /secureregistration <password> is an optional argument that allows storing or verifying the password for the manual key exchange in case the specified BigFix Relay is an authenticating Relay.
  • <masthead file path> is a required argument that specifies the absolute or relative path of the masthead file to be stored or verified in the MSI package.
  • <client installer path> is a required argument that specifies the absolute or relative path of the MSI package to be updated or verified.
  • /silent is an optional argument that prevents the command result window from being displayed. When this argument is used, it is still possible to know whether the command completed successfully or not by looking at its exit code.
  • /verify is an alternate required argument that allows verifying whether or not the masthead and the manual key exchange password stored in the MSI package match the specified values.
Note: If you want to store the latest masthead file, you can point to the ActionSite.afxm file located under the C:\Program Files (x86)\BigFix Enterprise\BES Client folder on the BigFix Server system.

The BES Client MSI Editing Tool returns:

  • Zero if the MSI package was updated or verified successfully.
  • A non-zero exit code in case of failure.

Examples:

Displays usage information:

BESClientSetupMSI.exe

Stores a masthead in the MSI package in case both are located in the same directory as BESClientSetupMSI.exe:

BESClientSetupMSI.exe masthead.afxm BigFixAgent.msi

Same as above, but without displaying a success or failure message:

BESClientSetupMSI.exe masthead.afxm BigFixAgent.msi /silent

Stores the specified masthead and BigFix Relay in the specified MSI package:

BESClientSetupMSI.exe /relayserver1 http://relay_host_or_IP:52311/bfmirror/downloads/ <path>\masthead.afxm <path>\BigFixAgent.msi

Stores the specified masthead, BigFix Relay and manual key exchange password in the specified MSI package:

BESClientSetupMSI.exe /relayserver1 http://relay_host_or_IP:52311/bfmirror/downloads/ /secureregistration password <path>\masthead.afxm <path>\BigFixAgent.msi

Verifies whether or not the masthead stored in the MSI package matches the specified one:

BESClientSetupMSI.exe /verify <path>\masthead.afxm <path>\BigFixAgent.msi

Verifies whether or not the manual key exchange password stored in the specified MSI package is equal to "mYp@ssw0rd":

BESClientSetupMSI.exe /verify /secureregistration mYp@ssw0rd <path>\masthead.afxm <path>\BigFixAgent.msi