Freigeben über


Verschieben von Team Foundation Server von einer Umgebung in eine andere

Das häufigste Szenario für eine umgebungsbasierte Verschiebung ist eine Änderung der Domäne der TFS-Bereitstellung, entweder aufgrund einer Änderung des Domänennamens oder durch die Umstellung von einer Arbeitsgruppe auf eine Domäne.

Wichtig

Möglicherweise möchten Sie nicht nur die Hardware, sondern auch die Domäne der TFS-Bereitstellung ändern.Eine Änderung der Hardware ist eine wiederherstellungsbasierte Verschiebung, und beide Verschiebungstypen dürfen niemals kombiniert werden.Schließen Sie zunächst die Hardwareverschiebung ab, und ändern Sie erst dann die Umgebung.

Außerdem führt das Ändern von Identitäten in TFS im Rahmen einer umgebungsbasierten Verschiebung häufig zu Konflikten oder Problemen.Identities-Befehl ist ein leistungsfähiges Tool, besitzt jedoch bestimmte Einschränkungen.Lesen Sie die entsprechenden Informationen im Rahmen der Planung Ihrer Verschiebung.Um eine erfolgreiche Verschiebung sicherzustellen, beachten Sie die folgenden Anforderungen:

  • Sobald ein Benutzerkonto in TFS angelegt ist, kann es nicht entfernt werden oder einem anderen Konto zugewiesen werden.Wenn Sie Domäne A/Benutzer A zu Domäne B/Benutzer B verschieben, funktioniert der Befehl "Identities" nur, um den Benutzer zu migrieren, wenn Domäne B/Benutzer B in TFS nicht bereits vorhanden ist.

  • Da die Mitglieder der lokalen Administratorgruppe automatisch zu TFS hinzugefügt werden, müssen Sie alle Konten entfernen, die von dieser Gruppe migriert werden sollen, bevor Sie die Domäne oder die Umgebung ändern.

Weitere Hintergrundinformationen finden Sie hier. Hier erhalten Sie auch eine ausführliche Beschreibung der Funktionsweise von Identitätsänderungen in TFS, einschließlich Beschränkungen des Tools.

Im den folgenden Abschnitten sind die Schritte zur Änderung der Umgebung der TFS-Bereitstellung erläutert:

  1. Überprüfen von Berechtigungen und Konten

  2. Anhalten der TFS-Dienste

  3. Sichern von Daten

  4. Verbinden von TFS mit der neuen Domäne

  5. Konfigurieren von SharePoint-Produkten für die neue Umgebung

  6. Verschieben von TFS-Benutzer- und -Dienstkonten

  7. Konfigurieren von Reporting und Analysis Services

  8. Neustarten der TFS-Dienste

Überprüfen von Berechtigungen und Konten

Um die Umgebung für TFS erfolgreich ändern zu können, müssen Sie Administrator auf dem lokalen Computer sowohl für TFS als auch für alle Softwareprogramme sein, von denen die Bereitstellung abhängt: SQL Server, Berichterstellung, SharePoint-Produkte (wenn die Bereitstellung Berichterstellung oder SharePoint verwendet) und jegliche andere Software, mit der die Bereitstellung zusammen arbeitet, wie z. B. Project Server. Alle Mitglieder der lokalen Administratorgruppe sind jedoch automatisch in TFS enthalten, was zu Problemen beim Migrieren von Konten führen kann. Daher sollten Sie ein Konto verwenden, das im Rahmen der umgebungsbasierten Verschiebung nicht migriert werden soll. Es ist empfehlenswert, ein spezielles administratives Konto nur für die Verschiebung hinzuzufügen, und dieses Konto für die Migration zu verwenden.

So überprüfen Sie, ob Sie Berechtigungen auf Administratorebene haben

  • Stellen Sie sicher, dass das Konto, das Sie verwenden, Mitglied der folgenden Gruppen ist:

    • Server: Administratoren (lokale Administratorengruppe oder entsprechend)

    • TFS: Team Foundation-Administratoren und Benutzer der Verwaltungskonsole

    • SQL Server: sysadmin

    • SharePoint-Produkte: Farmadministratoren (wenn die TFS-Bereitstellung in SharePoint-Produkte integriert ist)

