MTWeb

MassTransit allows you to transfer files over the web using a web server. This functionality is called MassTransit Web (MTWeb). Transferring files using the MTWeb feature is very convenient when you need to send or receive files, any files from any location. You just need a standard web browser running on a Windows or Mac machine. In addition, you can configure a secure connection to your web contacts that will assure privacy of the file transfers when transmitting files over the internet.

NOTE: The MTWeb functionality is available on MassTransit HP servers only.

The supported web servers for an MTWeb configuration on a Windows operating system are the following:

• Internet Information Services (IIS) 6;
• IIS 7.

The MassTransit contacts that can transfer files over the web are Web client contacts and Ad hoc contacts. They can log in to the MassTransit server using a web browser and transfer the desired files. The supported web browsers are:

Windows

• Internet Explorer 7 or higher
• Firefox 3 or higher
• Chrome 4.0 or higher (HTTP only)

Macintosh

• Safari 3 or higher
• Firefox 3 or higher
• Chrome 4.0 or higher (HTTP only)

INFO: MassTransit 7.2 adds support for Internet Explorer 9, Firefox 4, 64-bit Safari 5.

Go to top

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.


Go to top

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.


Go to top

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


Go to top

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:
         a. on 32-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files\Group Logic\MassTransit Server
         b. on 64-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files (x86)\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files (x86)\Group Logic\MassTransit Server

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:
         a. SOAP_PROXY_ADDRESS --- this setting should be set to the IP address of the machine;
         b. SOAP_PROXY_PORT --- this setting should be set to port you want SOAP to use for communications;
         c. DB_HOST --- the value of this setting should also be the IP address of the machine;
         d. DB_PORT --- this setting should be set to port you want the database to use for communications;
         e. DB_NAME --- this should be the name of the database in MySQL; by default, it is mtdatabase;
         f. 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;
         g. 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.

INFO: 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:
         a. 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 (,).
         b. 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 (,).

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

    8. 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.

    9. 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.

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


Go to top

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.


Go to top

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.
         a. if you are using IIS 6, follow these steps:
            i. Under the Web Sites folder, right click on the Default Web Site entry and select Properties.
           ii. Select the Home Directory tab.
           iii. Click on the Browse button to specify the webroot folder that is inside the directory which contains the web pages.
            iv. Click OK in the Default Web site Properties window to save the changes.
         b. if you are using IIS 7, follow these steps:
            i. 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.
           ii. On the right, go to the Actions pane, under Edit Site click Basic Settings…
           iii. Next to Physical path: click on the … button to specify the webroot folder that is inside the directory which contains the web pages.
            iv. 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.
         a. if the setting is set with no value (doc_root = ), close the php.ini file without changing anything and continue with step 10.
         b. 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:
            i. for MassTransit HP 7.0:
               - on 32-bit machines – doc_root = "C:\Program Files\Group Logic\MassTransit Server 7\WebPages\webroot"
               - on 64-bit machines – doc_root = "C:\Program Files (x86)\Group Logic\MassTransit Server 7\WebPages\webroot"
            ii. for MassTransit HP 7.1 and later:
               - on 32-bit machines – doc_root = "C:\Program Files\Group Logic\MassTransit Server\WebPages\webroot"
               - on 64-bit machines – doc_root = "C:\Program Files (x86)\Group Logic\MassTransit Server\WebPages\webroot"

   10. Restart IIS to apply the changes.

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


Go to top

