Running Remote Administration under IIS

MDaemon is equipped with a built-in web server, which means that Remote Administration doesn't require Internet Information Server (IIS) to operate. However, it does support IIS, and can therefore function as an ISAPI DLL.

To configure to operate under IIS 5:

1.Stop Remote Administration from running. You can do this by right-clicking on the Remote Administration entry under Servers in the left pane of the MDaemon GUI, and then clicking Toggle Active/Inactive.
2.Open the IIS management program (StartàSettingsàControl PanelàAdministrative ToolsàInternet Services Manager).
3.Right-click Default Website and then select NewàVirtual Directory.
4.Follow the Wizard as it takes you through the steps of creating a Virtual Directory. The following are suggested names and locations for data to be typed into the Wizard, but will vary depending on your installation of MDaemon and the location of MDaemon's Remote Administration component.
a.        Alias: "WebAdmin". Click Next.
b.        Directory: "c:\mdaemon\webadmin\templates". Click Next.
c.        Click Next.
d.        Click Finish.
5.Set the Execute Permissions to Scripts Only.
6.Set the Application Protection to Low (IIS Process).
7.Click the Configuration button in the Application Settings section of the Virtual Directory tab.
8.On the Mappings tab click the Add.
9.In the Executable field enter "c:\mdaemon\webadmin\templates\WebAdmin.dll". Note: This field cannot contain any spaces. If the path contains a space it must be converted to 8.3 format. The dir /x command will show the 8.3 name for a file or directory.
10.In the Extension field enter ".wdm" and select the radio button for All Verbs.
11.Click the Script Engine box.
12.Click OK.
13.All other mappings can be removed if you choose, then click the OK.
14.On the Documents tab add login.wdm as a Default Document and remove all other entries from the list.
15.In MDaemon, go to SetupàWeb & IM ServicesàRemote Administration and click Remote Administration runs using external webserver.
16.In Remote Administration URL type "/WebAdmin/login.wdm".
17.Click OK.

 

To configure to operate under IIS 6:

Create a new application pool for Remote Administration:

1.Stop Remote Administration from running. You can do this by right-clicking on the Remote Administration entry under Servers in the left pane of the MDaemon GUI, and then clicking Toggle Active/Inactive.
2.Open the IIS management program (StartàSettingsàControl PanelàAdministrative ToolsàInternet Services Manager).
3.Right-click Application Pools.
4.Click NewàApplication Pool.
5.In the Application pool ID field type "Alt-N" and click OK.
6.Right-click Alt-N
7.Click Properties.
8.Click Performance tab.
9.Clear "Shutdown worker processes after being idle for" and "Limit the kernel request queue".
10.Click Identity tab.
11.In the drop-down for Predefined, choose Local System.
12.Click OK.

 

Create a virtual directory for Remote Administration:

1.Open the IIS management program (StartàSettingsàControl PanelàAdministrative Tools (Internet Services Manager)).
2.Right-click your web site and then select New (Virtual Directory).
3.Specify an alias for the virtual directory (for example, "WebAdmin").
4.In the Path field, type the path to the Remote Administration Templates directory — for example, "C:\Program Files\Alt-N Technologies\WebAdmin\Templates".
5.Leave the Read and Run Scripts options checked.
6.Finish the wizard and right-click on the Virtual Directory that was created.
7.Select Properties.
8.On the Home Directory tab change the application pool to "Alt-N".
9.Click the Configuration button.
10.Click Add to add an ISAPI extension mapping.
11.In the Executable field enter the path to the WebAdmin.dll file. For example, "C:\Program Files\Alt-N Technologies\WebAdmin\Templates\WebAdmin.dll".
12.In the Extension field enter ".wdm"
13.Click the boxes for Script Engine and Verify the file exists.
14.Click OK.
15.All other mappings can be removed if you choose, then click the OK.
16.Select the Documents tab. 
17.Ensure that Enable default content page is checked.
18.Ensure that only "login.wdm" exists in the list.
19.Click the Ok and exit the virtual directory properties dialog.

 

Add .WDM to list of allowed web extensions:

1.Click on the Web Service Extensions folder (in the IIS MMC).
2.Click Add new web service extension.
3.In the Extension name field enter "WebAdmin".
4.Click Add and then browse to the WebAdmin ISAPI extension. For example:
C:\Program Files\Alt-N Technologies\WebAdmin\Templates\WebAdmin.dll.
5.Check Set extension status to allowed.
6.Click OK.
7.In MDaemon, go to SetupàWeb & IM ServicesàRemote Administration and click Remote Administration runs using external web server.
8.In Remote Administration URL type "/WebAdmin/login.wdm".
9.Click OK.

For more information on Remote Administration, see: