Summary of Changes to DataService.exe.config

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

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

  • The pagination limit may be changed from the default value.
    Copy
    <add key="ODataPageSize" value="500" />
  • 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" />
  • 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>

Updates and Upgrades

DataService.exe.config changed considerably for MineMarket 5.1. UDP and named pipe endpoints and bindings were replaced with secure TCP endpoints and bindings.

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

To generate a new file:

  1. Rename the existing DataService.exe.config (previously called Data.Services.MineMarket.Hosting.exe.config) file in the MineMarket\Data Services installation folder, so that it can be used for reference purposes.
  2. Run the MineMarket installation package on a separate machine and copy the DataService.exe.config file to the MineMarket\Data Services installation folder.
  3. Configure the MineMarket Data Service as required.

To manually update an existing file from MineMarket 5.4.8:

  1. Update the version number to 4.8 in the following code.
    Copy
    <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
    </startup>
  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>