Summary of Changes to the IMS Integration Hub Distribution Manager Interface Config File

Depending on the number of customisations that have been made to configuration files for a specific IMS Integration Hub implementation, consider whether it is more efficient to generate new configuration files with a new installation of IMS Integration Hub, or manually update existing configuration files. Starting with new files from a clean installation is recommended.

Optional Override of gRPC for Adaptors

If you are using AUR or B2MML adaptors with MineMarket 5.5.3 or later, the default communication framework is gRPC. The value of this setting must match the Use Remoting setting used for MineMarket. If False, MineMarket uses gRPC, which is a newer communication technology to communicate between the server and clients. This newer technology is not better or more functional than prior technologies; however, .NET Remoting is no longer actively developed and therefore must be replaced.

If you use .NET Remoting as the communication technology for MineMarket, change the value for the UseRemoting key to True in the appSettings section.

Copy
<add key="UseRemoting" value="True" />

Error Logging

This error logging is for IMS Integration Hub application errors rather than the errors that can be viewed via the Error Log Viewer in the IMS Integration Hub Client.

A different network path and file name can be specified in the following code in the log4net section. The logging level may need to be changed to ERROR or DEBUG for less or more information about errors respectively.

Copy
<log4net>
  <appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">
    <file type="log4net.Util.PatternString" value="DistributionManager.txt" />
    <immediateFlush value="true" />
    <appendToFile value="true" />
    <rollingStyle value="Size" />
    <maxSizeRollBackups value="9" />
    <maximumFileSize value="1MB" />
    <staticLogFileName value="true" />
    <layout type="log4net.Layout.PatternLayout">
    <param name="ConversionPattern" value="%date %-5level %message%newline" />
    </layout>
  </appender>
  <root>
    <level value="INFO" />
    <appender-ref ref="RollingLogFileAppender" />
  </root>
</log4net>

Updates and Upgrades

The following information is for reference purposes.

  • The following keys were added in IMS Integration Hub 2.11. The value of these settings must match the remoting settings used for MineMarket.
    Copy
    <add key="UseRemoting" value="False" />
    <add key="gRPCTracers" value="-all" />
  • The following binding was added in IMS Integration Hub 2.11.
    Copy
    <dependentAssembly>
      <assemblyIdentity name="Microsoft.Practices.ServiceLocation" publicKeyToken="31bf3856ad364e35" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-1.3.0.0" newVersion="1.3.0.0" />
    </dependentAssembly>
  • The version number in the following binding was changed in IMS Integration Hub 2.11.
    Copy
    <dependentAssembly>
      <assemblyIdentity name="System.Threading.Tasks.Extensions" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.2.0.0" newVersion="4.2.0.0" />
    </dependentAssembly>