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:
Open the Window main menu and click on the Log option.
-OR-
Click on the Log button from the Navigation Bar.
Log Window Options
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:
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.
Filter by:
contacts – select a particular contact from the contacts list in the Who drop-down menu under the Filters area;
severity of the entry – select a severity type from the Severity drop-down menu under the Filters area. The available options are:
All – displays the entries of all severity types;
Error – displays only errors;
Warning – displays only warning messages;
Info – displays only information entries;
entry type – select an entry type from the Type drop-down menu under the Filters area. The available options are:
All – shows all entries of all types;
Error – displays error entries;
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;
Transfer – these entries show information about each of the transferred files – file name, size, transfer time, average bandwidth throughput, and cyclic redundancy check (CRC);
Output – log entries with information regarding services execution;
Spooling – displays printer processing messages;
Notification – all other messages that do not regard the rest of the described options;
Summary – shows summaries of the file transfers including number of transferred files, total transferred file size, average bandwidth throughput, and total transfer time;
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.
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.
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.
To remove log entries manually, follow these steps:
to remove all log entries – click on the Remove Displayed Entries button under the Maintenance area of the window.
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.
To remove log entries automatically, follow these steps:
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.
Open the Special tab of the Setup window.
From the Log and File Handling section, select the Clear Log Entries Older Than __ Days checkbox and type an age in days.
Click OK to save the changes.
Disable Dialogs for Logged Messages
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:
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.
Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
for MassTransit 7.6 and later:
on 64-bit machines:
C:\Program Files (x86)\Acronis\MassTransit Server
for MassTransit 7.1 to 7.6:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server
for MassTransit 7.0.x:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server 7
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server 7
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.
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.
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
Highlight the MassTransit (for MasTransit 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.
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;
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.
Note: Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.
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
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
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.
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;
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.
Configure Errors to Also Be Logged to syslog() or EventViewer
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.
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.
Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
for MassTransit 7.6 and later:
on 64-bit machines:
C:\Program Files (x86)\Acronis\MassTransit Server
for MassTransit 7.1 to 7.6:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server
for MassTransit 7.0.x:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server 7
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server 7
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.
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.
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
Highlight the MassTransit (for MasTransit 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.
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;
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.
Note: Settings with a '%%' preceding them are not enabled. Delete the '%%' to enable them.
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
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
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.
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;
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.
Network Monitoring Whitelist
%% NETWORK_MONITOR_WHITELIST = 127.0.0.1
Note: As of MassTransit 7.3, you can enter multiple IP addresses separated by commas.
When this setting is enabled, spurious connections from the given IP addresses 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:
Open the MassTransitEngine.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
for MassTransit 7.6 and later:
on 64-bit machines:
C:\Program Files (x86)\Acronis\MassTransit Server
for MassTransit 7.1 to 7.6:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server
for MassTransit 7.0.x:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server 7
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server 7
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.
Controlling the Interval Between Removing Log Messages
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:
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.
Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
for MassTransit 7.6 and later:
on 64-bit machines:
C:\Program Files (x86)\Acronis\MassTransit Server
for MassTransit 7.1 to 7.6:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server
for MassTransit 7.0.x:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server 7
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server 7
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.
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.
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
Highlight the MassTransit (for MasTransit 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.
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;
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.
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.
LOG_AGE_INTERVAL = – configure this setting (in seconds) to set at what interval the log entries should be removed from the list;
LOG_AGE_DURATION = – configure this setting (in seconds) to set how long the log entry removing should last.
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
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.
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;
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.
Disk Space Thresholds
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.
To set a mailbox disk space threshold which will trigger the warning message:
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.
Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
for MassTransit 7.6 and later:
on 64-bit machines:
C:\Program Files (x86)\Acronis\MassTransit Server
for MassTransit 7.1 to 7.6:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server
for MassTransit 7.0.x:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server 7
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server 7
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.
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.
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
Highlight the MassTransit (for MasTransit 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.
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;
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.
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.
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.
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.
In addition, you can configure an interval in minutes between the disk space warnings by enabling:
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.
When you have configured the desired settings, Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
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.
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;
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.
Convert Date and Time to Local Timezone
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:
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.
Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
for MassTransit 7.6 and later:
on 64-bit machines:
C:\Program Files (x86)\Acronis\MassTransit Server
for MassTransit 7.1 to 7.6:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server
for MassTransit 7.0.x:
on 32-bit machines:
C:\Program Files\Group Logic\MassTransit Server 7
on 64-bit machines:
C:\Program Files (x86)\Group Logic\MassTransit Server 7
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.
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.
Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
Highlight the MassTransit (for MasTransit 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.
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;
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.
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
When you have configured the setting, Save and close the MassTransit.cfg file.
Restart the MassTransit services in order to apply the changes immediately:
Go to Start → Control Panel → Administrative Tools → Services;
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.
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;
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.
