Ricardo Serradas

Algo que causa muita preocupação e muito planejamento em empresas que pensam em migrar do VSS para o Team Foundation server é justamente a migração do código-fonte.

Há os que pensam que vão perder o histórico, outros que vão ter que recolocar os fontes no sourcecontrol manualmente, e por aí vai. O legal é destacar que o TFS conta com uma ferramenta chamadaVSSConverter, que colabora com essa migração.

Esta ferramenta transporta entre as plataformas os arquivos, pastas, histórico de versões e informações de usuários. É claro que algumas informações não são compatíveis entre o VSS e o TFS e não serão transportadas. Abaixo, veremos um overview de uma preparação de migração e falaremos de mais detalhes.

Para que possamos continuar com o assunto, é importante ter instalado as ferramentas abaixo na máquina em que você pretende rodar a ferramenta de conversão:

• Team Explorer
• Permissão de administrador na máquina
• SQL Server Express
• Visual Source Safe 2005 ou superior
• A base do VSS que você quer analisar. O formato da base deve ser 6.0 ou superior. Você deve rodar o conversor na mesma máquina em que se encontra sua base.
• Você precisa também da senha de administrador da base do VSS.

Preparando a base do VSS

Antes de começarmos…

- Peça a todos os usuários para fazer check-ins em seus arquivos
- Crie um backup da base que vai migrar
- Use a ferramenta de análise do VSS para localizar e resolver problemas de integridade de dados na sua base.

Analisando os projetos…

VSSConverter.exe é um utilitário de linhas de comando que precisa dos seguintes parâmetros:

• Um caminho para a pasta que contém o arquivo srcsafe.ini da base que está migrando
• Um arquivo XML que contém configurações
• VSSConverter está em [raiz]:\Arquivos de Programas\Microsoft Visual Studio 9.0\Common7\IDE\ e pode ser chamada através do utilitário de linha de comando do Visual Studio.

Vamos imaginar que sua base do VSS esteja em C:\VSSDB.

Depois que você decidiu que projetos da base vai analisar, é preciso criar um arquivo que contenha as configurações. Este arquivo é a lista de projetos que você quer migrar.

Para criar o arquivo de configurações…

• Vamos criar um diretório para trabalhar com nosso arquivos. Eu criei o C:\VSS2TFS
• Dentro dele, crie o arquivo settings.xml e abra-o com o Notepad.
• Copie o XML abaixo e cole dentro do arquivo, onde $\PastaA e$\PastaB são os projetos que quer migrar.

<?xml version=”1.0″ encoding=”utf-8″?>
<SourceControlConverter>
<ConverterSpecificSetting>
<Source name=”VSS”>
<VSSDatabase name=”C:\VSSDB”></VSSDatabase>
</Source>
<ProjectMap>
<Project Source=”$\PastaA”></Project>
<Project Source=”$\PastaB”></Project>
</ProjectMap>
</ConverterSpecificSetting>
<Settings>
<Output file=”Analysis.xml”></Output>
</Settings>
</SourceControlConverter>

* Para migrar o banco inteiro, use: <Project Source=”$/”></Project>.

• Em <VSSDatabase name, coloque o caminho do diretório onde está sua base do VSS a ser migrada.
• Salve e feche.

O próximo passo será rodar o conversor usando o caminho deste arquivo como parâmetro. O usuário logado no windows precisa ser administrador no SQL Express também. Por padrão, o usuário que instalou o SQL ou o Visual Studio que ele acompanhou já tem essa permissão.

Para analisar o projeto com o conversor…

• No prompt de comando do Visual Studio, digite: VSSConverter Analyze settings.xml
• Quando for solicitado, digite a senha de administrador da base do VSS.

O conversor irá mostrar o status da análise. Quando terminar, irá gerar um relatório (VSSAnalysisReport.xml) e um arquivo de mapeamento de usuários (usermap.xml) e vai salvá-los no diretório corrente.

O próximo passo, depois de ver que a migração terá sucesso fazendo a análise, será fazer efetivamente a migração, o que veremos no próximo post.

Um abraço

Ricardo Serradas