Tracking

MassTransit helps you keep track of each event and file received and sent. There are a few options for tracking:

• Log – the Log window in the MassTransit Administrator keeps a record of each event as you contact others, move files, and process them in applications. To help you use the Log window to trouble-shoot, the Log window records the name of the user that launched MassTransit.
• Files – the Files window of the MassTransit Administrator keeps running lists of files that you have received and sent to each contact.
• Status – the Status window in the MassTransit Administrator shows the status of all configured MassTransit listens, the available disk space for your user mailboxes, information about the bandwidth throughput, and status of the current connections.
• Log Viewer – the Log viewer allows you to track information from the Log window of the MassTransit Administrator application. The Log window keeps a record of each event as users contact others, move files, and process them in applications. To help you use the Log viewer to trouble-shoot, the Log viewer records the name of the user that launched MassTransit if permitted to. For contacts with Log viewing privileges, the MassTransit Web interface will have a “View Log” tab.
• Reports – Reports is a feature which can be used through the MassTransit Web interface. It allows contacts to see reporting information based on privileges that are granted from the MassTransit Administrator contact information settings. For contacts with reporting privileges, the MassTransit Web interface will have a “Reports” tab.
• Perfmon tool – MassTransit supports the standard Windows Management Instrumentation (WMI) interface that allows system administrators to monitor MassTransit servers in production environments as well as diagnose problems.

Detailed information about the each of the tracking options and how to use them is displayed below.


Go to top

The Log window in the MassTransit Administrator application displays information about configured settings, available disk space, connections statuses, occurred errors, and warnings. You can also see summaries of the file transfers containing the number of the transferred files, the total size of the files, and the transfer time.

To open it:

    a. Open the Window main menu and click on the Log option.

-OR-

    b. Click on the Log button from the Navigation Bar.


Go to top

In the Log window, you can filter the log entries to see the ones that are for a particular contact, severity, or entry type. You can also delete all log entries or just the selected ones.

Below is a list of all available actions in the Log window:

    1. Resume Updates – if you have highlighted a row from the Log window, new entries will not be displayed until you resume updating the table. For this purpose, click on the Resume Updates button and the table will be updated.

    2. Filter by:
         a. contacts – select a particular contact from the contacts list in the Who drop-down menu under the Filters area;
         b. severity of the entry – select a severity type from the Severity drop-down menu under the Filters area. The available options are:
            i. All – displays the entries of all severity types;
            ii. Error – displays only errors;
           iii. Warning – displays only warning messages;
            iv. Info – displays only information entries;
         c. entry type – select an entry type from the Type drop-down menu under the Filters area. The available options are:
            i. All – shows all entries of all types;
            ii. Error – displays error entries;
           iii. Connect – displays connection entries which show information about the type of the connection (manual or automatic), when a connection has been established/dismantled, and whether the file transfer has began/ended;
            iv. Transfer – these entries show information about each of the transferred files – file name, size, transfer time, average bandwidth throughput, and cyclic redundancy check (CRC);
            v. Output – log entries with information regarding services execution;
            vi. Spooling – displays printer processing messages;
           vii. Notification – all other messages that do not regard the rest of the described options;
           viii. Summary – shows summaries of the file transfers including number of transferred files, total transferred file size, average bandwidth throughput, and total transfer time;
            ix. Info – displays information about configuration settings like available disc space, remote administration configuration, IP address of your server, database, etc.
    The displayed results are the ones that satisfy the conditions from all filters.

    3. Copying the log contents – you can select and copy sections of the log to the clipboard as tab-delimited text to use in other programs. It may take a long time to copy multiple log entries.

    4. Managing outdated log entries – because the Log window records all significant MassTransit events, the list can become long and unwieldy. A long log list may slow MassTransit down. You can remove log entries that no longer have any relevance to you. You can either delete selected entries manually or set MassTransit to remove entries automatically once they reach a certain age. You can also remove entries using scripts. Entries are purged daily as they exceed this number. You can set up a script which warns you before the log is purged and delete records of your choosing before the purge takes place.
         a. To remove log entries manually, follow these steps:
            i. to remove all log entries – click on the Remove Displayed Entries button under the Maintenance area of the window.
            ii. to remove selected entries only:
               - highlight the entries you want to delete (Press Shift and click to select multiple nonadjacent entries. You can also press Control and click to select/deselect an individual entry.) and click on the Remove Selected Entries button under the Maintenance area.
               - OR -
               - display the log entry or entries you want to remove using the filters, then click Remove Displayed Entries.
         b. To remove log entries automatically, follow these steps:
            i. Open the Setup window of the MassTransit Administrator by clicking on the Setup button from the Navigation Bar or by selecting the Setup... option from the Window main menu.
            ii. Open the Special tab of the Setup window.
           iii. From the Log and File Handling section, select the Clear Log Entries Older Than __ Days checkbox and type an age in days.

            iv. Click OK to save the changes.


