MassTransit Web Setup

Installing and Upgrading MassTransit Web

Note: The web server for the MTWeb configuration must be installed on the machine where the MassTransit server is installed.

Detailed installation instructions of the MTWeb functionality are described on the Installing MTWeb 7 page from the Installation Guide.

For information on how to upgrade prior versions of MassTransit to version 7, follow the instructions on the Upgrading MassTransit to 7 page from the Installation Guide.

Configure MTWeb

Besides the MassTransit Web setup configurations, there are some more configurations that can be set. For details, please see below.

MTWeb Configurations in the mtweb.ini File

There are some configurations regarding the MTWeb performance in the mtweb.ini file. To set them:

1. Open the mtweb.ini file located in the MTWeb directory. By default, this folder is placed on the system drive in:
   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

      Note: All lines beginning with a semicolon (;) in the mtweb.ini file are considered commented and therefore ignored. Please ensure that all settings you change are uncommented (if you see ";" characters at the beginning of any of the settings you modify, delete them).

2. To configure the mode you are running MTWeb in, configure the following setting:

   MTWEB_MODE="PRODUCTION" – the MTWEB_MODE setting controls the execution MTWeb code and should be set to PRODUCTION when deployed in a production environment. If the mode is set to DEVELOPMENT, MTWeb performs extra operations that make diagnosing problems easier but may impact performance.

   Warning: Please do not set the MTWEB_MODE to DEVELOPMENT unless you have been advised to by Group Logic.

3. The address for SOAP and the database used should be set during the MTWeb setup. If you need to, you can modify the settings:
   • SOAP_PROXY_ADDRESS --- this setting should be set to the IP address of the machine;
   • SOAP_PROXY_PORT --- this setting should be set to port you want SOAP to use for communications;
   • DB_HOST --- the value of this setting should also be the IP address of the machine;
   • DB_PORT --- this setting should be set to port you want the database to use for communications;
   • DB_NAME --- this should be the name of the database in MySQL; by default, it is mtdatabase;
   • DB_USER – this setting should be set to the name of the MySQL user that will access the MassTransit database (you set that database user during the MassTransit installation); by default, it is masstransit; please consult the FAQ section of the MassTransit installation for information on creating a new user in MySQL;
   • DB_PASSWORD – this should be set to the password of the MySQL user that will access the MassTransit database (you set that password for the database user during the MassTransit installation).

     Note: If you change any of the database properties you need to reflect those changes in the 'Database Settings' section of the MassTransitEngine.cfg file.

4. To configure the name of the WSDL file used for SOAP calls to the MassTransit server, use the following setting:

   SOAP_WSDL = "MassTransit.wsdl" – configure the setting to the WSDL file that MassTransit shall use for the SOAP calls.

   Warning: Please do not change the SOAP_WSDL setting unless you have been advised to by Group Logic.

5. You can configure a timeout in seconds for the SOAP connection. In order for errors to be properly reported, the timeout should be less than the PHP and web server timeouts (see the MassTransit installation for information about the timeouts). Anything less than 30 seconds is sufficient if you're using default timeouts.

   SOAP_TIMEOUT = 20

6. MassTransit allows you to configure a separate address from the default web server for the MassTransit Assistant plug-in communication. To configure a web server for the web plug-in, set the following setting:
   

   HOST_IP_ADDRESS = "localhost:50000" – when this setting is set, the MassTransit Assistant plug-in will use that address designated for server communication. Otherwise, it will use the address given by the MassTransit server.

   Note: If your server is using a private, NAT'd IP address, you will need to configure MassTransit so that external web client users will connect to the public IP address. The best option would be to use a DNS entry in HOST_IP_ADDRESS, like "HOST_IP_ADDRESS=masstransit.mydomain.com:50000". Set the public DNS entry to resolve to the public address, and set the internal DNS entry to resolve to the private address of the server, unless you want internal users to route through the public address. If web clients are connecting on a port other than 50000, change that number to the appropriate port.

7. To set plug-in versions which can be used for transferring files to the MassTransit server, configure the following settings:
   • LATEST_AVAILABLE_PLUGIN_VERSION = "7,0,1,167" – sets the latest available plug-in version that can be used by the web users. By default, the latest available version is the same version number as the MassTransit server. Please note that the version numbers have to be separated with commas (,).
   • MINIMUM_REQUIRED_PLUGIN_VERSION = "6,1,0,174" – sets the minimum required plug-in version that can be used by the web users for transferring files. By default, the minimum required plug-in version is 6.1.0.174. Please note that the version numbers have to be separated with commas (,).
8. To enable secure session cookies for MTWeb:

Warning!: Before configuring this, make sure that the server is set up for HTTPS access because this will disable HTTP authentication.

Note: After making changes to the php.ini file, you will have to restart the whole server for them to take effect.

1. Navigate to and open the php.ini file.
2. Uncomment the following line: ;session.cookie_secure = and set it to 1.

   e.g. session.cookie_secure = 1

MassTransit 7.2 and later contains new configuration options in the mtweb.ini file, these new settings are described bellow:

1. Set default fall back web application window, that appears when a web client logs into the MassTransit web application. The AUTO_HTTP_FALLBACK = option is located under the "FILE TRANSFER" section.

   The AUTO_HTTP_FALLBACK =' s default value is true. If the default file transfer transport is plug-in and the setting; AUTO_HTTP_FALLBACK = is set to true and the web client does not yet have the plug-in installed, the client will be immediately directed to the "send" and "download files" pages in HTTP mode. If set to false, the web user will see the plug-in download page on first login, even if HTTP transfer is allowed. If the user chooses to not download the plug-in and use HTTP instead, he will not be pushed to the plug-in download page again, but can navigate to it manually.

2. Set a default subject entry for sending files and requesting files e-mails.

   The DEFAULT_SEND_FILES_SUBJECT =option is displayed under the "FILE TRANSFER" section. The default value of the is "Files are available".

   A default "send files" subject entry can be configured by the MassTransit administrator. This option controls the pre-populated text that appears in the subject field, when web user is sending files to an valid email address. The email subject field has limit of 255 characters.

   The DEFAULT_REQUEST_FILES_SUBJECT =option is displayed under the "FILE TRANSFER" section. The default value is "Please send me some files".

   This option controls the pre-populated text, that appears in the subject field, when web user is requesting files from a valid email address. The email subject field has limit of 255 characters.

3. When you have configured all desired settings, save and close the mtweb.ini file.
   

Secure MTWeb Configuration

You can configure secure connections between your MassTransit HP server and the web users by encrypting the transferred files or by encrypting the entire web traffic on your server.

See detailed instructions on how to do that on the Secure MTWeb Configuration page.

MTWeb with Multi-homing

If the machine where MassTransit is installed is configured with multiple IP Addresses, it is often useful to designate an IP Address for MassTransit and one for 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.

For detailed instructions on how to configure multi-homing, see the MTWeb with Multi-homing page.