Mover o Team Foundation Server de um ambiente para outro

Artigo
06/09/2015

O cenário de mudança baseada em ambiente mais comum é alterar o domínio da implantação do TFS, seja uma alteração de nome de domínio ou ir de um grupo de trabalho a um domínio.

Importante

Em algumas situações, convém alterar o domínio de uma implantação do TFS bem como do hardware.A alteração do hardware é um movimento baseado em restauração e nunca deverá combinar os dois tipos de movimento.Primeiro complete a movimentação de hardware e então altere o ambiente.

Além disso, alterar identidades no TFS como parte de um movimento de ambiente é a aparência que mais causa conflitos ou problemas.Comando de identidades é uma ferramenta poderosa, mas que possui certas limitações.Leia sobre isso como parte do planejamento de sua movimentação.Para ajudar a garantir uma mudança bem-sucedida, entenda os seguintes requisitos:

Assim que uma conta de usuário estiver presente no TFS, ela não poderá ser removida ou ter outra conta mapeada para ela.Por exemplo, se você estiver movendo DomainA/UserA para DomainB/UserB, o comando de identidades funcionaria somente para migrar o usuário se DomainB/UserB já não estiver presente no TFS.
Como os membros do grupo Administradores local são adicionados automaticamente à TFS, certifique-se de remover todas as contas que desejar migrar do grupo antes que de modificar o domínio ou o ambiente.

Para informações gerais adicionais, clique aqui para obter uma descrição mais detalhada de como a identidade se altera no trabalho do TFS, incluindo as restrições da ferramenta.

Nós faremos um passo a passo para alterar o ambiente da implantação do TFS nas seções a seguir:

Verificar permissões e contas
Serviços de parada TFS
Fazer backup dos dados
Adicionar o TFS ao seu novo domínio
Configurar Produtos do SharePoint para o novo ambiente
Mover contas de usuário e de serviço do TFS
Configurar o Reporting Services e o Analysis Services
Reiniciar serviços TFS

Verificar permissões e contas

Para alterar com êxito o ambiente do TFS, você precisará ser um administrador no computador local e no TFS e qualquer software de que a implantação depende: o SQL Server, relatórios, Produtos do SharePoint (se sua implantação usar relatórios ou o SharePoint) e qualquer outro software com que a implantação interopere, como o Project Server. No entanto, todos os membros do grupo de administradores local são incluídos automaticamente no TFS, o que pode causar problemas ao tentar migrar as contas. Portanto, você deve usar uma conta que não pretenda migrar como parte da movimentação de ambiente. Você pode considerar adicionar uma conta administrativa especial apenas para mudança, e usar essa conta para executar a migração.

Para verificar permissões a nível de administrador

Verifique se a conta que você está usando é membro dos seguintes grupos:
- Servidores: Administradores (grupo administradores local ou equivalente)
- TFS: Administradores do Team Foundation e Usuários do Console Administrativo
- SQL Server: sysadmin
- Produtos do SharePoint: administradores de farm (se sua implantação do TFS for integrada aos produtos do SharePoint)

Se você não for membro de um ou mais desses grupos, obtenha permissões agora.

Agora que você tem certeza de que está usando uma conta com todas as permissões necessárias, é hora de começar a verificar as contas para ver se pode haver qualquer conflito com nomes ou grupos no ambiente para o qual você está se movendo. Nós já sabemos que as contas que são membros do grupo administradores local não podem ser migradas, Portanto, nós as removeremos primeiro.

Remover contas a serem migradas do grupo Administradores local

Abra o grupo Administradores local e remova todas as contas que você deseja migrar para o novo ambiente. Repita esta etapa para todos os outros grupos que possam ser afetados.

Agora verifique a lista de identidades no ambiente atual do TFS e procure todos os possíveis problemas com contas de usuário individual ou de grupos que possam existir no novo ambiente.

Dica

Considere a possibilidade de criar uma tabela ou um mapa de migração das identidades a serem movidas como parte da movimentação ambiente, incluindo detalhes de quais contas não poderão ser migradas automaticamente.

Verificar identidades

No servidor de camada de aplicativo do Team Foundation, abra uma janela de prompt de comando com permissões administrativas, navegue até %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools, e execute o seguinte comando para ver as identidades atualmente no sistema:
```
TFSConfig Identities
```
Uma lista de identidades será exibida. Verifique esses usuários e grupos para garantir que não haja cópias ou problemas potenciais com as identidades no ambiente para o qual você moverá o TFS, e siga as etapas para atenuar todos os conflitos em potencial.

Serviços de parada TFS

Interromper os serviços ajuda a garantir que os usuários não possam fazer alterações nos itens de trabalho nem fazer check-in do código-fonte para a implantação original durante ou após o processo de movimentação.

