How to Change the XML Port in XenDesktop
book
Article ID: CTX127945
calendar_today
Updated On:
Description
This article describes how to change the XML port in XenDesktop 5.x based releases to something other than the default of 80.
Requirements
This change is required to be made on each controller within the XenDesktop 5.x site that you want to change the XML port on.
Note: This change only alters communications between Web Interface or the StoreFront, and the XenDesktop Controller: it does not change the Windows Communication Foundation (WCF) Registration port that Virtual Desktop Agents use.
Background
In previous versions of XenDesktop (2.0/3.0/4.0), you were able to change the XML port using the
ctxxmlss.exe command. In XenDesktop 5.x releases, this change is now achieved using the BrokerService.exe command as shown in the following section. This change is because of the XML functionality being included as part of the Broker Service in XenDesktop 5.x releases.
Note: The Command Prompt must be run with Administrative privileges (right-click, choose
Run as Administrator if you are not logged on as a user with Administrator rights on the server). If you do not run Command Prompt with Administrative level rights, an error might occur when trying to run the BrokerService.exe commands.
Instructions
To change the XML port in XenDesktop 5.x, complete the following steps:
-
Click Start > Run.
-
Type command prompt or cmd in the text field and choose Command Prompt or cmd that appears in the Programs listing.

-
Type cd \.

-
Type cd Program Files\Citrix\Broker\Service and press Enter.
-
Type BrokerService.exe /show and press Enter to show the current ports:

-
To change the XML port type, BrokerService.exe -wiport (storefrontport) port and press Enter:

-
The Citrix Broker Service will then automatically stop and start to apply the change.
-
Run the BrokerService.exe /show command again and validating the WI Port value to confirm, as displayed in the following screen shot:

Issue/Introduction
This article describes how to change the XML port in XenDesktop 5.x based releases using the BrokerService.exe command.
Additional Information
Please note:
Update the STA port in your storefront server under "Manage Citrix Gateways" and edit your gateway appliance and add/modify the new STA along with the port number.
Similarly, modify the port number under Store -> Manage -> Delivery controller -> Edit -> Over here mention the new port number for your controller.
Was this article helpful?
thumb_up
Yes
thumb_down
No