Skip to end of metadata
Go to start of metadata



MassTransit Administration

Administering MassTransit is available using the MassTransit Administrator application.

The MassTransit Administrator application allows you to configure, manage and control your contacts, communication methods, MassTransit services, actions, etc.

The main windows in the MassTransit Administrator are the following:

  • Contacts – allows you to create, delete, configure, and connect to your contacts;
  • Files – designed for observing and managing the transferred files, assigning services and priorities, and connecting to contacts;
  • Status – allows observing the available communication methods and file transfers;
  • Log – gives information about the connection statuses, summaries for the file transfers, occurred errors, and others;
  • Setup – allows configuring incoming and outgoing calls, actions, services, security, mailboxes, etc.



Go to top


Installing the MassTransit Administrator


The MassTransit Administrator can be installed on a different computer from where the MassTransit Server is installed in order to allow Remote Administration of the server. The MassTransit Administrator must be the same version number as the MassTransit Server to implement Remote Administration.

The installation process of MassTransit 7.0 is a little different than the installation process of MassTransit 7.1 and later. Below you will find installation steps.

Go to top


Installing MassTransit 7.0 Administrator



In MassTransit 7.0, the MassTransit Administrator can be installed with the MassTransit installer by selecting the MassTransit Administrator option only on the "MassTransit Server Features" window. See detailed steps below:

  1. Double click InstallMT7Server.exeto launch the InstallShield Wizard.

    INFO:

    You may quit the installation at any time; the Cancel button is enabled until the Install button is selected.

  2. A "Preparing to Install…" window remains open until the installation preparation is complete.
  3. When the installation preparation completes, the "Welcome to the InstallShield Wizard for MassTransit Server 7, Version 7.0" window appears. Select the Next button to continue.
  4. The "License Agreement" window appears next. The Next button is enabled after you select I accept the terms in the license agreement. Once you have read and agreed with the license agreement, select Next to continue or select Cancel to cancel the installation.
  5. The "ReadMe Information" window appears next; read it and select Next to continue.
  6. The "MassTransit Server Features" window appears next. Select MassTransit Administrator and click Next:
       
  7. The "Destination Folder" window appears next. If you want to, you can configure a different from the default location by clicking on the Change... button. Click Next when ready.
       
  8. The "Ready to Install the Program" window appears. Click Install if you are ready with the configurations. Otherwise, click Back. Clicking Cancel will cancel the installation.
  9. When the "InstallShield Wizard Completed" window appears, click Finish.
       

The MassTransit 7.0 Administrator is installed and you can launch it to connect to a remote MassTransit server.


Go to top


Installing MassTransit Administrator 7.1 and later



In MassTransit 7.1 and later, the MassTransit Administrator application is being installed with the MassTransit server automatically. If you want to install the MassTransit Administrator only, you need to use a different installer that installs the MassTransit Administrator without the server.

Note:

You must install .NET Framework 3.5 in order for the MassTransit Administrator to work on Windows 8 or Windows 8.1.

 

  1. Double click InstallMTAdmin.exe to launch the MassTransit Administrator Installer.

    INFO:

    You may quit the installation at any time; the Cancel button is enabled until the Install button is selected.

  2. When the installer appears, click Install.
       
  3. The MassTransit Administrator Setup begins. Click Next to continue.
  4. The "End-User License Agreement" window appears next. The Next button is enabled after you select I accept the terms in the license agreement. Once you have read and agreed with the license agreement, select Next to continue or select Cancel to cancel the installation.
  5. The "Destination Folder" window appears next. If you want to change the default installation location, click on the Change... button. Otherwise, click Next.
       
  6. The "Ready to install MassTransit Administrator" window appears next. If you need to review or change the installation settings, click Back. When ready, click Install.
       
  7. When the installation is complete the following window should appear:
       
  8. Click Finish. The Launch MassTransit Administrator on exit check box is selected by default. Uncheck it if you do not want the launch the administrator now.
  9. A message from the MassTransit Administrator Installer should appear stating that the MassTransit Administrator setup has completed successfully. Click OK.
       

The MassTransit Administrator is now installed and you can launch it to connect to a remote MassTransit server.


Go to top


Launching the MassTransit Administrator

 


The MassTransit Administrator application can connect to a server only if the server's MassTransit Engine is running.

INFO:

Find more information about MassTransit Engine and Transporter services on the MassTransit Engine page.

    1. Double click the MassTransit Administrator.exe located in the root MassTransit folder to connect to your MassTransit server; the default location is:
         a. for MassTransit Server 7.0:
            - 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
         b. for MassTransit Server 7.1:
            - on 32-bit machines: C:\Program Files\Group Logic\MassTransit Server
            - on 64-bit machines: C:\Program Files (x86)\Group Logic\MassTransit Server

    2. The "MassTransit Servers" window appears.

       

    3. Add the server you wish to connect to if there are no set server preferences:
        a. Select the Edit Server List… button; the "MassTransit Server List" window appears.

          

        b. Select the Add button; the "Configure MassTransit Server Connection" dialog appears.

          

        c. Add the name and address of the server you are connecting to; all fields are required. If Remote Administration is enabled and you are connecting to a remote server, enter that machine's information.
            i. Enter the server Name (or localhost if you are connecting locally); this is just a name to identify the server you're connecting to.
            ii. Enter the server IP Address or DNS name (or localhost if you are connecting locally).
           iii. Enter the Port. Use 20002 (the default) unless the MassTransit server has been configured to use a different port.
        d. Select OK to continue.
        e. After selecting OK you return to the "MassTransit Server List" window and see the server you just created.

    4. To connect, highlight the server entry and select Connect.

