Outgoing Calls with Multi-homing

Note: Since MassTransit 7.2.1 the MassTransitEngine.cfg file offers new option for configuring a particular IP address to be used for all outgoing MassTransit protocol traffic.

In Multi-homing environment where you want to ensure that all MassTransit protocol traffic is being sent over a single IP you need to specify an outgoing IP for TCP/IP, TCP/IP Secure, and UDT connections. The particular IP address can be set in the MassTransitEngine.cfg file.

  1. Open the MassTransitEngine.cfg file, located in the installation directory.
  2. Navigate to the MTAP Multi-homing settings section.
  3. Specify the desired IP address as MTAP_OUTGOING_IP_ADDRESS=.
  4. Delete the "%%" sign in front of the modified setting.
  5. Save and close the MassTransitEngine.cfg file.
  6. Restart the MassTransit service.
    1. Open the Services console from Start → Administrative Tools → Services.
    2. Highlight the MassTransit service and click on the Stop button from the Services tool bar, or select the Stop option from the context menu of the service.

Moving or Renaming the Web Pages

The web pages displayed for the Web Client and Ad hoc contacts are stored in the MTWeb folder within the MassTransit Installation folder. You can rename the MTWeb folder or move it to another location on the same machine if you wish, for example, if you want to keep it with your other web pages.

To rename the folder, edit its name in Windows Explorer.

If you do rename or move the MassTransit MTWeb folder, you must tell MassTransit and the web server (IIS) where to find the web pages. Follow these steps to accomplish this:

  1. In the MassTransit Administrator, open the Setup window by clicking on the Setup button from the Navigation Bar or by clicking on the Setup... option from the Window main menu.
  2. In the Setup window, select the Special tab.
  3. Under the Location of MassTransit web pages section, click on the Choose... button.

  4. Browse for the new MTWeb folder that contains the web pages and select it. Click OK in the Browse for Folder window.
  5. When you have selected the location of the web pages, click OK in the Setup window to save the changes.
  6. In the folder containing the web pages, delete the contents of the parsed and templates_c folders with the exception of the readme.txt files.
  7. Open the IIS Manager from Start → Administrative Tools → IIS Manager.
    1. if you are using IIS 6, follow these steps:
      • Under the Web Sites folder, right click on the Default Web Site entry and select Properties.
      • Select the Home Directory tab.
      • Click on the Browse button to specify the webroot folder that is inside the directory which contains the web pages.
      • Click OK in the Default Web site Properties window to save the changes.
    2. if you are using IIS 7, follow these steps:
      • In the Connections pane, expand the server name, expand Sites, then click on the Default Web Site entry to display the IIS configuration Home pane.
      • On the right, go to the Actions pane, under Edit Site click Basic Settings…
      • Next to Physical path: click on the button to specify the webroot folder that is inside the directory which contains the web pages.
      • Click OK in the Edit Site window to save the changes.
  8. Open the php.ini file in an application suitable for plain text edit. For PHP 5.3.1, the file is located in: C:\PHP
            For PHP versions prior to 5.3.1, the file is located in: C:\Windows
  9. Find the doc_root setting.
    1. if the setting is set with no value (doc_root = ), close the php.ini file without changing anything and continue with step 10.
    2. if the setting has a value set, change the value with the path to the webroot folder that is inside the directory which contains the web pages. For example, if you have changed the name of the MTWeb folder to WebPages, the doc_root setting should be configured to:
    3. on 64-bit machines:
      • for MassTransit 7.6 and later:

        doc_root = "C:\Program Files (x86)\Acronis\MassTransit Server\MTWeb\WebRoot"

      • for MassTransit 7.1 to 7.6:

        doc_root = "C:\Program Files (x86)\Group Logic\MassTransit Server\MTWeb\WebRoot"

      • for MassTransit 7.0:

        doc_root = "C:\Program Files (x86)\Group Logic\MassTransit Server 7\MTWeb\WebRoot"

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

        doc_root = "C:\Program Files\Acronis\MassTransit Server\MTWeb\WebRoot"

      • for MassTransit 7.0:
      • doc_root = "C:\Program Files\Group Logic\MassTransit Server 7\MTWeb\WebRoot"
  10. Restart IIS to apply the changes.

Now, your web users should be able to log successfully into the web site.