You can customize the user interface of the MassTransit Web. To do that, follow the steps below:

    1. Open the mtweb.ini file located in the MTWeb directory. By default, this folder is placed on the system drive in:
         ~\Program Files\Group Logic\MassTransit 7
         On 64-bit versions of Windows, the default location of the MassTransit folder is on the system drive in:
         ~\Program Files (x86)\Group Logic\MassTransit 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. Go to the USER INTERFACE section in the file.

    3. To modify the text that appears on the MassTransit login page, edit the value of the setting below. Please limit the size of this message to a maximum length of 250 characters.
         LOGIN_MSG = "Please enter your MassTransit username and password."

    4. To change the name of the server that will appear in the user interface, modify the setting below:
         SERVER_NAME = "MassTransit Server"

    5. On MassTransit HP version 7.0.1 and later, you are allowed to change the default watermark in the To field on the Send Files page of the user interface. To do that, change the following setting to the watermark you want:
         WATERMARK = "MassTransit Server"

    6. To set the maximum number of pages to be returned in search results in the Log Viewer, change the setting below. The maximum value of the setting is 100.
         LOGVIEWER_MAX_PAGES = 20

    7. To set the maximum number of pages of search results to show in page listing in the Log Viewer, modify the setting below. The maximum value is 25.
         LOGVIEWER_MAX_DISPLAYED_PAGES = 25

    8. To set the maximum number of search results to show per page in the Log Viewer, modify the following setting (the maximum value is 100):
         LOGVIEWER_RESULTS_PER_PAGE = 30

    9. You can configure a delay (in seconds) between completing one update and beginning the next when MassTransit Web is in live-update mode. Values less than or equal to zero will be treated as 1 second. There is no maximum value.
         LOGVIEWER_UPDATE_DELAY_SECONDS = 10

   10. Log entry timestamps can be displayed in 24-hour format or in 12-hour format with am/pm displayed. Set to true if you want to use the 24-hour format. Set to false to use the 12-hour format.
         LOGVIEWER_24_FORMAT = "false"

   11. You can enable or disable the My Account tab from the MassTransit Web user interface. To enable it, set the setting below to true. Set it to false to disable.

NOTE: Disabling will redirect clients back to the login screen if their password expires.

         MY_ACCOUNT_TAB_ENABLED = "true"

   12. To configure the system administrator contact information, modify the setting below. When this text is set, it will be displayed if a user attempts to log in with an incorrect username or password.
         ADMIN_CONTACT_TEXT = "Contact Jane Doe at janedoe@email.com or (888) 888-8888 for password support."

   13. To display or not a new job ticket button on job ticket Send Files page for ALL Web client contacts, change the setting below. Set it to true to enable or false to disable. When this setting is enabled, a button will appear at the bottom of the job ticket Send Files page that will start a new job ticket transaction when clicked. See the next step to set the text of the button.
         DISPLAY_NEW_JOB_TICKET_BUTTON = "true"

   14. To configure a custom text for the new transaction button on job ticket Send Files page, modify the setting below. Only takes effect if the above DISPLAY_NEW_JOB_TICKET_BUTTON setting is true.
         NEW_JOB_TICKET_BUTTON_TEXT = "Start a new upload transaction"

   15. To configure the number of rows to show in file listing on the Send Files page, configure the setting below. If there are more files to list than this number, some of them will be hidden by default for performance reasons.
         MAX_ROWS_TO_SHOW = 100

   16. In MassTransit 7.1, you can configure the number of rows to show in file listing on the Download Files page. If there are more files to list than this number, some of them will be hidden by default for performance reasons.
         MAX_ROWS_TO_SHOW_DOWNLOAD = 1000

   17. Go to the APPLICATION section of the mtweb.ini file.

   18. You can configure an "idle timeout" for users to enforce them to login again after a defined period of idle time (in seconds) in the AUTHENTICATION_TIMEOUT setting. If you do not want to set a timeout, set the value to zero or just omit configuring this setting. There is no maximum value restriction.
         AUTHENTICATION_TIMEOUT = 3600

   19. Configure whether to cache the client data with each request or to cache them for the session in the setting below. Set it to 0 for no cache (cache for the session) or to 1 if you want to cache the data with each request.
         CACHE_CLIENT_DATA = 1

   20. Select a language file to use in the user interface of MassTransit Web. The default one is "en" (English). You can change it to "fr" if you want to switch the language to French.

INFO: The default location of the language files is inside the lang folder which is placed in: ~\Program Files\Group Logic\MassTransit 7\MTWeb

         lang = "en"

   21. Set the MEMORY_LIMIT setting to configure the maximum amount of memory a request/PHP script may consume. This setting is specified in bytes but may also be expressed in a shorthand documented here: us3.php.net/manual/en/faq.using.php#faq.using.shorthandbytes. Note that to have no memory limit, you need to set this directive to -1, the default is 32M.

