All Collections
Business System Integrations
Integration Service
Configuration
Integration Service - Update or Install the Integration Service
Integration Service - Update or Install the Integration Service

A step-by-step guide to updating or installing the Integration Service.

Support avatar
Written by Support
Updated over a week ago

Product: Transaction Manager


The Integration Service is used in many of TrueCommerce's locally-based Integrations in order to help pass data from Transaction Manager and your Business System or a local Flat-File Integration.

This service plays a vital role in keeping your business process flowing as it is responsible for handling all the data flow! You'll want to keep the Integration Service up-to-date as possible as TrueCommerce is constantly providing improvements to its process.

Not Sure if you need the Integration Service?

If you're unsure whether or not you need to install the Integration Service we recommend checking out the following article to get a brief rundown of when its required and when it isn't


Local Admin Required


TrueCommerce provides limited support for environmental issues - as such requires Local Admin privileges in order to troubleshoot the Integration Service if any issue should occur. As such it is highly recommended to install the Integration Service as local admin due to the known issues with Domain Admins failing to have the proper permissions

Local Admin Requirements

Most all issues with the Integration Service failing to run consistently or install properly have been resolved with Local Admin users - if you are unable to provide this access TrueCommerce will be limited in its support


Upgrading


If you previously had the Integration Service installed and are upgrading to the latest version you'll want to make sure to backup your Integrated DLL prior to running the installer to avoid automatically upgrading your Business System integration at the same time - which often requires additional work

Backing up Your DLL

It is highly recommended to backup your Integration DLL if you are utilizing one of our Local Framework integrations to avoid needing to reconfigure your Integrations

Once the installation is complete - you can restore your backed up DLL and restart the Integration Service if it was automatically running to keep your Business System integration at the same level it was before.

Upgrading from the Legacy Integration Service (v1)

It is recommended that you perform a complete uninstall of the Legacy Integration Service when upgrading to the Advance Integration Service (V2)


Downloading the Integration Service


You can download the latest Integration Service straight from Transaction Manager's Integration Settings menu.

TrueCommerce no longer recommends using the Legacy Integration Service (V1) associated with the Option 1 selection - it is recommended moving forward you select Option 2 to install the Advance Integration Service (V2)

Navigate: Integration Settings

Select: Option 2 (for recommended Advance Integration Service)

Select: Download Integration Service


Installing the Integration Service


Once you've downloaded the Integration Service installer you can follow the prompts to easily install the latest version of the service.

For Upgrades

If you already have the Integration Service installed and are upgrading it is recommended to stop the Transaction Manager Integration Service (TmoIntegrationService) prior to installation.

Stopping the Service

Open: Services from the Windows Search menu

Locate: Transaction Manager Integration Service

Select: Stop the service

(Alternatively): Right Click โ†’ Stop

Installing the Integration Service

By default the Integration Service installer would of downloaded into your Downloads folder - from there you'll want to be sure to install it by running it as administrator to ensure proper installation

It is not recommended to install without Local Administrator privilege.

Domain Admins often result in failure for a proper installation and will not be supported by TrueCommerce for this reason

Launch the Installer

You'll need to run the installer as administrator while logged in under a Domain Admin account in order to ensure proper installation.

Locate: Installer

Right Click: Run as administrator

Run the Installer

Follow the prompts for the installer to get the the Integration Service installed onto the machine.

Successful Installation

After the installation you will now see the TrueCommerce tray icon next to your clock - double clicking the TrueCommerce icon will show your connectivity status.

rev 2/8/2024

Did this answer your question?