Go to top

By default, popup dialogs appear for messages written to the MassTransit log. To disable all popup dialogs for messages written to the MassTransit log, follow these steps:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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: Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.

    2. Set the following setting to TRUE in order to disable ALL popup dialogs that appear for messages written to the MassTransit log. Messages that are not written to the MassTransit log will continue to be displayed in dialogs.
         DISABLE_DIALOGS_FOR_LOGGED_MESSAGES = TRUE

    3. Save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.


Go to top

If you want to, you can configure all error entries from the Log window to also be logged to syslog() or EventViewer. This configuration can be set in the MassTransit.cfg file:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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: Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.

    2. Set the following setting to true in order to enable logging the error entries from the MassTransit Log to syslog() or EventViewer:
         log_errors_to_syslog = true

    3. Save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.

Go to top

%% NETWORK_MONITOR_WHITELIST = 127.0.0.1

When this setting is enabled, spurious connections from the given IP address will not be logged in MassTransit or treated as errors. This is useful if there is a network monitoring probe checking periodically to verify MassTransit is listening on specific ports. This setting is located in the MassTransitEngine.cfg file. Normally you can find the file here:

• on 32-bit machines:
  • MassTransit HP 7.0 – C:\Program Files\Group Logic\MassTransit Server 7
  • MassTransit HP 7.1 and later – C:\Program Files\Group Logic\MassTransit Server
  • MassTransit SFTP 7.0 and later-- C:\Program Files\Group Logic\MassTransit SFTP
• on 64-bit machines:
  • MassTransit HP 7.0 – C:\Program Files (x86)\Group Logic\MassTransit Server 7
  • MassTransit HP 7.1 and later – C:\Program Files (x86)\Group Logic\MassTransit Server
  • MassTransit SFTP 7.0 and later – C:\Program Files (x86)\Group Logic\MassTransit SFTP

You will need to uncomment the setting by removing the '%%' before it can take effect.

NOTE: When you make changes to the MassTransit configuration files you need to restart the MassTranist services for the changes to take effect. The correct way to do this operation is to stop the MassTransit Engine service, restart the MassTransit Transporter and start the MassTransit Engine again.

Go to top

When you have set automatic removing of log entries (step 4a above), you can make changes to the MassTransit.cfg file to control the interval of deleting the log messages concerning low disk space:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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

    2. Locate the Log/File Aging [in seconds] section and configure the desired settings. This section controls how often and how long garbage collection of log and job browser records occurs. Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.
         a. LOG_AGE_INTERVAL = – configure this setting (in seconds) to set at what interval the log entries should be removed from the list;
         b. LOG_AGE_DURATION = – configure this setting (in seconds) to set how long the log entry removing should last.

    3. Save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.


Go to top

You can configure warning log messages to appear in the Log window of the MassTransit Administrator when the mailbox or database disk space(s) is/are running out of free space.
These settings can be configured in the MassTransit.cfg configuration file. The file is located in the MassTransit installation directory, by default:

• on 32-bit machines:
  • MassTransit HP 7.0 – C:\Program Files\Group Logic\MassTransit Server 7
  • MassTransit HP 7.1 and later – C:\Program Files\Group Logic\MassTransit Server
  • MassTransit SFTP 7.0 and later-- C:\Program Files\Group Logic\MassTransit SFTP
• on 64-bit machines:
  • MassTransit HP 7.0 – C:\Program Files (x86)\Group Logic\MassTransit Server 7
  • MassTransit HP 7.1 and later – C:\Program Files (x86)\Group Logic\MassTransit Server
  • MassTransit SFTP 7.0 and later – C:\Program Files (x86)\Group Logic\MassTransit SFTP

To set a mailbox disk space threshold which will trigger the warning message:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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

    2. Locate the Free disk space warning thresholds [in MB] section and set the desired settings:

NOTE: Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.

         a. mailbox_disk_space_threshold = 10 – a mailbox disk space threshold in MB (Megabytes); it will trigger a warning message in the Log window when only the configured number of Megabytes are left free on the disk.
         b. database_disk_space_threshold = 10 – a database disk space threshold in MB (Megabytes); it will trigger a warning message in the Log window when only the configured number of Megabytes are left free on the disk.

    3. In addition, you can configure an interval in minutes between the disk space warnings by enabling:
         a. disk_message_interval = 30 – this interval will determine the minimum time in minutes between logging messages and firing actions when the disk space is low.

    3. When you have configured the desired settings, save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.


