Team Foundation Server 2013 Installation Guide Page 1 of 164 Team Foundation Server 2013 Installation Guide Benjamin Day benday@benday.com v1.1.0 May 28, 2014
Team Foundation Server 2013 Installation Guide Page 2 of 164 Contents Chapter 1: Install Windows 2012 Server... 3 Install Windows Server 2012... 3 Join Windows to a Domain... 17 Configure Windows Update... 23 Chapter 2: Install SQL Server 2014... 32 Chapter 3: Install SQL Server 2012... 53 Chapter 4: Install SharePoint Foundation 2013 w/ Service Pack 1... 74 Install SharePoint Foundation 2013 Pre-requisites... 75 Install SharePoint Foundation... 81 Run the SharePoint Products Configuration Wizard App... 86 Run the SharePoint Configuration Web-based Wizard... 94 Chapter 5: Install Team Foundation Server 2013 Update 2... 99 SharePoint Option 1: Blocked... 108 SharePoint Option 2: Automatic Installation... 109 SharePoint Option 3: Manually Installed SharePoint... 113 TFS2013 Readiness Checks... 114 Chapter 6: Install Team Foundation Server 2013 (RTM)... 118 Chapter 7: Install TFS2013 Build Server... 137 Chapter 8: Install TFS2013 Test Controller for Automated Testing... 154
Team Foundation Server 2013 Installation Guide Page 3 of 164 Chapter 1: Install Windows 2012 Server The first step of installing Team Foundation Server 2013 is to install Windows Server. Since this installation guide is focused on installing TFS onto a single server aka. the TFS App Tier and Data Tier will be installed on a single machine we have to look at the system requirements for all the pieces of TFS plus the requirements for SQL Server Reporting Services, SQL Server Analysis Services, and SharePoint. This guide will show you how to install TFS2013 on a single server and will use SharePoint Foundation 2013 for the SharePoint integration. Why am I writing all this in the chapter about installing Windows Server 2012? Because at the current moment, SharePoint Foundation 2013 is not supported on Windows Server 2012 R2. Notice that I said 2012 R2 and not 2012. This isn t a TFS2013 limitation but because we re relying on SharePoint Foundation 2013, it means that we need to install TFS2013 on Windows 2012. Install Windows Server 2012 Either insert your Windows Server 2012 DVD into your DVD drive or mount the Windows Server 2012 ISO image into your virtual machine. Start the machine
Team Foundation Server 2013 Installation Guide Page 4 of 164 You ll eventually see a message that says Press any key to boot from CD or DVD. Press any key (example: <SPACE>) to run the Windows Server installer
Team Foundation Server 2013 Installation Guide Page 5 of 164 You should see the Windows Setup dialog which prompts you to choose your language, time/currency formats, and keyboard/input method. This guide will assume that you choose English (United States) for Language, Time/Currency and choose US for the keyboard settings. Choose your Language to install Choose your Time and currency format Choose your Keyboard or input method Click Next
Team Foundation Server 2013 Installation Guide Page 6 of 164 Click the Install now button
Team Foundation Server 2013 Installation Guide Page 7 of 164 Enter your product key Click Next
Team Foundation Server 2013 Installation Guide Page 8 of 164 You should see a dialog asking you to Select the operating system you want to install. Choose Windows Server 2012 Standard (Server with a GUI) Click Next
Team Foundation Server 2013 Installation Guide Page 9 of 164 Check the I accept the license terms checkbox Click Next
Team Foundation Server 2013 Installation Guide Page 10 of 164 Click Custom: Install Windows only (advanced)
Team Foundation Server 2013 Installation Guide Page 11 of 164 You should now see a list of disks and partitions. Choose the disk and/or partition where you want to install Windows Click Next
Team Foundation Server 2013 Installation Guide Page 12 of 164 The installation should now be running.
Team Foundation Server 2013 Installation Guide Page 13 of 164 After the installer has finished setting up windows on your disk, you ll be prompted to supply an administrator password. Enter an administrator password in the Password and Reenter password boxes Click the Finish button
Team Foundation Server 2013 Installation Guide Page 14 of 164 You should now see the Windows Server 2012 lock screen. Press Ctrl+Alt+Del to bring up the login dialog
Team Foundation Server 2013 Installation Guide Page 15 of 164 Type your administrator password followed by <Enter>
Team Foundation Server 2013 Installation Guide Page 16 of 164 You should be able to successfully log in and you should see the Server Manager window. Windows Server 2012 has been installed.
Team Foundation Server 2013 Installation Guide Page 17 of 164 Join Windows to a Domain At this point, you have just a basic and clean install of Windows Server 2012. For ease of permissions management, it s time to join this server to an Active Directory Domain. Press the Start button on your keyboard to bring up the Start page You should now see a Start page that looks something like the screenshot below. Windows Server 2012 and Windows 8 are tricky and it s not immediately obvious but you can just type stuff on the keyboard in order to perform actions. That s what you ll do on this next step just start typing. Type Join a domain
Team Foundation Server 2013 Installation Guide Page 18 of 164 After you start typing, you should see a search dialog appear. By default, the search is going to be on Apps and it won t show any results. The action you want is under Settings. Click on the Settings icon You should now see Join a domain in the results. Click Join a domain
Team Foundation Server 2013 Installation Guide Page 19 of 164 You should now see the System Properties dialog. Click the Change button
Team Foundation Server 2013 Installation Guide Page 20 of 164 You should see the Compute Name / Domain Changes dialog. Enter the name that you d like to use for this computer in the Computer name box Select the Domain radio button Enter the name of your domain in the Domain textbox Click OK
Team Foundation Server 2013 Installation Guide Page 21 of 164 When prompted by the Windows Security dialog, enter the username and password for a member of the Domain Admins group in Active Directory. Enter the user name & password for a member of the Domain Admins group for this domain Click the OK button You should now see a welcome message for your domain. Click OK
Team Foundation Server 2013 Installation Guide Page 22 of 164 You ll be prompted to reboot the machine. Click the OK button Click the Close button
Team Foundation Server 2013 Installation Guide Page 23 of 164 Click the Restart Now button Configure Windows Update Now that Windows is joined to the domain, you should configure and run Windows Update to make sure that the server is patched. Log into the server using an account with Administrator permissions Press the Start key to get to the Start page Type Install Optional Updates Click the Settings icon
Team Foundation Server 2013 Installation Guide Page 24 of 164 You should now see Install optional updates in the search results. Click Install optional updates
Team Foundation Server 2013 Installation Guide Page 25 of 164 Click the Turn on automatic updates button
Team Foundation Server 2013 Installation Guide Page 26 of 164 Windows Update will spin for a while. When that s completed, you need to enable updates for other Microsoft products. Click Find out more
Team Foundation Server 2013 Installation Guide Page 27 of 164 A browser window will appear. Check the I agree to the Terms of Use for Microsoft Update checkbox Click the Install button
Team Foundation Server 2013 Installation Guide Page 28 of 164 You ll see a User Account Control (UAC) prompt. Click Yes You ll see a message that says Microsoft Update was successfully installed. Close the web browser and return to the Windows Update dialog
Team Foundation Server 2013 Installation Guide Page 29 of 164 Windows Update should be checking for updates and the dialog should now say that you receive updates For Windows and other products from Microsoft Update. If updates are found you ll see something like the image below. Click on the update message
Team Foundation Server 2013 Installation Guide Page 30 of 164 If there are any Optional updates, click the Optional tab and check all the available updates. If the Optional tab is visible and has updates, click the Optional tab. Then check all available optional updates. Click the Install button to begin installing
Team Foundation Server 2013 Installation Guide Page 31 of 164 Updates should now be downloading and installing. Restart the server as necessary.
Team Foundation Server 2013 Installation Guide Page 32 of 164 Chapter 2: Install SQL Server 2014 As of Team Foundation Server 2013 Update 2, SQL Server 2014 is an option as the data repository. This chapter will walk you through the process of installing SQL Server 2014 for use with TFS. Log on to server using an account that is a member of the Adminstrators group Run Server Manager First we need to verify that the.net Framework 3.5 features are installed on this server. In Server Manager, click Add roles and features On the Before you begin page of the wizard, click Next On the Select installation type page, choose Role-based or feature-based installation and click Next On the Select destination server page o Choose Select a server from the server pool o Select the name of the current server o Click Next
Team Foundation Server 2013 Installation Guide Page 33 of 164 You should now be on the Select server roles page of the wizard. Check Application Server Click Next
Team Foundation Server 2013 Installation Guide Page 34 of 164 You should now be on the Select features page. Verify that.net Framework 3.5 Features is checked Verify that.net Framework 4.5 Features is checked Click Next
Team Foundation Server 2013 Installation Guide Page 35 of 164 You should now be on the Confirm installation selections page. Check Restart the destination server automatically if required Click Install The features should now be installing.
Team Foundation Server 2013 Installation Guide Page 36 of 164 Eventually, the feature installation should finish. Verify that the installation succeeded Click Close
Team Foundation Server 2013 Installation Guide Page 37 of 164 Now that the.net Framework pre-requisite is installed, you can start the installation of SQL Server 2014. Insert the SQL Server 2014 DVD or mount the appropriate ISO image Open the DVD drive using Windows Explorer (explorer.exe) Run the SQL Server setup program Click Yes on any User Account Control dialogs that appear
Team Foundation Server 2013 Installation Guide Page 38 of 164 You should now see the SQL Server Installation Center window. In the left panel, click Installation In the right panel, click New SQL Server stand-alone installation or add features to an existing installation You might now be prompted for a license key. Enter a license key Click Next
Team Foundation Server 2013 Installation Guide Page 39 of 164 Check I accept the license terms Check Turn on Customer Experience Improvement Program Click Next
Team Foundation Server 2013 Installation Guide Page 40 of 164 Check Use Microsoft Update to check for updates Click Next
Team Foundation Server 2013 Installation Guide Page 41 of 164 Verify that none of the install rule checks have failed. Verify that there are 0 failures Click Next
Team Foundation Server 2013 Installation Guide Page 42 of 164 You ll now be prompted to choose which type of installation you want to do. Choose SQL Server Feature Installation Click Next
Team Foundation Server 2013 Installation Guide Page 43 of 164 You should now be on the Feature Selection page. Under Instance Features check o Database Engine Services o Full-text and Semantic Extractions for Search o Analysis Services o Reporting Services Native (Optional) Under Shared Features check o Management Tools Complete Click Next
Team Foundation Server 2013 Installation Guide Page 44 of 164 If you get this failure, something went wrong when you installed the.net Framework 3.5 features.
Team Foundation Server 2013 Installation Guide Page 45 of 164 You should now be on the Instance Configuration page. Choose Default instance Click Next
Team Foundation Server 2013 Installation Guide Page 46 of 164 On the Server Configuration page you need to set all the services to automatically start. For each service, set Startup Type to Automatic Click Next
Team Foundation Server 2013 Installation Guide Page 47 of 164 Choose Windows authentication mode Click the Add Current User button to add the current user as a SQL Server administrator (Optional) Click the Add button and add the Domain Admins group to the SQL Server administrators Click Next
Team Foundation Server 2013 Installation Guide Page 48 of 164 Click the Add Current User button to add the current user as an Analysis Server administrator (Optional) Click the Add button and add the Domain Admins group to the Analysis Services administrators Click Next
Team Foundation Server 2013 Installation Guide Page 49 of 164 Choose Install and configure Click Next
Team Foundation Server 2013 Installation Guide Page 50 of 164 You should now see the Ready to Install page. Click Install
Team Foundation Server 2013 Installation Guide Page 51 of 164 The installer should now be running.
Team Foundation Server 2013 Installation Guide Page 52 of 164 Eventually, the installer should finish. Verify that all items installed successfully Click Close to exit the installer SQL Server 2014 is now installed.
Team Foundation Server 2013 Installation Guide Page 53 of 164 Chapter 3: Install SQL Server 2012 SQL Server 2012 is used as the data repository for Team Foundation Server 2013. A TFS2013 license also includes a license to install SQL Server 2012 Standard for use exclusively for TFS without having to purchase an additional TFS license. This chapter will walk you through the process of installing SQL Server 2012 for use with TFS. Log on to server using an account that is a member of the Adminstrators group Insert the SQL Server 2012 DVD or mount the appropriate ISO image Open the DVD drive using Windows Explorer (explorer.exe) Run the SQL Server setup program Click Yes on any User Account Control dialogs that appear
Team Foundation Server 2013 Installation Guide Page 54 of 164 You should now see the SQL Server Installation Center window. In the left panel, click Installation In the right panel, click New SQL Server stand-alone installation or add features to an existing installation
Team Foundation Server 2013 Installation Guide Page 55 of 164 Click OK
Team Foundation Server 2013 Installation Guide Page 56 of 164 Enter your product key. Enter your product key Click Next
Team Foundation Server 2013 Installation Guide Page 57 of 164 Check I accept the license terms Check Send feature usage data to Microsoft Click Next
Team Foundation Server 2013 Installation Guide Page 58 of 164 If product updates are found, install them. Check Include SQL Server product updates Click Next
Team Foundation Server 2013 Installation Guide Page 59 of 164 Verify that the Setup Support Rules dialog does not report any failed checks. Click Next
Team Foundation Server 2013 Installation Guide Page 60 of 164 We ll be installing only some of SQL Server s features. On Setup Role, choose SQL Server Feature Installation. Choose SQL Server Feature Installation Click Next
Team Foundation Server 2013 Installation Guide Page 61 of 164 You should now be on the Feature Selection page. Under Instance Features check o Database Engine Services o Full-text and Semantic Extractions for Search o Analysis Services o Reporting Services Native (Optional) Under Shared Features check o Management Tools Complete Click Next
Team Foundation Server 2013 Installation Guide Page 62 of 164 On the Installation Rules page, verify that there are zero Failed checks. Click Next
Team Foundation Server 2013 Installation Guide Page 63 of 164 You should now be on the Instance Configuration page. Choose Default instance Click Next
Team Foundation Server 2013 Installation Guide Page 64 of 164 Click Next
Team Foundation Server 2013 Installation Guide Page 65 of 164 You should now be on the Server Configuration page. Do not modify the Account Name values Set the Startup Type value to Automatic for each service Click Next
Team Foundation Server 2013 Installation Guide Page 66 of 164 Choose Windows authentication mode Click the Add Current User button to add the current user as a SQL Server administrator (Optional) Click the Add button and add the Domain Admins group to the SQL Server administrators Click Next
Team Foundation Server 2013 Installation Guide Page 67 of 164 Click the Add Current User button to add the current user as an Analysis Server administrator (Optional) Click the Add button and add the Domain Admins group to the Analysis Services administrators Click Next
Team Foundation Server 2013 Installation Guide Page 68 of 164 You should now be on the Reporting Services Configuration page. Choose Install and configure Click Next
Team Foundation Server 2013 Installation Guide Page 69 of 164 Check Send Windows and SQL Server Error Reports to Microsoft Click Next
Team Foundation Server 2013 Installation Guide Page 70 of 164 On the Installation Configuration Rules page, verify that there are zero Failed checks. Click Next
Team Foundation Server 2013 Installation Guide Page 71 of 164 You should see the Ready to Install page with a summary of the feature installations. Click Install
Team Foundation Server 2013 Installation Guide Page 72 of 164 The install should now be running.
Team Foundation Server 2013 Installation Guide Page 73 of 164 After running for a while, the installation should complete successfully. Click Close to close the Setup window Close out of any other SQL Server installer windows. SQL Server 2012 is now installed. Download and install the latest service pack and updates for SQL Server 2012.
Team Foundation Server 2013 Installation Guide Page 74 of 164 Chapter 4: Install SharePoint Foundation 2013 w/ Service Pack 1 If you chose Windows Server 2012 R2 as your operating system for Team Foundation Server 2013 Update 2, you ll find that installing SharePoint is a bit of a problem. SharePoint Foundation 2013 RTM isn t supported on Windows Server 2012 R2. Good news and bad news. The good news is that SharePoint 2012 Service Pack 1 *is* supported. The bad news is that installing it directly through the TFS2013.2 installer *isn t*. Not a huge problem but you will have to install SharePoint Foundation 2013 manually. Download the SharePoint Foundation 2013 with Service Pack 1 installer from Microsoft Log on to the server using a user account with Administrator privileges Double-click the installer (sharepoint.exe) to begin the install Click Yes on the User Account Control dialog
Team Foundation Server 2013 Installation Guide Page 75 of 164 The SharePoint installer will run briefly and then disappear. You might be prompted with a dialog like the one below that asks How do you want to open this type of file (.hta)? Choose Microsoft (R) HTML Application host Install SharePoint Foundation 2013 Pre-requisites You ll eventually see the SharePoint Foundation 2013 installer main menu. Click Install software prerequisites
Team Foundation Server 2013 Installation Guide Page 76 of 164 You should now see the welcome screen for the Microsoft SharePoint 2013 Products Preparation Tool. Click Next
Team Foundation Server 2013 Installation Guide Page 77 of 164 You ll be prompted to accept the license terms. Check I accept the terms of the License Agreement(s) Click Next
Team Foundation Server 2013 Installation Guide Page 78 of 164 The installer should now be running.
Team Foundation Server 2013 Installation Guide Page 79 of 164 The installer should complete and will prompt you to restart the server. Click Finish After the server has rebooted, log back into the server The installer will resume and will probably present you with a User Account Control dialog. Click Yes
Team Foundation Server 2013 Installation Guide Page 80 of 164 The installer will run some more. It will eventually finish and present you with the Installation Complete page. Click Finish
Team Foundation Server 2013 Installation Guide Page 81 of 164 Install SharePoint Foundation The pre-requisites are now installed and now you need to resume the installation of SharePoint Foundation 2013. Double-click sharepoint.exe You should now see the welcome screen of the installer. Click Install SharePoint Foundation
Team Foundation Server 2013 Installation Guide Page 82 of 164 You should now see the Read the Microsoft Software License Terms dialog. Check I accept the terms of this agreement Click Continue
Team Foundation Server 2013 Installation Guide Page 83 of 164 You ll be prompted to choose the Server Type. Choose Complete Use for production environments Click Install Now
Team Foundation Server 2013 Installation Guide Page 84 of 164 The installer should now be running.
Team Foundation Server 2013 Installation Guide Page 85 of 164 When the installer completes, you should see the screen below. Check Run the SharePoint Products Configuration Wizard now Click Close
Team Foundation Server 2013 Installation Guide Page 86 of 164 Run the SharePoint Products Configuration Wizard App You should now see the SharePoint Products Configuration Wizard. Click Next You ll be prompted for permission to start or reset the Internet Information Services, SharePoint Administration Service, and SharePoint Timer Service. Click Yes
Team Foundation Server 2013 Installation Guide Page 87 of 164 Choose Create a new server farm Click Next
Team Foundation Server 2013 Installation Guide Page 88 of 164 You should now see the Specify Configuration Database Settings page. In the Database server box, enter the name of your SQL Server In the Database name box, leave the default value of SharePoint_Config In the Username box, enter the name of your TFS Reports user (ex. domain\tfsreports) In the Password box, enter the password for your TFS Reports user Click Next
Team Foundation Server 2013 Installation Guide Page 89 of 164 You ll be prompted to provide a passphrase for the SharePoint farm. After you have entered this passphrase, be sure to remember it because some day you might want to add more machines to this farm and you ll need to provide this passphrase again. (But that ll probably be years from now and you ll have forgotten it. ) Enter a passphrase in both boxes Click Next
Team Foundation Server 2013 Installation Guide Page 90 of 164 You should now be on the Configure SharePoint Central Administration Web Application page. Change the port number to 17012 Choose NTLM Click Next
Team Foundation Server 2013 Installation Guide Page 91 of 164 The installer will show you a confirmation screen. Click Next to begin the installation
Team Foundation Server 2013 Installation Guide Page 92 of 164 The configuration utility should be running.
Team Foundation Server 2013 Installation Guide Page 93 of 164 After a while (in my most recent case, 3 hours) the installer should complete with the message Configuration Successful. Click Finish
Team Foundation Server 2013 Installation Guide Page 94 of 164 Run the SharePoint Configuration Web-based Wizard It s time to run yet another configuration wizard. This time in a browser. You might see a Help Make SharePoint Better window. Choose Yes, I am willing to participate Click OK
Team Foundation Server 2013 Installation Guide Page 95 of 164 You should now be on the How do you want to configure your SharePoint farm page. Click Start the Wizard
Team Foundation Server 2013 Installation Guide Page 96 of 164 You should now be on the Services page. Choose Use existing managed account Click Next You should see a message saying Working on it.
Team Foundation Server 2013 Installation Guide Page 97 of 164 After a (long) while, the wizard will prompt you to Create Site Collection. Set Title to TFS Documents Click OK
Team Foundation Server 2013 Installation Guide Page 98 of 164 You should soon see the This completes the Farm Configuration Wizard screen. Click Finish SharePoint Foundation 2013 is now installed.
Team Foundation Server 2013 Installation Guide Page 99 of 164 Chapter 5: Install Team Foundation Server 2013 Update 2 Now that Windows and SQL Server are installed, you re ready to install Team Foundation Server 2013 (TFS2013). If you re installing this on a Hyper-V virtual machine with dynamic memory enabled, change the minimum amount of RAM to 8GB (at least temporarily) to allow SharePoint Foundation 2013 to install. Log on to the server using a user account with Administrator privileges Mount the TFS2013 Update 2 ISO image or insert a TFS2013 Update 2 installer DVD Using Windows Explorer (explorer.exe), navigate to the installer directory Run tfs_server.exe
Team Foundation Server 2013 Installation Guide Page 100 of 164 You should see the Team Foundation Server Setup dialog. Check I accept the license terms for Team Foundation Server Click Install Now
Team Foundation Server 2013 Installation Guide Page 101 of 164 You ll see a User Account Control dialog. Click Yes
Team Foundation Server 2013 Installation Guide Page 102 of 164 The installer will run and copy files to your disk.
Team Foundation Server 2013 Installation Guide Page 103 of 164 You may be prompted to restart your machine. Click OK to restart your machine When the server has finished rebooting, log in with the same user account to resume the installation When you log back in, the installer will resume.
Team Foundation Server 2013 Installation Guide Page 104 of 164 You might be prompted to supply a product key for the installation. If you have the product key, you can enter it now or you can complete the installation with a trial license. Enter your product key or choose Install a Trial License Click Activate
Team Foundation Server 2013 Installation Guide Page 105 of 164 You should now see the Team Foundation Server Configuration Center. You ll be doing a Standard Single Server configuration. Choose Standard Single Server from the left panel Click Start Wizard
Team Foundation Server 2013 Installation Guide Page 106 of 164 You should now be on the Standard Configuration Wizard s welcome screen. Select Yes, I want to participate Click Next
Team Foundation Server 2013 Installation Guide Page 107 of 164 You ll be prompted for a username and password that will be used as a service account for accessing SharePoint and SQL Server Reporting Services. This account is typically named {domain-name}\tfsreports. Type the user account into the Account Name text box Type the password into the Password text box Click the Test link to verify the username and password Click Next
Team Foundation Server 2013 Installation Guide Page 108 of 164 You ll now be on the SharePoint installation screen. There are a handful of different things that could happen at this point: Blocked, Install SharePoint Automatically, or Install SharePoint Manually. NOTE: If you already did a manual install of SharePoint Foundation 2013, skip forward in this guide to the SharePoint Option 3: Manually Installed SharePoint heading. SharePoint Option 1: Blocked If you re installing Team Foundation Server 2013 Update 2 on Windows Server 2012 R2 or installing TFS2013.RTM or TFS2013.1 on Windows Server 2012 R2, you ll see a screen like the one below. SharePoint Foundation 2013 RTM cannot be installed on Windows Server 2012 R2 and you ll see the following messages: - Due to the issues listed below, SharePoint cannot be installed. - SharePoint Foundation 2013 cannot be installed on Windows 8.1 or Windows Server 2012 R2.
Team Foundation Server 2013 Installation Guide Page 109 of 164 All is not lost though! You can do a manual installation of SharePoint Foundation 2013 with Service Pack 1 and you ll be fine. There s another chapter in this installation guide that will walk you through that process. SharePoint Option 2: Automatic Installation In an ideal world, you ll see a screen similar to the one below that doesn t warn you of any issues and allows you to just go ahead and install SharePoint Foundation 2013. If you re doing a single server installation of TFS (TFS, SQL Server, and SharePoint Foundation on the same machine) like what this guide helps you to do, there will be a warning here about memory usage competition between SQL Server and SharePoint Foundation 2013 s Distributed Cache Service. Installing SharePoint Foundation 2013 may cause performance problems on this server and at some point you may want to separate these services. If your screen looks like the one below: Click Install SharePoint Foundation 2013
Team Foundation Server 2013 Installation Guide Page 110 of 164 The SharePoint 2013 installer should now be running. If prompted to restart the server, follow the instructions to restart the server and then log back in to the server. Click Yes to restart the server After the server has restarted, log back in as the same user
Team Foundation Server 2013 Installation Guide Page 111 of 164 After logging back in, the installer will resume. There may be several reboots but eventually SharePoint will be finished installing. Click Next
Team Foundation Server 2013 Installation Guide Page 112 of 164 You ll see a summary of the TFS configuration and, if you ve rebooted, you ll see a warning icon next to the Service Account section. This is because you need to re-type the service account s password. Click the Service Account link Re-enter the password for the service account Click Readiness Checks
Team Foundation Server 2013 Installation Guide Page 113 of 164 SharePoint Option 3: Manually Installed SharePoint If you manually installed SharePoint the standard TFS installation process is a lot shorter. You ll have entered the TFSReports username and password on the previous screen and you ll land on the following screen and won t see any prompts about SharePoint installation at all. Click Next
Team Foundation Server 2013 Installation Guide Page 114 of 164 TFS2013 Readiness Checks The readiness checks should run without any errors. There may be warnings (probably about SharePoint memory) but they can be safely ignored for TFS installations that are not intended to be high-performance. Click Configure
Team Foundation Server 2013 Installation Guide Page 115 of 164 The installer should now be in the process of configuring Team Foundation Server 2013.
Team Foundation Server 2013 Installation Guide Page 116 of 164 The configuration process should complete with a message saying Success. Click Next
Team Foundation Server 2013 Installation Guide Page 117 of 164 You should now see the summary page that summarizes the results of the installation. Click Close to exit the installer Team Foundation Server 2013 Update 2 is now installed.
Team Foundation Server 2013 Installation Guide Page 118 of 164 Chapter 6: Install Team Foundation Server 2013 (RTM) Now that Windows and SQL Server are installed, you re ready to install Team Foundation Server 2013 (TFS2013). If you re installing this on a Hyper-V virtual machine with dynamic memory enabled, change the minimum amount of RAM to 8GB (at least temporarily) to allow SharePoint Foundation 2013 to install. Log on to the server using a user account with Administrator privileges Mount the TFS2013 ISO image or insert a TFS2013 installer DVD Using Windows Explorer (explorer.exe), navigate to the installer directory Run tfs_server.exe
Team Foundation Server 2013 Installation Guide Page 119 of 164 You should see the Team Foundation Server Setup dialog. Check I accept the license terms for Team Foundation Server Click Install Now
Team Foundation Server 2013 Installation Guide Page 120 of 164 You ll see a User Account Control dialog. Click Yes
Team Foundation Server 2013 Installation Guide Page 121 of 164 The installer will run and copy files to your disk and install some component pieces such as the.net Framework.
Team Foundation Server 2013 Installation Guide Page 122 of 164 You may be prompted to restart your machine. Click OK to restart your machine When the server has finished rebooting, log in with the same user account to resume the installation
Team Foundation Server 2013 Installation Guide Page 123 of 164 When you log back in, the installer will resume.
Team Foundation Server 2013 Installation Guide Page 124 of 164 You ll be prompted to supply a product key for the installation. If you have the product key, you can enter it now or you can complete the installation with a trial license. Enter your product key or choose Install a Trial License Click Activate
Team Foundation Server 2013 Installation Guide Page 125 of 164 You should now see the Team Foundation Server Configuration Center. You ll be doing a Standard Single Server configuration. Choose Standard Single Server from the left panel Click Start Wizard
Team Foundation Server 2013 Installation Guide Page 126 of 164 You should now be on the Standard Configuration Wizard s welcome screen. Click Next
Team Foundation Server 2013 Installation Guide Page 127 of 164 You ll be prompted for a username and password that will be used as a service account for accessing SharePoint and SQL Server Reporting Services. This account is typically named {domain-name}\tfsreports. Type the user account into the Account Name text box Type the password into the Password text box Click the Test link to verify the username and password Click Next
Team Foundation Server 2013 Installation Guide Page 128 of 164 You ll be prompted to install SharePoint Foundation 2013. This screen may display a warning about memory usage competition between SQL Server and SharePoint Foundation 2013 s Distributed Cache Service. Installing SharePoint Foundation 2013 may cause performance problems on this server and at some point you may want to separate these services. Click Install SharePoint Foundation 2013
Team Foundation Server 2013 Installation Guide Page 129 of 164 The SharePoint 2013 installer should now be running. If prompted to restart the server, follow the instructions to restart the server and then log back in to the server. Click Yes to restart the server After the server has restarted, log back in as the same user
Team Foundation Server 2013 Installation Guide Page 130 of 164 After logging back in, the installer will resume. There may be several reboots but eventually SharePoint will be finished installing. Click Next
Team Foundation Server 2013 Installation Guide Page 131 of 164 You ll see a summary of the TFS configuration and, if you ve rebooted, you ll see a warning icon next to the Service Account section. This is because you need to re-type the service account s password. Click the Service Account link Re-enter the password for the service account Click Readiness Checks
Team Foundation Server 2013 Installation Guide Page 132 of 164 The readiness checks should run without any errors. There may be warnings (probably about SharePoint memory) but they can be safely ignored for TFS installations that are not intended to be high-performance. Click Configure
Team Foundation Server 2013 Installation Guide Page 133 of 164 The installer should now be in the process of configuring Team Foundation Server 2013.
Team Foundation Server 2013 Installation Guide Page 134 of 164 The configuration process should complete with a message saying Success. Click Next
Team Foundation Server 2013 Installation Guide Page 135 of 164 You should now see the summary page that summarizes the results of the installation. Click Close to exit the installer Team Foundation Server 2013 is now installed.
Team Foundation Server 2013 Installation Guide Page 136 of 164
Team Foundation Server 2013 Installation Guide Page 137 of 164 Chapter 7: Install TFS2013 Build Server If you d like to do automated builds with Team Foundation Server 2013 (TFS2013), you re going to need a machine that has the TFS Build services installed. TFS2013 s build services are made up of two different services: the TFS Build Controller and the TFS Build Agent. The Controller and Agent(s) can be on the same machine or on different machines. It s probably not a good idea but the Build Controller & Agent(s) can be installed on the same machine as TFS itself. The controller & agent services can be installed on any of the following operating systems: Windows 2008 R2 with SP1 Windows Server 2012 Windows Server 2012 R2 Windows 7 SP1 Windows 8 Windows 8.1 This install guide assumes that you re doing the installation as an Active Directory user and that that user is a member of the Administrators group on the TFS2013 app server and/or is a member of the Active Directory Domain Admins group. This guide also assumes that you re putting the build service on a machine that is not the TFS app tier. Log on to the server that you want to install TFS Build services using an account that is an Administrator on the TFS2013 machine Insert the TFS2013 installer DVD or mount the TFS2013 ISO image Open the installer drive using Windows Explorer (explorer.exe)
Team Foundation Server 2013 Installation Guide Page 138 of 164 You should see the TFS installer directory and it should look similar to the image below. Double-click tfs_server.exe to start the installer
Team Foundation Server 2013 Installation Guide Page 139 of 164 You should now see the Team Foundation Server Setup dialog. Check I accept the license terms for Team Foundation Server Click the Install Now button You ll be prompted with a User Account Control dialog. Click the Yes button
Team Foundation Server 2013 Installation Guide Page 140 of 164 Choose either Install a Trial License or Enter the product key If you chose to enter a product key, enter your product key Click the Activate button
Team Foundation Server 2013 Installation Guide Page 141 of 164 You should now see the Team Foundation Server Configuration Center window. From the left column, choose Configure Team Foundation Build Service Click the Start Wizard button
Team Foundation Server 2013 Installation Guide Page 142 of 164 You should now see the Build Service Configuration Wizard screen. Choose Yes, I want to participate Click the Next button
Team Foundation Server 2013 Installation Guide Page 143 of 164 You ll now be prompted to choose the Team Project Collection (TPC) that you want to use with this build service. A build controller can talk to only one TPC. If you need build services for more than one TPC, you ll need more than one controller instance. Click the Browse button You should now see the Connect to Team Project Collection dialog. Click the Servers button
Team Foundation Server 2013 Installation Guide Page 144 of 164 You should see the Add/Remove Team Foundation Server dialog. Click the Add button You should see the Add Team Foundation Server dialog. Enter the name of your TFS app tier machine in the Name or URL of Team Foundation Server box (Optional) Adjust the Path, Port number, and/or Protocol options as required. (NOTE: if you installed TFS2013 using the steps provided in this guide, no changes are necessary.) Click the OK button
Team Foundation Server 2013 Installation Guide Page 145 of 164 You should be back on the Add/Remove Team Foundation Server dialog and you should see the TFS machine that you just added on the previous step in the Team Foundation Server list. Click the Close button You should be back on the Connect to Team Project Collection dialog. Your TFS machine should be selected in the Select a Team Foundation Server drop down list and you should see the list of Team Project Collection(s) for your TFS instance. (NOTE: out of the box, the TPC that gets created is named DefaultCollection.) Choose the TPC that you want to use with this build server. (Example: DefaultCollection) Click the Connect button
Team Foundation Server 2013 Installation Guide Page 146 of 164 You should be back on the Select a Team Project Collection page and the screen probably says that it found 0 build controller(s) and 0 build agent(s) running on 0 machine(s). Click Next
Team Foundation Server 2013 Installation Guide Page 147 of 164 The Build Services screen allows you to configure the build Controller and also how many Agent instances to run on this build machine. Choose Use the default setting On the Number of build agents to run on this build machine drop down, choose the option that ends with (recommended) Click the Next button
Team Foundation Server 2013 Installation Guide Page 148 of 164 The Configure build machine page allows you to specify the user account that the build service will run as. This can be pretty much any account that you want but my recommendation is to create a separate account in Active Directory that is just for running the build service. Typically, this account is named TFSBuild. Choose Use a user account In the Account Name box, enter the fully-qualified username for the service (example: domain_name\tfsbuild) In the Password box, enter the password for the service account Click the Test link to verify the username and password Click the Next button
Team Foundation Server 2013 Installation Guide Page 149 of 164 You should now be on the Confirm the Configuration Settings Before Proceeding page. Click the Next button
Team Foundation Server 2013 Installation Guide Page 150 of 164 The installer will run some checks to verify that everything is ready to be configured. All these checks should pass. Click the Configure button
Team Foundation Server 2013 Installation Guide Page 151 of 164 The configuration should run and quickly complete with the message of Success. Click the Next button
Team Foundation Server 2013 Installation Guide Page 152 of 164 The Review the Results page should also say Success. Click the Close button on this page Click the Close button on the next page
Team Foundation Server 2013 Installation Guide Page 153 of 164 You should now see the Build Configuration page on the Team Foundation Server Administration Console. This page should be showing you the Controller and Agent(s) that you just created. Team Foundation Server Build has been configured.
Team Foundation Server 2013 Installation Guide Page 154 of 164 Chapter 8: Install TFS2013 Test Controller for Automated Testing There are two types of Controllers and Agents in the Team Foundation Server (TFS) world: Build and Test. The Build Controller and Build Agent are for doing TFS automated builds. The Test Controller and Test Agent services are for supporting automated testing. The test controller can be configured to support either Manual Test (aka. QA) activities or be configured for Load & Performance Test activities (aka. used as a Load Test Rig). A single instance of the Controller cannot be used for both QA and for Load Testing. This chapter will walk you through installing the Controller service for the purposes of Manual / QA testing. (NOTE: installing the Agent service for QA testing is typically remotely done via Microsoft Test Manager (MTM) rather than by running an installer program. When told to use a machine as part of a test environment, MTM will automagically install the test agent on that machine.) The Agents are found on a different DVD / download from Microsoft than Visual Studio 2013 or Team Foundation Server 2013. If you re getting your software from MSDN, the screenshot below shows you the information for the Agents for Visual Studio 2013 ISO. Log into the machine where you want to install the QA Test Controller service as an Administrator. Insert the Agents DVD into the DVD drive or mount the Agents ISO Using Windows Explorer (explorer.exe) navigate to the DVD drive
Team Foundation Server 2013 Installation Guide Page 155 of 164 The Agents ISO has two folders: TestAgent and TestController. Double-click the TestController folder In the TestController folder, you should see the installer file for the controller vstf_testcontroller.exe. Double-click on vstf_testcontroller.exe to start the installer
Team Foundation Server 2013 Installation Guide Page 156 of 164 You should see the Test Controller 2013 page. Check the I agree to the License Terms and Privacy Policy checkbox Click the Install button
Team Foundation Server 2013 Installation Guide Page 157 of 164 Click Yes The installer will run and eventually end at a screen that should say Setup Successful. Click the Launch button
Team Foundation Server 2013 Installation Guide Page 158 of 164 You should see a UAC prompt for TestControllerConfigUI.exe. Click the Yes button
Team Foundation Server 2013 Installation Guide Page 159 of 164 You should now see the Configure Test Controller window. The user account that you use for the service account needs to be a member of the Adminstrators group on this machine. Under Specify the logon account for the test controller service, choose This account radio button In the This account textbox, enter the username for the username that you d like to use for the test controller service. (Example: domainname\testcontroller) In the Password textbox, enter the password for the service account Click the Test link to verify the credentials Check the Register test controller with Team Project Collection checkbox Click the Browse button to choose the Team Project Collection for this controller
Team Foundation Server 2013 Installation Guide Page 160 of 164 You should see the Connect to Team Project Collection dialog. Choose your TFS server name from the Select a Team Foundation Server drop down Choose your Team Project Collection from the Team Project Collections list Click the Connect button
Team Foundation Server 2013 Installation Guide Page 161 of 164 You should now be back on the Configure Test Controller dialog and you should see the URL for the Team Project Collection that you just chose in the Register with the following Team Project Collection textbox.
Team Foundation Server 2013 Installation Guide Page 162 of 164 Now you ll enter the information for how the test agents and test controllers will talk. Check the Use a lab service account to communicate with test controller checkbox In the Account name box, enter the username for this account. (Example: domainname\testagent) In the Password box, enter the password for this account Click the Test link to verify the credentials Click the Apply Settings button
Team Foundation Server 2013 Installation Guide Page 163 of 164 You should see the Configuration summary dialog. It will run and eventually complete with the message Configuration succeeded. Click the Close button
Team Foundation Server 2013 Installation Guide Page 164 of 164 You should be back on the Configure Test Controller dialog. Click the Close button The test controller has been successfully configured.