Here you can find detailed instructions about how to configure a different from the default location for all MassTransit Contacts or for a particular one. You will also find information about how to set up a mailbox on a local or remote drive.
Note: If you change the location of the mailboxes to be on any other drive (different than the C: drive), you will need to grant 'Full Control' permissions for the local IUSR account for the folder where you have moved the mailboxes.
Note: If you are changing from a custom mailbox to a default mailbox, or changing from one custom mailbox to another, MassTransit does not affect your original custom mailbox. To delete or move its contents, you must do so manually using the Windows Explorer.
Change the Location for All Contacts' Mailboxes
All Mailboxes On a Local Drive
To choose a different location for the mailboxes for all contacts, follow these steps.
Before changing the location of the mailboxes, make sure you have backed up needed files that are in the old mailbox location.
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
In the Setup window, click the Special tab.
From the Location of User Mailboxes Folder section, select Use Custom Location and click Choose.
Locate the disk and folder for the new location.
Click Open, then click OK to save the chosen location.
Click OK in the Setup window.
MassTransit automatically creates mailboxes for each entry in your Contact window and files received and sent are placed in them.
If you use the default mailbox option, MassTransit creates a contact mailbox folder within the User Mailboxes folder in the MassTransit folder. The user mailbox folder has the same name that is displayed in the Contacts window of the MassTransit Administrator.
You can also set the mailbox path for a contact via the COM scripting interface using the Mailbox Location property for MassTransit Contacts.
All Mailboxes On a Remote Drive
Provide the appropriate login credentials for MassTransit Engine.
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 Start→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.
Provide the appropriate login credentials for MassTransit Transporter service – if your MassTransit server is SFTP, you need to provide network access to the MassTransit Transporter service in order to be able to set remote mailboxes.
Open the Services console (available in Start → Control Panel → Administrative Tools) and right click on the MassTransit Transporter 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 in the previous step 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 stop the MassTransit service, restart the MassTransit Transporter service to apply these changes, and start the MassTransit service again.
Provide permissions to MassTransit for the remote mailbox folder.
Go to the remote location where you want to place the mailboxes and give READ & WRITE permissions to the domain user you used in the previous steps.
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.
The set up for remote mailboxes is now complete. Your Client, Server and Group contacts should be able to use their mailboxes.
Note: At this stage, MassTransit should be set up for all contact types, except that MassTransit HP 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.
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 does NOT have administrative privileges in your network
Login credentials for IIS 6 on Windows Server 2003.
Open the IIS Manager from Start→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.
lick 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.
Login credentials for IIS 7.0 or 7.5 on Windows Server 2008 and Windows Server 2008 R2.
Open the IIS Manager from Start→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 as an administrator 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.
Provide the appropriate access permissions to IIS for MTWeb.
Navigate to the MTWeb folder within the MassTransit installation folder. By default, this folder is placed on the system drive in:
for MassTransit HP 7.0: ~\MassTransit Server 7\MTWeb\
for MassTransit HP 7.1 and later: ~\MassTransit Server\MTWeb\
Give READ, WRITE, and MODIFY 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.
Provide permissions to IIS for the remote mailbox folders.
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.
Change the Mailbox Location of a Contact
If you prefer, you can designate a different folder location for contact’s mailbox folder. This custom mailbox folder can be located anywhere on your system or on a mounted network server and can have any name you want. However, you cannot select a folder previously assigned to another contact; each contact must have a unique mailbox folder. In addition, MassTransit creates the Received, Sent, To Send, Cannot Be Sent, and To Be Forwarded folders within the folder you select. If you change your mind later, you can always designate a different folder to act as the contact mailbox.
Mailbox On a Local Drive
To create a custom mailbox for a contact on a local drive, follow these steps.
In the Contacts window of the MassTransit Administrator, click Add Contact... to add a new contact, or select an existing contact and click Edit....
In the Contact Information window that appears, go to the Mailbox tab.
In the "Mailbox" area, click Use Custom Mailbox and click Select.... Locate and select the folder you want. Then, click OK.
Click OK to close the Contact Information window.
If you previously clicked OK while the default mailbox option was selected and have changed to a custom mailbox, MassTransit will prompt you to delete the old mailbox folder and all its contents.
Mailbox On a Remote Drive
To create a custom mailbox for a contact on a remote drive, follow these steps.
Provide the appropriate login credentials for MassTransit Engine.
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 Start→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.
Provide the appropriate login credentials for MassTransit Transporter service – if your MassTransit server is SFTP, you need to provide network access to the MassTransit Transporter service in order to be able to set remote mailboxes.
Open the Services console (available in Start→Control Panel→Administrative Tools) and right click on the MassTransit Transporter 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 in the previous step 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 stop the MassTransit service, restart the MassTransit Transporter service to apply these changes, and start the MassTransit service again.
Provide permissions to MassTransit for the remote mailbox folder.
Go to the remote location where you want to place the mailbox and give READ & WRITE permissions to the domain user you used in the previous steps.
Set the remote mailbox.
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.
The set up for remote mailbox of a contact is now complete. Your Client, Server or Group contact should be able to use their mailboxes.
Note: If you are setting a remote mailbox for a Web contact, he will only be able to transfer files using the MassTransit plug-in. If you want the Web contact 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.
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.
Login credentials for IIS 6 on Windows Server 2003.
Open the IIS Manager from Start→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.
Login credentials for IIS 7.0 or 7.5 on Windows Server 2008 and Windows Server 2008 R2.
Open the IIS Manager from Start→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 as an administrator 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.
Provide the appropriate access permissions to IIS for MTWeb.
Navigate to the MTWeb folder within the "MassTransit Server 7" installation folder. By default, this folder is placed on the system drive in:
for MassTransit HP 7.0: ~\MassTransit Server 7\MTWeb\
for MassTransit HP 7.1 and later: ~\MassTransit Server\MTWeb\ b. Give READ, WRITE, and MODIFY 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. c. Navigate to the tmp folder within the "php" folder. By default, this folder is placed on the system drive in: ~\php\. d. Give READ & WRITE permissions to the chosen domain user for the tmp folder. e. 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.
Provide permissions to IIS for the remote mailbox folder. a. 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 a remote mailbox of the Web contact is now complete. Your Web contact should be able to successfully transfer files using the MassTransit plug-in or HTTP.