NOTE: This setting will override the memory limit setting in php.ini for MTWeb. Generally, you should not change this setting.

         MEMORY_LIMIT = 32M

   22. To customize the default header and/or footer of the MassTransit Web Application, follow the steps below:

• Locate the “\Group Logic\MassTransit Server\MTWeb\customize” directory
• Make copies of the following files, removing the 'example.' portion of the file name.

  example.header.tpl

  example.footer.tpl

• Leave the copied files in this directory, open them with Notepad and modify and save them as required.
• The MassTransit Web UI will automatically use the modified files instead of the default MassTransit header/footer.

Go to top

The MassTransit website uses default logos created by Group Logic. However administrators can configure their own company logo or change the entire look of the website. Follow the steps in this article to configure the MassTransit website to use a custom company logo.

NOTE: Before you begin you should keep in mind the following: Do not modify the size of the logos. Do not change the logo type. The extension of the logo should be .PNG Do not modify the name of the files. It would be better if you back up the original files and rename them filename-original. Use a quality software package (like Photoshop, Photo Art Studio, etc. ) to modify the graphics. When you perform an upgrade (version hotfix or upgrade) these files will need to be backed up and replaced as needed.

.

   23. To customize the skin of the web interface with MassTransit 7.2 or later, follow the steps below:

• Navigate to C:\Program Files\Group Logic\MassTransit Server\MTWeb\WebRoot\Templates;
• Make a copy of the Default folder in the same directory and give it a custom name;
• Changes can be applied to the "CSS" code and the images in the copied folder to customize the interface;
• Set the TEMPLATE= option in the mtweb.ini to use the new customized folder. One a production server you may want to leave that step until you're done with the changes.
• When you have configured all desired settings, save and close the mtweb.ini file.

INFO: MassTransit 7.2 and later offers documentation on how to integrate the MassTransit web client Assistant with custom web sites. The integration supports immediate upload, immediate download, and single upload modes. For more information, please download the MassTransitSDK.zip file.

    24. Modifying the primary login page.

You will need to modify the “login_bk.png” graphic in order to add your company logo to your MassTransit website login page:
         a. Open the file located in the following directory using a software graphics package and edit it as needed:
            Group Logic\MassTransit Server\MTWeb\webroot\Templates\Default\images”
         b. Save the new graphic and close the program.
Your logo should now be stated as a primary header logo for the login page of the website.

    25. Modifying the header page displayed after login.

You will need to modify the “header.png” graphic in order to add your company logo to your MassTransit website.
         a. Open the file located in the following directory using a software graphics package and edit it as needed:
            Group Logic\MassTransit Server\MTWeb\webroot\Templates\Default\images”
         b. Save the new graphic and close the program.
Your logo should now be display as the primary header logo after a user logs into the website.

    26. If you would like to further customize the look of the site, you can modify the appropriate Cascading Style Sheet (CSS) file. Most elements are documented inline. For instance, opening the file “login_visuals.css” allows you to customize the login page. If you want to modify the background for this page, find and edit this section:

 body {

/* Background for main login page. */

                font-family: "Helvetica Neue", Helvetica, Verdana, sans-serif;

                background-color: #C5CCD3;

                background-image: url('./images/masstransit-canvas.jpg');

                background-repeat: no-repeat;

}

Notice the reference to masstransit-canvas.jpg. Graphic files should be located inside this folder.

Make any edits to the necessary files for the elements you need to customize.

Go to top

MassTransit allows you to disable the "Download All" button for the Generic Web Client. There is a setting in the MassTransitEngine.cfg file that allows you to disable the “Download All” button on the Download Files tab of MTWeb.

1. Open the MassTransitEngine.cfgfile located in the MassTransit installation directory:
   1. for MassTransit HP 7.0 – ~\Group Logic\MassTransit Server 7
   2. for MassTransit 7.1 and later – ~\Group Logic\MassTransit Server
