Important
To successfully integrate Xpert.ivy Server into Microsoft Internet Information Server it is important that you exactly execute all the integration steps described below. If the integration does not work verify each integration step again.
IIS 6 (Windows Server 2003)
1. If your Microsoft Internet Information Server is not running on the same host as the Xpert.ivy Server then copy the integration directory to the host where your IIS is running. All next steps have to be done on the host the IIS is running on.
2. Allow the user groups Authenticated Users and IIS_WPG to have Full control permission on the integration directory.
3. Open the Internet Information Services (IIS) Manager (Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager). On the left pane select the context menu New > Application Pool ... of the node Application Pools. A dialog opens.
Configure the Application pool ID of the application pool with Xpert.ivy Server.
Click OK to close the dialog and create the application pool:
4. On the left pane select the context menu New > Virtual Directory ... on the node of the web site you want to integrate Xpert.ivy Server into. A wizard appears. Configure the Alias of the Virtual Directory with ivy:
Configure the Path of the Virtual Directory with the path of the integration directory:
Configure the Access Permissions of the Virtual Directory with Read and Execute:
Click on Next > and Finish to finish the wizard and create the Virtual Directory.
5. On the left pane select the context menu Properties on the new created Virtual Directory. On the tab Virtual Directory select Xpert.ivy Server in the Application pool:
combo box:
6. On the left pane select the context menu Add a new Web service extension ...
on the node Web Service Extensions. A dialog appears. Configure the Extension name with the value Xpert.ivy Server and the Required files: with the path of the file isapi_redirect-1.2.30.dll in the integration directory. Select the check box Set extension status to Allowed. Click OK to create the new web service extension:
7. On the left pane select the context menu Properties on the web site you want to integrate Xpert.ivy Server into. A dialog appears. Change to the tab ISAPI Filters. Press the button Add .... Another dialog appears. Configure the Filter name: with the value Xpert.ivy Server and the Executable with the path of the file isapi_redirect-1.2.30.dll in the integration directory:
Click OK to add the new ISAPI filter and again OK to finish the Properties dialog.
8. If your Microsoft Internet Information Server is not running on the same host as the Xpert.ivy Server or if you have changed the AJP port of the Xpert.ivy Server then open the file worker.properties inside the integration directory in a text editor. Change the following line if you have changed the AJP port to another value than 8009:
worker.XpertIvyServer.port=8009
Change the value localhost in the following line to the host where your Xpert.ivy Server is running if your Microsoft Internet Information Server is not running on the same host as the Xpert.ivy Server:
worker.XpertIvyServer.host=localhost
9. Check if the integration is working by opening a web browser on the address http://<your host>/ivy/
IIS 7 (Windows Server 2008)
1. If your Microsoft Internet Information Server is not running on the same host as the Xpert.ivy Server then copy the integration directory to the host where your IIS is running. All next steps have to be done on the host the IIS is running on.
2. Allow the user groups Authenticated Users and IUSR to have Full control permission on the integration directory.
3. Open the Server Manager (Start > Control Panel > Administrative Tools > Server Manager).
Navigate to the node Server Manager > Roles > Web Server (IIS) and select it. Validate that under the Role Services the services CGI, ISAPI Extensions and ISAPI Filters are installed. If this is not the case select the menu Add Role Services to install the missing services.
4. Open the Internet Information Services (IIS) Manager (Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager). In the Connections pane select the node that represent your machine. In the Feature View open the Feature Delegation entry.
Ensure that the Delegation of the Handler Mappings are set to Read/Write. Use the menu Read/Write on the Actions pane to change the Delegation to Read/Write.
5. In the Connections pane navigate to the Web Site you want integrate the Xpert.ivy Server into. Use the context menu Add Virtual Directory ... of the Web Site to add a new Virtual Directory. A dialog opens. Configure the Alias of the Virtual Directory with ivy and the Physical path of the Virtual Directory with the path of the integration directory. Click OK to close the dialog and create the Virtual Directory:
6. Select the new created Virtual Directory ivy in the Connections pane and open the Handler Mappings entry in the Feature View:
In the Actions pane select the Edit Feature Permissions ... menu:
On the Edit Feature Permission dialog select all three permission and click OK:
7. Select the Web Site in the Connections pane and open the ISAPI Filters entry in the Feature View:
In the Actions pane select the Add ... menu:
On the Add ISAPI Filter dialog configure the Filter name with Xpert.ivy Server and the Executable with the path of the isapi_redirect-1.2.30.dll located in the integration directory. Click OK to add the ISAPI Filter:
8. In the Connections pane select the node that represent your machine and open the ISAPI and CGI Restrictions entry in the Features View:
In the Actions pane select the Add ... menu:
On the Add ISAPI or CGI Restriction dialog configure the ISAPI or CGI path with the path of the isapi_redirect-1.2.30.dll located in the integration directory.
As Description use Xpert.ivy Server. Select the Allow extension path to execute check box. Click OK to add the ISAPI or CGI Restriction:
9. If your Microsoft Internet Information Server is not running on the same host as the Xpert.ivy Server or if you have changed the AJP port of the Xpert.ivy Server then open the file worker.properties inside the integration directory in a text editor. Change the following line if you have changed the AJP port to another value than 8009:
worker.XpertIvyServer.port=8009
Change the value localhost in the following line to the host where your Xpert.ivy Server is running if your Microsoft Internet Information Server is not running on the same host as the Xpert.ivy Server:
worker.XpertIvyServer.host=localhost
10.Check if the integration is working by opening a web browser on the address http://<your host>/ivy/
Change context URI /ivy/
The context URI /ivy/ can be changed inside the Xpert.ivy Server by changing the system property WebServer.IvyContextName (See chapter System Properties to learn about how to change a system property). However, if you change the context URI on the Xpert.ivy Server you also have to change the context URI in the Microsoft IIS integration. This can be done by changing the last line of the uriworkermap.properties configuration file:
/ivy/*=XpertIvyServer
If you want to have /xpertline/ as the context URI change this line to the following:
/xpertline/*=XpertIvyServer