External links:
Installation
SmarterMail comes as a single installation file that contains everything necessary to run the product. The SmarterMail installer can be downloaded from http://www.smartertools.com The free version and the licensed version of SmarterMail are both contained within this installation file, so it will not be necessary to download or install the file again if you purchase a license after trying the free version.
Note: Users of Windows 2003 Advanced Server need to install SmarterMail from Add/Remove Programs in the control panel in order for file permissions to be properly set.
If you have IIS 6.0 or later, it is recommended that you run the SmarterMail web interface under IIS instead of using the built-in web server for performance reasons. See the topic Running as an IIS site for more information.
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
|
| |
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.
|
| |
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.
|
Running Web Interface Under an Existing IIS Site
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 an existing web site in IIS 5.0 or higher, follow the step-by-step instructions below.
This section explains how to setup SmarterMail as a virtual directory under an existing IIS site. This is not the recommended method. While it will function properly, it is recommended that you set SmarterMail up as its own IIS site instead. To learn how to set SmarterMail up on its own 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.
Disable the SmarterMail Web Server
While not absolutely necessary, this step will improve security on your server. As a result, while not mandatory, this step 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
|
| |
Change the Startup Mode to Disabled and click on the Apply button
|
| |
Click on the Close button
|
Add SmarterMail to an IIS Site
| |
Click on Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS)
|
| |
Open up the Web Sites tree and locate the site under which you want to place SmarterMail
|
| |
Right-click on the web site and choose New -> Virtual Directory
|
| |
When asked for an Alias, enter "SmarterMail", "Mail", or another name. This will be used in the URL to get to webmail, as in http://www.example.com/smartermail.
|
| |
For Path, use "C:\Program Files\SmarterTools\SmarterMail\MRS" (or use the location in which you installed SmarterMail).
|
| |
When asked what permissions to grant, choose only Read and Run Scripts.
|
| |
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 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)
|
Update DNS
| |
If any domains are already setup with SmarterMail, make sure to update their webmail DNS records to point to the new site.
|
Test the Site
| |
Open up a web browser, and type in the URL of the virtual directory (ex. http://www.example.com/virtualdirectory).
|