Compartilhar via

Fazer backup e restaurar um aplicativo de serviço de pesquisa no SharePoint usando o VSS

  • Artigo

Saiba como fazer backup e restaurar um aplicativo de serviço de pesquisa no SharePoint usando o VSS (Serviço de Cópia de Sombra de Volume).

Pré-requisitos para backup e restauração do SharePoint com o serviço de cópias de sombra de Volume

Para programar uma solução de backup e restauração para o SharePoint, você precisa entender como o VSS funciona e a interface do SharePoint com ele.

Tabela 1. Conceitos principais para fazer backup e restaurar o SharePoint com o Serviço de Cópia de Sombra de Volume

Artigo Descrição
Serviço de cópias de sombra de volume e seus artigos filho. Saiba mais sobre o VSS e como programar para ele.
Windows SharePoint Services and the Volume Shadow Copy Service and its child articles. Visão geral das informações e procedimentos passo a passo para fazer backup e restauração de dados do SharePoint usando o VSS e a interface do SharePoint com VSS.

Usar o serviço de cópias de sombra de Volume para fazer backup e restaurar um aplicativo de serviço de pesquisa

Os procedimentos a seguir servem para ajudar os desenvolvedores com a criação de um aplicativo de backup/restauração que usa o VSS. Se você for um profissional de TI que procura instruções para fazer backup ou restaurar um aplicativo de serviço de pesquisa do SharePoint, consulte Backup e restauração do SharePoint.

Pré-requisito: Baixe e instale o Microsoft Windows SDK para Windows 7 e .NET Framework 4 para o servidor com o aplicativo de serviço de pesquisa (SSA) e para cada servidor com um componente de índice de pesquisa. Entre outras coisas, isso instalará vshadow.exe e betest.exe para C:\\Program Files\\Microsoft SDKs\\Windows\\v7.1\\Bin\\x64\\vsstools.

Ponta: Para obter detalhes sobre os cmdlets Windows PowerShell mencionados neste artigo, consulte Windows PowerShell para referência do SharePoint.

Para registrar o gravador VSS do SharePoint e preparar os servidores de backup e restauração

  • Registre o gravador VSS do SharePoint com um destes métodos:

    • Abra Serviços em Ferramentas administrativas e iniciar o serviço de Gravador VSS do SharePoint.

    • Abra um console de comando e execute stsadm.exe -o registerwsswriter. O utilitário stsadm é encontrado em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\BIN. Verifique se que o serviço é executado em Serviços em Ferramentas administrativas.

Para fazer backup de um aplicativo de serviço de pesquisa do SharePoint usando o VSS

  1. Obtenha metadados VSS executando em uma linha de comando em cada servidor que contém um componente de índice e também no computador que está executando vshadow.exe -wm > writers.txt SQL Server onde os bancos de dados de pesquisa estão localizados. O arquivo writers.txt criado lista todos os autores VSS associados ao servidor. Você pode usar esse arquivo nas próximas etapas para gerar os arquivos de manifesto para o aplicativo de serviço de pesquisa (SSA) e o índice de pesquisa.

  2. Siga estas etapas para criar um manifesto para o SSA no computador que executa o SQL Server onde os bancos de dados de pesquisa estão localizados.

  3. Crie um arquivo XML e copie o seguinte nela:

    <BETest>
  <Writer writerid="SharePoint Services Writer ID">
    <Component logicalPath="PathSSA" componentName="SearchAppOffice" />
    <Component logicalPath="PathC" componentName="SearchAppOffice_CrawlStore" />
    <Component logicalPath="PathA" componentName="SearchAppOffice_AnalyticsReportingStore" />
    <Component logicalPath="PathL" componentName="SearchAppOffice_LinksStore" />
  </Writer>
  <Writer writerid="SQL Server Writer ID">
    <Component logicalPath="PathDbSSA" componentName="SearchAppOffice" />
    <Component logicalPath="PathDbC" componentName="SearchAppOffice_CrawlStore" />
    <Component logicalPath="PathDbA" componentName="SearchAppOffice_AnalyticsReportingStore" />
    <Component logicalPath="PathDbL" componentName="SearchAppOffice_LinksStore" />
  </Writer>
