Last week I upgraded my TFS 2012 test environment to CTP3 to try out the new features rolled out in preview as part of the Visual Studio 2012 Upgrade 2 CTP. In this blog post, I’ll walk you through the steps required to upgrade, you may find the quick notes in each section useful if you don’t have the time to read through the complete blog post.
- TFS Application Tier
- TFS Build Controller/Agent
- TFS Test Controller/Agent
- Developer Workstation
- SharePoint extensions
What is Visual Studio 2012 Upgrade 2 CTP 3 and where can I get it?
- Read about the new features included in Upgrade 2 CTP 3.
- Download the Visual Studio 2012 Upgrade 2 CTP 3.
|
Sandcastle – My Test Environment
Figure 1 – Sandcastle topology
TFS 2012 Application Tier – Windows Server 2012, current patch version Dev11.Update1
2. TFS 2012 Build Controller/Agent – Windows Server 2012, current patch version Dev11.Update1
3. TFS 2012 Test Controller/Agent – Windows Server 2012, current patch version Dev11.Update1
4. SharePoint 2010 – Windows Server 2012, current patch version Dev11
5. SQL Server 2012, SQL Server Analysis Server 2012 – Windows Server 2012, current patch version Dev11
Upgrading TFS 2012 Application Tier to Visual Studio 2012 Update 2 CTP 3
While the detailed walkthrough is given below, a few quick notes,
- The TFS Service account details are not automatically picked up and need to be hand entered, it is advised that you keep the tfs service account details handy
- The TFS database name will not be picked up and will need to be hand entered
- If you have the ‘Visual Studio Team Foundation Server 2012 Update 1 Power Tool’ installed and decide to check ‘Configure Scheduled Backups using the existing Backup and Restore Power Tools settings’ the validation before the upgrade will fail
- The backup scheduled configured from your previous set up will be lost during the upgrade
- If you do not uninstall the ‘Visual Studio Team Foundation Server 2012 Update 1 Power Tool’ from the Application Tier you will continue to get the exception ‘TF257007: An error occurred while the following management extension for Team Foundation was being loaded. C:\Program Files (x86)\Microsoft Team Foundation Server 2012 Power Tools\Database Backup Tools\\Microsoft.TeamFoundation.Power.Tools.Admin.dll. Fore more information, review the logs in the Logs node of the administration console.’ every time you open the TFS Admin Console on the Application Tier.
- The Application Tier upgrade will NOT require a restart before or after the upgrade
Details
1. The previous upgrade path of my test environment has been Team Foundation Server 2012 RTM => Team Foundation Server 2012 Update 1
2. Navigate to the Visual Studio 2012 Update 2 official download page and download ‘VS2012_2_CTP_TFS_Full_ENU.iso’
http://www.microsoft.com/en-us/download/details.aspx?id=36539
3. Once the download has completed, mount the iso and double click tfs_server.exe
4. You will get the standard installer, as you are already aware CTP’s aren’t meant for production environments and don’t have a defined upgrade path. Click accept terms and continue
5. Accept the License terms and start the upgrade
6. The upgrade takes roughly 7-10 minutes
7. Once the installer completes you will be redirected to the upgrade wizard. Click Next to continue with the upgrade
8. Enter the SQL Server Instance name
9. You will need to enter the Account name and password of your tfs service account, click the test hyperlink to validate the credentials
10. Continue to configure reporting services, if you don’t have reporting services in your setup, uncheck and continue.
11. Click ‘Populate URLs’ to bring back the currently configured reporting services url.
12. The wizard will detect the SQL instance name that your application tier currently uses
13. The wizard will pick up the Analysis server name your current set up is configured to
14. The TFS Reporting service account needs to be entered and is not picked up automagically from your last configuration
15. Click next to configure SharePoint, you can optionally skip and configure this later
16. Click the test hyperlink to validate the SharePoint URLs
17. If you have the ‘Visual Studio Team Foundation Server 2012 Update xx Power Tool’ installed, you will get the Configure Scheduled Backups screen.
Note If you have the option ‘Configure Scheduled Backups using the existing Backup and Restore Power Tools settings’ the validation will fail on the validation page in the upgrade wizard. The only way to progress with the installation is to uncheck the ‘Configure Scheduled Backups using the existing Backup and Restore Power Tools settings’.
18. Summary of the configuration selected by you.
19. Validate and you will run into the below errors if you did not uncheck ‘Configure Scheduled Backups using the existing Backup and Restore Power Tools settings’
You may see the below in the upgrade log file…
[Info @16:52:40.223] +-+-+-+-+-| Running VerifyPowerToolInputs: Verifying the Backup Power Tool settings are valid |+-+-+-+-+-
[Info @16:52:40.224]
[Info @16:52:40.224] +-+-+-+-+-| Verifying the Backup Power Tool settings are valid |+-+-+-+-+-
[Info @16:52:40.224] Starting Node: PTINPUTS
[Info @16:52:40.224] NodePath : VINPUTS/Conditional/Container/Progress/PTINPUTS
[Info @16:52:40.229] Node returned: Error
[Error @16:52:40.235] The Backup and Restore Power Tool settings discovered on this machine are invalid. Configuration of scheduled backups cannot proceed. To continue with configuration of Team Foundation Server you must uncheck the option to configure scheduled backups. After Team Foundation Server is configured you can run the Scheduled Backups wizard from the Administration Console to enable scheduled backups.
[Info @16:52:40.236] Completed VerifyPowerToolInputs: Error
[Info @16:52:40.236] -----------------------------------------------------
[Info @16:52:40.240] Execution results:
[Info @16:52:40.240] Overall result: Failure
[Info @16:52:40.240] Nodes completed: 76
[Info @16:52:40.240] Nodes succeeded: 73
[Info @16:52:40.240] Nodes skipped: 22
[Info @16:52:40.240] Nodes with errors: 1
[Info @16:52:40.240] Nodes with warnings: 0
[Info @16:52:40.240] Number of error messages: 1
[Info @16:52:40.240] Number of warning messages: 0
[Info @16:52:40.240] Number of info messages: 2
20. Uncheck ‘Configure Scheduled Backups using the existing Backup and Restore Power Tools settings’ and rerun the validation
21. If all goes to plan, you will get an all green after the upgrade
22. The upgrade progress should indicate Success
23. If you have the Visual Studio Team Foundation Server 2012 Update 1 Power Tool installed on the Application Tier you will see the exception message ‘TF257007: An error occured while the following management extension for Team Foundation was being loaded. C:\Program Files (x86)\Microsoft Team Foundation Server 2012 Power Tools\Database Backup Tools\\Microsoft.TeamFoundation.Power.Tools.Admin.dll. Fore more information, review the logs in the Logs node of the administration console.’ every time you open the TFS Administration console. Uninstall the Visual Studio Team Foundation Server 2012 Update 1 Power Tools from the application tier to fix this exception.
24. The upgrade of the application tier to Visual Studio 2012 Update 2 is complete!
Upgrading TFS 2012 Build Controller & Agent to Visual Studio 2012 Update 2 CTP 3
While the detailed walkthrough is given below, a few quick notes,
- The Team Project Collection to associate with the build service will not be automatically picked from the existing configuration and has to be specified again
- The TFS Build Service account details are not automatically picked up and need to be hand entered, it is advised that you keep the service account details handy
- The upgrade will require a restart on the build controller after the upgrade
Details
1. Navigate to the Visual Studio 2012 Update 2 official download page and download ‘VS2012_2_CTP_TFS_Full_ENU.iso’
http://www.microsoft.com/en-us/download/details.aspx?id=36539
2. Once the download has completed, mount the iso and double click tfs_server.exe
3. You will get the standard installer, as you are already aware CTP’s aren’t meant for production environments and don’t have a defined upgrade path. Click accept terms and continue
4. Accept the License terms and start the upgrade
5. The upgrade takes roughly 7-10 minutes
6. Once the installation completes, you will be redirected to the upgrade wizard. Click on the ‘Configure Team Foundation Build Service’ to configure build services on this box.
7. Click next to start the configuration of build services
8. The team project collection the build service was previously associated to is not picked up from the existing set up and has to be specified during the upgrade.
9. The existing build controller and agent set ups are picked up and you are given the option to associate them with the upgrade. Clicking NO allows you to change this.
10. Enter the service account details for the build service, optionally click the test hyperlink to validate the credentials.
11. Validate the configuration
12. Upgrade
13. Upgraded successfully
14. Close the wizard
15. Open up TFS Admin console and you can see that the version of the upgrade shows up to indicate that the build server is now Upgrade 2 CTP3 now
16. Click on ‘Build Configuration’ and you should be able to see the list of build controllers and agents you had before the upgrade.
Upgrading TFS 2012 Test Controller & Agent to Visual Studio 2012 Update 2 CTP 3
While the detailed walkthrough is given below, a few quick notes,
- The Team Project Collection to associate with the test controller will not be automatically picked from the existing configuration and has to be specified again
- The TFS Test Service account details are not automatically picked up and need to be hand entered, it is advised that you keep the service account details handy
- The upgrade will require a restart on the test controller after the upgrade
Details
1. Navigate to the Visual Studio 2012 Update 2 official download page and download ‘VS2012_2_CTP_Agents_ENU.iso’
http://www.microsoft.com/en-us/download/details.aspx?id=36539
2. Once the download completes, mount the iso and navigate to the folder Test Controller and click on vstf_testcontroller.exe to start the upgrade
3. The upgrade takes less than 5 minutes to complete
4. You will be required to restart once the install completes
5. Now open up Configure Test Controller from windows, you will see the configuration window, the previously configured details are not picked up and need to be specified again
6. Specify the test service account and the team project collection URL, you may optionally specify the lab management service account details as well
7. Click Apply Settings, if the details are correct, you will get an all green screen. Click close to exit the wizard.
8. Now navigate to the folder Test Agent and run vstf_testagent.exe to start the upgrade
3. The upgrade takes less than 5 minutes to complete. Click Launch to configure the test agent after installation.
4. The previous settings of the test agent will not be picked up after the upgrade and need to be specified.
5. You will need to specify the test service account and the details of the test controller
6. Click Apply to apply the settings. You will be required to restart the machine after the test configuration has completed.
Upgrading Developer Machine to Visual Studio 2012 Update 2 CTP 3
While the detailed walkthrough is given below, a few quick notes,
- The upgrade will require a restart on the developer workstation after the upgrade
Details
1. Navigate to the Visual Studio 2012 Update 2 official download page and download ‘vsupdate_KB2707250.exe’
http://www.microsoft.com/en-us/download/details.aspx?id=36539
2. Once the download completes, mount the installer and click setup to start the upgrade. The upgrade takes about 15 minutes to complete and you’ll be required to restart the developer machine once the installation completes.
Upgrading SharePoint server to Visual Studio 2012 Update 2 CTP 3
The upgrade does not require anything to be run on the SharePoint servers.
Hope you found this useful…
Please leave a comment if you have run into a problem or have feedback?
Cheers,
Tarun