The Citrix MetaFrame servers cannot process your request at this time. The Citrix XML service OBJ

ArticleDirectory

• This document applies:

Explaining and changing the Citrix XML service port Document ID: Ctx104063 /Created on: 2004-5-7/updated on: 2008-4-16 Average rating:

View products this document applies

Explaining the XML Service

The Citrix XML service was introduced with MetaFrame 1.8 Service Pack 2 and a feature Release 1 license needed to be installed. MetaFrame XP and later inates the Citrix XML service as a standard feature.

When MetaFrame 1.8 Service Pack 2 or later is installed and the server rebooted, the Citrix XML service binaries are placed on the system whether the Citrix XML service was or was not installed. all that must be done to complete the Citrix XML service installation is to register the XML service itself by runningCtxxmlssCommand.

Unlike MetaFrame XP or later, MetaFrame 1.8 does not allow for the sharing of port 80 with IIS.

The below command-line syntax applies to all MetaFrame environments:

Ctxxmlss. EXE command line usage

Syntax

Ctxxmlss [Switches] [/RNNNN] [/KNnn] [/U] [/?]

Parameters

/RNNNN-Registers the service on port numberNNNN

/KNnn-Keep-aliveNnnSeconds (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 look in the Citrix Management Console (MetaFrame XP and later) and/or locate the following registry key (assuming IIS Port Sharing is not being used ):

Warning:Using Registry Editor incorrectly can cause serious problems that may
Require you to reinstall your operating system. Microsoft cannot guarantee that problems
Resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor
Your own risk. For information about how to edit the registry, view the "Changing keys
And values "help topic in Registry Editor (regedit.exe) or the" add and delete
Information in the Registry "and" Edit registry data "Help topics in regedt32.exe. Make
Sure you back up the registry before you edit it. If you are running Windows NT, also
Update your Emergency Repair Disk (ERD ).

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.

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 remove the Citrix XML service functionality from your MetaFrame server, simply rename or delete the wpnbr. DLL file.

Lastly, once 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

1. OpenCommand PromptWindow.

2. RunCtxxmlss/u(This command will unregister the Citrix XML service and mark it for deletion ).

3. Reboot the server.

Registering the XML service on a port other than sharing with IIS

1. unregister the service using the previous instructions.

2. OpenCommand PromptWindow.

3. RunCtxxmlss/R [Port Number](Notice that there is no space between the switch "/R" and the port number.

4. Reboot the server or open the Service Control Manager and manually startCitrix XML Service.

Registering the XML service to share the port with IIS 5.0

1. unregister the service using the previous instructions.

2. copy the filesCtxxmlss.txt, CLM. dll, wpnbr. dllTo\ Inetpub \ scriptsFolder.***(If you are runningMetaFrame Presentation Server 3.0ThenCLM. dllFile is no longer needed ).***

3. If you are runningMetaFrame Presentation Server 3.0 or Citrix Presentation Server 4.0,Locate the file ctxadmin. dll and copy it to a folder calledCtxadminUnder\ Inetpub \ scripts.

4. If you are runningCitrix Presentation Server 4.0,Locate the filesCtxconfproxy. dll, ctxsta. dll, ctxsta. configAnd copy them\ Inetpub \ scripts.

5. OpenIIS manager MMC snap-in.

6. ExpandDefault web site.

7. Right-clickScriptsFolder and clickProperties.

8. On the virtual directory tab make sure thatExecute permissionsField is setScripts and executables.

9. OpenCommand PromptWindow.

10. RunIisresetCommand (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 ctx0000683-how to configure the XML service to share with IIS.

Otherwise, follow these steps:

By default when installing IIS 6.0 the virtual scripts folder is not created.

1. unregister the service using the previous instructions.

2. navigate to\ InetpubFolder and create a new folder namedScripts.

3. OpenIIS manager MMC snap-in.

4. Right-clickDefault web siteAnd selectNew | virtual directory...

5. ClickNext.

6. UnderAlias:Type the nameScriptsAnd clickNext.

7. UnderPath:TypeDrive letter: \ Inetpub \ scriptsAnd clickNext.

8. UnderAllow the following permissions:Make sure that the following are selected:

A. Read

B. run scripts (such as ASP)

C. Execute (such as ISAPI applications or cgi)

9. ClickNextAnd clickFinish.

10. Right-clickScriptsVirtual directory and goProperties.

11. Under the virtual directory tab make sure thatExecute permissions:Field is setScripts and executables.

12. Under the Directory Security tab, clickEdit...UnderAuthentication and Access ControlAnd make sure thatEnable Anonymous AccessCheck box is selected.

13. Now copy the files ctxxmlss.txt, CLM. dll, wpnbr. DLL to the newly createScriptsFolder underInetpubFolder.***(If you are runningMetaFrame Presentation Server 3.0ThenCLM. dllFile is no longer needed ).***

14. If you are runningMetaFrame Presentation Server 3.0Locate the file ctxadmin. dll and copy it to a folder called ctxadmin under \ Inetpub \ scripts.

15. In IIS Admin right-clickWeb service extensions, SelectAdd a new Web ServiceExtension. type the nameCitrix XML ISAPIInExtension nameField and clickAdd. InAdd FilePopup window, type in or browse to the location of the wpnbr. dll file. Then finish by selectingSet the extension status to allowedCheck box.

16.MetaFrame Presentation Server 3.0,IN iis Admin right-clickWeb service extensions, SelectAdd a new Web ServiceExtension. type the nameCitrix XML administration ISAPIInExtension nameField and clickAdd. InAdd FilePopup window, type in or browse to the location of the ctxadmin. dll file. Then finish by selectingSet the extension status to allowedCheck box.

17. RunIisresetCommand (be aware that this command will restart all IIS-related services ).

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 MetaFrame Presentation Server 3.0, all the files required are located in Program Files \ Citrix \ System32.

This document applies:

• MetaFrame XP 1.0 for Microsoft Windows 2003
• Presentation Server 4.0 for Microsoft Windows 2000
• MetaFrame Presentation Server 3.0 for Microsoft Windows 2003
• Presentation Server 4.5 for Windows Server 2003
• MetaFrame XP 1.0 for Microsoft Windows 2000
• Presentation Server 4.0 for Microsoft Windows 2003
• MetaFrame Presentation Server 3.0 for Microsoft Windows 2000