Spostare Team Foundation Server da un ambiente a un altro

Articolo
06/09/2015

Lo scenario di spostamento basato sull'ambiente più comune modifica il dominio della distribuzione TFS, che si tratti di una modifica del nome di dominio o del passaggio da un gruppo di lavoro a un dominio.

Importante

In alcuni casi, oltre all'hardware potrebbe essere necessario modificare il dominio di una distribuzione TFS.La modifica dell'hardware è uno spostamento basato su ripristino e i due tipi di spostamento non devono mai essere associati.Completare innanzitutto lo spostamento dell'hardware e successivamente cambiare l'ambiente.

Inoltre, la modifica delle identità in TFS come parte di uno spostamento di ambiente è l'aspetto che causa più spesso conflitti o problemi.Il Comando Identities è uno strumento potente, ma presenta alcune limitazioni.Approfondire l'argomento come parte della pianificazione dello spostamento.Per garantire che uno spostamento venga eseguito correttamente, assicurarsi di aver compreso i requisiti seguenti:

Un account utente presente in TFS non può essere rimosso né essere associato a un altro account.Ad esempio, se si esegue lo spostamento da DominioA/UtenteA a DominioB/UtenteB, tramite il comando Identities la migrazione dell'utente viene eseguita solo se DominioB/UtenteB non è già presente in TFS.
Poiché i membri del gruppo Administrators locale vengono aggiunti automaticamente a TFS, assicurarsi di rimuovere tutti gli account che si desidera migrare da tale gruppo prima di modificare il dominio o l'ambiente.

Per ulteriori informazioni di base, vedere qui per una descrizione del modo in cui l'identità viene modificata in TFS, incluse le limitazioni dello strumento.

Nelle sezioni seguenti verranno esaminati i passaggi per modificare l'ambiente della distribuzione TFS:

Controllare le autorizzazioni e gli account
Arrestare i servizi TFS
Eseguire il backup dei dati
Unire TFS al nuovo dominio
Configurare Prodotti SharePoint per il nuovo ambiente
Spostare gli account utente e del servizio TFS
Configurare Reporting Services e Analysis Services
Riavviare i servizi TFS

Controllare le autorizzazioni e gli account

Per modificare correttamente l'ambiente per TFS, è necessario essere un amministratore del computer locale, di TFS e di tutto il software da cui dipende la distribuzione: SQL Server, Creazione rapporti, Prodotti SharePoint, se la distribuzione utilizza la creazione rapporti o SharePoint, e qualsiasi altro software con cui interagisce la distribuzione, ad esempio Project Server. Tutti i membri del gruppo Administrators locale vengono tuttavia inclusi automaticamente in TFS, il che può causare dei problemi quando si tenta di eseguire la migrazione degli account. Pertanto, è necessario utilizzare un account che non si intende migrare come parte dello spostamento di ambiente. È consigliabile aggiungere un account amministrativo specifico per lo spostamento e utilizzarlo per eseguire la migrazione.

Per verificare le autorizzazioni a livello di amministratore

Assicurarsi che l'account utilizzato sia un membro dei seguenti gruppi:
- Server: Amministratori (gruppo Administrators locale o equivalente)
- TFS: Team Foundation Administrators e Utenti console di amministrazione
- SQL Server: sysadmin
- Prodotti SharePoint: Amministratori farm (se la distribuzione di TFS si integra con Prodotti SharePoint)

Se non si è un membro di uno o più di questi gruppi, è possibile ottenere ora le autorizzazioni.

Una volta ottenuto un account con tutte le autorizzazioni necessarie, è possibile avviare il controllo degli account per verificare l'eventuale presenza di conflitti con i nomi o i gruppi nell'ambiente di destinazione. È noto che non è possibile eseguire la migrazione degli account che sono membri del gruppo Administrators locale, pertanto è possibile rimuoverli per primi.

Rimuovere gli account da migrare dal gruppo Administrators locale