2. Find the following line in the MassTransitEngine.cfg file:
       %%DISABLE_DOWNLOAD_ALL_FOR_GENERIC_WEB_CLIENT = FALSE
3. Uncomment it by removing the %% at the beginning of the line.
4. Set the value to TRUE. The line should now look like this:
   DISABLE_DOWNLOAD_ALL_FOR_GENERIC_WEB_CLIENT = TRUE

When set to TRUE the Download All button is grayed out on the Download Files tab and the Generic Web Client is forced to select files for download and use the Download Selected button.

NOTE: Any time you make a change to the MassTransitEngine.cfg file you must restart the MassTransit engine and Transporter services for the changes to take effect. It is important that you stop the Transporter first, restart the engine and then start the Transporter.

Go to top

There are two types of contacts that can transfer files using MTWeb: Web client and Ad hoc contacts.

You can find detailed instructions on how to create and configure their privileges on the Contacts page.

There are a few more contact settings which can be configured. See the sections below.


Go to top

Some settings for the web users are configurable in the mtweb.ini file. To configure them:

    1. Open the mtweb.ini file located in the MTWeb directory. By default, this folder is placed on the system drive in:
         a. on 32-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files\Group Logic\MassTransit Server
         b. on 64-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files (x86)\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files (x86)\Group Logic\MassTransit Server

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. Go to the FILE TRANSFER section of the mtweb.ini file.

    3. Configure the setting below to force the user to fill in a job ticket or not by default. Set it to "0" if you do not want to force using a job ticket. Otherwise, set it to "1" (no quotes).

NOTE: The setting can be overridden per user within the MassTransit Administrator application.

         mForceHTMLJobTicket = 0

    4. Configure the setting below to the maximum number of files that Web Client users are allowed to send per transfer using the plug-in. Only numbers greater than "0" enable this feature, default is "0" which means that the maximum number is not restricted.

NOTE: This value is ignored for HTTP transfers.

         mLimitNumFilesPerTransfer = 0

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

The changes will take effect the next time the Web client contact/Ad hoc contact logs into the MassTransit web site.


Go to top

Some settings for the web users are configurable in the MassTransitEngine.cfg file. To configure them:

    1. Open the MassTransitEngine.cfg file located in the MassTransit installation directory. By default, this file is placed on the system drive in:
         a. on 32-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files (x86)\Group Logic\MassTransit Server
         b. on 64-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files (x86)\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files (x86)\Group Logic\MassTransit Server

NOTE: All lines beginning with '%%' in the MassTransitEngine.cfg 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 require all web users to select either a Forwarding contact or a Service (from the To: or Service: drop-down menu on the Send Files tab of the user interface) before uploading files to the MassTransit server, configure the following setting as shown below:
         FORCE_WEB_CLIENT_FORWARDING_OR_SERVICE_SELECTION=TRUE
         The plug-in prompts the user on drag and drop as well as clicking the Select Files… button.

    3. In order to apply the changes immediately, you need to restart the MassTransit Engine:
         a. Open the Services console from Start → Administrative Tools → Services.
         b. 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.
         c. Highlight the MassTransit Transporter service and click on the Restart button from the Services tool bar, or select the Restart option from the context menu of the service;
         d. Highlight the MassTransit service and click on the Start button from the Services tool bar, or select the Start option from the context menu of the service.

The next time web users log into the MassTransit web site, they will be prompted to select either a Forwarding contact or a Service from the To: or Service: drop-down menu on the Send Files tab of the user interface before uploading files.


Go to top

Some settings for the web users are configurable in the MassTransit.cfg file. To configure them:

    1. Open the MassTransit.cfg file located in the MassTransit installation directory. By default, this file is placed on the system drive in:
         a. on 32-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files\Group Logic\MassTransit Server
         b. on 64-bit machines:
            i. MassTransit HP 7.0 – ~\Program Files (x86)\Group Logic\MassTransit Server 7
            ii. MassTransit HP 7.1 and later – ~\Program Files (x86)\Group Logic\MassTransit Server

