SmarterMail 3.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.

Note: Several steps that were necessary under SmarterMail 1.x are no longer necessary, and thus have been removed from this topic.

Install IIS (if necessary)

 

Click on Start -> Control Panel -> Add Remove Programs

 

Click on Add / Remove Windows Components.

 

Check the box for Internet Information Services (IIS).

 

Complete the Wizard and wait for the installation to complete.

 

If Microsoft.Net mappings are not correct (for example, if you install IIS after Microsoft.Net), run the following at the command prompt (replace "\Windows\" with "\WinNT\" for Windows 2000 installations):

  • c:
  • cd \Windows\Microsoft.Net\Framework\v1.1.4322
  • aspnet_regiis -i

Disable the SmarterMail Web Server

While not absolutely necessary, this step will improve security 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 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"

 

Click on OK to save the settings

Verify IIS Settings

 

If you are using Windows 2003, verify that the ASP.NET v1.1.4322 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)

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.