Go to top

When you use the MassTransit server for communicating with servers on long distances, it is very useful to convert the date and time to the local ones in order to assure that actions, configured to trigger at particular time, will not start earlier or later than planned. For this purpose, you can enable a setting from the MassTransit.cfg file and then, all dates given in the MassTransit log will be converted to the local time.

To enable the time conversion to the local time:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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

    2. Locate the Date/Time conversions section set the following setting to TRUE:

NOTE: Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.

         DO_LOCAL_TIMEZONE_CONVERSION = TRUE

    3. When you have configured the setting, save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.


Go to top

The Files window in the MassTransit Administrator application shows all files that are sent, received, or waiting to be sent, on the server or for a particular contact, as well as information about the files themselves - file size, transmission date, contact name, set priorities, and requested services.

To open it:

    a. Open the Window main menu and click on the Files option.

-OR-

    b. Click on the Files button from the Navigation Bar.


Go to top

In the Files window, you can filter your contacts in order to see only the files that are sent, received, or waiting to be sent for a particular contact. In addition, you are allowed to connect to contacts, to create job tickets and attach them to the files, to reveal mailboxes in Windows Explorer. The job tickets provide detailed information about the transmission, the transmitted files, shipping and billing information, etc.

INFO: See the Job Tickets page for more information about job tickets.

All actions available in the Files window are listed below:

    1. Filter the displayed files by contact – select a contact from the User Filter drop-down menu and the files to send, sent, and received from that contact will be displayed in the To Send, Sent, and Received tabs respectively.

    2. Designate files for sending – there are two ways to designate files to send to a contact in the Files window:

NOTE: Designating files in the Files window is available on MassTransit HP servers only.

         a. Drag and drop the files in the To Send tab of the window.
         b. Select a contact from the User Filter drop-down menu and click on the Add Files... button. Then, browse for the files, select them and add them to the list.

    3. Connect to a Server contact – select the desired Server contact from the User Filter and click on the enabled Connect button.

NOTE: This action is available on MassTransit HP servers only.

    4. Update the information displayed in the Files window – click Resume or close and reopen the Files window.

    5. Reveal contact's mailbox in Windows Explorer – select a contact that has files in any of the tabs of the Files window or highlight a file and click on the Reveal in Explorer button.

    6. Add job ticket – highlight a file and click on the Add... button. This will display the Job Ticket window. Enter the desired information in it and click on the OK button.

INFO: Find more information about job tickets and how to configure them on the Job Tickets page.

NOTE: This action is available on MassTransit HP servers only.

    7. Select a priority for sending of the files – highlight a designated file from the To Send tab and select a predefined priority from the Priority drop-down menu.

INFO: Find detailed information about configuring priorities in the Setting Priorities for Sending Files section of the Transferring Files page.

NOTE: This action is available on MassTransit HP servers only.

    8. Select services to be performed for a file – in the Received tab, highlight a file and select a service from the Services drop-down menu. The selected service will be displayed in the Requested Service column of the files table.

INFO: Find detailed information about configuring services on the Services page.

NOTE: This action is available on MassTransit HP servers only.

    9. Process a service – highlight a file from the Received tab of the window, select a service if there is not a selected one, and click on the Process button.

