The Platform Installer is recommended for use on development machines only. This is because:
- The Platform Installer requires internet access which may not be available in a production environment.
- The Platform Installer
setup.will fail on Windows servers that have IE Enhanced Security Configuration enabled.
For testing and production environments it is recommended to:
- Use the NServiceBus PowerShell Module to install any required prerequisites.
- Download and run the individual installers from downloads rather than installing via the Platform Installer.
The Platform Installer is a Microsoft Click-Once application, which means it has a built-in self-updating mechanism. Click-Once applications are sometimes blocked by corporate firewalls or software restriction policies. If the Platform Installer fails, review the offline install page for installation instructions.
setup. will install .NET 4.5.2 if required and will then bootstrap the Platform Installer application.
Before proceeding with product selection, the Platform Installer will prompt to accept the NServiceBus license agreement.
The Platform Installer requires internet access to download individual packages. If non-Windows integrated proxy authentication is required, a credentials dialog will be shown.
This dialog offers to save credentials for future use. If the Save Credentials option is chosen, the credentials will be encrypted and stored in the registry at
HKEY_CURRENT_USER\ for use in subsequent launches of the Platform Installer.
The Platform Installer will prompt for the items to install. Individual components can be selected for installation or upgrade. If the latest version of a product is installed, no checkbox will be displayed for that item as there is no installation or upgrade action required. Similarly if the Platform Installer cannot communicate with the version information feed, it will also disable product selection.
This installation runs the appropriate Deployment Image Servicing and Management (DISM.exe) command line to install the required Windows Features for Message Queuing (MSMQ). The installation will also check to ensure that any unsupported MSMQ Windows Features are not installed. This installation is required only if MSMQ is going to be used as the message transport. The other supported message transports are detailed in the transports documentation.
This installation configures Microsoft Distributed Transaction Coordinator (DTC) for usage by NServiceBus. The configuration sets the following registry values in
- Enable Network DTC Access.
NetworkDtcAccessis set to
- Allow Outbound transactions:
NetworkDtcAccessOutboundis set to
NetworkDtcAccessTransactionsis set to
XaTransactionsis set to
This install is optional.
Installs the ServiceInsight application. This MSI can be downloaded directly from the ServiceInsight releases page.
Installs the ServicePulse application. This MSI can be downloaded directly from the ServicePulse releases page.
Installs the ServiceControl application. This MSI can be downloaded directly from the ServiceControl releases page.
The Platform Installer caches the downloaded MSI files in
%temp%\. These files are downloaded directly from GitHub. Some corporate firewalls prevent the downloading of executable files via content filters or by blocking specific web sites. If the Platform Installer cannot download the individual applications, consult with the network administration staff.
The Platform Installer logs activity in
%appdata%\. The current log file will be named according to the current date. For example, a log created on January 25, 2018 would result in the filename
The command line options used for the MSI installations ensure that a detailed log file is produced for each installation. These files are located alongside the Platform Installer logs in
An installation or upgrade of a product will overwrite any existing MSI log for that product.
MSI installers provide detailed error information via error codes. MSI error messages can assist in troubleshooting installation issues.
As previously mentioned, Click-Once can be problematic in some environments or circumstances. The following links provide some tips on troubleshooting issues with Click-Once.
An error occurred trying to download 'https://s3.amazonaws.com/particular.downloads/PlatformInstaller/PlatformInstaller.application'. See the setup log file located at 'C:\Users\ADMINI~1\AppData\Local\Temp\VSD9C86.tmp\install.log' for more information.
Log file content:
URLDownloadToCacheFile failed with HRESULT '-2146697208' Error: An error occurred trying to download 'https://s3.amazonaws.com/particular.downloads/PlatformInstaller/PlatformInstaller.application'.
Resolve this by (temporarily) disabling IE Enhanced Security.