Summary of Changes to DataMartAgent.exe.config

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

In DataMartAgent.exe.config on the machine where the MineMarket Data Mart Agent is installed:

  • The following connection strings can be updated with the Application Configuration Editor.
    Copy
    <add name="MineMarketServerURL" connectionString="tcp://localhost:8085/ClientManager" />
    <add name="DataMartDataContext" connectionString="Data Source=localhost; Initial Catalog=DataMart; Integrated Security=True;MultipleActiveResultSets=True" providerName="System.Data.SqlClient" />
  • 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" />
      </layout>
    </appender>

Updates and Upgrades

Even for implementations with custom integrations, Datamine does not recommend trying to update this configuration file from MineMarket 5.4.6 or earlier.

To generate a new file:

  1. Rename the existing DataMartAgent.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 DataMartAgent.exe.config file to the MineMarket installation folder.
  3. Configure the MineMarket DataMart Agent as required.

To manually update an existing file from MineMarket 5.4.7 or 5.4.8:

  1. Add the following section in the configSections section.
    Copy
    <section name="unity" type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, Microsoft.Practices.Unity.Configuration" />
  2. Add the following code before the log4net section.
    Copy
    <unity configSource="Data.Mart.Agent.Unity.config" />
  3. 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>
  4. 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>
  5. Update the version number to 4.8 in the following code.
    Copy
    <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
    </startup>