How to Change the Virtual Desktop Agent (VDA) Registration Port in XenDesktop 5 for Desktop Delivery Controller and Virtual Desktop Agent
Created On: Jun 23, 2011 / Updated On: Jan 2, 2013
Average Rating: 
Summary
This article describes how to change the Virtual Desktop Agent (VDA) registration port in XenDesktop 5 for Desktop Delivery Controller (DDC) and VDA.
This article contains information about the following two scenarios:
Requirements
The following are the basic requirements for changing the VDA registration port in XenDesktop 5 for DDC and VDA:
- A working XenDesktop 5 site
- A VDA with Agent version 5.x installed
- All VDAs registered and functioning
- Permission to perform power actions on VDAs
Background
The default VDA registration port is 80 in XenDesktop 5 and 8080 in XenDesktop 4. VDAs now inherit their VDA Registration Ports through Citrix policy.
Caution! The order in which you change the VDA registration port is important. Any deviation from these steps requires you to update the registry to force communication on the desired port.
Caution! The order in which you change the VDA registration port is important. Any deviation from these steps requires you to update the registry to force communication on the desired port.
Procedure
To change the VDA registration port in XenDesktop 5 for DDC and VDA, complete the following procedure:
For this scenario, create the Citrix Machine Policy and update the DDCs, as explained the following procedures:
Creating a Citrix Machine Policy
- Create a new Citrix Machine policy or edit an existing one.
Note: In this example, the Unfiltered policy is modified so that the change applies to all VDAs, as displayed in the following screen shot:
- Navigate to the Settings tab and select Control Registration Port, as displayed in the following screen shot:
- Update the Value to reflect the new port, as displayed in the following screen shot:
- Select OK.
- Restart all Desktops and verify that all VDAs register successfully.
- Restart all Desktops and wait until all the Desktops report as Unregistered.
Updating the DDCs
- Open command prompt.
- Navigate to the XenDesktop install directory Program Files\Citrix\Broker\Service
- Enter BrokerService.exe /Show to display the currently used ports.
- To change the WCF port, type BrokerService.exe -VdaPort <port>, as displayed in the following screen shot:
- Press Enter.
- The CitrixBrokerService stops and then starts to complete the change.
For this scenario, force VDA 5.x Registration Port Change using the Registry, as explained in the following procedure:
Caution! This fix 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. Be sure to back up the registry before you edit it.
Caution! This fix 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. Be sure to back up the registry before you edit it.
- On VDA, create the following string value under HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\VirtualDesktopAgent:
Name: RegistrarEndpointPattern
Type: REG_SZ
Data: <?xml version="1.0" encoding="utf-16"?><RegistrarEndpointInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><Address>http://{0}:<NewWCFport>/
Citrix/CdsController/IRegistrar</Address><Binding>WsHttpBindingIRegistrarEndpoint</Binding>
<Contract>Citrix.Cds.Protocol.Controller.IRegistrar</Contract></RegistrarEndpointInfo>
Notes
• Replace <NewWCFport> with the modified WCF port, for example <Address>http://{0}:8080/Citrix/CdsController/IRegistrar
• The data value contains hidden characters to allow it to display properly. Copy the text from the attached file if you require a copy.
- Stop and restart the Citrix Desktop service.
- Once successfully registered, the VDAs policy is updated. You can remove this value.
More Information
Upgrades from VDA 4.x and command line installations must be accompanied by the preceding registry change.
Refer to the Knowledge Center article CTX123000 - How to Configure XenDesktop Registration in a Non-Organizational Unit and Modified WCF Port for more information.
No comments:
Post a Comment