NOTE: This action is available on MassTransit HP servers only.

   10. Filter the received files by the status of the assigned services – in the Received tab of the Files window, select a service status from the Status Filter drop-down menu. You can filter the files by the following statuses:

         a. All – displays all files.
         b. All Not Completed – displays all files that haven't been processed by a service.
         c. Holding – displays all received files.
         d. Error – displays all files that an error has occurred on during a service execution.
         e. Queued – displays the files which are queued to a service.
         f. Processing – displays the files which are being currently processed by a service. The files processing is quite fast so you may not see any files if this filter is selected.
         g. Completed – displays all files that a service has been completed on.

   11. Remove files from MassTransit – there may be times when you want to remove a file from your system, either without processing it or after you have already processed it and sent a copy to your contact. Or, the list of files you’ve sent may be too long and you may want to reduce it. A long file list may slow MassTransit down. Whenever you remove a file from one of MassTransit’s default locations (for example, a received file in the Received tab or folder or a file for sending in the To Send tab or folder), MassTransit asks you if you want to move files to the trash. However, if you remove a file that is in a custom mailbox folder, only its name is removed from the list; the file and its location remain unchanged. If you want to delete or move such a file, you must do so using the Windows Explorer. If you want to remove only entries for files that have already been sent or for received files that have already been processed, you can have MassTransit remove those entries automatically. This automatic deletion does not affect entries for files that are waiting to be sent or entries for files that have been received and not processed. Furthermore, automatic deletion does not delete the files themselves. You need to remove the files manually. Automatic file-entry deletion only affects entries in the Files window.
         a. To remove a file from MassTransit manually, follow these steps:
            i. In the Files window, select a file you want to remove from any tab.
            ii. Press Shift and click to select multiple nonadjacent files. You can also press Control and click to select/deselect an individual file. To select all, choose Select All from the Edit main menu, or press Control+A.
           iii. Click on the Remove button. If the file you are removing is in the default mailbox folder, MassTransit asks whether to move the file to the Trash. Select one of these or click Cancel. If the file you are removing is not in its default location, clicking Remove eliminates the item from the list, but leaves the file itself in its current location.
         b. To remove files entries automatically, follow these steps:
            i. Open the Setup window of the MassTransit Administrator by clicking on the Setup button from the Navigation Bar or by selecting the Setup... option from the Window main menu.
            ii. Open the Special tab of the Setup window.
           iii. From the Log and File Handling section, select the Clear File Entries Older Than __ Days checkbox and type an age in days.

            iv. Click OK to save the changes.


Go to top

When you have set automatic removing of files (step 11b above), you can make changes to the MassTransit.cfg file to control the interval of deleting the files concerning low disk space:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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

    2. Locate the Log/File Aging [in seconds] section and configure the desired settings. This section controls how often and how long garbage collection of log and job browser records occurs. Settings with a '%%' preceding them are not enabled.
         a. FILE_AGE_INTERVAL = – configure this setting (in seconds) to set at what interval the file entries should be removed from the Files window;
         b. FILE_AGE_DURATION = – configure this setting (in seconds) to set how long the file entry removing should last.

    3. Save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.


Go to top

If you need to, you can configure automatic removing of queued (To Send) file entries when the files cannot be found. Enabling automatic removing can avoid repeated errors if forwarded or programmatically added files are removed from their source locations.

To configure automatic removing of missing queued files:

    1. Open the MassTransit.cfg in an application suitable for plain text editing. 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

    2. Locate the Missing Queued Files Settings section.

NOTE: Settings with a '%%' preceding them are not enabled. Delete the '%%' symbols at the front of the line in order to activate the settings.

    3. Configure the following setting:

         PURGE_TO_SEND_RECORDS = TRUE – setting this option to TRUE enables the automatic removing of missing queued file entries from the Files window; when set to FALSE, MassTransit will not remove the file entries from the To Send queue.

NOTE: If the queued files are on remote volumes, enabling this will unqueue the files permanently if the remote volume is inaccessible.

    3. Save and close the MassTransit.cfg file.

    4. Restart the MassTransit services in order to apply the changes immediately:
         a. Go to Start → Control Panel → 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.


Go to top

The Status window in the MassTransit Administrator application shows the status of all configured MassTransit listens, the available disk space for your user mailboxes, information about the bandwidth throughput, and status of the current connections.

To open it:

    a. Open the Window main menu and click on the Status... option.

-OR-

    b. Click on the Status button from the Navigation Bar.

The Status window displays the status of all created MassTransit listens – whether they are active or not (Idle). It also provides information about the IP address and port number that the particular listen is using.

You can observe the status of the connection between your server and a particular contact:

When the file transfer begins, you will be able to observe the progress of the transmission:
    A. If you are sending files:

    B. If you are receiving files:

In addition, you can observe the expected throughput and the actual throughput of the connection bandwidth if you have configured bandwidth throttling:

The Status window of the MassTransit Administrator gives you information about the available disk space on the drive where the database and user mailboxes are configured respectively.

Go to top

In the Status window, you can enable and disable listens, edit the setup, and observe the connections statuses and the file transfers.

All actions available in the Status window are listed below:

    1. Enable a listen – highlight an inactive listen (Idle status) from the list in the Status window and click on the Start Listening button. The listen status should change from Idle to:
         a. for a TCP/IP, TCP/IP Secure, and UDT listens – Waiting for a call...
         b. for an FTP Server listen – Waiting for FTP connection
         c. for an SFTP Server listen – Waiting for SFTP connection
         d. for Hot Folder and FTP Client – Periodically checking for files...

    2. Disable a listen – highlight an active listen from the list in the Status window and click on the Stop Listening button. A dialog box for confirmation of the operation appears – click Disable if you are sure you want to disable the listen. After that, the listen status would change to Idle.

    3. Edit Setup – click on the Edit Setup... button. The Setup window appears and you can change any settings you want to. If you change the Outgoing Calls settings, the changes should reflect on the Status window.