</BETest>

  4. Substitua os espaços reservados de 10 neste arquivo pelos valores apropriados do arquivo writer.txt que você gerou na primeira etapa. Use a tabela a seguir como guia.

    Observação

    Na coluna à direita, o SSA é um espaço reservado para o nome do Aplicativo de Serviço de Pesquisa.

    Tabela 2. Espaços reservados e valores de arquivo de manifesto SSA de writers.txt

    Espaço reservado Onde as informações estão localizadas em writers.txt.
    SharePoint Services Writer ID O GUID WriterId listadas sob a entrada de "Escritor de serviços do SharePoint"
    PathSSA A entrada de caminho lógico listada com o nome do aplicativo de serviço de pesquisa na entrada "Escritor de serviços do SharePoint"
    PathC A entrada path lógico listado para o componente chamado" _SSA__CrawlStore" na entrada "Escritor de serviços do SharePoint"
    PathA A entrada path lógico listado para o componente chamado" SSA _AnalyticsReportingStore" na entrada "Escritor de serviços do SharePoint"
    PathL A entrada path lógico listado para o componente chamado" _SSA__LinksStore" na entrada "Escritor de serviços do SharePoint"
    SQL Server Writer ID O GUID WriterId listadas sob a entrada de "SqlServerWriter"
    PathDbSSA A entrada de caminho lógico listada para o componente com o nome do aplicativo de serviço de pesquisa na entrada "SqlServerWriter"
    PathDbC A entrada path lógico listado para o componente chamado" _SSA__CrawlStore" na entrada "SqlServerWriter"
    PathDbA A entrada path lógico listado para o componente chamado" _SSA__AnalyticsReportingStore" na entrada "SqlServerWriter"
    PathDbL A entrada path lógico listado para o componente chamado" _SSA__LinksStore" na entrada "SqlServerWriter"

    Este é o arquivo de manifesto SSA. Para obter um exemplo de um arquivo de manifesto SSA concluído, consulte Exemplo de arquivos de manifesto.

  5. Siga estas etapas para criar um manifesto para a pesquisa de arquivos de índice. Repita essas etapas em cada servidor que tem um componente de índice.

  6. Crie um arquivo XML e copie o seguinte nela:

    <BETest>
  <Writer writerid="SharePoint Services Writer ID">
      <Component logicalPath="PathIndex" componentName="NameIndex" />
  </Writer>
  <Writer writerid="OSearch15 Writer ID">
      <Component logicalPath="PathOSearch15" componentName="IndexComponentGroup" />
  </Writer>    
</BETest>

  7. Substitua os espaços reservados de seis neste arquivo pelos valores apropriados do arquivo writer.txt que você gerou na primeira etapa. Use a tabela a seguir como guia.

    Tabela 3. Pesquisar espaços reservados e valores de arquivo de manifesto de índice de writer.txt

    Espaço reservado Onde as informações estão localizadas em writers.txt
    SharePoint Services Writer ID
    		O GUID WriterId listadas sob a entrada de "Escritor de serviços do SharePoint"
    PathIndex
    		A entrada de caminho lógico listada para o componente cujos nomes começam com "IndexComponentGroup" na entrada "Escritor de serviços do SharePoint"
    NameIndex
    		A entrada de nome listada para o componente cujos nomes começam com "IndexComponentGroup" na entrada "Escritor de serviços do SharePoint"
    OSearch15 Writer ID
    		O GUID WriterId listadas sob a entrada de "Gravador VSS do OSearch15"
    PathOSearch15
    		A entrada de caminho lógico listada para o componente cujos nomes começam com "IndexComponentGroup" na entrada "Gravador VSS do OSearch15". É normalmente vazia.
    IndexComponentGroup
    		A entrada de nome listada para o componente cujos nomes começam com "IndexComponentGroup" na entrada "Gravador VSS do OSearch15"

    Este é o arquivo de manifesto de índice de pesquisa. Para obter um exemplo de um arquivo de manifesto de índice de pesquisa concluído, consulte Exemplo de arquivos de manifesto.

  8. (Opcional) Registre os tamanhos das pastas IndexComponent em cada servidor que contém um componente de índice. Você pode usar essas informações posteriormente para verificar o backup.

  9. Em qualquer servidor no farm, abra o Shell de Gerenciamento do SharePoint e execute as seguintes linhas, em que o nome do aplicativo de serviço de pesquisa é o SSA que você deseja fazer backup. Deixe a janela SharePoint Management Shell aberto depois dela.

    $ssa = Get-SpenterpriseSearchServiceApplication -Identity "name of search service application"