NOTE: All lines beginning with '%%' in the MassTransit.cfg 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 enable/disable the FTP/SFTP transfer privileges for all web contacts, set the following setting to TRUE or FALSE respectively:
         ON_FOR_WEB_CLIENTS_BY_DEFAULT = TRUE

    3. In order to apply the changes immediately, you need to restart the MassTransit Engine:
         a. Open the Services console from Start → Administrative Tools → Services.
         b. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Stop button from the Services tool bar, or select the Stop option from the context menu of the service.
         c. Highlight the MassTransit Transporter service and click on the Restart button from the Services tool bar, or select the Restart option from the context menu of the service;
         d. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Start button from the Services tool bar, or select the Start option from the context menu of the service.

The next time web users log into the MassTransit web site, the configured setting will take effect and will be enabled/disabled to transfer files using FTP or SFTP transfer method.


Go to top

Active Directory is a technology created by Microsoft that provides a variety of network services, including:

• Lightweight Directory Access Protocol LDAP is the industry standard directory access protocol, making Active Directory widely accessible to management and query applications;
• Kerberos-based authentication;
• DNS-based naming and other network information;
• Central location for network administration and delegation of authority;
• Information security and single sign-on for user access to networked based resources;
• The ability to scale up or down easily, etc.;

See detailed instructions on how to configure Active Directory on the Active Directory page.


Go to top

Before transferring files with MTWeb, you need to configure the following components:

• Listens for incoming calls on the server;
• MTWeb
• Web client and/or Ad hoc contacts set with the desired privileges. Then, you have to provide the set login credentials to the users.

When you complete the requirements stated above, you are ready to transfer files using MTWeb. The information below is designed to inform the users on the server side of the connection how to transfer files to/from their Web client and/or Ad hoc contacts.

Your Web client and Ad hoc contacts should read the instructions for using MTWeb in the Web Client User Guide.

The Web client and/or Ad hoc contacts can use the MassTransit Web Assistant plug-in or the HTTP feature of MassTransit.

Only the MassTransit plug-in can use the advanced communication protocols of MassTransit - TCP/IP, TCP/IP Secure, and UDT. They provide the ability to modify the transfer packets and buffer sizes in order to increase the transfer speed. In addition, the MassTransit Assistant plug-in allows transferring huge file volumes. In HTTP mode on the other hand, users can transmit only up to 2GB of files in a single transfer but your MTWeb users will be able to send and receive files without installing anything on the machine they are connected from.

Ad hoc delivery works in both transfer modes plug-in and HTTP. They also provide secure files transfers when configured.

Using the MassTransit plug-in, MTWeb users can drag and drop files for uploading, and Unicode support for the file names is implemented.

Below is a table where you can find detailed information about the differences between the two transfer methods.

NOTE: Please note that Web client and Ad hoc contacts can transfer only up to 2 GB in a single file transfer in HTTP mode. The MassTransit Assistant plug-in does not have such a limitation.

The MassTransit Web Assistant plug-in needs to be downloaded and installed by the Web client or the Ad hoc contact the first time they log into the MassTransit web site. After that, they will not be prompted to install it again unless the MassTransit server is upgraded.

If the installed plug-in version is not compatible with the MassTransit server version, the user will be prompted to download and install the newer version. Otherwise, the user will be able to transfer files only with HTTP.

NOTE: If you are using a plug-in version 6.1.1 or higher, you will be able to transfer files with MassTransit 7 without performing an upgrade. If you want to use the latest features of MassTransit 7, upgrade to the most recent plug-in.

As mentioned above, sending files with the MassTransit Web Assistant plug-in can be performed only by Web client and Ad hoc contacts that have installed it on their machine and are logged into the web site of your MassTransit HP server.

MassTransit 7.1 allows multiple addresses to be entered as file recipients. In order for the Web client or Ad hoc contacts to be able to use this feature, they need to upgrade their MassTransit plug-in to 7.1.x or later.