INFO: For more information about configuring outgoing calls, see the Communications page.

Go to top

NOTE: The Log Viewer feature is not available on MassTransit SFTP servers.

The Log Viewer feature allows Web client contacts to see information from the Log window (through the MassTransit Web interface) based on privileges that are granted from the MassTransit Administrator contact information settings. For contacts with log viewing privileges, the MassTransit Web interface will have a "View Log" tab.

Depending on the assigned privileges, the Web client contact will be able to see all log entries of the Log window or only log entries for specified contacts. In addition, there are filters which can be set for displaying the information in a more convenient view and an option for auto-refreshing the displayed log entries.

When you have set filters in the Log Viewer click Find, the displayed results are the ones that satisfy the conditions from all filters.

The available in the Log Viewer filters are the following:

    1. View Only filters:
         a. Contacts – setting this filter displays log entries only for the specified contact (or a group of contacts); the available options in this drop-down menu are All and the contacts that you have privileges to see information about;
         b. Type – filters all entries of the specified type; these are the available types:
            i. All – shows all entries of all types;
            ii. Error – displays error entries;
           iii. Connection – displays connection entries which show information about the type of the connection (manual or automatic), when a connection has been established/disconnected, and whether the file transfer has begun/ended;
            iv. File Transfer – these entries show information about each of the transferred files – file name, size, transfer time, average bandwidth throughput, and cyclic redundancy check (CRC);
            v. Output – log entries with information regarding services execution;
            vi. Spooling – displays printer processing messages;
           vii. Notification – all other messages that do not regard the rest of the described options;
           viii. Summary – shows summaries of the file transfers including number of transferred files, total transferred file size, average bandwidth throughput, and total transfer time;
            ix. Info – displays information about configuration settings like available disc space, remote administration configuration, IP address of your server, database, etc.;
         c. Severity – filters all entries of the specified severity:
            i. All – displays the entries of all severity types;
            ii. Error – displays only errors;
           iii. Warning – displays only warning messages;
            iv. Info – displays only information entries.

    2. View Entries Dated Between filters:
         a. Start Date – enter a date or select one from the calendar next to the field to filter all entries from the specified start date to the present date (or to the End Date, if specified);
         b. End Date – enter a date or select one from the calendar next to the field to filter all entries to the specified end date;
         c. Common Dates – for faster setting of a time interval, you can select from this drop-down menu one of the following options:
            i. Today – displays all entries from today only;
            ii. Yesterday – displays all entries from yesterday;
           iii. Last 7 Days – displays all entries for the last 7 days;
            iv. Last 14 Days – displays all entries for the last 14 days;
            v. Last 30 Days – displays all entries for the last 30 days;

    3. Search Text – enter some text in this field if you want to filter all log entries that contain the entered text.

When you have set the desired filters, click on the FIND button to display the filtered information.

If you want to reset all set filters, just click on the RESET ALL button.


The Log Viewer has an option for auto refreshing the displayed log information in real time. By default, the option is disabled but you can enable it by clicking on the On radio-button in the REAL-TIME REFRESH area of the "View Log" tab:

To disable auto refreshing of the Log Viewer, click on the Off radio-button.


Go to top

You can customize the user interface of the "View Log" tab in the MassTransit web site. 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 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

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

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

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

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

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

    9. Restart the Internet Information Services (IIS) from the IIS Manager in order to apply the changes immediately.

INFO: For more customizations of the MassTransit Web user interface, please refer to the MTWeb page.

Go to top

As mentioned above, only Web client contacts can use the Log Viewer feature and since it is configurable per contact, you need to perform the following steps for every contact that would use the feature.

To configure a contact to use Log Viewer:

    1. In the MassTransit Administrator, open the Contacts window by clicking on the Contacts button from the Navigation Bar or by selecting the Contacts option from the Window main menu.

    2. In the Contacts window, highlight a Web client contact to be configured to use the Log Viewer feature and click on the Edit... button.

    3. In the Contact Information window that appears, open the Security tab.

    4. Under the Web Privileges area of the Security tab, check the Allow User To Access Log check box and click on the Configure... button. This will allow the user to view ALL log entries. If you want to restrict the displayed in his user interface log entries to specified contacts only, continue with the steps below. Otherwise, skip to step 6.

    5. To limit the displayed to the Web client contact log entries:
         a. Check the Limit Log To Listed Contacts check box from the Web Privileges area as shown below:

         b. Then, specify the desired contacts that the user will be able to see log entries for from the Web Log & Files Limit Contact List area:

            i. To choose the desired contacts, select them from the Add: drop-down menu;
            ii. To remove contacts from the list, select them from the Remove drop-down menu.

    6. When you are ready with the contact configuration, click on the OK button to save the changes.

