Create the Marketing Service Orchestrator

Note: Two orchestrator options are available in MineMarket:

Marketing Service Orchestrator (described in this activity)
Marketing Service On-demand Orchestrator (see Configure the Marketing Service On-demand Orchestrator)

Datamine recommends using the on-demand orchestrator for improved efficiency and scalability when processing large volumes of despatch orders.

Use this activity to create the Marketing Service Orchestrator.

The Marketing Service Orchestrator is a single Windows Service that is used instead of the regular MineMarket Marketing Service. The Marketing Service Orchestrator:

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 Marketing Service Orchestrator is run in console mode
In a billboard run within the MineMarket Client

Activity Steps

Start Windows Command Prompt.
Enter the following script, but substitute MineMarketMarketingServiceOrchestrator with the name of the Marketing Service Orchestrator.
Copy
```
sc create MineMarketMarketingServiceOrchestrator binPath= "MineMarketPath\BulkTrak.MarketingService.exe /M=3" DisplayName= DatamineMineMarketMarketingServiceOrchestrator start= demand
```
Where:
- sc create—Uses the service configuration utility to create a new Windows Service.
- MineMarketMarketingServiceOrchestrator—Name of the MineMarket Marketing Service Orchestrator. To include spaces in the service name, enclose the service name in double quotation marks.
- binPath= "MineMarketPath\BulkTrak.MarketingService.exe /M=3"—Location of the executable file for the MineMarket Marketing Service Orchestrator. This is passed into the script as a string. The number after /M= must be the number of Marketing Service Farms that will be created.
- DisplayName= DatamineMineMarketMarketingServiceOrchestrator—Display name of the MineMarket Marketing Service Orchestrator that appears within the Windows Service list. To include spaces in the display name, enclose the display name in double quotation marks.
- Start= demand—Enables manual control of when the MineMarket Marketing Service Orchestrator starts.
  Important: There must be a space after each equal sign (=) in the command.
  Example: DisplayName= "Datamine MineMarket 5.6 Marketing Service Orchestrator"
  For further information about the SC command, refer to https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/sc-create.
Press the Enter key.
The new Marketing Service Orchestrator is created as a Windows Service.
Important: If using the Marketing Service Orchestrator, do not start the regular MineMarket Marketing Service.
Additional configuration for the Marketing Service Orchestrator is via the Application Configuration Editor. See Edit the MineMarket Application Configuration.