NOTE:

You will be able to connect to the server only when the Engine is running; otherwise, a dialog will appear stating that a connection cannot be made to the server.

        a. If you are connecting your MassTransit SFTP server for a first time, the Enter MassTransit Registration Information window appears. Enter your email address and the registration code sent from Group Logic.

          

        b. If you are connecting your MassTransit HP server for a first time, you need to have the license.txt file located in your MassTransit installation folder before starting the MassTransit services.

    5. The "MassTransit" window appears with a toolbar of the following buttons: Contacts, Status, Files, Log, and Setup. Click any button to go to the corresponding window.


Go to top


Shutting Down the MassTransit Administrator

  • To disconnect from the server only, go to the File menu and select Disconnect From Server.
  • To exit the MassTransit Administrator, go the File menu and select Exit.




Go to top


Remote MassTransit Administration

 

The file transfer engine and transporter run as services and can be accessed for viewing and administration by a separate application, the MassTransit Administrator. MassTransit HP allows local and remote Administrators to connect if remote administration is enabled for both MySQL and the MassTransit Engine.

NOTE:

Remote administration is not available on MassTransit SFTP servers.

The easiest way to configure remote administration for MySQL is to check the checkbox when you install MassTransit 7. If you already have MassTransit installed and want to enable Remote Administration, use the following instructions. Both MassTransit and MySQL will need to be configured before remote connections will be accepted. In addition, if you want to enable remote administrators to use MassTransit from behind a firewall, you need to open the ports that the MassTransit Administrator uses.


Go to top

Configuring Remote Administration in MassTransit

 


     1. Via the MassTransit Administrator connect to the local server.

     2. Select the Setup button on the toolbar.

     3. Select the Special tab.
         

     4. Click the Set Remote Administrator Password button.

     5. The "Password" dialog appears; enter your password. This password has to be entered by a Remote Administrator when he attempts to connect to your server.

     6. Select the OK button and now any Remote Administrators with the password can connect to your server.


Go to top

Administrator Request Timeout Settings


 

%% ADMINISTRATOR_REQUEST_TIMEOUT = 120

Set this value to indicate how long the MassTransit Administrator application should wait for responses from requests to the attached MassTransit Server. Positive values are in units of seconds (120 = two minutes), negative values are in units of microseconds (-4500000 = 4.5 seconds). Disable the timeout by setting the value to 0.This setting is located in the MassTransit.cfg file. Normally you can find the file here:

  • for MassTransit Server 7.0:
    • 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
  • for MassTransit Server 7.1 and later:
    • on 32-bit machines: C:\Program Files\Group Logic\MassTransit Server
    • on 64-bit machines: C:\Program Files (x86)\Group Logic\MassTransit Server

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 Transporter service, restart the MassTransit engine and start the MassTransit Transporter again.



Go to top

Configuring Remote Administration in MySQL

 

 

INFO

This is unnecessary if you have selected the Enable remote login for this account checkbox during installation.

  1. Launch the MySQL Command Line Client. It can be found in Start -> All Programs -> MySQL -> MySQL Server 5.1.

  2. Enter the password for the root user.

  3. Enter the following command. Replace the blue parts with their corresponding values.
    1. If the username you entered on the "MySQL Settings" dialog during the installation of MassTransit, is different than masstransit, replace it with the one you use.
    2. Using "%" will allow any machine to connect to the database. For security purposes, it is better to specify a specific host IP if only a limited number of hosts will need to perform remote administration.

      GRANT ALL ON mtdatabase.* TO masstransit@'%'

  4. (Optional) If you'd like to limiting the total resources users use, enter the line below by replacing the number values with the ones you want. The default of these values is "0" (Unlimited) when the MassTransit installer creates this account, if you don't want to change that, skip this step.

    WITH MAX_QUERIES_PER_HOUR 20 MAX_UPDATES_PER_HOUR 10 MAX_CONNECTIONS_PER_HOUR 5 MAX_USER_CONNECTIONS 2

  5. Type ; (semicolon) and press Enter to complete the query.

  6. If you get an ERROR message, start over from step 3. and make sure the syntax of the commands is correct.

Now that you have configured both MySQL and MassTransit, Remote Administration is enabled. Follow the next section to make sure your firewall is not blocking their ports.


Go to top


Open Necessary Firewall Ports for Remote Administration



In order for you to use the Remote Administrator function of MassTransit from behind a firewall, you will need to have 3 ports opened. The default ports are as follows:

  • Port 20002 – port for outgoing from Remote Administrator to MassTransit Engine request connections;
  • Port 20003 – port for outgoing from MassTransit Engine to Remote Administrator request connections.
  • Port 3306 – port for communication between the Remote Administrator and MySQL.

