Change Release Management Server URL in Release Management Client 2013

  • Article

Setting up Release Management Server URL in Release Management Client should be done when it is set up initially. In an already configured client, it is possible to change the URL of the server, in Administration tab like shown below.
http://lh3.googleusercontent.com/-UdNAklWW6mc/VeIE759PCDI/AAAAAAAAFvg/OR9ppAe1a34/image_thumb%25255B2%25255D.png?imgmax=800 http://lh3.googleusercontent.com/-CqxJLDvao6Q/VeIE-qlcFxI/AAAAAAAAFvw/tgkH1a1osSI/image_thumb%25255B4%25255D.png?imgmax=800 http://lh3.googleusercontent.com/-RtCw1b_UmOY/VeIFBEaJMhI/AAAAAAAAFwA/Q-M8A-XPtMQ/image_thumb%25255B6%25255D.png?imgmax=800
If the configured server is not accessible, the client will show error,
“The Release Management Server is not currently available. If the problem persists please contact your administrator. The application will now close.”
http://lh3.googleusercontent.com/-6xy3chshNSw/VeIFDZThkSI/AAAAAAAAFwQ/zW6CS5Q0hEg/image_thumb%25255B7%25255D.png?imgmax=800
Since the client is getting closed when OK button is clicked, it is not possible to change the server URL in the Release Management client.
In Release Management 2013, generally following path contains the file (Microsoft.TeamFoundation.Release.Data.dll.config) containing the server URL.
C:\Program Files (x86)\Microsoft Visual Studio 12.0\Release Management\Client\bin
http://lh3.googleusercontent.com/-U9YvOolS1qw/VeIFFi1H__I/AAAAAAAAFwg/qSGaZJbNddw/image_thumb%25255B11%25255D.png?imgmax=800
It is possible to manually edit the “Microsoft.TeamFoundation.Release.Data.dll.config” file, and URL needs to be set in multiple locations in this file.
http://lh3.googleusercontent.com/-bwPBCNP89cE/VeIFH-I0srI/AAAAAAAAFww/HwnCGhZ_hnQ/image_thumb%25255B13%25255D.png?imgmax=800
There is easier option to do this with RM server 2013 update 2 onwards. That is by using the “ReleaseManagementConsoleAdjustConfigFile.exe” in the same folder (C:\Program Files (x86)\Microsoft Visual Studio 12.0\Release Management\Client\bin).
http://lh3.googleusercontent.com/-d6gFhIeN1I8/VeIFJ2e7diI/AAAAAAAAFxA/uNj9avs5EAE/image_thumb%25255B15%25255D.png?imgmax=800
Two parameters are required to be passed to this executable to set the new URL for the release management client.

  • **configfilename ** config file name that is Microsoft.TeamFoundation.Release.Data.dll.config
  • newwebserverurl New RM Server URL

Example command below.

ReleaseManagementConsoleAdjustConfigFile.exe -configfilename .\Microsoft.TeamFoundation.Release.Data.dll.config -newwebserverurl http://YourRMServer:1000

This command should be run in Administrative command prompt.

http://lh3.googleusercontent.com/-AVeQGEZNI3k/VeIFL2Xl3EI/AAAAAAAAFxQ/6OtuX_IDGZk/image_thumb%25255B17%25255D.png?imgmax=800

The command updates the “Microsoft.TeamFoundation.Release.Data.dll.config” file.

http://lh3.googleusercontent.com/-G27Y91Mp148/VeIFONhSBsI/AAAAAAAAFxg/8MKh-qRLMQc/image_thumb%25255B19%25255D.png?imgmax=800

When the correct URL is set the RM Client can connect to RM server.

http://lh3.googleusercontent.com/-2--mdNHuGxg/VeIFQI-M-kI/AAAAAAAAFxw/Cb_EHV60jZI/image_thumb%25255B21%25255D.png?imgmax=800