How-To: Configure and Troubleshoot Modus Web 4.x Components


Product:
ModusMail & ModusGate
Version & Build: Version 4.2
 
 

Background information:

Over the course of Modus' development, we have provided 3 different user interfaces for the WebMail / WebQuarantine programs. This how-to describes the most recent, Version 4.2.

NOTE: A diagnostic utility is available to help determine any connectivity or configuration problems. Before reading further, please see the Diagnostic Utility for WebMail/WebQuarantine to help pinpoint any errors you may have, then refer to the appropriate section below for configuration details.

Folder Structure:

To access the configuration files described below, locate the directory entitled Webroot. In a default installation, it can be found in C:\Program Files\Vircom\Web\Webmail\Webroot (machines upgraded from older builds may find it in the VMWServer or MWMServer directory).

 

The main configuration information is contained in a file called webmailsvr.ini, located in Web\Webmail.  This file is used by both old and new UI versions.  This is where you specify the IPs used for the SMTP, POP and IMAP connections.  Below is a breakdown of the required configuration information.

 

Configuration 1: Modus and Web components installed on 1 server  

 

WebMail & Quarantine: Webmailsvr.ini configuration

[RPC:Settings]

The Host address must be the IP of the server where Webmail or Quarantine is installed and running.

 

[Default:Settings]

The POP3Server, IMAP4Server and SmtpServer fields must all display either the static IP of the mail server or the loopback address, 127.0.0.1 

1) The address entered in the SmtpServer field must be added to the security settings in the ModusMail admin console: Security / Mail Relay / Accept mail for relay from these hosts.

2) The loopback can only be used for the SMTP, POP & IMAP values if Webmail is installed on the same server as ModusMail.  If Webmail is on a separate server, you must enter the mail server's IP instead (either internal or public IPs can be used). 

In ModusGate: the IP for SmtpServer, POP3Server and IMAP4Server will always be the loopback address, 127.0.0.1.  The ModusGateServer value is used instead, and must display the actual IP of ModusGate.

 

DomainName: this must match the default domain name as displayed in the ModusMail configuration console, i.e. the first domain name in the list.  Example, if the primary domain is abc.com in Modus, enter that information here; if it is mail.abc.com (i.e. the machine name is included), then use that same format here.

In ModusGate: The default entry is in machine.domain.com name format.  Delete the machine name and ensure that the domain used in the actual email address is displayed, e.g. mycompany.com.

 

BasePath: this must contain the full path to the Users subfolder within WebMail or Web Quarantine, e.g. C:\Vircom\Web\WebMail\Users.

 

NumSpellChecker: The spellcheck function became unreliable in Modus 3.x because of changes made to Microsoft's Word.  It's recommended to change the value to 0 (off) to prevent a build-up of errors in the Windows Event Viewer.

The new Webmail UI in versions 4.0 and 4.1 has its own spell-check function built in and no longer relies on Microsoft; it also no longer requires the use of the NumSpellChecker line in this file.

 

WebAdminURL: A default install will auto-create a virtual directory called WebAdmin under the Default Web Site in IIS. Therefore the path here can be simply /webadmin/ - note that the path must end with a forward slash.

If WebAdmin was created under a different site, enter the full URL path here, e.g.:

http://www.mydomain.com/webadmin/

 

QuarantineEnabled: The value =1 to display the quarantine tab; value =0 to hide it.

 

NOTE: In brand new installs, this value does not appear as the quarantine is enabled for all users by default. If you wish to prevent users from seeing their quarantine contents, either create the entry manually with the desired value, or control it from the Modus admin console: Web > Webmail: disable "Show Quarantine Folder" > Apply. After making the change, stop/restart the Webmail Server Service.

It can also be configured on a per domain basis in the Modus admin console > domain properties > WebMail tab.

 

[DomainName:Settings]

This is where to configure the connections for other domains or mail servers, where the connection info is different from the default domain.  For example, if you have a single webmail website that all local users log into: all domains use the settings under the [Default:Settings] section, even if each domain has its own IP.

If you have domains that require different settings from the Defaults, or if you want to allow WebMail access to multiple mail servers, create a section called [DomainName:Settings] and enter the required configuration using the following syntax, e.g.:

[DomainName:Settings]

ConvertState=0

[xyz.com:Settings]

DomainName=xyz.com

Pop3Server=10.10.10.10

Pop3Port=110

SmtpServer=10.10.10.10

SmtpPort=25

QuarantineEnabled=0

 

WebAdmin Configuration

Go to the Web \ WebAdmin \ Root folder in Windows Explorer and open the file called Web.config: <appSettings> section:

 

Site value: the default value will be blank. If there are any problems accessing this program, enter either 127.0.0.1 or the Mail server's IP between quotes (either internal or public IP). If the machine has more than 1 NIC card, use the 1st static IP; don't use 127.0.0.1.

 