If you need or want to use different than the default ports, you are allowed to change them. The port numbers should be as follows:

  • Port XXXXX – port for outgoing from Remote Administrator to MassTransit Engine request connections;
  • Port XXXX(X+1) – port for outgoing from MassTransit Engine to Remote Administrator request connections,

where XXXXX and XXXX(X+1) are a port numbers of five digits.

NOTE:

If you choose to use ports other than the defaults, please be sure to make the appropriate changes to the Remote Administrator Settings section of your MassTransitEngine.cfg file.



Go to top


Configure Ports for Remote Administration

 


If you need to, you are allowed to change the default port numbers for Remote Administration. To do that, follow the steps below:

    1. Open the MassTransitEngine.cfg configuration file in an application suitable for plain text edit. The file is located in the installation directory of MassTransit which by default is located in:
         a. for MassTransit HP 7.0:
            i. on 32-bit machines: C:\Program Files\Group Logic\MassTransit Server 7
            ii. on 64-bit machines: C:\Program Files (x86)\Group Logic\MassTransit Server 7
         b. for MassTransit HP 7.1 and later:
            i. on 32-bit machines: C:\Program Files\Group Logic\MassTransit Server
            ii. on 64-bit machines: C:\Program Files (x86)\Group Logic\MassTransit Server

    2. Locate the Remote Administrator Settings area and configure 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. ADMINISTRATOR_ADDRESS= – set this setting to the IP or DNS address the MassTransit server uses in order to listen for remote Administrator connections. Leave the field blank to use all available addresses.
         b. ADMINISTRATOR_REQUEST_PORT=20002 – the port number the MassTransit server listens on for incoming Administrator request connections; set the desired port number and remember to open the port on your Firewall;
         c. ADMINISTRATOR_NOTIFICATION_PORT=20003 – the port number the MassTransit server listens on for incoming Administrator notification connections; set the desired port number and remember to open the port on your Firewall;
         d. MAX_REMOTE_ADMINISTRATORS=5 – the maximum number of remote Administrator applications that can connect to the MassTransit Server. The default number of connections is 5.

NOTE:

The Administrator application is always allowed to connect to the local MassTransit 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 Engine:
         a. Open the Services console from Start → Administrative Tools → Services.
         b. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Stop button from the Services tool bar, or select the Stop option from the context menu of the service.
         c. Highlight the MassTransit Transporter service and click on the Restart button from the Services tool bar, or select the Restart option from the context menu of the service;
         d. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Start button from the Services tool bar, or select the Start option from the context menu of the service.


Go to top


Configure MassTransit Administrator to Work on Windows 2008 R2 AMD 64

 


There is a common problem with MassTransit Administrator on AMD Windows Server 2008 R2 64 bit machines. When trying to launch the Administrator, it crashes.

In order to make MassTransit Administrator work on AMD 64 bit machines, you must configure the Administrator to run in Compatibility mode for Windows 2008 SP1. Follow the instruction bellow:

    1. Go to the installation directory of MassTransit, the default installation path is:
         a. for MassTransit HP:
            i. MassTransit HP 7.0:
               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
            ii. MassTransit HP 7.1 and later:
               on 32-bit machines: C:\Program Files\Group Logic\MassTransit Server
               on 64-bit machines: C:\Program Files (x86)\Group Logic\MassTransit Server
         b. for MassTransit SFTP 7.0 and later:
            i. on 32-bit machines: C:\Program Files\Group Logic\MassTransit SFTP
            ii. on 64-bit machines: C:\Program Files (x86)\Group Logic\MassTransit SFTP

    2. Right click on the MassTransit Administrator executable file (MassTransit Administrator.exe).

    3. Choose the Properties option and go to the Compatibility tab.

    4. Under the Compatibility mode section, check the Run this program in compatibility mode for check box and select Windows 2008 SP1 from the drop down menu.

    5. Click on the Apply button and then OK.

Now MassTransit Administrator is properly configured to work on Windows 2008 R2 AMD 64 bit machines.


Go to top


Troubleshooting

Problem: The MassTransit Administrator shut down immediately upon launch.
Solution:

  1. Verify the MassTransit Engine is running. When the Engine is not running, a dialog appears stating: "An error occurred with MassTransit: Unable to connect to the MassTransit server."
  2. Look for an error log entry on the Application page of the Event Viewer. To open the Event Viewer, go to Start → Programs → Administrative Tools → Event Viewer. Look for an Error type and the source name should have "MassTransit" in it. Select the error and double click it. When the event opens, look at the description; the last few sentences of the description are frequently the most informative.



Problem: A dialog appears stating, "An error occurred with MassTransit: Remote Administration is disabled because the required password has not been configured."
Solution: Remote Administration is not enabled in MassTransit; follow Steps 1-6 to configure it.


Problem: A dialog appears stating, "An error occurred with MassTransit: Failed to connect to server due to problems initializing – most likely a database issue."
Solution: Remote Administration is not enabled in MySQL; follow Steps 1-4 to configure it.


Go to top