Transaction Manager - Integration Service: Terminal Servers Configuration
Micah A. Parker avatar
Written by Micah A. Parker
Updated over a week ago

Product: Transaction Manager & Integration Service


Terminal Environments, including that of Application Virtualization (App Servers) and Citrix Environments are environments that are hosted remotely allowing multiple users to remote into the machine which then perform an instancing or creation of a virtual copy of the Terminal Server specifically for each user that logs in.

This environments allow multiple users to be logged into the same machine virtually without affecting the other by having their own copy of the system to be interacted with until logging off.


Disclaimer


TrueCommerce does not officially support Terminal Servers - as such any configuration of such a server will have limited TrueCommerce support available. Our team will assist in ensuring that the proper recommendations have been followed, but will be unable to provide further troubleshooting into your Terminal Environment.

TrueCommerce does not retain technical resources that have the required in-depth knowledge of environmental systems pertaining to complex setups such as Terminal Environments

Citrix Environments

Due to the nature of Citrix Environments TrueCommerce imposes additional limitations into support for these servers as it is beyond the scope of the support services provided by TrueCommerce due to limited resources available who have knowledge of this complex environments.

If you're considering configuring a Citrix Environment you will want to consider supportability from the TrueCommerce team - as environmental issues that cannot be replicated within a TrueCommerce setup will be beyond the support of TrueCommerce.

Application Servers / Application Virtualization

Similar to Citrix Environments, any Application Virtualization in which a user continues to use their regular Desktop/Workstation but launches virtual apps that are spun up via a Server and ran on the client's workstation are not supported.

These environments have a complexity beyond what TrueCommerce supports and will be treated as such.

Alternative Recommendation


If your server falls under one of the listed restrictions/limitations expressed above it is TrueCommerce's recommendation that utilizing the Advance Integration Service (V2) system that you configure a single local workstation or Virtual Machine that is not configured with terminal access to be used as the bridge to operate between Transaction Manager and your ERP.

This configuration utilizes the power of SignalR to create a dedicated connection on a single machine that all other machines will leverage while falling under supportability from TrueCommerce.

With the introduction of the V2 Service only a single machine will be required to have the Integration Service installed, and as such can be configured to allow other all machines (even users on a terminal machine) to perform integrated operations such as Import, and Export within the Transaction Manager system without the need to install, or configure the Integration Service on any local user.

Scheduler

This machine will operate as both your Integration Service server as well as your Scheduler machine, as such it's recommended setting up a basic machine that runs continuously with limited interference or restarts to allow your Scheduler service to run properly.


Configuring a Terminal Environment


If you would like to attempt to configure a Terminal Environment TrueCommerce has managed to successfully implement the Integration Service by following the below recommendations.

The details in this article are provided as-is in an attempt to ensure best practices are followed for a successful Terminal Server setup.

However these do not fall within TrueCommerce support and will be limited

Prerequisites


In order for your Terminal Server to be successfully configured you will need to perform all operations and installations under a Local Admin account. A Domain Admin is not sufficient and has been the primary culprit of conflicts with the installation of the Integration Service across Terminal Server environments.

Local Admin

A Local Admin account is required as TrueCommerce does not maintain knowledge or expertise on troubleshooting conflicts caused by permission sets not granting proper permissions. This Local Admin is only required for the initial one time installation or during an upgrade of the Integration Service.

TrueCommerce does not hold knowledge of Domain Admins or Permission Sets and will not assist in ensuring proper installation if not granted access to the Local Admin provided in the below article

EXCEPTIONS WILL NOT BE MADE

Security Concerns

If security is a concern regarding installing applications under a Local Admin account tied directly to a main server, then it is recommended that you utilize the provided recommended Alternative Solution listed above.

Terminal Mode

You will need to run the Integration Service (V2) under Terminal Mode (this setting must be configured under Local Admin account).

Additional Resources


rev 9/5/2023

Did this answer your question?