The contacts can observe the file transfers in the Status tab of the plug-in. They can also see a log of the transfers in the Log tab of the plug-in. For more information about using the plug-in, see the Web Client User Guide.

When you receive files sent with the MassTransit Assistant plug-in, you can observe the file transfer(s) in the Status window and you can see summary information about the transfers in the Log window of the MassTransit Administrator application. In addition, you can designate services and/or actions that you have configured on the server, to be performed on the received files in the Files window of the MassTransit Administrator application.

The transfer speed obtained with the plug-in is a few times higher than the HTTP(HTTPS) transfer speed since the plug-in uses the specially designed for MassTransit communication protocols - TCP/IP, TCP/IP Secure, and UDT.

Please note that using a secured connection may slow down the transmission speed. When you encrypt the files with methods that use a higher level of encryption, the file transfers are more secure but that increases the time for the transmission.

The transferred files are being received in the Received folder of the contact's mailbox.


Go to top

In order to enable your Web client and/or Ad hoc contacts to transfer files via HTTP, you need to configure the feature on the server first. See instructions how to enable HTTP transfers below.

NOTE: In MassTransit 7.1, the HTTP transfer mode is enabled by default.

After that, the contacts can easily switch to use HTTP (and back to plug-in) when they are logged into the MassTransit web site.

If you want to, you can secure your entire traffic of the web server by configuring it to use secure sockets (SSL). Instead of communicating on the default web port (80), your web server will use the default secure port (443). In this case, when the Web client and/or Ad hoc contacts use HTTP to transfer files, they will be actually using HTTPS. Find detailed information about how to secure your web traffic on the Secure MTWeb Configuration page.

In order to configure HTTP transfers, follow these steps:

    1. Open the mtweb.ini file in an application suitable for plain text edit. By default, the file is located inside the MTWeb folder:
         a. for 32-bit machines, the default location of the MTWeb folder is:
            i. MassTransit HP 7.0 – ~\Program Files\Group Logic\MassTransit Server 7\MTWeb
            ii. MassTransit HP 7.1 and later – ~\Program Files\Group Logic\MassTransit Server\MTWeb
         b. for 64-bit machines, the default location of the MTWeb folder is:
            i. MassTransit HP 7.0 – ~\Program Files (x86)\Group Logic\MassTransit Server 7\MTWeb
            ii. MassTransit HP 7.1 and later – ~\Program Files (x86)\Group Logic\MassTransit Server\MTWeb

NOTE: All lines beginning with ";" in the mtweb.ini file are considered commented and therefore ignored. You must uncomment all lines mentioned in the steps below.

    2. Under the "FILE TRANSFER" area of the mtweb.ini file, change the line beginning with "HTTP_TRANSFER_ALLOWED =" as shown below:
         HTTP_TRANSFER_ALLOWED = "true"

    3. Verify the line beginning with "HTTP_STAGING_FOLDER =" is set to the path of your php\tmp folder:
         HTTP_STAGING_FOLDER = "C:\php\tmp\"

    4. Set the desired file transfer option to be the default one. Choose between "plugin" and "http":
         a. if you want to use the plug-in by default, set the "DEFAULT_FILE_TRANSFER_TRANSPORT =" setting to:
            DEFAULT_FILE_TRANSFER_TRANSPORT = "plugin"
         b. if you want to use HTTP by default, set the "DEFAULT_FILE_TRANSFER_TRANSPORT =" setting to:
            DEFAULT_FILE_TRANSFER_TRANSPORT = "http"

    5. Save and close the mtweb.ini file.

When you have enabled HTTP transfers on the MassTransit server, the Web client and Ad hoc contacts can use it to send files to the server and other contacts and to download files from the server.

MassTransit 7.1.x and later allows multiple addresses to be entered as file recipients.

Web client and Ad hoc contacts can find detailed information about how to transfer files in the Web Client User Guide.

When you receive files sent via HTTP, you cannot observe the file transfer(s) on the server but you can see summary information about the transfers in the Log window of the MassTransit Administrator application. In addition, you can designate services and/or actions that you have configured on the server, to be performed on the received files in the Files window of the MassTransit Administrator application.

