SmarterMail 4.x Help
This documentation is for a product that is no longer supported by SmarterTools.

Running Web Interface Under IIS

By default, SmarterMail will install a basic web server that allows you to start using SmarterMail immediately after installation. However, it is recommended that you move SmarterMail to a more robust and secure web server, such as Microsoft's Internet Information Server (IIS). To configure SmarterMail to run under IIS 5.0 or higher, follow the step-by-step instructions below.

This section explains how to setup SmarterMail as its own IIS site (recommended method). If you wish to run SmarterMail as a virtual directory under an existing IIS site, click here.

Note: This topic assumes that you are familiar with IIS and how it works. SmarterTools recommends that you use the web server included with SmarterMail if you do not feel comfortable using IIS.

Disable the SmarterMail Web Server

While not absolutely necessary, this step will improve security and performance on your server and is highly encouraged.

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

 

Click on Start -> Program Files -> SmarterTools -> SmarterMail -> Configure SmarterMail Web Server

 

Click on the Stop button

 

Change the Startup Mode to Disabled and click on the Apply button

 

Click on the Close button

Add an Application Pool (Windows 2003 only)

 

Click on Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS)

 

Right-click on Application Pools and choose New -> Application Pool

 

Name the pool SmarterMail (or something equivelent) and click OK

Add SmarterMail to IIS

 

Click on Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS)

 

Right-click on the web sites tree on the left of the page and choose New -> Web Site

 

When asked for a description, enter SmarterMail

 

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.

 

For Path, use "C:\Program Files\SmarterTools\SmarterMail\MRS" (or use the location in which you installed SmarterMail).

 

Leave the "Allow anonymous access to this web site" box checked.

 

When asked what permissions to grant, choose only Read and Run Scripts.

 

Finish the wizard

 

Open the web site tree for the new IIS site and right click on the mailprocessing directory. Choose Properties from the pull-down menu.

 

In the Execute Permissions dropdown box, choose "None" and click OK

 

(Windows 2003 only) Right click on the site name and choose properties

 

(Windows 2003 only) In the home directory tab, choose the SmarterMail application pool

Verify IIS Settings

 

If you are using Windows 2003, verify that the ASP.NET v2.0.50727 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.  (Control Panel -> Add / Remove Programs -> Windows Components -> Application Server -> Details)

 

Ensure that the default document for the site is Default.aspx (under the Documents tab)

 

For better performance, set HTTP content expiration for 7 days on the App_Themes folder unless you are actively creating a new skin

 

In Windows 2003, alter application pool's performance tab to disable the "Shutdown worker processes after being idle for," or change it to a high value, like 240.

Update DNS

 

If any domains are already setup with SmarterMail, make sure to update their webmail DNS records to point to the new IP address.

Test the Site

 

Open up a web browser, and type in the IP address of the site you just added.