Suspend-SPEnterpriseSearchServiceApplication -Identity $ssa

  10. Execute backups de bancos de dados do SSA e o índice seguindo estas etapas:

  11. No servidor com os bancos de dados SSA, execute o seguinte comando em uma linha de comando, em que a pasta de backup de destino é o caminho completo da pasta para os arquivos de backup, o arquivo de log de backup é o caminho completo e o nome do arquivo de log de backup e o arquivo de manifesto SSA é o caminho e o nome do arquivo de arquivo do arquivo de manifesto SSA.

    betest.exe /v /b /d "destination backup folder" /s "backup log file" /x "SSA manifest file"

  12. No servidor com a janela do Shell de Gerenciamento do SharePoint aberta, execute a linha a seguir, em que o nome do arquivo de topologia é o caminho completo e o nome do arquivo exportado que contém as informações de topologia. Você usará esse arquivo no procedimento de restauração para o SSA.

    Export-SPEnterpriseSearchTopology -SearchApplication $ssa -Filename "topology file name"

  13. Verificar se o arquivo é criado.

  14. Em cada servidor que tem um componente de índice, execute o seguinte em uma linha de comando, em que a pasta de backup de destino é o caminho completo da pasta para os arquivos de backup, o arquivo de log de backup é o caminho completo e o nome do arquivo de log de backup e o arquivo de manifesto de índice é o caminho e o nome do arquivo do manifesto de índice.

    betest.exe /v /b /d "destination backup folder" /s "backup log file" /x "index manifest file"

  15. (Opcional) Inspecione as pastas de índice que sofreram backup. Verifique se os nomes de pasta e tamanhos correspondem com aqueles registrada na etapa anterior.

Para restaurar um aplicativo de serviço de pesquisa do SharePoint usando o VSS

  1. Em qualquer servidor no farm, abra o Shell de Gerenciamento do SharePoint e execute as seguintes linhas para remover o aplicativo de serviço de pesquisa existente e seu proxy, em que o nome do aplicativo de serviço de pesquisa é o SSA que você deseja restaurar e o nome do proxy é seu proxy de aplicativo. Observe que name of SSA proxy normalmente é o mesmo que o nome do SSA com a palavra "Proxy" é adicionado ao final de. A opção RemoveData garante que os bancos de dados de pesquisa serão removidos.

    $ssa = Get-SPEnterpriseSearchServiceApplication -Identity "name of search service application"
Remove-SPEnterpriseSearchServiceApplication -Identity $ssa -RemoveData
Remove-SPEnterpriseSearchServiceApplicationProxy -Identity "name of SSA proxy"

  2. No mesmo servidor, execute o seguinte em uma linha de comando para restaurar os bancos de dados SSA, onde a pasta de backup de destino é o caminho completo da pasta para os arquivos de backup, o arquivo de log de backup é o caminho completo e o nome do arquivo de log de backup e o arquivo de manifesto SSA é o caminho e o nome do arquivo de arquivo do arquivo de manifesto SSA.

    betest.exe /v /r /d "destination backup folder" /s "backup log file" /x SSA_manifest_file

  3. No mesmo servidor, abra um Shell de Gerenciamento do SharePoint e execute as seguintes linhas para restaurar o SSA, onde o nome do pool de aplicativos é o nome do novo pool, domain\user é o nome de domínio do usuário em que o pool de aplicativos faz logon como, o nome do aplicativo de serviço de pesquisa é o nome do SSA, e topology_file_name é o caminho e o nome do arquivo de tipologia que você criou quando o SSA foi backup.

    Dica

    [!DICA] Este código cria uma nova identidade do pool de aplicativos para executar o SSA restaurado, mas você também pode usar uma conta existente com o cmdlet Get-SPServiceApplicationPool.

    $applicationPool = New-SPServiceApplicationPool -name "application pool name" -account "domain\\user"
Restore-SPEnterpriseSearchServiceApplication -Name "name of the search service application" -ApplicationPool $applicationPool -TopologyFile "topology_file_name" -KeepId

  4. Crie um proxy para o SSA com os seguintes cmdlets. Recomendamos que você use os mesmos valores para o nome do aplicativo de serviço de pesquisa e o nome do proxy SSA que você usou na etapa 1.

    $ssa = Get-SpenterpriseSearchServiceApplication -Identity "name of search service application"
