MassTransit 5 and Later Hot Fix Installation Instructions

Click one of these links to jump to the section desired:

Windows - MassTransit Enterprise

Installation Instructions - Enterprise

Note: You MUST first have installed and run the MassTransit public release before applying this hot fix.

This hot fix updates the MassTransit Engine, Administrator and MTWeb components.

WARNING: Hot fixing MTWeb may overwrite customized MassTransit MTWeb configurations. Please ensure that you backup your current configuration before applying this hotfix. If you have a customized MTWeb configuration, please contact Group Logic support before applying this hotfix to ensure compatibility.

This hot fix contains the following folders and files:

• Databases folder
• Extras folder
• Security folder
• MassTransit Engine.exe
• MassTransit Administrator.exe
• MassTransit Engine.tlb
• MTWeb folder
• ldapfilters.cfg

Before replacing these files on your server, make a copy of them to another location as a backup.

Additionally backup your MassTransit.cfg and MassTransit Engine.cfg files.

To apply the hot fix, stop the MassTransit service, copy all of the extracted files into your MassTransit directory (by default C:\Program Files\Group Logic\MassTransit Server 5), and then restart the MassTransit service.

Next configure MTWeb by following the MTWeb Hot Fix section below.

Your MassTransit Enterprise Server is now running the latest hot fix version.

Windows - MassTransit Professional

Installation Instructions - Professional

Note: You MUST first have installed and run the MassTransit public release before applying this hot fix.

This hot fix contains the following files:

• Databases folder
• Extras folder
• Security folder
• MassTransit Engine.exe
• MassTransit Administrator.exe
• MassTransit Engine.tlb

Before replacing these files on your server, make a copy of them to another location as a backup.

Additionally backup your MassTransit.cfg and MassTransit Engine.cfg files.

To apply the hot fix, stop the MassTransit service, copy all of the extracted files into your MassTransit directory (by default C:\Program Files\Group Logic\MassTransit Server 5), and then restart the MassTransit service.

Your MassTransit Professional Server is now running the latest hot fix version.

Windows - MassTransit Client and Satellite

Installation Instructions - Client and Satellite Only

Note: You MUST first have installed and run the MassTransit public release before dropping in this hot fix.

This hot fix contains the following files:

• Databases folder
• Security folder
• MassTransit Client.exe or MassTransit Satellite.exe
• MassTransit Client.tlb or MassTransit Satellite.tlb

Before replacing these files on your server, make a copy of them to another location as a backup.

To apply the hot fix, stop the MassTransit Client, copy all of the extracted files into your MassTransit directory, and then restart MassTransit Client.

Your MassTransit Client is now running the latest hot fix version.

Mac OS X - MassTransit Enterprise

Installation Instructions - Enterprise

Note: You MUST first have installed and run the MassTransit public release before applying this hot fix.

This hot fix updates the MassTransit Engine, Administrator and MTWeb components.

WARNING: Hot fixing MTWeb may overwrite customized MassTransit MTWeb configurations. Please ensure that you backup your current configuration before applying this hotfix. If you have a customized MTWeb configuration, please contact Group Logic support before applying this hotfix to ensure compatibility.

This hot fix contains the following folders and files:

• Databases folder
• Extras folder
• Security folder
• MassTransit Engine.app
• MassTransit Administrator.app
• MTWeb folder
• ldapfilters.cfg

Before replacing these files on your server, make a copy of them to another location as a backup.

Additionally backup your MassTransit.cfg and MassTransit Engine.cfg files.

To apply the hot fix, stop the MassTransit Engine application, copy all of the mounted files into your MassTransit directory (Applications:MassTransit Server 5 Folder), and then restart the MassTransit Engine application.

Next configure MTWeb by following the MTWeb Hot Fix section below.

Your MassTransit Server is now running the latest hot fix version.

Mac OS X - MassTransit Professional

Installation Instructions - Professional

Note: You MUST first have installed and run the MassTransit public release before dropping in this hot fix.

This hot fix contains the following files:

• Databases folder
• Extras folder
• Security folder
• MassTransit Engine.app
• MassTransit Administrator.app

Before replacing these files on your server, make a copy of them to another location as a backup.

Additionally backup your MassTransit.cfg and MassTransit Engine.cfg files.