The edited Web client contact will be able to view the defined log entries the next time he/she logs into the MassTransit web site. The log information will be displayed in the View Log tab of the contact's user interface.


Go to top

NOTE: The Reports feature is not available on MassTransit SFTP servers.

The Reports feature allows Web client contacts to see reporting information (through the MassTransit Web interface) based on privileges that are granted from the MassTransit Administrator contact information settings. For contacts with reporting privileges, the MassTransit Web interface will have a “Reports” tab.

The available Reports are:

• Server summary reports:
  • Contact Expiration – displays a complete list of contacts that have expired or will expire in the next 30 days;
  • Contact List – displays a complete list of contacts with configuration;
  • Contacts by Type – lists all active contacts and their type;
  • Database Analysis – displays detailed analysis of DBMS performance, memory usage, and configuration;
  • Error Summary – displays file transfer and connection errors grouped by error;
  • File Summary – displays a high level view of files in the system including number and size of files to send, sent, and received;
  • Server Summary – displays a high level view of MassTransit server configuration and status;
• Status reports:
  • Bandwidth and Thruput Over The Last 24 Hours – comparison of raw network I/O vs. throughput (including compression) during the previous 24 hours;
  • MassTransit Performance Counters – display of various MassTransit performance counters during the previous 24 hours;
  • Server Performance Over the Last 24 Hours – overview of key server functions such as open connections, SQL server performance, and bandwidth usage over the previous 24 hours;
• Usage reports:
  • Most Active Contacts by Bytes Transferred – shows top 25 active contacts based on number of bytes transferred;
  • Most Active Contacts by Files – shows top 25 active contacts based on number of files transferred;
  • Usage Details – server usage by hour of day, day of week, and monthly;
• Contact-based reports:
  • Files Transferred by Contact – lists all files sent and received by a single contact within specified period;
  • Usage by Contact – number and size of files sent and received by specified contacts.

In addition, you can filter the displayed in the reports data by for a selected period.

Go to top

Database reports are not enabled by default. If you want to set contacts to see database reports, you need to enable them from the mtweb.ini configuration file. By default, the mtweb.ini file is located in the following location:
    ~\MassTransit Server\MTWeb

To enable database reports, follow these steps:
    1. Open the mtweb.ini file in an application suitable for plain text editing.

    2. Locate the REPORTING DATABASE CONFIGURATION section and configure the following settings as shown below:
         a. Uncomment the REPORTING_DB_USER setting (delete the semi colon (;) at the beginning of the line) and set it to the MassTransit database user (by default, this is the masstransit user):
            REPORTING_DB_USER = "masstransit"
         b. Uncomment the REPORTING_DB_PASSWORD setting (delete the semi colon (;) at the beginning of the line) and set it to the password for the MassTransit database user:
            REPORTING_DB_PASSWORD = "password"

    3. Save and close the mtweb.ini file. The next time the Web client contacts that are configured to use database reports log into the MassTransit web site, they will be able to see them on the "Reports" tab of their user interface.

    4. Restart the Internet Information Services (IIS) from the IIS Manager in order to apply the changes immediately.


Configure reports from a secondary database:
By default, the web reporting interface will use the DB_HOST, DB_NAME, DB_USER, and DB_PASSWORD settings from the DATABASE SERVER section of the mtweb.ini file. The Reports feature can be configured to report from a live MassTransit database, or a secondary copy of the database. The secondary database copy must have the same database schema as the live database. To configure reporting to work from a secondary database, edit the information in the mtweb.ini file. If the secondary information is not filled in, or not valid, MassTransit Web will report using the live database server configuration.

    1. In the mtweb.ini file, locate the REPORTING DATABASE CONFIGURATION section.

    2. Uncomment (delete the semi colon (;) at the beginning of the line) and configure the following settings:
         a. REPORTING_DB_HOST = "localhost" – set it to the secondary database host address;
         b. REPORTING_DB_PORT = 3306 – if needed, configure this setting to the port for accessing the secondary database;
         c. REPORTING_DB_NAME = "mtdatabase" – configure this setting to the name of the secondary database;
         d. REPORTING_DB_USER = "masstransit" – set the user name for accessing the secondary database as a value of this setting;
         e. REPORTING_DB_PASSWORD = "password" – set the password of the user which will access the secondary database.

    3. Save and close the mtweb.ini file.

    4. Restart the Internet Information Services (IIS) from the IIS Manager in order to apply the changes immediately. The next time the Web client contacts that are configured to use database reports log into the MassTransit web site, they will be able to see them on the "Reports" tab of their user interface.

