Configure the Marketing Service On-demand Orchestrator

Note: Two orchestrator options are available in MineMarket:

  1. Marketing Service On-demand Orchestrator (described in this activity)
  2. Marketing Service Orchestrator (see Create the Marketing Service Orchestrator)

From MineMarket 5.6, the Marketing Service On-demand Orchestrator is installed (but not enabled) by default with the MineMarket Marketing Service and is recommended for improved efficiency and scalability when processing large volumes of despatch orders.

Use this activity to enable and configure the Marketing Service On-demand Orchestrator. This activity updates the BulkTrak.MarketingService.exe.config file.

The Marketing Service On-demand Orchestrator is a Windows service contained within the MineMarket Marketing Service. The On-Demand Orchestrator can be used instead of the regular MineMarket Marketing Service to distribute the despatch order processing load across multiple Marketing Service Farms.

The Marketing Service On-demand Orchestrator:

  • Automatically creates the Marketing Service Farms on an on-demand basis, based on the number of despatch order states (or 'downstream causes') awaiting processing and the number of despatch orders (or 'transaction batch size') that each Farm can process
  • Dynamically distributes the work of processing despatch order states to the Marketing Service Farms
  • Reports on the total progress of despatch order state processing
  • Reports if a Marketing Service Farm becomes unresponsive

Status and error messages can be displayed:

  • In a server console window if the MineMarket Marketing Service is run in console mode
  • In a billboard run within the MineMarket Client

Activity Steps

  1. On the machine where the MineMarket Marketing Service is installed, navigate to the MineMarket installation folder and double-click AppConfig.exe.

    The Application Configuration Editor opens.

  2. In the Marketing Service On-demand Orchestrator category, update the following details as required:
    • On-demand Orchestrator Endpoint—The connection URL that specifies the communication protocol; the name or IP address of the server on which the Marketing Service On-demand Orchestrator runs; and the TCP port on which the Marketing Service requests downstream causes for processing. Default: tcp://localhost:50051.

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

    • Use On-demand Orchestrator—Select True to enable the Marketing Service On-demand Orchestrator to manage the processing load of the Marketing Service Farms. If False, either the MineMarket Marketing Service or the Marketing Service Orchestrator (if created) is used. Default: False.
    • Maximum Number Of Farms—The maximum number of Marketing Service Farms that the Marketing Service On-demand Orchestrator can run. Default: 5.

      Note: By default, the On-demand Orchestrator creates and runs a minimum of five Marketing Service Farms, even when there are no despatch order states to be processed. The minimum value is hard coded and cannot be edited.

  3. Click OK.

    The Application Configuration Editor closes and updates the BulkTrak.MarketingService.exe.config file.