Product(s): Transaction Manager, Integration Service
With the introduction of the Advanced Integration Service (V2), you can now configure a single machine (known as the Scheduler Machine) to perform the processes. This will allow any other machine to fully utilize the Transaction Manager system without requiring the service to be installed on that machine
This configuration also allows Transaction Manager to run the Scheduler system to automatically Import/Export your Transactions.
Required Prerequisites
Local Admin
You will be required to provide a Local Admin account in order for the Integration Service to operate successfully.
IMPORTANT: A Local Administrator account is required to receive full Technical Support. Click the blue buttons for the associated articles, below, for details.
Enabling Terminal Mode
Even if your system is not a Terminal Environment, you will need to enable the Terminal Server mode flag by within the XML configuration for the TmoIntegrationService config file in order to allow multiple machines to connect to it.
Configuring the Flag
The flag within the TmoIntegrationServices.exe.config will be read upon starting of the Integration Service. As such, TrueCommerce will need to enable this manually for the service to be configured to allow multiple connections to it.
Stop (Recommended): The Integration Service
Navigate: C:\Program Files (x86)\True Commerce\TmoIntegrationServiceV2
Open: TmoIntegrationServices.exe.config
Locate: The "TerminalServer" key under the <configuration>
Set: value to True
NOTE: If the flag does not exist, you can add it under the <configuration> group
<add key="TerminalServer" value="True" />
IMPORTANT: Failure to configure the XML under the Local Admin account often results in this setting not properly saving and the TmoIntegrationService under Terminal Mode will fail to launch.
Restart the Integration Service
You will need to restart the Integration Service after modifying the config in order for the Integration Service to reconfigure itself into Terminal Mode.
Confirming Terminal Mode Enabled
To confirm that Terminal Mode properly was enabled and was not blocked by your environment, you can check your Event Viewer for the Event ID 102, which will state Terminal Mode. Otherwise, if it states Workstation, then Terminal Mode is not properly enabled.
Terminal Server Mode Enabled
Terminal Mode is not properly enabled
The most common reason for Terminal Mode not being enabled is due to not modifying the config under the Local Admin account.
Enabling Scheduler Support
Once the Integration Service is configured into Terminal Mode, you will need to enable remote connections from external machines by checking the Enable Scheduler Support option.
Locate: The TrueCommerce tray icon
Right-Click: Enable Scheduler Support
IMPORTANT: If you attempt to check the Enable box but it does not check, your permissions are blocking it and you are not under a Local Admin.
Configuring Workstations
For any Client Workstation that you wish to leverage the Scheduler Machine in order to have it (rather than the client machine itself) perform integrated actions (Import/Export/Sync), you need to copy the Service ID from the Scheduler Machine and have the Client paste it into Transaction Manager under the Integration Settings.
Copying the Service ID
To copy the Service ID, locate the TrueCommerce tray icon and double-click it to launch the info dialogue, then select the Copy icon located next to the Service ID.
Locate: TrueCommerce system tray icon
Double-Click: TrueCommerce icon
Select: The Copy icon (Paper with blue arrow)
Setting the Service ID
With the Service ID copied into your clipboard, you will need to launch Transaction Manager and set your Service ID under the Option 2 selection for every Foundry user who wishes to utilize this machine for its integration activity.
Navigate: Transaction Manager → Integration Settings
Select: Option 2
Paste: Service ID
NOTE: Every user (regardless of machine) who has the same Service ID as the "Scheduler machine" will now route its Integration Activity through the Scheduler machine and will not require installation of the Integration Service itself.
Additional Resources
rev. 12/18/2024