Wenn Sie in mindestens einer dieser Gruppen kein Mitglied sind, lassen Sie sich die Berechtigungen jetzt erteilen.

Nachdem Sie nun ein Konto mit allen erforderlichen Berechtigungen verwenden, überprüfen Sie die Konten, um festzustellen, ob es möglicherweise Konflikte mit Namen oder Gruppen in der Umgebung für die Verschiebung gibt. Da Konten, die Mitglied der lokalen Administratorgruppe sind, nicht migriert werden können, werden diese als erste entfernt.

Entfernen von zu migrierenden Konten aus der lokalen Administratorgruppe

  • Öffnen Sie die lokale Administratorgruppe und entfernen Sie alle Konten, die Sie zur neuen Umgebung migrieren möchten. Wiederholen Sie diesen Schritt für alle weiteren Gruppen, die möglicherweise betroffen sind.

Überprüfen Sie jetzt die Liste von Identitäten in der aktuellen TFS-Umgebung, und suchen Sie nach potenziellen Problemen mit Gruppen oder einzelnen Benutzerkonten, die in der neuen Umgebung vorhanden sein können.

Tipp

Erstellen Sie ggf. eine Tabelle oder Migrationszuordnung der Identitäten, die im Rahmen der umgebungsbasierten Verschiebung migriert werden sollen. Dazu gehören Details, welche Konten möglicherweise nicht automatisch migriert werden können.

Überprüfen von Identitäten

  1. Öffnen Sie auf dem Anwendungsebenenserver für Team Foundation ein Eingabeaufforderungsfenster mit Administratorberechtigungen, wechseln Sie zu %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools, und führen Sie folgenden Befehl aus, um die aktuell im System vorhandenen Identitäten anzuzeigen:

    TFSConfig Identities
    
  2. Es wird eine Liste mit Identitäten angezeigt. Überprüfen Sie diese Benutzer und Gruppen, um sicherzustellen, dass keine potenziellen Duplikate oder Probleme mit Identitäten in der Umgebung vorliegen, in die Sie TFS verschieben möchten, und führen Sie entsprechende Schritte aus, um mögliche Konflikte zu beheben.

Anhalten der TFS-Dienste

Indem Sie die Dienste beenden, helfen Sie sicherzustellen, dass Benutzer keine Änderungen an Arbeitsaufgaben in der ursprünglichen Bereitstellung vornehmen oder dort Quellcode einchecken, nachdem die Bereitstellung verschoben wurde.

  1. Öffnen Sie auf dem TFS-Anwendungsebenencomputer ein Eingabeaufforderungsfenster, und wechseln Sie zum Verzeichnis "Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools".

  2. Geben Sie den folgenden TFSServiceControl-Befehl ein:

    TFSServiceControl quiesce

Sichern der Datenbanken und des Verschlüsselungsschlüssels für SQL Server Reporting Services

  1. Öffnen Sie die Verwaltungskonsole für TFS und führen Sie auf der Seite Geplante Sicherungen eine vollständige Sicherung durch. Die Sicherung sichert alles, was Sie im Sicherungsplan zur Sicherung konfiguriert haben, jedoch sofort, nicht erst zu dem Zeitpunkt, der im Plan angegeben ist. Wenn die Bereitstellung Berichterstellung verwendet, können Sie den Verschlüsselungsschlüssel als Teil dieses Sicherungssatzes speichern.

    Das Fenster kann geschlossen werden, während der Auftrag abgeschlossen wird

    (Wenn Sie keine Sicherungen konfiguriert haben, müssen Sie einen Plan erstellen, bevor Sie eine vollständige Sicherung durchführen können.)

  2. Wenn die Sicherung abgeschlossen ist, überprüfen Sie, ob die Sicherung auf dem Datenträger oder der Netzwerkfreigabe verfügbar ist und ob Sie von der neuen Hardware auf diese Sicherung zugreifen können.

