Downloading Integration Service
Click here to see this page in full context
  1. Transaction Manager >
  2. Integration Settings >
  3. Downloading Integration Service

 

Downloading the Integration Service

Every Transaction Manager user who wants to perform integration work must install the Integration Service locally. To download and install the Integration Service:

  1. Log in to the terminal server as the Local Administrator.

  2. In Transaction Manager, open the Integration Settings page from the navigation menu.

  3. Select an option from the Advanced Integration Service Settings, and then click the Download Integration Service link. If you selected Option 2 for your Advanced Integration Service Setting, see Option 2 Download before continuing.

  4. Save the file locally to the machine and right-click to run as administrator. 

  5. Select Next in the Transaction Manager Integration Service - InstallShield Wizard pop-up window to begin the installation.

  6. Enter a User Name and Organization and click Next.

  7. Select the Complete setup type radio button and click Next.

  8. Click the Install button once the Integration Services is ready to install.

  9. If necessary, click Yes to allow the program to install.



    A progress bar displays to notify the status of the Integration Service installation.

  10. Click Finish to complete the install of Transaction Manager Integration Service.


     

  11. When prompted by the pop-up, click Yes to allow the Transaction Manager Integration Service to add the URLs to the "Trusted" security zone on your computer.

  12. Select OK to acknowledge that the settings have been changed.

 

Option 2 Downloads

If Option 2 was your choice for Advanced Integration Service Setting, the TMOIntegrationServicesV2 file will be downloaded to your local folder. 

 

NOTE

If you selected any option other than Option 2, you can skip this section. 

If you have one terminal server or if you do not want to install the integration service on several different clients, the integration service can be installed just once (for example, on a Sage 100 server but nowhere else), and a unique identifier will be associated to that server to make it a cloud integration.

Integration Service V2

The Active Scheduler Machine field should show both the Global Unique Identification Number (GUID) of the integration service and the machine on which it is installed on the Transaction Manager | Administration | Scheduler page (and the Scheduled Event Edit page, accessed by editing a specific event).

For the previous Integration Service, the Active Scheduler Machine field will only show the Windows computer name.

Logic is included for determining whether to add or remove the customer's record from the ttcCloudCustProfile, depending on the integration service version (for local and hybrid BSPs), or Cloud only customer (cloud only BSP).

The Active Scheduler Machine must be set to at least one Active Cloud Scheduled Event.

Integration Service V2 and beyond

For Integration Service V2 and beyond, the Active Scheduler Machine must be set to at least 1 Active Cloud or local Scheduled Event, and the Advanced Integration Service SEtting must be set to Option 2 with the correct GUID.

Following are the ordered steps in which to configure Scheduler for Integration Service V2 (and later versions):

  1. Install Integration ServiceV2.

  2. Once it is running, right-click on the TrueCommerce icon within the system tray, then select about.


     

  3. Copy the Integration Service ID by clicking the paper icon to the right of the INtegration Service ID.

  4. Log into Transaction Manager and navigate to the Integration Settings page.

  5. Select Option 2, then paste the Integration Service ID into the Integration Service ID field.

  6. Click Save.

  7. Navigate to Transaction Manager Scheduler, and then click Activate.

  8. Once configured, the following "Integration Service ID installed on Windows Computer Name" is displayed in the Active Scheduler machine field.


    The only other instance where the integration service will need to be installed is if a customer is utilizing an on-premise labeling utility, where the Integration Service will need to be installed on that machine.

 

Related Topics