Aprire il gruppo Administrators locale e rimuovere tutti gli account che si desidera migrare nel nuovo ambiente. Ripetere questo passaggio per tutti gli altri gruppi interessati.

A questo punto controllare l'elenco delle identità nell'ambiente TFS corrente e cercare eventuali potenziali problemi con i gruppi o i singoli account utente che potrebbero essere presenti nel nuovo ambiente.

Suggerimento

Si consiglia di creare una tabella o una mappa di migrazione delle identità da spostare come parte dello spostamento di ambiente, includendo i dettagli degli account per cui la migrazione potrebbe non essere eseguita automaticamente.

Verificare le identità

Nel server livello applicazione per Team Foundation, aprire una finestra del prompt dei comandi con le autorizzazioni amministrative, passare a %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools ed eseguire il comando seguente per visualizzare le identità presenti in quel momento nel sistema:
```
TFSConfig Identities
```
Verrà visualizzato un elenco di identità. Controllare questi utenti e gruppi per assicurarsi che non vi siano duplicati o problemi potenziali con le identità nell'ambiente di destinazione di TFS e risolvere eventuali conflitti potenziali.

Arrestare i servizi TFS

L'arresto dei servizi garantisce l'impossibilità da parte degli utenti di apportare modifiche agli elementi di lavoro o di archiviare codice sorgente nella distribuzione originale durante o dopo il processo di spostamento.

Nel computer livello applicazione TFS, aprire una finestra del prompt dei comandi e cambiare il percorso di directory in Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools.
Digitare il seguente comando TFSServiceControl:

TFSServiceControl quiesce

Eseguire il backup dei database e della chiave di crittografia di SQL Server Reporting Services

Aprire la console di amministrazione per TFS e nella pagina Backup pianificati eseguire un backup completo. Verrà eseguito il backup di tutti gli elementi configurati nel piano di backup. L'operazione verrà tuttavia eseguita immediatamente e non in base alla tempistica prevista nel piano. Se nella distribuzione è utilizzata la creazione rapporti, è possibile eseguire il backup della chiave di crittografia nell'ambito di questo set di backup.

Se non sono stati configurati i backup, sarà necessario creare un piano prima di poter eseguire un backup completo.
Una volta completato, verificare che il backup sia disponibile nel dispositivo di archiviazione o nella condivisione di rete e che sia possibile accedervi dal nuovo hardware.

Unire TFS al nuovo dominio

In ciascun server aprire la finestra delle proprietà del computer.
Modificare le impostazioni del computer nel dominio o gruppo di lavoro a cui si desidera aggiungere il server.

Se viene richiesto di fornire il nome utente e la password di un account che dispone delle autorizzazioni per aggiungere questo computer al dominio, fornire le credenziali appropriate.
Riavviare il computer per rendere effettive le modifiche apportate al dominio.

Nota

Dopo aver riavviato il computer è possibile che venga visualizzato un avviso in cui si informa che non è stato possibile avviare determinati servizi o driver.Continuare con la procedura descritta di seguito.

Configurare Prodotti SharePoint per il nuovo ambiente

Se tramite la modifica si ottiene un ambiente che non dispone di alcuna relazione di attendibilità con l'ambiente precedente, potrebbe essere necessario configurare Prodotti SharePoint per ottenerne il corretto funzionamento. Informazioni sugli utenti importati dai servizi directory sono disponibili nei siti SharePoint dal controllo Web Selezione utenti. Gli amministratori di siti e altri utenti utilizzano Selezione utenti per selezionare utenti e gruppi durante l'assegnazione delle autorizzazioni. Quando le informazioni relative agli utenti si trovano in più insiemi di strutture o in un insieme di strutture senza una relazione attendibile per tutti gli utenti, potrebbero essere necessari passaggi aggiuntivi per garantire che tutti gli utenti e i gruppi siano disponibili in questo controllo Web.

Ignorare questa procedura se non si utilizza Prodotti SharePointnella distribuzione, se il nuovo ambiente dispone di un'attendibilità bidirezionale con l'ambiente precedente o se non viene visualizzato alcun errore per l'applicazione Web di SharePoint nella console di amministrazione di Team Foundation.