New-SPEnterpriseSearchServiceApplicationProxy -Name "name of SSA proxy" -SearchApplication $ssa

  5. (Opcional) Verifique se o SSA e seu proxy existem abrindo A Administração Central. Escolha Gerenciar aplicativos de serviço e verificar se o SSA e seu proxy estão listados.

  6. (Opcional) Clique no SSA na lista de serviços e, em seguida, na página que é aberta, verifique se a tabela de Topologia do aplicativo de pesquisa corresponde a tipologia que você exportou no procedimento de backup. (Você também pode verificar a topologia com o cmdlet Get-SPEnterpriseSearchStatus).

  7. Restaure os arquivos de índice com o seguinte procedimento em todos os servidores com componentes de índice.

  8. Interrompa o serviço controlador de host nos Serviços de Ferramentas Administrativas >ou executando o seguinte cmdlet no Shell de Gerenciamento do SharePoint:

    stop-service SPSearchHostController

  9. Nos mesmos servidores, execute o seguinte em uma linha de comando, em que o arquivo de manifesto de índice é o caminho e o nome do arquivo do manifesto de índice que você criou no procedimento de backup.

    betest.exe /v /r /d "destination backup folder" /s "backup log file" /x "index manifest file"

  10. (Opcional) Verifique se os nomes de pasta e tamanhos correspondem aos registrada no procedimento de backup.

  11. Para cada componente de índice, renomear dados sob a pasta de dados seguindo estas etapas:

  12. No SharePoint Management Shell, execute o seguinte cmdlet.

    Get-SPEnterpriseSearchVssDataPath

  13. A partir da saída do cmdlet, registre a última parte da cada GUID. Por exemplo, se uma linha da saída for IndexComponentGroup_e255918b-6ab0-4d7c-8049-720b2744c62f, registre 720b2744c62f.

  14. Em Explorador de Arquivos (ou Windows Explorer no Windows Server 2008), navegue até C:\\Program Files\\Microsoft Office Servers\\15.0\\Data\\Office Server\\Applications\\Search\\Nodes\\24488A\\IndexComponentN\\storage\\data, onde N é o número de um componente de índice.

  15. Cada uma dessas pastas tem uma subpasta cujo nome começa com "SP" seguido por 12 dígitos hexadecimais, seguidos por um número de versão. Para cada uma dessas subpastas onde os 12 dígitos hexadecimais coincidir com um das terminações GUID registrada na etapa anterior, renomeie a subpasta para importindex. No exemplo contínuo, você renomearia a subpasta SP720b2744c62f.1.I.1.0 toimportindex.

  16. Reinicie o serviço do controlador de host nos Serviços de Ferramentas Administrativas >ou executando o seguinte cmdlet no Shell de Gerenciamento do SharePoint:

    start-service SPSearchHostController

  17. Verifique se os nomes de pasta de dados de índice têm revertida para seu nome anterior. (No exemplo contínuo, isso seria "'SP720b2744c62f.1.I.1.0".)

  18. (Opcional) Verifique se o tamanho das pastas IndexComponent corresponde os tamanhos registradas no procedimento de backup.

  19. Reinicie o SSA.

  20. Em todos os servidores afetados, execute o seguinte cmdlet em SharePoint Management Shell para verificar que o serviço de aplicativo de pesquisa está funcionando corretamente:

    Get-SPEnterpriseSearchStatus

  21. Verifique se a alimentação e procurar por novos documentos funcionam. Por exemplo, verifique o tamanho do índice usando a consulta "size>=0". Além disso, adicionar um novo documento e verificar se ele é pesquisável.

Arquivos de manifesto de exemplo

Arquivo de manifesto do SSA

<BETest>
  <Writer writerid="da452614-4858-5e53-a512-38aab25c61ad">
    <Component logicalPath="3bca1050-c15a-4987-93dc-8f911d35a0ba\\2e1f9435-d714-4bcb-be8d-ae1214e2ea22" componentName="SearchAppOffice" />
    <Component logicalPath="3bca1050-c15a-4987-93dc-8f911d35a0ba\\b8bb09b8-a823-43b0-a131-7bd5464f91fb" componentName="SearchAppOffice_CrawlStore" />
    <Component logicalPath="3bca1050-c15a-4987-93dc-8f911d35a0ba\\20c0c0b5-2086-4b16-8ce8-2cecb5186ebe" componentName="SearchAppOffice_AnalyticsReportingStore" />
    <Component logicalPath="3bca1050-c15a-4987-93dc-8f911d35a0ba\\15004c47-21ca-441e-80fe-9e068ef4ad14" componentName="SearchAppOffice_LinksStore" />
  </Writer>
  <Writer writerid="a65faa63-5ea8-4ebc-9dbd-a0c4db26912a">
    <Component logicalPath="DDDVSS4\\SQLEXPRESS" componentName="SearchAppOffice" />
    <Component logicalPath="DDDVSS4\\SQLEXPRESS" componentName="SearchAppOffice_CrawlStore" />
    <Component logicalPath="DDDVSS4\\SQLEXPRESS" componentName="SearchAppOffice_AnalyticsReportingStore" />
    <Component logicalPath="DDDVSS4\\SQLEXPRESS" componentName="SearchAppOffice_LinksStore" />
  </Writer>
</BETest>

Arquivo de manifesto de índice

<BETest>
  <Writer writerid="da452614-4858-5e53-a512-38aab25c61ad">
    <Component logicalPath="3bca1050-c15a-4987-93dc-8f911d35a0ba\\cfbddb07-2409-4b3d-997b-ee1b936c3dbd" componentName="IndexComponentGroup_3bca1050-c15a-4987-93dc-8f911d35a0ba" />
  </Writer>
  <Writer writerid="0ff1ce15-0201-0000-0000-000000000000">
    <Component logicalPath="" componentName="IndexComponentGroup_3bca1050-c15a-4987-93dc-8f911d35a0ba" />
  </Writer>
</BETest>

Confira também