Verbinden von TFS mit der neuen Domäne

  1. Öffnen Sie auf jedem Server die Eigenschaften für den Computer.

  2. Ändern Sie die Einstellungen für den Computer auf die Domäne oder Arbeitsgruppe, mit der Sie den Server verbinden möchten.

    Geben Sie die entsprechenden Anmeldeinformationen ein, wenn Sie aufgefordert werden, den Benutzernamen und das Kennwort eines Kontos einzugeben, das über Berechtigungen zum Hinzufügen dieses Computers zur Domäne verfügt.

  3. Starten Sie den Computer neu, damit die Änderung der Domäne wirksam wird.

    Hinweis

    Nachdem Sie den Computer neu gestartet haben, wird möglicherweise eine Warnung angezeigt, dass Dienste oder Treiber nicht gestartet werden konnten.Fahren Sie mit der nächsten Prozedur fort.

Konfigurieren von SharePoint-Produkten für die neue Umgebung

Wenn Sie die Umgebung in eine Umgebung ändern, in der es keine Vertrauensstellung zur vorherigen Umgebung gibt, müssen Sie möglicherweise SharePoint-Produkte konfigurieren, damit es ordnungsgemäß funktioniert. Informationen zu Benutzern, die von Verzeichnisdiensten importiert wurden, stehen auf SharePoint-Websites im Personenauswahl-Websteuerelement zur Verfügung. Websiteadministratoren und andere Benutzer verwenden die Personenauswahl, um Personen und Gruppen beim Zuweisen von Berechtigungen auszuwählen. Wenn sich Informationen in mehreren Gesamtstrukturen oder in einer Gesamtstruktur ohne Vertrauensstellung für alle Benutzer befinden, müssen Sie möglicherweise zusätzliche Schritte ausführen, um sicherzustellen, dass alle Personen und Gruppen in diesem Websteuerelement verfügbar sind.

Überspringen Sie diese Prozedur, wenn Sie SharePoint-Produkte nicht in der Bereitstellung verwenden, wenn die neue Umgebung eine bidirektionale Vertrauensstellung zur alten Umgebung aufweist, oder wenn keine Fehler für die SharePoint-Webanwendung in der Verwaltungskonsole für Team Foundation auftreten.

  1. Öffnen Sie auf jedem Server, der Teil der SharePoint-Farm ist, die Ihre Bereitstellung von Team Foundation Server unterstützt, ein Eingabeaufforderungsfenster mit Administatorberechtigungen, und ändern Sie das Verzeichnis in "%Programme%\Gemeinsame Dateien\Microsoft Shared\Web Server Extensions\15\BIN".

  2. Geben Sie den folgenden Befehl ein, wobei Key der Verschlüsselungsschlüssel ist, den Sie in der Bereitstellung von SharePoint-Produkte verwenden möchten:

    stsadm.exe -o setapppassword -password Key

    Hinweis

    Dieser Schlüssel ist eine Verschlüsselungszeichenfolge, die zum Verschlüsseln des Kennworts für das zum Zugreifen auf die Gesamtstruktur oder Domäne verwendete Konto verwendet wird.Die Verschlüsselungszeichenfolge muss für jeden Server in der Farm gleich sein, es sollte aber eine eindeutige Zeichenfolge für jede Farm verwendet werden.

  3. Geben Sie den folgenden Befehl ein, wobei domain:DNSName die Zielgesamtstruktur bzw. die Domäne und ihr DNS-Name ist, user,password der Benutzername und das Kennwort für ein Konto ist, das Zugriff auf die Zielgesamtstruktur oder die Domäne hat, und WebApp der Name der Webanwendung ist, die die Bereitstellung von Team Foundation Server unterstützt:

    stsadm.exe -o setproperty -pn peoplepicker-searchadforests -pv domain:DnsName**,user,**password **-url http://**WebApp

  4. Geben Sie den folgenden Befehl ein, wobei URL die URL für eine Websiteauflistung ist, die eine Teamprojektauflistung unterstützt, Port die Portnummer ist, die dieser Websiteauflistung zugewiesen ist, und UserName der Benutzername des Kontos ist, das für diese Websiteauflistung als Besitzer fungiert:

    **stsadm.exe -o siteowner -url http://URL:**Port -ownerlogin UserName

  5. Wiederholen Sie den vorherigen Schritt für jede Websitesammlung, die die Bereitstellung von Team Foundation Server verwendet.

