Summary of Changes to DataMartService.exe.config

Important: If changing any port numbers, review the summary of all Default Port Numbers.

In DataMartService.exe.config on the machine where the MineMarket Data Mart Service is installed:

  • The port number in the following code must match the port number in BulkTrak.Server.exe.config and BulkTrak.Service.exe.config on the Application Server.

    The server name can be updated with the Application Configuration Editor.

    Copy
    <endpoint address="net.tcp://localhost:17040" binding="netTcpBinding" bindingConfiguration="TCPForServiceStatusNotification" contract="IMS.ServiceInstrumentation.WCF.ServiceContracts.IServiceStatusListener" />
  • A different path and file name can be specified in the following code in the log4net section. The logging level can be changed to DEBUG or ERROR. The DEBUG logging level should only be used while investigating errors.
    Copy
    <appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">
      <file type="log4net.Util.PatternString" value="%property{DefaultLogName}" />
      <threshold value="INFO" />
      <preserveLogFileNameExtension value="true" />
      <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 - %message%newline" />
      </layout></appender><appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
      <threshold value="INFO" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%date - %message%newline" />

Updates and Upgrades

DataMartService.exe.config changed considerably for MineMarket 5.1.0 UDP and named pipe endpoints and bindings were replaced with secure TCP endpoints and bindings. Unsecured MSMQ bindings were replaced with secure bindings.

Even for implementations with custom integrations, new configuration files must be used. Datamine does not recommend trying to update this configuration file from MineMarket 5.4.4 or earlier.

If updating from MineMarket 5.4.5 or earlier, a connection string has been added to facilitate automatic upgrading of the Data Mart database. The connection string can be updated with the Application Configuration Editor.

Copy 
<connectionStrings>
  <add name="DataMartDataContext" connectionString="Data Source=localhost; Initial Catalog=DataMart; Integrated Security=True" providerName="System.Data.SqlClient" />
</connectionStrings>

To generate a new file:

  1. Rename the existing DataMartService.exe.config file in the MineMarket installation folder, so that it can be used for reference purposes.
  2. Run the MineMarket installation package on a separate machine and copy the DataMartService.exe.config file to the MineMarket installation folder.
  3. Configure the MineMarket Data Mart Service as required.

To manually update an existing file from MineMarket 5.4.5 – 5.4.8:

  1. Add the following connection string to facilitate automatic upgrading of the Data Mart database. The connection string can be updated with the Application Configuration Editor.
    Copy
    <connectionStrings>
      <add name="DataMartDataContext" connectionString="Data Source=localhost; Initial Catalog=DataMart; Integrated Security=True" providerName="System.Data.SqlClient" />
    </connectionStrings>
  2. Edit the version number in the following dependent assembly in the runtime section.
    Copy
    <dependentAssembly>
      <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />
    </dependentAssembly>
  3. Add the following dependent assemblies in the runtime section.
    Copy
    <dependentAssembly>
      <assemblyIdentity name="System.Diagnostics.DiagnosticSource" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.0.5.0" newVersion="4.0.5.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="Microsoft.Bcl.AsyncInterfaces" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Threading.Tasks.Extensions" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.2.0.1" newVersion="4.2.0.1" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Text.Json" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-5.0.0.2" newVersion="5.0.0.2" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="Microsoft.Graph.Core" publicKeyToken="31bf3856ad364e35" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-1.25.1.0" newVersion="1.25.1.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="Microsoft.Identity.Client" publicKeyToken="0a613f4dd989e8ae" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.29.0.0" newVersion="4.29.0.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.0.1.1" newVersion="4.0.1.1" />
    </dependentAssembly>
  4. Update the version number to 4.8 in the following code.
    Copy
    <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
    </startup>