Summary of Changes to the MineMarket Data Mart Agent Config File

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 INFO. 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="ERROR" />
      <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="ERROR" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%date - %message%newline" />
      </layout>
    </appender>
    <appender name="EventLogAppender" type="log4net.Appender.EventLogAppender">
      <threshold value="ERROR" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%message" />
      </layout>
    </appender>

Updates and Upgrades

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. See Configure the MineMarket Information Services.

Note: Even for implementations with custom integrations, Datamine does not recommend trying to update configuration files from MineMarket 5.5.0 or earlier. The following changes are cumulative.

To manually update an existing file from MineMarket 5.5.1:

  1. Edit the binding redirects of the following dependent assemblies in the runtime section.
    Copy
    <dependentAssembly>
      <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.0.4.1" newVersion="4.0.4.1" />
    </dependentAssembly>
    <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>
  2. Add the following dependent assembly in the runtime section.
    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>

To manually update an existing file from MineMarket 5.5.2:

  1. Add the following keys in the appSettings section.
    Copy
    <add key="UseRemoting" value="False" />
    <add key="gRPCTracers" value="-all" />
  2. Add the following dependent assemblies in the runtime section.
    Copy
    <dependentAssembly>
      <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Numerics.Vectors" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.1.3.0" newVersion="4.1.3.0" />
    </dependentAssembly>

To manually update an existing file from MineMarket 5.5.3 Patch 1:

  1. Add the following keys in the appSettings section.
    Copy
    <add key="UseSSL" value="True" />
    <add key="SSLTargetNameOverride" value="" />
    <add key="Keystore" value=".\keystore" />