Set up SmarterMail as an IIS Site

By default, SmarterMail installs a basic Web server that allows administrators to start using the application immediately after installation. However, SmarterTools recommends moving to a more robust and secure Web server, such as Microsoft IIS.
The instructions for setting up SmarterMail as an IIS site differ slightly depending on whether you are using IIS 6.0 or IIS 7.0/7.5.  Applies to SmarterMail 8.x – 12.x

Set up Smartermail as an IIS Site in IIS 6 :

An overview of the instructions are:

1. Disable the SmarterMail Web server
2. Add Application pool
3. Add SmarterMail to IIS
4. Verify IIS Settings
5. Update DNS
6. Test the site

Disable the SmarterMail Web Server
These steps will stop and disable the web server included with SmarterMail. They will also have the side-effect of disabling the shortcut on SmarterMail on your desktop until you update it with the new URL for SmarterMail.

1. Click on Start -> Program Files -> SmarterTools -> SmarterMail -> Configure SmarterMail Web Server.
2. Click on the Stop button.
3. Change the Startup Mode to Disabled
4. Click on the Apply button.
5. Click the Close button.

Add an Application Pool
Follow these steps to add an application pool:

1. Click on Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.
2. Right click on Application Pools and choose New -> Application Pool.
3. Name the pool SmarterMail (or something equivalent) and click OK.
4. Click Close.

Add SmarterMail to IIS
Follow these steps to add SmarterMail to IIS:

1. Click on Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.
2. Right-click on the web sites tree on the left of the page and choose New -> Web Site.
3. When asked for a description, type SmarterMail
4. Choose the IP address to use for webmail. If this IP address is shared with another web site, you will need to use a different port or Host Headers. For more information about using Host Headers, refer to the IIS documentation.
5. For the physical path, browse to the SmarterMail\MRS folder. The default location is: C:\Program Files (x86)\SmarterTools\SmarterMail\MRS.
6. Leave the “Allow anonymous access to this web site” box checked.
7. When asked what permissions to grant, choose only Read and Run Scripts.
8. Finish the Wizard.
9. Go to Property of the site and then Home Directory tab
10. From Application pool select the SmarterMail application pool you created
11. Click OK

Verify IIS Settings
Follow these steps to verify the IIS settings:

1. If you are using Windows 2003, verify that ASP .NET v4.0 Web Service Extension is set to Allowed in IIS. If you do not see ASP .NET under Web Service Extensions, ensure that ASP .NET is enabled in the Application Server. You can do this by going to: Control Panel -> Add/Remove Programs -> Windows Components -> Application Server -> Details.
2. Ensure that the default document for the site is Default.aspx (under the Documents tab).
3. For better performance, set HTTP content expiration for 7 days on the App_Themes folder unless you are actively creating a new skin.
4. In Windows 2003, alter application pool’s performance tab to disable the “Shutdown worker process after being idle for,” or change it to a high value, like 240.

Update DNS
If any domains are already set up with SmarterMail, make sure to update their Webmail DNS records to point to the new IP address.
Test the site
Open up your browser and type the IP address of the site you just added.
================================

Set up Smartermail as an IIS Site in IIS 7/7.5

An overview of the instructions are:

• Disabling the SmarterMail Web server
• Adding a new application pool for SmarterMail
• Adding SmarterMail to IIS
• Verifying IIS Settings
• Updating DNS
• Testing the site

Disabling the SmarterMail Web Server
These steps will stop and disable the default web server that is included with SmarterMail. This will also have the side-effect of disabling any shortcut for SmarterMail that may be placed on your desktop until you update it with the new URL for the SmarterMail site created in IIS.

1. Click on Start -> Programs -> SmarterTools -> SmarterMail -> Configure SmarterMail Web Server
2. Click on the Stop button
3. Change the Startup Mode to Disabled
4. Click on the Apply button
5. Click the Close button

Add an Application Pool
Follow these steps to add an application pool specifically for SmarterMail:

1. Open Internet Information Services (IIS) Manager
2. Right click on Application Pools from the tree view and choose Add Application Pool
3. Name the new application pool SmarterMail, or something similarly easy to identify
4. Set the .Net Framework Version to v4.0.x
5. Set the Application Pools Managed Pipeline to ‘Integrated’
6. Make sure “Start application pool immediately” is checked
7. Click OK

Add SmarterMail to IIS
Follow these steps to add SmarterMail to IIS:

1. Open Internet Information Services (IIS) Manager
2. Click on your ServerName, and on the right side, under IIS, double-click ISAPI and CGI Restrictions
3. Verify that ASP.NET v4.0 is allowed (If not, right click on ASP.NET v4.0.x and select Allowed)
4. On the left side of the page, right click on Sites in the tree view and choose Add Website
5. Name the site SmarterMail
6. If you created an Application Pool name other than SmarterMail, click Select and choose the correct Application Pool
7. For the physical path, browse to the SmarterMail -> MRS folder. The default location is C:\Program Files (x86)\SmarterTools\SmarterMail\MRS
8. For Binding, choose an IP address to use for Webmail. If this IP address is shared with another Web site, you will need to use a different port or Host Headers. For more information about using Host headers, refer to the IIS documentation
9. Make sure “Start Web site immediately” is checked
10. Click OK

Verify IIS Settings
Follow these steps to verify the IIS settings. Please read each item carefully.

1. In IIS Manager, click on your ServerName
2. Under IIS, double click ISAPI and CGI Restrictions
3. Verify that ASP .NET v4.0 is allowed. If it is not, right-click on ASP .NET v4.0 and select Allowed
4. In the tree view, click Sites
5. Expand (or double click) the SmarterMail site
6. Click on the App_Themes folder
7. Under IIS, double click HTTP Response Headers
8. Under the Action menus, click Set Common Headers
9. Enable the Expire Web content setting
   • Click After
   • Add 7 for the number of days
10. Click OK
11. Click on Application Pools in the tree view
12. Right click on the SmarterMail application pool and select Advanced Settings
13. Under the Process Model heading, ensure the the Identity is set to the NetworkService account
14. From the Start menu, open Administrative Tools and select Services, then verify that the World Wide Publishing Service is running.

Thanks & Regards

  Srikanth Goud  - Virtualization Administrator