Sep 22, 2020
How to Run VisNetic WebMail under IIS
How to Run VisNetic WebMail under IIS
This scenario is useful in several situations:
administrator has only one IP and wants to run both IIS and WebMail on port 80
administrator wants to have a backup solution
some administrators are very experienced with administration of IIS and want to use it with VisNetic WebMail
VisNetic WebMail was not designed for IIS so we cannot guarantee full functionality under IIS. After numerous tests and with the help of our customers, we discovered that with the changes described below all features should work. We do NOT officially support this configuration and can NOT offer support for configuring Webmail with IIS, configure at your own risk.
The following description was done on a test machine with IIS 6.0 and VisNetic MailServer 8.3. It should also work with older versions of VisNetic Webmail and of course with older versions of IIS.
1. Editing the WebMail files to be compatible with IIS.
A. Create a config.html
Create (or open) the config.html with a text editor. The file should be in the \VisNetic MailServer\html\mail\ folder by default. Insert line
$SERVER_INSTALL_PATH = 'the real path to your VisNetic\WebMail installation';?>
$SERVER_INSTALL_PATH = 'C:/Program Files/Deerfield.com/VisNetic MailServer/';?>
Attention: there must not be a CRLF after ?> otherwise attachments will not be displayed correctly
B. Editing fastlog.html file (only for VisNetic WebMail versions prior to version 8.3)
Open the fastlog.html file in VisNetic MailServer\html\mail\ in any text editor and replace this block:
$username = $AUTH_USER;
$password = $AUTH_PASSWORD;
with this block:
$username = $PHP_AUTH_USER;
$password = $PHP_AUTH_PW;
2. Create the Virtual Directory on IIS for WebMail
Start IIS from Control Panel -- Administrative Tools and click Internet Information Services (IIS) Manager. List the Default Web Site tree, by click righting and select (or the Action menu) -- New -- Virtual Directory.
The Virtual Directory Creation Wizard will welcome you. Click Next and in the dialog fill in the Alias. That is the name under which you want to call the virtual directory and how the users will access the WebMail interface under IIS. Let's call it 'WebMail'.
The next dialog wants you to specify the path to the directory where the html files are stored. Default is C:\Program files\Deerfield.com\VisNetic MailServer\HTML\Mail\. If you installed VisNetic MailServer to another directory you will have to choose the appropriate path.
Click next and now the permissions definition is requested. Check Read, Run and Execute permissions.
Continue by clicking Next and the Finish button to end the Virtual Directory specification.
3. Set the properties for newly created Virtual Directory
After finishing step 1, a new item will appear in the tree. Right-click on it and choose Properties.
In the default Virtual Directory tab click on the Configuration button. Then click on the Add button in the Mappings tab.
Browse for the php.exe file that is in the C:\Program Files\Deerfield.com\VisNetic MailServer\PHP\ directory and which should be the interpreter for html files. Fill in the extension .html. The path to the executable should be quoted with "", and confirm by pressing OK. Then once more click OK to return back to the Properties dialog.
After that, choose the Documents tab. Here you have to add a new default document type. Click Add and fill the 'index.html' in the shown dialog
Finish it by clicking OK and move the newly created type to the top of the file types list by clicking on the Move Up button.
Choose the Directory Security tab and click the Edit button for Anonymous access and authentication control section. Copy the Username, which is in the Anonymous access sub-section.
4. Assign the appropriate rights for Username
The final step is to set the correct permissions for this Username, which is used for Anonymous Access to the following folders:
Windows\temp (this is needed for attachments in Webmail - they would otherwise be truncated if this is not set)
By default the installation path to VisNetic MailServer is:
C:\Program Files\Deerfield.com\VisNetic MailServer\
The procedure for setting the rights is shown only for the first directory. The others are the same.
Go to ..\VisNetic MailServer\WebMail folder, right-click on the Users directory and choose Properties. Choose the Security tab.
Click Add button and paste the Username which you copied in the Directory Security tab in IIS Settings.
Click OK and check the Read and Write permissions for that user.
Do the same for other folders listed above.
5. Create a new extension for PHP.EXE
Return to IIS Manager and create new extension for the php.exe (WebMail PHP). From the tree select 'Web Service Extensions' -- from the right panel click right and select 'Add a new Web service extension and add (browse) for ..\VisNeic MailServer\php\php.exe and allow it (enable the checkbox 'Set extension status to Allowed').
For older versions of IIS, you do not have to create new extension for PHP.EXE
6. Change default port and start the service
Now you need to start the IIS web service and optionally change the default IIS port (if you want simultaneous web services VisNetic Webmail, IIS, Apache,...). Go to the IIS Manager, in the tree choose 'Web Sites' and with right mouse button click choose 'Properties'. Change the TCP port to different port, for example 801.
To start the service simply right-click the Default Web site and press 'Start'
7. Log on to VisNetic WebMail using IIS
Log on to VisNetic WebMail using the following URL format:
http://your_IP:801/WebMail or http://your_domain:801/WebMail.
Allow Virtual Hosts customization (which is not possible under IIS even after all the changes above)
1. Create Virtual Directories under IIS corresponding with your Virtual Hosts. All of them should get the data from html\mail\ folder.
2. Edit html\mail\include.html file and the last line below:
//MSIE check // on JS submit is nullkuli bezpecnosti se tamtestuje /temp/
if((eregi("MSIE",$HTTP_USER_AGENT) || !$HTTP_USER_AGENT) && !eregi("Opera",$HTTP_USER_AGENT)) $isie=1;
if(eregi("^Mozilla",$HTTP_USER_AGENT) && substr($HTTP_USER_AGENT,strpos($HTTP_USER_AGENT,"/")+1,3)>=5) $ismozilla=1;
// add this line here
$URL = $HTTP_HOST.$PHP_SELF.$QUERY_STRING;
Allow attachments more than 2 MB
Edit wmi.ini file, which is in the ..\VisNetic MailServer\PHP\ folder. Find line:
upload_max_filesize = 2M
and change the number according to your needs.
Try adjusting this value if your attachments are not working properly.
Change the temp folder for uploading files
By default, WebMail uses Windows system temp folder. It is recommended to change it to the WebMail temp folder, which is in html\temp.
Edit the wmi.ini file and find this line:
delete the semi-colon from the beginning of this line and fill in your path to html\temp folder in your. Do not forget to assign permissions to that folder as described in step 4.
If you change the temp directory, please note that this new temp must have the name "temp" so for example webmail/temp/ or html/temp/, etc... (it is for increased security of WebMail)
Jan 06, 2006 10:35 AM
This answer was helpful
This answer was not helpful
-- Entire Support Site --
Add to Favorites
Submit a Ticket