Configuring IIS for ePortal
Configuring IIS for ePortal
Open the windows Control Panel and click on the Administrative Tools icon (if on Windows
2002 / Windows XP)
Click on the Internet Information Services icon to see Figure 1
Please note that these screenshots relate to IIS running on a Windows XP machine and may be
different to those on other Windows platforms.
Figure 1 – Internet Information Services (IIS)
Expand the tree until Default Web Site appears (Figure 2)
Figure 2 – IIS window with Default Web Site expanded
1
2
Creating the jakarta Virtual Directory
Right click on Default Web Site (Figure 2) and select New | Virtual directory
Figure 3 – New | Virtual directory window
Click Next
Figure 4 – Alias window
Author
2
Date
3
Enter jakarta in the Alias text box (make sure that jakarta is in lower case)
Click on Next
Figure 5 – Directory window
Click Browse…
Browse to your ePortal folder. By default this is C:\Facility\ePortal\
Browse to bin\win32\i386
Click OK
The path appears in the Directory text box
Click Next
Author
3
Date
4
Setting the access permissions
Figure 6 – Permissions window - jakarta
Tick the Execute (such as ISAPI applications or CGI) checkbox
Click on Next
Figure 7 – Finish window
Author
4
Date
5
Click on Finish
Setting up an ISAPI Filter
We now need to set up an ISAPI filter called ePortal
Right click on Default Web Site (Figure 2) and select Properties
Figure 8 – Properties window
Select the ISAPI filters tab
Author
5
Date
6
Figure 9 – ISAPI filters tab
Click Add…
Figure 10 – Add filter window
Enter ePortal in the Filter Name text box
Click Browse…
Browse to your ePortal folder. By default this is C:\Facility\ePortal\
Browse to bin\win32\i386
Double click on isapi_redirect.dll. Click OK
Author
6
Date
7
Creating the ePortal Virtual Directory
Lastly we need to create a virtual directory called ePortal
Right click on Default Web Site (Figure 2) and select New | Virtual directory
Click Next
Enter eportal in the Alias text box (make sure that eportal is in lower case)
Click on Next
Click Browse…
Browse to your ePortal folder. By default this is C:\Facility\ePortal\
Browse to webapps\ePortal
Click OK
The path appears in the Directory text box
Click Next
The Access Permissions for the eportal virtual directory are set to the default as in Figure 12
Figure 11 – Permissions window - eportal
Click Next
Author
7
Date
8
Click Finish
Right click on Default Web Site (Figure 2) and select Properties
Click on the ISAPI Filters tab
Figure 12 – ISAPI filters window
The eportal ISAPI filter should have a green arrow pointing upwards next to it (Figure 13)
The service is now correctly set up and ready to be restarted.
To stop and start IIS:
Click on Default Web Site (Figure 2) in the IIS window.
Click on the black Stop button on the toolbar.
Click on the black Start button on the toolbar.
Author
8
Date
9
Configuring IIS on Windows 2003 Server
When working with 2003 server the initial stages of configuration are the same as those for
working with Windows 2000 server. When the jakarta and eportal directories have been created
there is then an additional step, which is creating a web service extension, details as follows.
Figure 13 – Web Service Extension
Add a new web service extension
Select the Web Service Extensions option from the menu on the left
Click on Add a new Web service extension.
Figure 14 – New Web Service Extension
Author
9
Date
10
Enter eportal ISAPI in the Extension name box
Place a tick in Set extension status to Allowed
Click Add…
Figure 15 – Adding a new web service extension
Browse to your ePortal folder. By default this is C:\Facility\ePortal\
Browse to \bin\win32\i386
Click on isapi_redirect.dll
The completed web service extension will show in the right hand panel with the status set to
allowed
Author
10
Date
11
Finally check that the Isapi filter is showing with a green up arrow, to locate this.
Select the Default website,
Right click and select Properties
Click the Isapi Filters tab, it should now have green upward facing arrow as shown below.
Author
11
Date
12
IIS 5.0 Isolation Mode
In some instances, setting up the web service extension alone will not get the ISAPI filter to turn
green. In this case, you have to run IIS in version 5.0 isolation mode.
Right click on the ‘Web Sites’ folder and select Properties
Author
12
Date
13
On the Service tab put a tick in ‘Run WWW service in IIS 5.0 isolation mode’
Go to Start | Run and type iisreset
This will reset all IIS services. Once this is done, the ISAPI filter should now be green and pointing
upwards.
Author
13
Date