WebMonitor Configuration

Go to the Web \ WebMonitor > web.config file: the default value will be: <add key="ModusServerAddress" value="127.0.0.1"></add>

If there are any problems accessing this program or the IP must be changed (such as when there are multiple NIC cards on the machine), copy the following lines from the Web.config file and paste them to Custom.config file and enter the new IP:

<add key="DefaultLanguage" value="en-US"></add>
<add key="DefaultTheme" value="Vircom"></add>
<add key="ModusServerAddress" value="127.0.0.1"></add>

 

Folder Permissions

On a Windows 2000 server, give Modify* permissions to the IUSR_machine and ASPNET accounts (often called aspnet_wp) on the folders listed below.  On a Windows 2003 machine, the permissions must instead be given to the IUSR_machine and Network Service accounts. Make sure the permissions are propagated to the child files and folders.

  • WebAdmin
  • WebMail (including server and client folders in older setups)
  • ModusMail
  • WebMonitor

* At a minimum, the above-named accounts must have Read & Execute, List and Read permissions on the above folders & contents, and Modify permissions on the Temp and Users directories within Web\Webmail or Web\Quarantine. 

 

IIS Site Configuration:

If you if you had an existing WebMail or Quarantine virtual directory, new sites are created under the names NewWebMail or NewQuarantine. You should therefore have the following sites:

  • WebMail (Mail): Local Path points to ...Web\Webmail\AspRoot
  • Quarantine (Gate): Local Path points to ...Web\Quarantine\AspRoot
  • NewWebMail (Mail): Local Path points to ...Web\Webmail\WebSite
  • NewQuarantine (Gate): Local Path points to ...Web\Quarantine\WebSite
  • WebAdmin (Mail & Gate): Local Path points to ...Web\WebAdmin\Root
  • WebMonitor (Mail & Gate): Local Path points to ...Web\WebMonitor

 

Custom settings

If you wish to change or customize any of the default settings for any of the web components, use the Custom.config files NOT the Web.config files.  Changes made to Custom.config will not be overwritten by subsequent upgrades, whereas any changes made to Web.config will be lost during an upgrade. 

For details about customization, see WebMail and WebQuarantine Interface Customization

 

Configuration 2:  WebMail and ModusMail installed on separate servers

To allow all components to talk to each other, you'll need to create pointers to the mail server after the install is complete:

 

WebAdmin:

Go to the Web \ WebAdmin \ Root folder in Windows Explorer and open the file called Web.config: <appSettings> section:

 

Site value: enter the Mail server's IP between quotes (either internal or public IP)

 

WebMail or Quarantine - webmailsvr.ini file:

Go to the Web\Webmail folder and open the webmailsvr.ini file: 

 

Host address: The Host address must be the IP of the machine where webmail is installed and running. 

 

POP3, IMAP4 and SMTPServer settings: enter the IP of the mail server

In ModusGate: the IP for SmtpServer, POP3Server and IMAP4Server will always be the loopback address, 127.0.0.1.  The ModusGateServer value is used instead, and must display the actual IP of ModusGate.

 

DomainName: this must match the default domain name as displayed in the ModusMail configuration console, i.e. the first domain name in the list.  Example, if the primary domain is abc.com in Modus, then enter that information here; if it's mail.abc.com (i.e. the machine name is included), then use that same format here.

For details about folder permissions, different domain settings, etc., see the information in Configuration 1.

 

Important Notes when WebMail / Quarantine is installed on a separate machine:

  • In the Modus Admin console > Services tab, the WebMail Server Service will appear to be disabled and the Settings button will not display a hostname or IP.  This is normal: the service is controlled on the other server where it's installed and running.
  • To stop and restart the WebMail Server Service, use the Windows > Admin Tools > Services panel.
  • The configuration options under Web / WebMail tab are not available in the console: these settings must be configured manually in the webmailsvr.ini file.

 

WebMonitor:

See the information in Configuration 1 above, but enter the ModusMail or ModusGate server's IP in the line: <add key="ModusServerAddress" value="127.0.0.1"></add>

 

Additional Configuration Information when using Database mailboxes:

Do you use database mailbox authentication?  If yes, create an ODBC connection between the web server and the database server, using a mirror of the ODBC configuration on the Modus server: same System DSN name, login and password.

 

Additional Configuration Information when using SQL quarantine:

Do you use SQL for the quarantine database?  If yes, create an ODBC connection to the database server, again mirroring the connection info on Modus: same System DSN name, login and password.

 

Configuration for Windows 2003

For more details about configuring a Windows 2003 server, see How-To: Configure Windows 2003 for web components

 

Installing the "old" UI

If you have a first-time installation of ModusMail or Gate, you will only have the new user interface that comes with 4.x.  If you wish to provide both the old and new UIs for browser compatibility or other reasons, see How-To: Install the "old" WebMail or WebQuarantine Interface