No computador de camada de aplicativo do TFS, abra uma janela de prompt de comando, e altere os diretórios para Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools.
Digite o seguinte comando do TFSServiceControl:

TFSServiceControl quiesce

Faça backup dos bancos de dados e da chave de criptografia do SQL Server Reporting Services

Abra o console de administração para TFS e, na página de Backups Agendados, faça um backup completo. O backup fará backup de tudo que você configurou para backup no seu plano de backup, mas ele fará isso imediatamente, e não de acordo com a hora agendada no plano. Se a sua implantação usar relatórios, faça backup da chave de criptografia como parte desse conjunto de backup.

(Se você não tiver backups configurados, será necessário criar um plano antes que seja possível fazer um backup completo.)
Assim que o backup é concluído, verifique se o backup está disponível no dispositivo de armazenamento ou no compartilhamento de rede, e se você pode acessar esse backup do novo hardware.

Adicionar o TFS ao seu novo domínio

Em cada servidor, abra as propriedades para o computador.
Altere as configurações do computador para o domínio ou grupo de trabalho no qual você deseja ingressar o servidor.

Se você for solicitado a fornecer o nome de usuário e a senha de uma conta com permissões para ingressar este computador no domínio, forneça as credenciais apropriadas.
Reinicie o computador para que as alterações de domínio tenham efeito.

Dica

Após reiniciar o computador, um aviso pode parecer indicando que os serviços ou drivers não puderam ser iniciados.Continue com o procedimento a seguir.

Configurar Produtos do SharePoint para o novo ambiente

Se você estiver alterando o ambiente para um onde não haja confiança com seu ambiente anterior, talvez seja necessário configurar o Produtos do SharePoint antes que ele funcione corretamente. As informações sobre os usuários importados de serviços de diretório estão disponíveis nos sites do SharePoint no controle da Web Seletor de Pessoas. Os administradores do site e outros usuários usam o selecionador de pessoas para selecionar pessoas e grupos ao atribuir permissões. Quando informações sobre os usuários estão localizadas em várias florestas ou em uma floresta sem uma relação de confiança para todos os usuários, as etapas adicionais podem ser necessárias para garantir que todos as pessoas e grupos fiquem disponíveis deste controle da Web.

Ignore esse procedimento se você não estiver usando Produtos do SharePoint em sua implantação, se o novo ambiente tiver uma confiança bidirecional no antigo ambiente ou se não aparecerem erros para seu aplicativo da Web do SharePoint no console de administração de Team Foundation.

Em cada servidor que é parte da farm do SharePoint que oferece suporte à implantação de Team Foundation Server, abra uma janela de prompt de comando com permissões administrativas, e altere os diretórios para %programfiles%\Common Files\Microsoft Shared\Web Server Extensions\15\BIN.
Digite o seguinte comando, onde Key é a chave de criptografia que você deseja usar na implantação de Produtos do SharePoint:

stsadm.exe -o setapppassword -password Key

Dica

Essa chave é uma cadeia de caracteres de criptografia que é usada para criptografar a senha da conta que é usada para acessar a floresta ou o domínio.A cadeia de caracteres de criptografia deve ser a mesma para todos os servidores em farm, mas uma cadeia de caracteres exclusiva deve ser usada para cada farm.
Digite o seguinte comando, onde domain:DNSName é a floresta ou o domínio de destino e seu nome DNS, user,password é o nome de usuário e a senha de uma conta que tenha acesso à floresta ou ao domínio de destino, e WebApp é o nome do aplicativo Web que oferece suporte à implantação do Team Foundation Server:

stsadm.exe -o setproperty -pn peoplepicker-searchadforests -pv domain:DnsName**,user,**password **-url http://**WebApp
Digite o seguinte comando, onde URL é a URL para uma coleção de site que suporta uma coleção de projeto de equipe, Port é o número da porta que é atribuído à coleção do site e UserName é o nome da conta de usuário que atuará como o proprietário para essa coleção do site:

**stsadm.exe -o siteowner -url http://URL:**Port -ownerlogin UserName
Repita a etapa anterior para cada coleção de site que a implantação do Team Foundation Server usar.

Mover contas de usuário e de serviço do TFS

Como mencionado no início deste tópico, a movimentação de contas é quando você tem a maior probabilidade de encontrar dificuldades, especialmente se não planejou cuidadosamente a migração do usuário. O comando de Identidades do TFSConfig não pode migrar nenhuma conta para uma conta já existente no TFS.

Se os nomes de conta forem os mesmos em ambos os domínios, e a única diferença for o nome de domínio, você poderá usar o modo em lotes de identidades de TFSConfig para alterar imediatamente todas as identidades. Caso contrário, você deverá alterar identidades individualmente e especificar um nome de conta de destino diferente, como detalhado abaixo.