In ogni server appartenente alla farm SharePoint che supporta la distribuzione di Team Foundation Server, aprire una finestra del prompt dei comandi con autorizzazioni amministrative, quindi cambiare il percorso di directory in %programfiles%\Common Files\Microsoft Shared\Web Server Extensions\15\BIN.
Digitare il seguente comando, dove Key è la chiave di crittografia che si desidera utilizzare nella distribuzione di Prodotti SharePoint:

stsadm.exe -o setapppassword -password Key

Nota

Questa chiave è una stringa di crittografia che consente di crittografare la password per l'account utilizzato per accedere all'insieme di strutture o al dominio.La stringa di crittografia deve essere la stessa per ogni server della farm, ma è necessario utilizzare una stringa univoca per ogni farm.
Digitare il seguente comando, dove domain:DNSName è la foresta o il dominio di destinazione, con il relativo nome DNS, user,password rappresenta il nome utente e la password di un account che ha accesso alla foresta o al dominio di destinazione e WebApp è il nome dell'applicazione Web che supporta la distribuzione di Team Foundation Server:

stsadm.exe -o setproperty -pn peoplepicker-searchadforests -pv domain:DnsName**,user,**password **-url http://**WebApp
Digitare il seguente comando, dove URL è l'URL di una raccolta siti che supporta una raccolta di progetti team, Port è il numero di porta che viene assegnato alla raccolta siti e UserName è il nome utente dell'account che fungerà da proprietario della raccolta siti:

**stsadm.exe -o siteowner -url http://URL:**Port -ownerlogin UserName
Ripetere il passaggio precedente per ogni raccolta siti utilizzata dalla distribuzione di Team Foundation Server.

Spostare gli account utente e del servizio TFS

Come accennato all'inizio di questo argomento, lo spostamento degli account è l'operazione nella quale è più probabile incontrare delle difficoltà, in particolare se la migrazione degli utenti non è stata pianificata con cura. Tramite il comando TFSConfig Identities non può essere eseguita la migrazione di un account in un account già esistente in TFS.

Se in entrambi i domini sono presenti degli account con lo stesso nome e l'unica differenza tra loro è il nome del dominio, è possibile utilizzare la modalità batch di TFSConfig Identities per modificare tutte le identità contemporaneamente. In caso contrario, è necessario modificare le identità singolarmente e specificare un nome account di destinazione diverso, come descritto dettagliatamente più avanti.

Nel server livello applicazione per Team Foundation, aprire una finestra del prompt dei comandi con autorizzazioni amministrative, passare a %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools ed eseguire il comando seguente per modificare gli ID del servizio (SID) per l'account del servizio nel nuovo dominio:
```
TFSConfig identities /change /fromdomain:OldComputerorDomainName /todomain:NewDomainName /account:OldTFSServiceAccount /toaccount:NewTFSServiceAccount
```
Avviso

Se l'account del servizio è un account di sistema come Servizio di rete, non è possibile eseguirne la migrazione direttamente perché nel nuovo ambiente esiste già un account di sistema con lo stesso nome.La modifica dovrà quindi essere eseguita in due fasi.Vedere l'esempio in Comando Identities.
Per eseguire la migrazione di tutti gli account che hanno lo stesso nome nel nuovo ambiente, digitare il comando seguente:
```
TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName
```
Gli account verranno elaborati in batch.
Se il nuovo dominio contiene una o più identità i cui nomi variano tra i due ambienti, è necessario aggiornare manualmente i SID per ciascuna di tali identità. Ad esempio, se l'account utente di Christie Church era Fabrikam\CChurch nell'ambiente precedente, ma è NewFabrikam\ChristieC nel nuovo ambiente, sarà necessario aggiornare il SID manualmente. Per ogni account con questo requisito digitare il comando seguente:
```
TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName /account:OldAccountName /toaccount:NewAccountName
```

Eseguire ora il comando seguente per aggiornare l'account del servizio:

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

