CTX104063 - Explaining and Changing the Citrix XML Service Port - Citrix Knowledge Center

06-02-2014

KNOWLEDGE CENTER
Knowledge Center Knowledge Center eDocs Communities Discussions Blogs Alerts Sign in

Knowledge Center Home > CTX104063

Rate this Article:

Include Discussions

Print View

22

Languages: Select

Article Feedback

Advanced Search Language Options

Explaining and Changing the Citrix XML Service Port

Document ID: CTX104063 / Created On: Aug 18, 2004 / Updated On: Feb 22, 2013

Products
XenApp XenDesktop XenServer DesktopPlayer XenClient NetScaler NetScaler Gateway (Formerly Access Gateway) Receiver VDI-in-a-Box CloudBridge >> View All Products

Average Rating:

(74 ratings)

View products this document applies to

Summary
This article explains the XML Service. The Citrix XML Service was introduced with MetaFrame 1.8 Service Pack 2 and a Feature Release 1 license has to be installed. MetaFrame XP and later incorporates the Citrix XML Service as a standard feature.

CTXXMLSS.EXE Command Line Usage

The command-line syntax below applies to all MetaFrame environments: Syntax: CTXXMLSS [switches] [/Rnnnn] [/Knnn] [/U] [/?] Parameters: /Rnnnn - Registers the service on port number nnnn /Knnn - Keep-Alive nnn seconds (default 9). /U - Unregisters the service. /? (help) - Displays the syntax for the utility and information about the utilities options. After the Citrix XML Service is registered, a new service appears in the Services Applet and registry entries are created. Ensure this service is started. To determine which port is being used, either verify its presence in the Citrix Management Console (MetaFrame XP and later) and/or locate the following registry key (assuming IIS port sharing is not being used):

Knowledge Resources
Product Documentation Interoperability Updates Troubleshooting Customer Service My Support Options

Caution! This procedure requires you to edit the registry. Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Back up the registry before you edit it. HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CtxHttp Value: "TcpPort" If the value is listed in hex, change to a decimal notation. If Microsoft IIS is installed, the administrator of the MetaFrame XP installation is given the option to install the Citrix XML Service and share a port with IIS. remove the Citrix XML Service functionality from your MetaFrame server, rename or delete the Wpnbr.dll file.

Support & Maintenance In fact, no separate XML Service is running. IIS serves the XML data using an ISAPI filter named Wpnbr.dll located in the \Inetpub\Scripts folder. To Programs
New! Premier Support

Software Support Appliance Maintenance

And when the XML Service port is changed on the MetaFrame Servers, change NFuse or Web InterFace, MetaFrame Secure Access Manager, or the Program Neighborhood Client to use the new port.

Unregistering the XML Service

Complete the following steps to un-register the XML Service: 1. Open a command Prompt window. 2. Run ctxxmlss /u (This command unregisters the Citrix XML Service and marks it for deletion).

Registering the XML Service on a port other than sharing with IIS
1. 2. 3. 4. Unregister the service using the previous instructions. Open a command Prompt window. Run ctxxmlss /r[Port Number]. Note that there is no space between the switch /r and the port number. Open the service control manager and manually start the Citrix XML Service.

Note: During the unregister/register process you might see the below error message. There is no need to reboot the server. Just run the Unregister command again, go to services and attempt to start the service then Reregister the service. Could not start the Citrix XML Service service on Local Computer. Error 1060: The specified service does not exist as an installed service.

Registering the XML Service to share the port with IIS 5.0
1. Unregister the service using the preceding Unregistering the XML Service instructions. 2. Copy the files ctxxmlss.txt, clm.dll, wpnbr.dll to the \Inetpub\Scripts folder. ***(If you are running MetaFrame Presentation Server 3.0 then the clm.dll file is no longer needed).*** 3. If you are running MetaFrame Presentation Server 3.0 or Citrix Presentation Server 4.0, locate the file ctxadmin.dll and copy it to a folder called ctxadmin under \Inetpub\Scripts. 4. If you are running Citrix Presentation Server 4.0, locate the files ctxconfproxy.dll,ctxsta.dll,ctxsta.config and copy them to \Inetpub\Scripts. 5. Open the IIS Manager MMC Snap-in. 6. Expand the Default Web Site.

http://support.citrix.com/article/CTX104063

1/3

CTX104063 - Explaining and Changing the Citrix XML Service Port - Citrix Knowledge Center

06-02-2014