NOTE: The data used to generate reports is based on information gathered and stored in MassTransit 6.0 and later. There is no reporting coverage of information and data gathered previous to the installation of MassTransit 6.0.

Go to top

As mentioned above, only Web client contacts can use the Reports feature and since it is configurable per contact, you need to perform the following steps for every contact that would use the feature.

To configure a contact to use reports:

    1. In the MassTransit Administrator, open the Contacts window by clicking on the Contacts button from the Navigation Bar or by selecting the Contacts option from the Window main menu.

    2. In the Contacts window, highlight a Web client contact to be configured to use the Reports feature and click on the Edit... button.

    3. In the Contact Information window that appears, open the Security tab.

    4. Under the Web Privileges area of the Security tab, check the Allow User To Access Reports check box and click on the Configure... button.

    5. The Configure Reporting window appears:

    6. Choose which reports to be available for the contact by selecting one of the following radio buttons:
         a. Allow user to run all reports including server summaries – selecting this radio button will enable the user to use all available reports;
         b. Restrict user to contact-based reports – selecting this option will restrict the available reports to the contact-based ones (Files Transferred by Contact and Usage by Contact reports); you can also restrict the available to the user contact reports to reports for defined users only instead of allowing them to see reports for all existing users – for this purpose, do the following:
            i. check the Limit contact-based reports to the contacts listed check box;
            ii. from the Add drop-down menu, select the contacts that the user will be able to see contact information for; to remove contacts from the list, select them from the Remove drop-down menu.

    7. When you are ready with the reporting configuration, click on the OK button to save the changes.

    8. Click OK in the Contact Information window.

The edited Web client contact will be able to run the defined reports the next time he/she logs into the MassTransit web site. The reports will be displayed in the Reports tab of the contact's user interface.


Go to top

The statistics table of the database stores information used to populate the MassTransit reports. To control the size of this data, the data can be purged after a period of time. It can also be folded, reducing the size of the table but also losing some granularity – some data will be condensed into 1 hour chunks.

You can configure the database statistics purging and folding settings, by modifying some of the options in the MassTransitEngine.cfg file. Normally you can find the file here:

• on 32-bit machines:
  • MassTransit HP 7.0 – C:\Program Files\Group Logic\MassTransit Server 7
  • MassTransit HP 7.1 and later – C:\Program Files\Group Logic\MassTransit Server
• on 64-bit machines:
  • MassTransit HP 7.0 – C:\Program Files (x86)\Group Logic\MassTransit Server 7
  • MassTransit HP 7.1 and later – C:\Program Files (x86)\Group Logic\MassTransit Server

To configure the database statistics folding and purging settings, follow these steps:

    1. Open the MassTransitEngine.cfg in an application suitable for plain text edit.

    2. Locate the "Database Statistics Folding and Purging 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.

         a. settings for purging the database statistics:
            i. DATABASE_STATS_TABLE_PURGING_ENABLED = TRUE – defines whether the statistics table should be purged; the default is TRUE;
            ii. DATABASE_STATS_TABLE_PURGE_TIME_MONTHS = 18 – defines after how many months the records in the statistics table should be purged; the default is 18 months;
         b. settings for purging the database statistics:
            i. DATABASE_STATS_TABLE_DATA_FOLDING_ENABLED = TRUE – defines whether the statistics table should be folded; the default is TRUE;
            ii. DATABASE_STATS_TABLE_DAYS_TO_FOLD_AFTER = 90 – defines after how many days statistics will be folded (if folding is enabled); the default is 90 days;
         c. DATABASE_STATS_TABLE_FOLD_TIME = 3:00 – defines at what time of day statistics folding and purging should occur; the default is 3:00 am; the format of the time is h:mm, using 24-hour time (so 0:00 for midnight, 3:00 for 3 am, 12:00 for noon, 22:30 for 10:30 pm).

WARNING: It is highly recommended to specify a low-usage time for the server.

    3. When you have configured the desired settings, save and close the MassTransitEngine.cfg file.

    4. 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).


Go to top

NOTE: Perfmon monitoring is not available for MassTransit SFTP servers.

