How to Configure XML Service to Share Port with IIS on Windows Server 2008

This article contains information about configuring XML Service to share a port with Internet Information Systems (IIS) on 32 and 64-bit versions of Windows Server 2008.

Note:??After creating the CtxIntegrated virtual folder, the anonymous authentication must be disabled and Windows Integrated authentication must be enabled in the virtual directory.

To configure XML Service to share the port with IIS on Windows Server 2008 for 32 and 64-bit versions, complete the following procedures:

1. Stopping and Unregistering the Citrix XML Service
2. Configuring the Citrix XML Service to Share a Port with IIS 7.x
3. Adding and Allowing ISAPI Extensions for CtxScriptsPool
4. Managing and Displaying a List of Application Pools
5. Adding Application and Virtual Directory

Stopping and Unregistering the Citrix XML Service

To stop and unregister the Citrix XML service, complete the following procedure:

1. Run the following command from the command prompt to stop the XML Service:
   net stop ctxhttp

2. Run the following command from the command prompt to unregister the Citrix XML Service:
   ctxxmlss /u

Configuring the Citrix XML Service to Share a Port with IIS 7.x

To configure the Citrix XML service to share a port with IIS 7.x, complete the following procedure:

1. Select Run from Start menu and type \Inetpub.

2. Create the Scripts folder in the \Inetpub folder.

3. Copy the following files to the IIS Scripts folder on the web server:
   ctxconfproxy.dll
   ctxsta.config
   ctxsta.dll
   ctxxmlss.txt
   radexml.dll
   wpnbr.dll

   Notes:

   • The 64-bit script files (CtxConfProxy.dll, ctxsta.dll, wpnbr.dll, radexml.dll, ctxadmin.dll) are located in each x64 folder in the install disk and 32-bit script files are installed in the \Program Files(x86)\Citrix\System32 folder during XenApp installation. In this procedure, only 64-bit installation is considered. For 32-bit installation, replace the folder path appropriately.
   • The default Scripts folder is available in the \Inetpub folder.
   • When installing IIS 7.x, the virtual Scripts folder is not created by default.

4. In the IIS Scripts folder, create the CtxAdmin folder and copy the ctxadmin.dll file to the \Inetpub\Scripts\CtxAdmin folder.

5. In the IIS Scripts folder, create the resource folder.

6. Create the en sub-folder in the resource folder.

7. Copy the ctxstaui.dll file from \Program Files (x86)\Citrix\System32\resource\en folder to the\Inetpub\Scripts\resource\en folder.
   Note:For XenApp 6.x for Windows Server 2008 R2, create de, es, fr, and ja sub-folders in the resource folder. Copy each matched ctxstaui.dll file to each language sub-folder.

8. Open the IIS Manager console.

9. In the left-pane, double-click the Server node.

10. On the server node home page, double-click ISAPI and CGI Restrictions, as displayed in the following screen shot:

    

11. From the Actions section, select Add.

12. In the Add ISAPI or CGI Restrictions dialog box, browse and select the \inetpub\scripts\CtxConfProxy.dll file for the ISAPI or GGI path field.

13. (Optional) Type the description of the ISAPI or CGI path in the Description field.

14. Select the Allow extension path to execute option, as displayed in the following screen shot:

    

15. Click OK.

16. Repeat Steps 11 through 15 to add and allow the following ISAPI extensions:

• \inetpub\scripts\CtxConfProxy.dll
• \inetpub\scripts\ctxsta.dll
• \inetpub\scripts\radexml.dll
• \inetpub\scripts\wpnbr.dll
• \inetpub\scripts\CtxAdmin\ctxadmin.dll

The following screen shot displays the required ISAPI extensions added and allowed:

Adding and Allowing ISAPI Extensions for CtxScriptsPool and CtxAdminPool

To add and allow ISAPI extensions for CtxScriptsPool, complete the following procedure:

1. On the left-pane of the IIS Manager console, right-click Application Pools.

2. From the shortcut menu, select Add Application Pool, as displayed in the following screen shot:

   

3. In the Add Application Pool dialog box, type CtxScriptsPool in the Name field as displayed in the following screen shot:

   

4. From the .NET Framework version list, select NET Framework v2.0.50727.

5. From the Managed pipeline mode list, select Classic.

6. Select the Start application pool immediately option.

7. Click OK.

8. Repeat Steps 1??through 7 to add and allow ISAPI Extensions for the CtxAdminPool.

Managing and Displaying a List of Application Pools

To manage and display a list of Application Pools, complete the following procedure:

1. Right-click CtxScriptsPool in the Application Pools dialog box and select Advanced Settings from the shortcut menu.

2. In the Advanced Settings dialog box, select Identity from the Process Model section.

3. From the Built-in account list, select NetworkService, as displayed in the following screen shot:

   

   Note:??The NetworkService account needs READ/WRITE access to the scripts directory so it can write logs.

4. Click OK.

5. Repeat Steps 1 through 5 to manage CtxAdminPool in the Application Pool.

Adding Application and Virtual Directory

1. In the left-pane of the IIS Manager console, select and right-click Default Web Site.

2. Select Add Application.

3. In the Add Application dialog box, type Scripts in the Alias field.

4. Select CtxScriptsPool for Application Pool.

5. Browse and select the \inetpub\Scripts file for the Physical path field.

6. Click OK.

7. In the left-pane of the IIS Manager console, right-click on Scripts application and select Add Application.

8. Type CtxAdmin in the Alias field.

   

9. Select CtxAdminPool for Application Pool.

10. Browse and select the \inetpub\Scripts\ctxadmin file for the Physical path field.

11. Click OK.

12. In the left-pane of the IIS Manager, right-click Scripts application and select Add Virtual Directory.

    

13. Type CtxIntegrated in the Alias field.

14. Browse and select the \inetpub\Scripts file for the Physical path field.

15. Click OK.

16. In the left-pane of the IIS Manager, double-click to select Scripts.

17. In the center-pane, double-click Handler Mappings.

18. From the right-pane, select Edit Feature Permissions.

19. Select Execute in the Edit Feature Permissions dialog box. Click OK.
    Note: As a result of the setting inheritance from the Scripts application, the ISAPI-Dll mapping is Enabled.

20. Change the value of XMLChoice to Share from Separate.

    KeyName:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Install\{C05CE041-63DB-4467-B777-9FCB30013CA2}
    Name: XMLChoice
    Type: REG_SZ
    Data: Share

21. From command prompt, stop and restart the Web server by running the iisreset command. This setting takes effect after the Web server restarts.

Minimum Role Services Required for Web Server (IIS) role

The following table contains information about the Applications and minimum Role Services required for the Web Server (IIS) role: