SmarterMail 5.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. To configure IIS7 in Windows 2008, please see the end of this page.

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 equivalent) 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 mail processing directory. Choose Properties from the pull-down menu.

 

In the Execute Permissions dropdown box, choose "Scripts Only" 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.

Configuring IIS7 for Windows 2008.

Disable the SmarterMail Web Server

 

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

 

Click Start -> Control Panel -> Administrative Tools -> Internet Information service (IIS) Manager

 

Right click Application Pools and select "Add Application Pool"

 

Name the pool "SmarterMail" (or something similar)

 

Set Managed Pipeline Mode to "Classic" and click OK

Add SmarterMail to IIS

 

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

 

Select ServerName -> Open ISAPI and CGI Restriction -> Verify that ASP.NET v2.0 is allowed (If not, right click on ASP.NET v2.0 and select "Allowed")

 

On the left side of the page, right click and choose "Add Website"

 

Name the Site "SmarterMail"

 

If you created an Application Pool name other than "SmarterMail" click Select and choose the correct Application Pool

 

For the physical path, browse to the SmarterMail/MRS folder. The default location is C:\Program Files\SmarterTools\SmarterMail\MRS

 

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.

 

Click OK

Verify IIS Settings

 

In IIS Manager click ServerName. Under Security double click ISAPI and CGI Restrctions. Then, verify that ASP.NET v2.0 is allowed. If it is not right click on ASP.NET v2.0 and select "Allowed."

 

In IIS Manager double click Sites -> Double click the SmarterTools site -> Double click on the App_Theme folder. Under HTTP features double click HTTP Response Headers. Under the Action menus, click Set Common Headers -> Check Expire Web content -> Click After -> Click the add 7 for the number of days -> Click OK

 

In Administrative Tools under Services, Verify that World Wide Web Publishing Service is Running