Se nella distribuzione è utilizzata la creazione rapporti, eseguire il comando seguente per aggiornare l'account di origine dati utilizzato per la creazione di rapporti:
```
TFSConfig Accounts /change /AccountType:ReportingDataSource /account:AccountName /password:Password
```
Se la distribuzione utilizza il proxy di Team Foundation Server, eseguire il comando seguente per aggiornare l'account del servizio utilizzato per il proxy:
```
TFSConfig Accounts /change /AccountType:Proxy /account:AccountName /password:Password
```
Nota

Se si esegue lo spostamento in un dominio non attendibile, potrebbe inoltre essere necessario aggiungere manualmente utenti e gruppi a team, progetti, raccolte e a Team Foundation Server stesso.Per ulteriori informazioni, vedere Aggiungere utenti ai progetti team, Impostare autorizzazioni di amministratore per raccolte di progetti team e Impostare le autorizzazioni di amministratore per Team Foundation Server.
Se la distribuzione viene integrata con Project Server, potrebbe essere necessario eseguire passaggi aggiuntivi per configurare gli account del servizio con le autorizzazioni richieste per l'operazione. Per ulteriori informazioni, vedere Assegnare le autorizzazioni per supportare l'integrazione TFS-Project Server e Configurare l'integrazione TFS-Project Server.

Configurare Reporting Services e Analysis Services

È possibile ignorare questa procedura se non si utilizzano i rapporti come parte integrante della distribuzione.

Se è stato rinominato un server di rapporti durante questo tipo di spostamento, è necessario reindirizzare Team Foundation Server al server di rapporti nel nuovo percorso. È anche necessario riavviare il warehouse e ricompilare manualmente il database di Analysis Services.

Aprire la console di amministrazione per Team Foundation, passare al nodo Creazione rapporti e modificare le impostazioni.
Modificare i valori di tutte e tre le schede in modo che includano il nuovo nome del server. Assicurarsi di inserire le informazioni corrette per l'account delle origini dati nel nuovo ambiente.
Scegliere Avvia processi per riavviare la creazione rapporti.
Scegliere Avvia ricompilazione per ricompilare il warehouse.

Configurare i backup

Se il nome della condivisione di rete o il dispositivo di archiviazione è cambiato con la modifica del nome di dominio, sarà necessario aggiornare il piano di backup pianificati in modo che punti a tali risorse rinominate.

Nella console di amministrazione passare al nodo Backup pianificati e riconfigurare i backup pianificati per eseguire il backup dei database TFS nel nuovo server. Per ulteriori informazioni, vedere Configurare una pianificazione e un piano di backup.

Riavviare i servizi TFS

Una volta aggiornato TFS con tutte le informazioni per il nuovo ambiente, riavviare i servizi.

Nel computer livello applicazione TFS, aprire una finestra dei prompt dei comandi con autorizzazioni amministrative e impostare per le directory il percorso Drive:\%programmi%\Microsoft Team Foundation Server 12.0\Tools.
Digitare il seguente comando TFSServiceControl:

TFSServiceControl unquiesce

D & R

D: Si desidera modificare uno o più server fisici per la distribuzione, ma non i domini.È possibile procedere in questo modo?

R: sì. Questa operazione è denominata spostamento basato sull'hardware e i passaggi sono descritti qui. Non tentare di effettuare uno spostamento basato sull'ambiente insieme uno basato sull'hardware. Completare innanzitutto lo spostamento dell'hardware e successivamente cambiare l'ambiente.

D: Si possiede una distribuzione che si integra con Project Server.È possibile eseguire altri passaggi per fare in modo che funzioni con TFS spostato?

R: Sì, dopo avere completato lo spostamento dell'ambiente, è necessario utilizzare il comando TFSAdmin ProjectServer /RegisterPWA con le opzioni /tfs, /force e /pwa per ripetere la registrazione di TFS con Project Server. Per ulteriori informazioni sull'integrazione di TFS con Project Server, vedere qui.

Condividi tramite