Verschieben von TFS-Benutzer- und -Dienstkonten

Wie zu Beginn dieses Artikels erwähnt, treten beim Verschieben von Konten am häufigsten Probleme auf, insbesondere wenn Sie die Benutzermigration nicht sorgfältig geplant haben. Mit dem TFSConfig-Befehl "Identities" kann kein Konto zu einem Konto migriert werden, das bereits in TFS vorhanden ist.

Wenn Kontonamen in beiden Domänen identisch sind und der einzige Unterschied der Domänenname ist, können Sie den Batchmodus von TFSConfig-Identitäten verwenden, um alle Identitäten sofort zu ändern. Andernfalls müssen Sie die Identitäten einzeln ändern und einen anderen Zielkontonamen angeben, wie unten beschrieben.

  1. Öffnen Sie im Anwendungsebenenserver für Team Foundation ein Eingabeaufforderungsfenster mit Administratorberechtigungen, wechseln Sie zu %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools, und führen Sie folgenden Befehl aus, um die Dienst-IDs (SIDs) für das Dienstkonto auf die neue Domäne zu ändern:

    TFSConfig identities /change /fromdomain:OldComputerorDomainName /todomain:NewDomainName /account:OldTFSServiceAccount /toaccount:NewTFSServiceAccount
    

    Warnung

    Wenn das Dienstkonto ein Systemkonto wie "Netzwerkdienst" war, können Sie das Dienstkonto nicht direkt migrieren, da ein Systemkonto mit demselben Namen in der neuen Umgebung vorhanden ist.Sie müssen eine Prozessänderung in zwei Stufen ausführen.Siehe das Beispiel in Identities-Befehl.

  2. Um alle Konten zu migrieren, die den gleichen Namen in der neuen Umgebung haben, geben Sie den folgenden Befehl ein:

    TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName
    

    Damit werden die Konten in einem Batchprozess verarbeitet.

  3. Wenn die neue Domäne eine oder mehrere Identitäten enthält, deren Name keinem in der vorherigen Umgebung entspricht, müssen Sie die SIDs für alle diese Identitäten manuell aktualisieren. Wenn das Benutzerkonto von Christie Church in der vorherigen Umgebung "Fabrikam\CChurch" war, in der neuen Umgebung jedoch "NeuFabrikam\ChristieC" ist, müssten Sie die SID manuell aktualisieren. Geben Sie für jedes Konto mit dieser Anforderung den folgenden Befehl ein:

    TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName /account:OldAccountName /toaccount:NewAccountName
    
  4. Führen Sie nun den folgenden Befehl aus, um das Dienstkonto zu aktualisieren:

    TFSConfig Accounts /change /AccountType:ApplicationTier /account:AccountName /password:Password
    
  5. Wenn die Bereitstellung Berichterstellung verwendet, führen Sie den folgenden Befehl aus, um das Datenquellenkonto aktualisieren, das zur Berichterstellung verwendet wird:

    TFSConfig Accounts /change /AccountType:ReportingDataSource /account:AccountName /password:Password
    
  6. Wenn die Bereitstellung Team Foundation Server Proxy verwendet, führen Sie den folgenden Befehl aus, um das Dienstkonto zu aktualisieren, das für den Proxy verwendet wird:

    TFSConfig Accounts /change /AccountType:Proxy /account:AccountName /password:Password
    

    Hinweis

    Wenn Sie eine Verschiebung in eine nicht vertrauenswürdige Domäne durchführen, müssen Sie Benutzer und Gruppen möglicherweise auch manuell zu Teams, Projekten, Auflistungen und Team Foundation Server selbst hinzufügen.Weitere Informationen finden Sie unter Hinzufügen von Benutzern zu Teamprojekten, Festlegen von Administratorberechtigungen für Teamprojektsammlungen und Festlegen von Administratorberechtigungen für Team Foundation Server.

  7. Wenn die Bereitstellung in Project Server integriert ist, müssen Sie ggf. zusätzliche Schritte ausführen, um die Dienstkonten mit den erforderlichen Berechtigungen für den Betrieb zu konfigurieren. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zum Unterstützen der TFS-Project Server-Integration und Konfigurieren der TFS-Project Server-Integration.