No servidor de camada de aplicativo do Team Foundation, abra uma janela de prompt de comando com permissões administrativas, navegue até %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools, e execute o seguinte comando para alterar as IDs de serviço (SIDs) para a conta de serviço do novo domínio:
```
TFSConfig identities /change /fromdomain:OldComputerorDomainName /todomain:NewDomainName /account:OldTFSServiceAccount /toaccount:NewTFSServiceAccount
```
Aviso

Se sua conta de serviço era uma conta de sistema, como Serviço de rede, você não pode migrar diretamente a conta de serviço, porque uma conta de sistema com o mesmo nome existe no novo ambiente.Você terá que realizar uma alteração de dois estágios no processo.Consulte o exemplo em Comando de identidades.
Para migrar todas as contas que têm o mesmo nome no novo ambiente, digite o seguinte comando:
```
TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName
```
Isso fará com que as contas sejam processadas em lotes.
Se seu novo domínio contiver uma ou mais identidades onde o nome altera entre ambientes, será necessário atualizar manualmente os SIDs para cada uma das identidades. Por exemplo, se a conta de usuário da igreja de Christie era Fabrikam\CChurch no ambiente anterior, mas for NewFabrikam\ChristieC no novo ambiente, você terá que atualizar manualmente o SID. Para cada conta que tenha esse requisito, digite o seguinte comando:
```
TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName /account:OldAccountName /toaccount:NewAccountName
```

Agora execute o seguinte comando para atualizar a conta de serviço:

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

Se sua implantação usar relatórios, execute o comando a seguir para atualizar a conta de fonte de dados usada para relatórios:
```
TFSConfig Accounts /change /AccountType:ReportingDataSource /account:AccountName /password:Password
```
Se sua implantação usar Proxy do Team Foundation Server, execute o comando a seguir para atualizar a conta de serviço usada para o proxy:
```
TFSConfig Accounts /change /AccountType:Proxy /account:AccountName /password:Password
```
Dica

Se você estiver se movendo para um domínio não confiável, talvez precise também adicionar usuários e grupos manualmente a equipes, projetos, coleções e Team Foundation Server.Para obter mais informações, consulte Adicionar usuários a projetos da equipe, Definir permissões de administrador de coleções de projeto da equipe e Definir permissões de administrador para o Team Foundation Server.
Se sua implantação for integrada ao Project Server, talvez seja necessário realizar etapas adicionais para configurar as contas de serviço com as permissões necessárias para a operação. Para obter mais informações, consulte Atribuir permissões para dar suporte à integração TFS-Project Server e Configurar a integração TFS-Project Server.

Configurar o Reporting Services e o Analysis Services

Você pode ignorar o procedimento se não estiver usando o relatório como parte da implantação.

Se você renomeou um servidor de relatório como parte deste tipo de movimentação, deverá redirecionar o Team Foundation Server para o servidor de relatórios no novo local. Você deve também reiniciar o depósito e manualmente recriar o banco de dados para Analysis Services.

Abra o console de administração do Team Foundation, vá até o nó de Relatórios e edite as configurações.
Altere os valores em todas as três guias de forma que elas incluam o novo nome do servidor. Certifique-se de que você forneceu informações corretas para a conta de origens de dados no novo ambiente.
Escolha Iniciar Trabalhos para reiniciar o relatório.
Escolha Iniciar Recompilação para recriar o depósito.

Configurar backups

Se o nome do compartilhamento de rede ou do dispositivo de armazenamento alterado com o nome do domínio for alterado, será necessário atualizar o plano de backup agendado para apontar para os recursos renomeados.

No console de administração, vá para o nó Backup Agendados e reconfigure os backups agendados para fazer backup dos bancos de dados do TFS no novo servidor. Para obter mais informações, consulte Configurar uma agenda e um plano de backup.

Reiniciar serviços TFS

Agora que você atualizou o TFS com todas as informações para o novo ambiente, reinicie os serviços.

No computador de camada de aplicativo do TFS, abra uma janela do prompt de comando com permissões administrativas e altere os diretórios para Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools.
Digite o seguinte comando do TFSServiceControl:

TFSServiceControl unquiesce

P e R

P: Desejo alterar o(s) servidor(es) físico(s) para minha implantação, não domínios.Posso fazer isso?

A: Sim. Isso é chamado de movimento com base em hardware, e as etapas podem ser encontradas aqui. Você não deve tentar combinar um movimento baseado em ambiente com um movimento baseado em hardware. Primeiro complete a movimentação de hardware e então altere o ambiente.

P: Eu tenho uma implantação que se integra ao Project Server.Eu preciso executar qualquer etapa extra para fazê-lo funcionar com meu TFS movido?

A: Sim, depois que você concluir a migração do ambiente, você precisará usar o comando TFSAdmin ProjectServer/RegisterPWA com as opções /tfs, /force e /pwa. Você pode ler mais sobre a integração de TFS com Project Server aqui.

Compartilhar via