How to Change the XML Port in XenDesktop

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:
  1. Click Start > Run.

  2. Type command prompt or cmd in the text field and choose Command Prompt or cmd that appears in the Programs listing.

    User-added image

  3. Type cd \.

    User-added image
  4. Type cd  Program Files\Citrix\Broker\Service and press Enter

    User-added image  
  5. Type BrokerService.exe /show and press Enter to show the current ports: 

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

    User-added image
  7. The Citrix Broker Service will then automatically stop and start to apply the change.

  8. Run the BrokerService.exe /show command again and validating the WI Port value to confirm, as displayed in the following screen shot:

    User-added image

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.