Setting up MTWeb with Multi-homing

By default, MassTransit listens on all IP addresses at the specified port. If the machine is configured with multiple IP addresses, it is often useful to designate an IP address for MassTransit and the web server. This is especially valuable when both the website and the MassTransit server must run on SSL (port 443). In such cases, you must configure MassTransit with multi-homing.

MassTransit allows you to create multiple listen entries of the same type and set an IP address for each one of them.

Note: Please note that the web server (IIS) needs to listen on a particular IP address and not on all IP addresses, because this may cause the TCP/IP Secure listen to stop listening.

To check the IP addresses that IIS is listening on, and to set an IP address to listen on, do the following:

1. Open Windows Start and type: cmd.
2. Right-click the Command Prompt icon, and select Run as administrator
3. At the command prompt, enter the following command depending on the action you want to perform.
   1. To see all addresses IIS is listening on:

      netsh http show iplisten

   2. To set IIS to listen on IP 172.17.200.20 by using port 443 (replace the IP address and the port number with the ones you need)

      netsh http add iplisten ipaddress=172.17.200.20:443

The figure below provides an example how MassTransit Server transfers files using SSL on IP address 10.10.2.36 on port 443. MTWeb will be configured on IP address 10.10.2.38 on port 443.

The following setup instructions are based on the diagram above:

1. Start the MassTransit Administrator.
2. In the Navigation bar, click Setup.
3. Select the Incoming Calls tab.
4. To add a new listen entry, click Add... and select the TCP/IP Secure as Method.
5. To configure an existing TCP/IP Secure listen, select it from the list in the Incoming Calls tab, and then click Configure...
6. In the window that appears, select an IP address option.The default option is All. This means that MassTransit will listen for incoming calls on all network interfaces. Instead, you can select a particular IP address. In this case MassTransit will use only that address to listen on.
7. In the Port field, enter the port that will be used, or leave the default setting.
8. If you want to receive connections from MassTransit 7.7 and older, select the check box Use legacy TLS v1.0 protocol.
9. Select a minimum encryption level for incoming calls.

   

10. Click OK. The configured method now appears as active in the Setup window.
11. Click OK to close the Setup window.

The IP addresses setup for the specific listen is complete. Users can now access MTWeb via IP address 10.10.2.38, while the file transfers (communication between MassTransit Server and MassTransit Assistant) will use IP address 10.10.2.36.

For detailed instructions on how to configure other listen methods, refer to Communications.