Please note that using a secured connection may slow down the transmission speed. When you encrypt the files, the file transfers are more secure but that increases the time for the transmission.

The transferred files are being received in the Received folder of the contact's mailbox.


Go to top

MassTransit 6.0.2 and later support transfers of files and folders with Unicode characters in TCP/IP, TCP/IP Secure, and UDT file transfers. By default, MassTransit will queue and transfer files and folders with high Unicode (>0xFF) successfully across the MassTransit protocol (TCP/IP, TCP/IP Secure, and UDT connections).

See the Transferring Files page for more information on the MassTransit Unicode support.


Go to top

Ad hoc file transfer allows Web client contacts to send files to users designated by email addresses that may or may not already have accounts in MassTransit. After logging in to the MassTransit Web (MTWeb) site, Web client users are allowed to send files to any valid email address. When the Web client clicks on the "Send" button, the files are sent to the MassTransit server. If the entered email address does not belong to an existing contact on the server, an account with that address is automatically created. If you have a limited Web client contact licenses, the automatically created contact will be an Ad hoc contact. Otherwise, the created contact will be a Web client contact.

See the Ad Hoc Delivery page for more information and configuration instructions.


Go to top

MassTransit 7 provides a new feature called Request Files. It allows Web client users to request files to be sent to them from other users designated by email addresses. After logging in to the MassTransit Web (MTWeb) site, the web client users are allowed to send a request to any valid email address. If the entered email address does not belong to an existing contact on the server, an account with that address is automatically created.

See the Request Files page for more information and configuration instructions.


Go to top

MassTransit web users may be repeatedly prompted to Enter Network Password when attempting to access a MassTransit file transfer website hosted by Microsoft IIS. This dialog may appear prior to the display of any MassTransit web content, and may repeatedly appear throughout the user’s MassTransit web session.

Users attempting to access a MassTransit file transfer website hosted on Microsoft IIS may be prompted with a Windows authentication dialog if the MassTransit website permissions have not been configured to allow Anonymous access. As a result, a dialog box asking "Enter Network Password" may appear throughout the web session.

To resolve this behavior, Microsoft IIS must be configured to allow Anonymous access.

Follow the steps below for enabling Anonymous access on IIS depending on the IIS version you have.


Go to top

To enable Anonymous access on IIS 6:

    1. Launch the Internet Information Services (IIS) Management Console from Start → Administrative Tools → IIS Manager.

    2. Right-click on the MassTransit website instance and select the Properties option.

    3. Open the Directory Security tab on the Web Site Properties window that appears.

    4. Click on the Edit... button from the Authentication and access control area.

    5. In the Authentication methods window that appears, check the Enable Anonymous Access check box.

    6. Click on the Browse... button next to the User name field and select the IUSR_COMPUTERNAME account (this is the Internet Guest User account; COMPUTERNAME is the name of your computer). Then, click OK.

    7. The IUSR_COMPUTERNAME account appears in the User name field. Enter the corresponding for the account password in the Password field.

    8. Click OK in the Authentication methods window.

    9. Click OK again to save the changes and close the web site's properties.

   10. Restart IIS.

NOTE: The Internet Guest User account begins with "IUSR_" and may also need to be enabled within the Users and Groups Management Console.

The Anonymous access should be enabled and the web client users (Web client and Ad hoc contacts) should not be prompted to Enter Network Password.


Go to top

To enable Anonymous access on IIS 7:

    1. Launch the Internet Information Services (IIS) Management Console from Start → Administrative Tools → IIS Manager.

    2. Click on the MassTransit website instance from the Connections pane of the IIS Manager.

    3. Double click Authentication from the Home pane.

    4. Highlight Anonymous Authentication from the list with authentication methods and click on the Enable option from the Actions pane.

    5. Restart IIS.

NOTE: The Internet Guest User account begins with "IUSR_" and may also need to be enabled within the Users and Groups Management Console.

The Anonymous access should be enabled and the web client users (Web client and Ad hoc contacts) should not be prompted to Enter Network Password.


Go to top