Connect Release Management to TFS

Last Update: 9/26/2016

Visual Studio 2015 | Team Services | TFS 2015 | Previous version

horizontal-line

information A newer version of Release Management is available

Release Management features have been integrated into the Build & Release hub in Team Foundation Server (TFS) and Visual Studio Team Services. For more information, see Continuous integration on any platform.

The newer web-based version is the recommended alternative to the server and client version described in this topic. If you do not already have Release Management installed, we encourage you to use the web-based version in TFS 2015 Update 2 and above or Visual Studio Team Services instead of the version described here. If you are already using an earlier server and client version, you should be aware that no new features will be added to these versions.

horizontal-line

Installing Release Management on TFS

These are the steps for connecting TFS to Release Management and adding an SMTP server. These are optional procedures. See system requirements for details of compatible versions of TFS. If you want to connect TFS, you will need a user account to act as an intermediary between TFS and Release Management. We show an account being created for this purpose, but you can use an account that already exists in TFS as long as it has the appropriate permissions.

Connect Release Management to TFS

  1. Ensure that you are a member of the Release Manager role in Release Management. In addition, to manage permissions in TFS, you must be a member of the Project Collection Administrators group. To add a user account, you must be a member of the Windows Administrators group (local user) or the Domain Administrators group (domain account).

    Tip: Do you need to add team mates to the Release Manager role in Release Management? See Add users to Release Management.

  2. Either designate an existing account or create a user account in TFS to act as intermediary account for Release Management. This can be a local or domain account. It doesn't need any special Windows or Domain permissions. We're creating a local Windows account named RMTFS here.

    Selecting an intermediary account for TFS

    Note: If you're planning to use an account that already exists in TFS, you can skip this step. If you have TFS deployed on more than one server, you'll want to use a domain account.

  3. In TFS, make the account a member of the Project Collection Administrators group. For more details, see Set administrator permissions for team project collections, though you can ignore the procedures for SharePoint and Reporting Services. Release Management doesn't require access to these features.

    Adding the account to the Project Collection Administrators group

  4. In TFS, select the account and set the Make requests on behalf of others permission to Allow.

    Allowing requests on behalf of others

  5. In Release Management client, choose Administration, Manage TFS and then New.

    Opening the TFS management page in Release Management client

  6. Add the URL and project collection for TFS.

    Setting the TFS configuration values in Release Management client

  7. Enter the name and password of the account that you permissioned in step 2 and then Verify the password for the account.

    Setting the connection identity in Release Management client

  8. After you save these settings, Release Management is connected to this TFS project collection. You're ready to manage releases with TFS and Release Management.

Set up an SMTP server

  1. Ensure that you are a member of the Release Manager role in Release Management. This is required to connect an SMTP server to Release Management.

    Tip: Do you need to add team mates to the Release Manager role in Release Management? See Add users to Release Management.

  2. In Release Management client, choose Administration and then Settings.

  3. In the SMTP Server Configuration box, enter the Server Name, Port, User Name and User Password for your SMTP server.

  4. Choose Save.

Go back Back to overview

Help and support

Send suggestions on UserVoice, follow us on Twitter @vsreleasemgmt

or send a smile from the Send-a-Smile link on the menu bar.