To apply the hot fix, stop the MassTransit Engine application, copy all of the mounted files into your MassTransit directory (Applications:MassTransit Server 5 Folder), and then restart the MassTransit Engine application.

Your MassTransit Server is now running the latest hot fix version.

Mac OS X - MassTransit Client and Satellite

Installation Instructions - Client and Satellite Only

Note: You MUST first have installed and run the MassTransit public release before dropping in this hot fix.

This hot fix contains the following files:

• Databases folder
• Security folder
• MassTransit Client.app or MassTransit Satellite.app

Before replacing these files on your server, make a copy of them to another location as a backup.

To apply the hot fix, stop the MassTransit application and copy all of the mounted files into your MassTransit directory.

Copy the data folder from your backed up Client or Satellite Databases folder into your MassTransit Databases directory.

Restart your MassTransit application.

Your MassTransit application is now running the latest hot fix version.

MTWeb Instructions for Windows

At this point in the hotfix process, the MassTransit Engine, Administrator, and MTWeb components should already be updated (this section assumes that you have already followed the steps in the Mass Transit Enterprise - Windows hotfix instructions above).

Please follow the instructions below to ensure that the newly updated MTWeb is configured properly:

• Browse to the MassTransit MTWeb directory on your server (by default C:\Program Files\Group Logic\MassTransit Server 5\MTWeb).
• Open the templates_c folder inside your MTWeb folder and delete all contents in that folder.
• Open the parsed folder inside your MTWeb folder and delete all contents in that folder.
• Ensure that the windows user account associated with the IIS website for MassTransit has read and write permissions on the templates_c and parsed folders.
• Carefully update the relevant settings in the newly updated mtweb.ini file (in the MTWeb folder) using your backup version as a reference. Do not copy the old backup version back to this directory to use it as the live version as the parameters may have changed.
• Ensure the mtweb.ini file is configured properly and the parameter mAvailPluginVersionWin and mAvailPluginVersionOSX are delimited by commas. The downloaded mtweb.ini file contains default values.
• If you are upgrading from a 5.0.1 version of MassTransit to a 5.0.2 version or later, please ensure that the version of PHP being used is at least 5.1.6. Also, add the following line to the Dynamic Extensions section of the php.ini file (default installation is: C:\Windows).
• extension=php_soap.dll
• If PHP logging has not previously been configured, follow the steps below to configure it (these steps are optional, but recommended to facilitate easier troubleshooting). Edit the following lines of the php.ini file (typically located in the following directory: C:\Windows) and save the file when you are done.
  • error_reporting = E_ALL
  • log_errors = on
  • error_log = "MT-PHPLog.log"
  Please note that for the error log to be written, the windows user account associated with the IIS web site that MassTransit is using (generally IUSR_COMPUTERNAME) needs to have write access to the log file. By default (if you don’t specify a folder), the default log file location will be your webroot folder. If you do not want to give the windows user account associated with the IIS web site full access to this folder, you may create an empty log file with this name manually and then grant that windows user account write access to that file only
• Restart the IIS Web Page Hosting Service

Your MassTransit Enterprise Server is now completely updated and configured with the latest hot fix version.

MTWeb Instructions for Mac OS X

At this point in the hotfix process, the MassTransit Engine, Administrator, and MTWeb components should already be updated (this section assumes that you have already followed the steps in the Mass Transit Enterprise - Mac OS X hotfix instructions above).

Please follow the instructions below to ensure that the newly updated MTWeb is configured properly:

• Using the Finder window, browse to the MassTransit MTWeb folder (by default: Applications: MassTransit Server 5 Folder: MTWeb).
• Carefully update the relevant settings in the new mtweb.ini file using your backup version as a reference. Do not use a copy of the backed up mtweb.ini file as the file parameters may no longer be valid
• Ensure the mtweb.ini file is configured properly and the parameter mAvailPluginVersionWin and mAvailPluginVersionOSX are delimited by commas. The downloaded mtweb.ini file contains default values
• Open the templates_c folder inside your MTWeb folder and delete all contents in that folder.
• Open the parsed folder inside your MTWeb folder and delete all contents in that folder.
• Ensure that the templates_c and parsed folders have read and write permissions set for all users.
• Restart the Apache Web Page Hosting Service.

Your MassTransit Enterprise Server is now updated and configured with the latest hotfix version.