Konfigurieren von Reporting und Analysis Services

Sie können diesen Vorgang überspringen, wenn Sie die Berichterstellung nicht als Teil der Bereitstellung verwenden.

Wenn Sie einen Berichtsserver als Teil dieser Art von Verschiebung umbenannt haben, müssen Sie Team Foundation Server an den Berichtsserver an seinem neuen Speicherort umleiten. Sie müssen auch das Warehouse neu starten und die Datenbank für Analysis Services neu manuell erstellen.

  1. Öffnen Sie die Verwaltungskonsole für Team Foundation, wechseln Sie zum Knoten "Berichterstellung", und bearbeiten Sie die Einstellungen.

    Berichte zeigen weiterhin auf den alten Server

  2. Ändern Sie die Werte auf allen drei Registerkarten so, dass sie den neuen Namen des Servers enthalten. Geben Sie unbedingt die korrekten Informationen für das Datenquellenkonto in der neuen Umgebung an.

    Vergewissern Sie sich, dass die Informationen auf allen 3 Registerkarten richtig sind

  3. Wählen Sie Aufträge starten, um die Berichterstellung neu zu starten.

  4. Wählen Sie Neuerstellung starten, um das Warehouse neu zu erstellen.

Konfigurieren der Sicherungen

Wenn der Netzwerkfreigabename oder der Datenträger sich mit der Domänennamenänderung geändert hat, müssen Sie die geplanten Sicherungen aktualisieren, damit auf diese umbenannten Ressourcen verwiesen wird.

  • Wechseln Sie in der Verwaltungskonsole zum Knoten "Geplante Sicherung", und konfigurieren Sie die geplanten Sicherungen, um die TFS-Datenbanken auf dem neuen Server zu sichern. Weitere Informationen finden Sie unter Konfigurieren eines Sicherungsplans.

Neustarten der TFS-Dienste

Nachdem Sie nun TFS mit allen Informationen für die neue Umgebung aktualisiert haben, starten Sie die Dienste neu.

  1. Öffnen Sie auf dem TFS-Anwendungsebenencomputer ein Eingabeaufforderungsfenster mit Administratorberechtigungen, und wechseln Sie zum Verzeichnis "Drive:\%Programme%\Microsoft Team Foundation Server 12.0\Tools".

  2. Geben Sie den folgenden TFSServiceControl-Befehl ein:

    TFSServiceControl unquiesce

F & A

F: Ich möchte den oder die physischen Server für die Bereitstellung ändern, nicht die Domäne.Geht das?

A: Ja. Das wird als hardwarebasierte Verschiebung bezeichnet, und die zugehörigen Schritte finden Sie hier. Versuchen Sie nicht, eine umgebungsbasierte Verschiebung mit einer hardwarebasierten Verschiebung zu kombinieren. Schließen Sie zunächst die Hardwareverschiebung ab, und ändern Sie erst dann die Umgebung.

F: Ich habe eine Bereitstellung, die in Project Server integriert ist.Muss ich zusätzliche Schritte ausführen, damit sie mit dem verschobenen TFS zusammenarbeitet?

A: Ja. Nachdem Sie die umgebungsbasierte Verschiebung abgeschlossen haben, müssen Sie den Befehl TFSAdmin ProjectServer /RegisterPWA mit den Optionen /tfs, /force und /pwa verwenden, um TFS erneut bei Project Server zu registrieren. Weitere Informationen über die TFS-Integration in Project Server finden Sie hier.