MassTransit 6.0 and later supports the standard Windows Management Instrumentation (WMI) interface that allows system administrators to monitor MassTransit servers in production environments as well as diagnose problems. This is only available on 32-bit operating systems.

MassTransit exposes key data points that reflect its state and performance as performance counters that could be monitored or recorded using standard WMI enabled system management tools, such as the Perfmon utility.


Go to top

To add MassTransit performance counters to the set of counters monitored in Perfmon on Windows 2003, Windows XP, or Windows Server 2008, follow these steps:

    1. To open the Perfmon tool:
         a. on Windows 2003 and XP, go to Start → Control Panel → Administrative Tools → Performance;
         b. on Windows 2008, go to Start → Control Panel → Administrative Tools → Reliability and Performance Monitor.

    2. Right click in the graph panel in the Performance window (Reliability and Performance Monitor window on Windows server 2008) and select Add Counters….

    3. In the Add Counters that window appears, select MassTransit from the Performance object drop-down menu.

    4. Select the desired counters by selecting one of the following radio buttons:
         a. All counters – selecting this radio button will display graphs for all of the following counters:

• Actions Fired – accounts for executed action tasks (e.g. e-mail being sent, script being executed, etc.);
• Active Connections – a 32-bit counter that includes presently open TCP, TCP/Secure, UDT, FTP and Hot Folder connections;
• Active Listens – accounts for listens that are currently listening (FTP client and Hot Folder listens remain active when they are polling);
• Completed Connections – accounts for connections as defined in Active Connections that have been completed;
• Contact Records Added – number of contact records added to the system. Contact Records Added counters will not increment for contacts added through MassTransit Administrator user interface, only through a script interface;
• Contact Records Added / sec – same as Contact Records Added but over time;
• Errors – number of errors reported by MassTransit;
• Failed User Logins – accounts for all failed logins (due to the way authentication is currently implemented in MassTransit / MTWeb (multiple authenticators that fall back on each other) this counter might get incremented for what would eventually be a successful
  login; however, those situations will also result in errors / warnings being logged, etc.; as soon as that original problem is addressed, this counter will reflect failed logins more accurately);
• File Records Added – number of files added to the system. File records added by dragging them to MassTransit Administrator user interface will not increment File Records Added counters;
• File Records Added / sec – same as File Records Added but over time;
• Files Received – accounts for files that are put into the “Received” status (this includes files that are being forwarded after they are received). The Files Received counter only updates after the file transfer session disconnects. If a user is using a remote FTP Client
  to log into MassTransit as an FTP Server, the counter will not update until the user logs off from the FTP Server;
• Files Sent – accounts for files that are being put into the “Sent” status (for files sent to groups, this counter is incremented for the group members as well as the group contact itself). The Files Sent counter only updates after the file transfer session disconnects. If
  a user is using a remote FTP Client to log into MassTransit as an FTP Server, the counter will not update until the user logs off from the FTP Server;
• Log Records Added – total log records added (includes log records added via scripting interfaces);
• Log Records Added / sec – Log Records Added but over time;
• Maximum Active Connections – same as Active Connections, but a “maximum” counter (i.e. never decremented);
• SOAP Calls – how often the MassTransit engine makes a SOAP call;
• SOAP Calls / sec – same as SOAP Calls but over time;
• SQL Commands – number of SQL commands executed by the MassTransit engine. SQL Commands counters will only count SQL commands triggered by the engine, not the MassTransit Administrator or Web Client log viewer;
• SQL Commands / sec – same as SQL Commands but over time;
• Total Bytes Received – represents the total size, in bytes, of all files that have been received (i.e. put into the “Received” status);
• Total Bytes Received / sec – same as Total Bytes Received but over time;
• Total Bytes Transmitted – represents the total size, in bytes, of all files that have been sent or forwarded (i.e. put in the respective status);
• Total Bytes Transmitted / sec – same as Total Bytes Transmitted but over time;
• Total Listens – accounts for all currently defined listens as they are displayed in the Status window of the MassTransit Administrator user interface;
• User Logins – web and application successful logins.

         b. Select Counters From List – selecting this radio button enables the counters list below it so that you can choose the desired counters by highlighting them and clicking on the Add button.

    5. Click the Close button when you have selected the desired counters.

No additional configurations steps or procedures are required.

NOTE: Perfmon's fastest refresh time is 1 second, therefore some counters will not increment if an event occurs in less than 1 second. For example, Connect and Disconnect with no file transfer may occur fast enough to not register on Active Connections counter (but will be counted under Completed Connections counter).

Go to top