7. 8. 9. 10.

Right-click the Scripts folder and click Properties. On the Virtual Directory tab make sure that the Execute Permissions field is set to Scripts and Executables. Open a command prompt window. Run the iisreset command (be aware that this command will restart all IIS-related services).

Registering the XML Service to share the port with IIS 6.0
For Citrix Presentation Server 4.0 on Windows 2003, refer to CTX107683 How to Configure the XML Service to Share with IIS. For other versions, complete the following steps: By default when installing IIS 6.0, the virtual Scripts Folder is not created. 1. Unregister the service using Unregistering the XML Service. 2. Navigate to the \Inetpub folder and create a new folder named Scripts. 3. Open the IIS Manager MMC Snap-in. 4. Right-click the Default Web Site and select New | Virtual Directory. 5. Click Next. 6. Under Alias: type the name Scripts and click Next. 7. Under Path: type Drive Letter:\Inetpub\Scripts and click Next. 8. Under Allow the following permissions: make sure that the following are selected: Read Run Scripts (such as ASP) Execute (such as ISAPI applications or CGI) 9. Click Next and click Finish. 10. Right-click the Scripts virtual directory and go to Properties. 11. Under the Virtual Directory tab make sure that the Execute Permissions: field is set to Scripts and Executables. 12. Under the Directory Security tab, click Edit under Authentication and Access Control and make sure that the Enable anonymous access check box is selected. Now copy the files ctxxmlss.txt, clm.dll, wpnbr.dll to the newly create Scripts folder under the Inetpub folder. ***(If you are running MetaFrame Presentation Server 3.0 then the clm.dll file is no longer needed).*** If you are running MetaFrame Presentation Server 3.0, locate the file ctxadmin.dll and copy it to a folder called ctxadmin under \Inetpub\Scripts. In IIS Admin right-click Web Service Extensions, select Add a new web service extension. Type the name Citrix XML ISAPI in the Extension name field and click Add. In the Add File popup window, type in or browse to the location of the wpnbr.dll file. Then finish by selecting the Set the extension status to allowed check box. For MetaFrame Presentation Server 3.0, in IIS Admin right-click Web Service Extensions, select Add a new web service extension. Type the name Citrix XML Administration ISAPI in the Extension name field and click Add. In the Add File popup window, type in or browse to the location of the ctxadmin.dll file. Then finish by selecting the Set the extension status to allowed check box. Run the iisreset command (be aware that this command restarts all IIS-related services).

Registering the XML Service to share the port with IIS 7.0
For XenApp Server 5.0 and 6.0 on Windows Server 2008 and R2, refer to CTX125107 How to Configure XML Service to Share a Port with IIS on 32 and 64 Bit Versions of Windows Server 2008. Note: The file ctxxmlss.txt is located in the Program Files\Citrix\System32 folder and the files clm.dll and wpnbr.dll are located in the <SYSTEMROOT>\System32 folder. With Presentation Server 3.0, all the files required are located in Program Files\Citrix\System32.

More Information
CTX128115 - Unable to Launch Published Applications from XenApp 6.x CTX125153 - How to Configure XML to Use a Different Port in XenApp 6.0 and 6.5

This document applies to:

MetaFrame Presentation Server 3.0 for Microsoft Windows 2000 MetaFrame Presentation Server 3.0 for Microsoft Windows 2003 MetaFrame XP 1.0 for Microsoft Windows 2000 MetaFrame XP 1.0 for Microsoft Windows 2003 Presentation Server 4.0 for Microsoft Windows 2000 Presentation Server 4.0 for Microsoft Windows 2003 Presentation Server 4.5 for Windows Server 2003 XenApp 5.0 for Windows Server 2003 x86 XenApp 5.0 for Windows Server 2008 x64 XenApp 5.0 for Windows Server 2008 x86 XenApp 6.0 for Windows Server 2008 R2 XenApp 6.5 for Windows Server 2008 R2 XenApp Fundamentals 6.0 for Windows Server 2008 R2

Did this article resolve your problem/question?

Yes No Need to test first Not sure, I need help Just browsing/General research

Provide comments about this article

http://support.citrix.com/article/CTX104063

2/3

CTX104063 - Explaining and Changing the Citrix XML Service Port - Citrix Knowledge Center
Contact Careers Legal Notice Privacy Governance Site Map

06-02-2014
1999-2014 Citrix Systems, Inc. All rights reserved.

http://support.citrix.com/article/CTX104063

3/3