Configurations for the Transporter Service

The Transporter service manages SFTP connections. Communication between the Transporter and the Engine are via Web Services calls and you are allowed to configure the communication parameters of the service in order to apply it in your environment.

The configuration settings for the Transporter service are placed in the MassTransitEngine.cfg and mtTransporter.ini files of the MassTransit installation directory:

1. for MassTransit 7.6 and later:
   • on 64-bit machines:

   C:\Program Files (x86)\Acronis\MassTransit Server

2. for MassTransit 7.1 to 7.6:
   • on 32-bit machines:

   C:\Program Files\Group Logic\MassTransit Server

   • on 64-bit machines:

   C:\Program Files (x86)\Group Logic\MassTransit Server

3. for MassTransit 7.0.x:
   • on 32-bit machines:

   C:\Program Files\Group Logic\MassTransit Server 7

   • on 64-bit machines:
   • C:\Program Files (x86)\Group Logic\MassTransit Server 7

To configure the Transporter service, follow these steps:

1. Open the MassTransitEngine.cfg in an application suitable for plain text edit.
2. Locate the "Transporter service settings" section and modify the desired settings:

   Note: Uncomment the settings you configure if they are commented out in order to activate them. You can do that by deleting the '%%' at the beginning of the line.

   1. TRANSPORTER_SERVICE_HOST = localhost – this option sets the host for the Transporter service; set it to a DNS or an IP address of the Transporter service host; the default value is "localhost";
   2. TRANSPORTER_SERVICE_PORT = 8002 – set this to the port number the Transporter service is listening on; the default is 8002;
   3. TRANSPORTER_CALLBACK_HOST = localhost – set this to a DNS name or IP address that the Transporter service will use to make notification callbacks; the default is "localhost";
   4.  TRANSPORTER_CALLBACK_PORT = 8003 – set this to the port number the Transporter notification sink will listen on; the default is 8003;
   5. TRANSPORTER_OPEN_TIMEOUT = 3 – this option is the Transporter service open time-out – it defines how long the engine will wait for the Transporter service to respond to a connection request, in seconds; the default is 3 seconds;
   6. TRANSPORTER_INACTIVITY_TIMEOUT = 25 – this is Transporter service inactivity time-out – it defines the length of a period of infrastructural inactivity on the Transporter service connection, in seconds, after which the engine should attempt to re-establish the Transporter service connection; the default is 25 seconds;
   7. Authentication parameters of the Transporter service. If these are not set, the current Windows identity will be used to authenticate against the Transporter service. Set to a valid domain, user name and password combination:
                  i. TRANSPORTER_USER_DOMAIN = – domain name for the Transporter user;
                  ii. TRANSPORTER_USER_NAME = – user name for the Transporter user;
                 iii. TRANSPORTER_USER_PASSWORD = – password for the Transporter user;
               h. TRANSPORTER_PROGRESS_POLL_INTERVAL = 1 – the Engine polls the Transporter for progress information on active sessions and this setting configures the rate of polling in seconds; set the value to 0 to turn off progress polling; the default is 1 second.
3. When you have configured the desired settings, save and close the MassTransitEngine.cfg file.
4. Open the mtTransporter.ini file in an application suitable for plain text edit.
5. Modify the setting bellow:
   1. TRANSPORTER_SOAP_ADDRESS= 127.0.0.1:8002 – this option sets the Transporter service host address and the port number; the default value is "127.0.0.1:8002";

      Note: The TRANSPORTER_SOAP_ADDRESS must match the settings for the TRANSPORTER_SERVICE_HOST and  the TRANSPORTER_SERVICE_PORT in the MassTransitEngine.cfg file.

      Note: If you want to use SFTP on a server with multiple IP addresses, please follow the steps in the Transporter Service Initialization Failed FAQ.

6. When you have configured the desired settings, save and close the mtTransporter.ini file.
7. In order to apply the changes immediately, you need to restart the MassTransit services:
            a. From the Services console, stop the MassTransit service (the service is called MassTransit SFTP for MassTransit SFTP servers);
            b. Restart the MassTransit Transporter service.
            c. Start the MassTransit service (the service is called MassTransit SFTP for MassTransit SFTP servers).