Executar a ferramenta de exame de pré-atualização (Office SharePoint Server)

Atualizado em: 2009-03-05

Neste artigo:

• Problemas informados pela ferramenta de exame de pré-atualização

• Instalar e executar a ferramenta de exame de pré-atualização

Você deve usar a ferramenta de exame de pré-atualização para examinar seus sites e corrigir erros antes de realizar uma atualização. Se você não tiver executado essa ferramenta e tentar fazer a atualização do seu ambiente, quando tentar executar o assistente de Configuração de Produtos e Tecnologias do SharePoint, ele será fechado e pedirá que você execute a ferramenta. É altamente recomendável que o administrador do servidor execute a ferramenta de exame de pré-atualização antes da atualização e solucione os problemas que possam ser resolvidos antes de agendar a atualização.

Para obter mais informações sobre problemas ou erros informados pela ferramenta de exame de pré-atualização, consulte as seguintes entradas de blog no site da Microsoft: https://go.microsoft.com/fwlink/?linkid=106424&clcid=0x416 (em inglês)

Problemas informados pela ferramenta de exame de pré-atualização

Para cada site do SharePoint, os problemas informados por esta ferramenta incluem a existência dos seguintes objetos:

• Modelos de site personalizados   Você precisa saber quais modelos de site foram personalizados para um site específico de modo a poder verificar as personalizações novamente após a atualização.

• Objetos órfãos   Objetos como itens de lista, listas, documentos, sites e conjuntos de sites podem ser órfãos — ou seja, os objetos existem mas não estão associados a um site específico. Como os objetos órfãos não funcionam na versão anterior, eles não funcionarão após a atualização. Se você realizar uma atualização in-loco, os itens órfãos ainda existirão, mas não funcionarão. Se você realizar uma atualização gradual, os itens órfãos não serão copiados para o novo site. Recomendamos que você limpe os objetos órfãos antes da atualização.

  Observação

  Os membros do grupo Administradores nos servidores Web front-end podem recuperar itens órfãos antes da atualização seguindo as etapas do artigo 918744 da Base de Dados de Conhecimento com a descrição de uma nova operação de linha de comando que você pode usar para reparar bancos de dados de conteúdo no Windows SharePoint Services (https://go.microsoft.com/fwlink/?linkid=69958&clcid=0x416).

• Web Parts personalizadas   Informe a existência de Web Parts personalizadas ao administrador do site ou desenvolvedor apropriado antes da atualização, para permitir que eles tenham tempo de investigar.

  Dica

  Os Web Parts personalizados muito ofuscados talvez precisem ser recriados e reimplantados após a atualização.

• Sites baseados em idiomas ou que usam controles não instalados   Se o banco de dados contiver um site baseado em um pacote de modelos de idiomas não instalado no momento nos servidores Web front-end ou um site que use controles (como os Microsoft Office Web Components) não instalados no momento nos servidores Web front-end, instale os pacotes de idiomas ou os controles ausentes antes da atualização.

Use as informações coletadas pela ferramenta de exame de pré-atualização para determinar:

• Se deve ser realizada uma atualização in-loco ou gradual.

  Determinar método de atualização (Office SharePoint Server) fornece informações para ajudar você a decidir que tipo de atualização será executada. É importante considerar o relatório gerado pela ferramenta de exame de pré-atualização ao tomar essa decisão. Em geral, se você encontrar problemas significativos, use uma atualização gradual em vez de uma atualização in-loco para poder resolver os problemas.

• Se deve ser realizada uma atualização de alguns ou de todos os conjuntos de sites que contenham sites personalizados.

• Quais sites precisam ter personalizações reaplicadas ou refeitas após a atualização e, portanto, podem demorar mais do que outros na etapa de revisão.

  Importante

  Quando você executar a ferramenta de exame de pré-atualização, os metadados de todas as listas e bibliotecas de seus sites serão atualizados. Isso significa que as listas e as bibliotecas no ambiente mostrarão que foram atualizadas após a execução da ferramenta de exame de pré-atualização. As datas de itens de lista e documentos individuais não são alteradas por esse processo.

Instalar e executar a ferramenta de exame de pré-atualização

1. Baixe e instale a ferramenta de exame pré-atualização do Centro de Download da Microsoft (em inglês) (https://go.microsoft.com/fwlink/?linkid=92383\&clcid=0x416) (em inglês).

   Dica

   Você deve ser membro do grupo Administradores do computador local para executar esta ferramenta.

2. Na linha de comando, altere a pasta que contém os dois arquivos e execute o comando a seguir para examinar todos os servidores do seu farm de servidores:

   prescan.exe /c preupgradescanconfig.xml /all
   

   Você pode usar a ferramenta de exame de pré-atualização para examinar todos os sites em seu ambiente (utilizando o parâmetro /all) ou para examinar uma URL específica (utilizando o parâmetro /v URL). Se você não fornecer um parâmetro de escopo, todos os sites serão examinados.

   Dica

   Modelos usados pelo SharePoint Portal Server 2003 podem ser identificados incorretamente durante o exame de pré-atualização como modelos personalizados a menos que você use o arquivo preupgradescanconfig.xml ao executá-lo. Esse arquivo contém a lógica adicional para identificar os modelos de site de portal como modelos padrão usados pelo SharePoint Portal Server 2003 e não como modelos personalizados baseados no Windows SharePoint Services 2.0.

   Se você já tiver instalado a nova versão, mas ainda não tiver executado o assistente de Configuração de Produtos e Tecnologias do SharePoint, poderá executar a ferramenta de exame de pré-atualização a partir da seguinte pasta: %Arquivos de Programas% \Common Files\Microsoft Shared\web server extensions\12\BIN.

   A execução do exame pode levar vários minutos ou algumas horas, dependendo da quantidade de conteúdo no seu ambiente.

3. Após a conclusão do exame, um relatório de resumo será exibido na janela de linha de comando.

Se houver algum erro ou se forem encontrados problemas de atualização em seus sites, você poderá revisar o relatório completo para ver os detalhes. O relatório é denominado PreupgradeReport_IDexclusiva_Log.txt (em que IDexclusiva é uma cadeia numérica) e está localizada no diretório temporário do computador do usuário que executou a ferramenta (por exemplo, %SYSTEMDRIVE%:\Documents and Settings\Usuário1\Local Settings\Temp). Há também um arquivo prescan.log no mesmo diretório; ele indica em que horário (ou horários) a ferramenta de exame de pré-atualização foi executada.

Depois de executar a ferramenta de exame de pré-atualização, você poderá revisar os relatórios para encontrar e solucionar problemas (procure "erro" no relatório para localizar os problemas). Você também pode compartilhar os resultados relevantes do exame de pré-atualização com outros membros da equipe de atualização. Por exemplo, você pode informar problemas, como modelos de sites personalizados ou Web Parts personalizados para o proprietário do site, Web designer ou desenvolvedor apropriado, antes de programar a atualização, para que eles tenham tempo de investigar os problemas e adotar medidas preliminares. Por exemplo, um designer ou desenvolvedor pode decidir que seja prudente recriar uma Web Part muito ofuscada antes da atualização. Os proprietários de sites podem verificar quaisquer personalizações que foram feitas em seus sites, inclusive modelos de sites e alterações em arquivos ASPX básicos, e podem observar possíveis problemas.

Baixar este manual

Este tópico está incluído no seguinte manual baixável para facilitar a leitura e a impressão:

• Manual sobre como atualizar para o Office SharePoint Server 2007 (em inglês)

Consulte a lista completa de manuais disponíveis na página de download de conteúdo do Office SharePoint Server 2007.