By default, mailboxes for all contacts are stored in a User Mailboxes folder located in the MassTransit installation folder. You can choose a new default location to store the User Mailboxes folder. In addition, you can choose a custom location for any individual contact. Mailboxes can be stored in any folder or disk drive available to MassTransit. Follow the steps in this article to configure remote mailboxes for your contacts on Windows Server 2003, Windows XP, Windows Server 2008, and Windows Server 2008 R2.
1. Provide the appropriate login credentials for MassTransit.
First, you need to choose a domain account which will be used by MassTransit to authenticate to Windows and access the remote mailboxes. This user needs to have administrative privileges on your MassTransit server machine.
Open the Services console (available in Control Panel->Administrative Tools) and right click on the MassTransit service. Select the "Properties" option from the context menu. #
In the "Log On" tab, select the "This account" radio button and browse for the chosen domain user by clicking on the "Browse..." button. Enter the domain account's password in the "Password" field. Then, retype the password in the "Confirm password" field and click on the "Apply" button. A message will appear stating: "The account domainuser has been granted the Log On As A Service right", where domainuser is the name of the domain account you chose. Click on the "OK" button.
Now, you need to restart the MassTransit service to apply these changes.
2. Provide permissions to MassTransit for the remote mailbox folder.
You can choose a remote location for the mailboxes of all your MassTransit contacts and for an individual user. Go to the remote location where you want to place the mailbox(es) and give READ & WRITE permissions to the domain user you used in the previous step.
3. Set the remote mailbox.
Follow the steps below to set a remote mailbox for all your MassTransit contacts or for an individual user.
3.1. Setting up remote mailboxes for all MassTransit contacts.
In order to configure all MassTransit contacts to use mailboxes on a remote location, launch the MassTransit Administrator and click on the "Setup" button from the Navigation bar.
In the "Special" tab, select the "Use Custom Location" radio button from the "Location of User Mailboxes Folder" area and click on the "Choose..." button.
Choose a location for the remote mailboxes and click on the "OK" button. Click "OK" to close the "Setup" window.
3.2. Set up a remote mailbox for an individual contact.
In order to configure an individual contact to use mailbox on a remote location, launch the MassTransit Administrator and edit a contact.
In the "Mailbox" tab of the "Contact Information" window, check the "Use Custom Mailbox" check box. Then, click on the "Select..." button and browse for a remote location of the contacts’ mailbox. Click on the "OK" button after you selected a desired network location.
Click "OK" once again to close the "Contact Information" window.
At this stage, MassTransit should be set up for all contact types, except that web contacts will only be able to transfer files using the MassTransit plug-in. If you want web contacts to be able to transfer files via HTTP, you need to provide access permissions and login credentials to IIS for the remote mailbox and MTWeb. To do that, please follow the steps below.
4. Provide the appropriate login credentials for IIS.
You need to choose a domain account which will be used by IIS to authenticate to Windows and access the remote mailboxes. It is recommended that this user have NOT administrative privileges in your network.
4.1. Login credentials for IIS 5 or 6 on Windows Server 2003 and Windows XP.
Open the IIS Manager from Control Panel->Administrative Tools. Under the "Web Sites" folder, right click on the Default Web Site entry (or whichever entry is configured for your MassTransit web setup) and select Properties.
Select the "Directory Security" tab. Under the "Authentication and access control" area, click on the "Edit..." button.
In the "Authentication Methods" window that appears, check the "Enable anonymous access" check box and click on the "Browse..." button. Find and select the domain user you want IIS to authenticate with. Enter the chosen domain account's password in the "Password" field and click on the "OK" button. Then will appear the "Confirm password" window prompting you to retype your password. Click on the "OK" button when you have reentered the password.
Click on the "OK" button in the "Default Web Site properties" window and restart the IIS service. You can do that from the IIS Manager or from the Services console.
4.2. Login credentials for IIS 7.0 or 7.5 on Windows Server 2008 and Windows Server 2008 R2. Open the IIS Manager from Control Panel->Administrative Tools. In the "Connections" pane, expand the server name, expand "Sites", and then click on the "Default Web Site" entry (or whichever entry is configured for your MassTransit web setup) to display the IIS configuration "Home" pane.
In the "Home" pane, double click the "Authentication" icon. Then, select "Anonymous Authentication" and click on the "Edit..." button from the "Actions" pane.
In the window that appears, choose the "Application pool identity" radio button and click "OK".
Open a command prompt from Start->Run... and enter the following 2 command lines:
cd %windir%\system32\inetsrv appcmd set config /section: applicationPools /[name='AppPool'].processModel.identityType:SpecificUser /[name='AppPool'].processModel.userName:domainname\username /[name='AppPool'].processModel.password:password where AppPool is your application pool (by default, this is the DefaultAppPool application pool), "domainname" is the name of your domain, "username" is the account you wish IIS to authenticate with, and "password" is the account's password.
5. Provide the appropriate access permissions to IIS for MTWeb.
Navigate to the "MTWeb" folder within the "MassTransit Server 6" installation folder. By default, this folder is placed on the system drive in:
~Program Files\Group Logic\MassTransit Server 6\MTWeb
On 64-bit versions of Windows, the default location of the MTWeb is on the system drive in:
~Program Files (x86)\Group Logic\MassTransit Server 6\MTWeb
Give READ & WRITE permissions to the domain user (chosen in the previous step) for the parsed and templates_c folders located inside the "MTWeb" directory. Browse the webroot folder located in the "MTWeb" directory and find the MT-PHPLog.log file. Give READ & WRITE permissions to the chosen domain user for this file.
Navigate to the tmp folder within the "php" folder. By default, this folder is placed on the system drive in: ~\php\
Give READ & WRITE permissions to the chosen domain user for the "tmp" folder. Confirm that the PHP installation directory has appropriate system permissions. To do that, give Read, Execute, and List permissions to the domain account for the "php" folder.
6. Provide permissions to IIS for the remote mailbox folder.
Go to the remote mailbox and give READ & WRITE permissions to the domain user used for IIS authentication.
Restart the IIS service from the IIS Manager.
The set up for remote mailboxes of the web contacts is now complete. Your web contacts should be able to successfully transfer files using the MassTransit plug-in or HTTP.
NOTE: For information on how to configure remote mailboxes on MassTransit 7 servers, please refer to Mailboxes page.