Solucionar problemas de atualização (SharePoint Foundation 2010)

  • Artigo

 

Aplica-se a: SharePoint Foundation 2010

Tópico modificado em: 2016-11-30

Mesmo depois de testar o processo de atualização para identificar possíveis problemas, é possível que ocorram problemas inesperados durante uma atualização do Windows SharePoint Services 3.0 para o Microsoft SharePoint Foundation 2010. Se perceber problemas após a atualização, quanto mais cedo você detectá-los e corrigi-los, melhor será a experiência do usuário final.

Este artigo descreve princípios gerais para identificar e solucionar problemas de atualização, além de incluir uma lista de problemas comuns. Depois de identificar e solucionar esses problemas, será possível continuar a atualização. Para obter mais informações sobre como continuar a atualização, consulte Continuar a atualização (SharePoint Foundation 2010).

Neste artigo:

  • Princípios gerais para identificar problemas

  • Problemas comuns

    • Personalizações ou arquivos ausentes ou substituídos no servidor

    • Configurações ausentes ou definidas incorretamente para farm de servidores, aplicativo Web ou serviços

    • Níveis de atualização inconsistentes ou incorretos

    • Navegação global ausente para blogs

    • Problemas de dados

    • Alterações na interface do usuário

    • Espaço insuficiente

    • Autenticação baseada em formulários

    • Segurança e permissões

    • Os arquivos .stp não funcionam após a atualização

    • Não é possível encontrar novas versões dos modelos de aplicativo Fabulous 40

Princípios gerais para identificar problemas

Comece verificando o status da atualização, para determinar em que ponto ela foi interrompida (caso isso tenha ocorrido), e consulte os arquivos de log em busca de erros ou avisos. Corrija os problemas encontrados antes de continuar a atualização.

Em primeiro lugar, verifique o status da atualização e os arquivos de log

Indicadores de status e arquivos de log da atualização devem dar uma indicação do que não deu certo durante o processo de atualização. Convém rever com atenção todos os erros registrados nos arquivos de log da atualização. Avisos nem sempre indicam um problema, mas não deixe de examiná-los para determinar se existe a possibilidade de que um deles cause ainda mais problemas.

  1. Verifique o status da atualização executando um dos procedimentos a seguir ou ambos:

    • Examine a página Status da Atualização no site da Administração Central do SharePoint.

    • Use a operação localupgradestatus de Stsadm.exe para verificar o status da atualização.

    Para obter mais informações sobre como verificar o status da atualização, consulte Verificar a atualização e examinar os sites atualizados (SharePoint Foundation 2010).

  2. Examine os seguintes arquivos de log:

    • O arquivo de log do Setup.exe.

    • O arquivo de log do Assistente de Configuração de Produtos do SharePoint (Psconfig.exe).

    • O arquivo de log de erros da atualização e o arquivo de log da atualização (que contém informações mais detalhadas do que o arquivo de log de erros da atualização).

    • Arquivos de log de rastreamento ou ULS.

      Esses arquivos estão armazenados na pasta %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS e são nomeados da seguinte maneira: NomedoServidor_AAAAMMDD-MMSS.log.

    • O arquivo de log de eventos do aplicativo.

      Esse arquivo pode ser exibido com o uso do Visualizador de Eventos.

    Para obter mais informações sobre os arquivos de log de Setup.exe, PSconfig.exe e da atualização, consulte Verificar a atualização e examinar os sites atualizados (SharePoint Foundation 2010). Para obter mais informações sobre o arquivo de log de rastreamento, consulte o artigo sobre logs de rastreamento (https://go.microsoft.com/fwlink/?linkid=182380&clcid=0x416) no MSDN.

Em seguida, solucione os problemas em ordem

Alguns problemas têm mais consequências do que outros. Por exemplo, um arquivo ausente no servidor pode causar vários erros aparentemente não relacionados em nível de site.

Solucione os problemas na seguinte ordem:

  1. Personalizações ou arquivos ausentes no servidor, como recursos ou Web Parts.

  2. Problemas de configuração no farm de servidores, no aplicativo Web ou em serviços, como caminhos gerenciados ou serviços não iniciados.

  3. Problemas adicionais descobertos em cada site, começando com sites de alto impacto e grande visibilidade.

À medida que identificar e corrigir os problemas mais importantes, você pode tentar reexecutar a atualização para conferir se outros problemas mais adiante no processo de atualização também foram corrigidos.

Problemas comuns

Verifique se algum dos problemas a seguir está causando um erro de atualização ou um aviso.

Personalizações ou arquivos ausentes ou preteridos no servidor

Um erro comum durante a atualização está relacionado a arquivos ausentes no servidor — arquivos instalados com o Windows SharePoint Services 3.0 ou personalizados. Quando se preparou para a atualização, você deve ter criado um inventário de personalizações no servidor (como definições de sites, modelos, recursos, Web Parts, assemblies) necessárias para os sites. (O verificador de pré-atualização pode ajudar a identificar esses itens.) Consulte o inventário para garantir que todos os arquivos necessários às personalizações estejam instalados no ambiente de atualização.

Se estiver fazendo uma atualização com anexação de banco de dados, será possível usar o cmdlet test-spcontentdatabase do Windows PowerShell antes de atualizar o banco de dados para identificar arquivos ausentes. Também existe a opção de usar a operação enumallwebs em Stsadm.exe para identificar personalizações no servidor que estão sendo usadas.

Nos arquivos de log da atualização, vários erros podem ser exibidos, entre os seguintes:

  • ERRO Detectada Contagem de Referência Web(s) usando modelo da Web ausente Identificador de Modelo de Site (lcid: Código de Idioma do Modelo de Site) em BancodeDadosdeConteúdo Nome do Banco de Dados de Conteúdo.

  • ERRO Detectada ID de recurso ausente = [Identificador de Recurso]

  • ERRO O arquivo [Caminho Relativo do Arquivo] é referenciado [Contagem de Referência] vezes no banco de dados, mas não está instalado no farm atual.

  • AVISO A classe de WebPart [Identificador de Web Part] é referenciada [Contagem de Referência] vezes no banco de dados, mas não está instalada no farm atual.

  • AVISO O assembly [Caminho do Assembly] é referenciado no banco de dados, mas não está instalado no farm atual.

  • AVISO Não foi possível atualizar o recurso. Exceção: a ID de definição de recurso 'Identificador de Recurso' não foi encontrada.

Se você conseguir obter um arquivo ou uma dependência ausente no servidor, instale-o(a) e depois execute novamente a atualização para os sites afetados. Se o arquivo ou a dependência (como uma Web Part) tiver sido preterido, decida se você deseja ou não recriar o site, a página ou a Web Part de forma a usar um modelo, um recurso ou uma Web Part diferente. Se for possível refazer a personalização usando dependências que não foram preteridas, você poderá executar a atualização novamente para os sites afetados. Se não conseguir remover a dependência, não poderá atualizar o site.

Após a instalação da dependência ou do arquivo ausente, use o cmdlet test-SPContentDatabase do Windows PowerShell em um servidor de teste para determinar se há outros arquivos ausentes para o banco de dados. Se você executar apenas o verificador de pré-atualização ou executar a atualização novamente, talvez o erro não apareça nos arquivos de log, embora ainda possa estar ocorrendo.

Configurações ausentes ou definidas incorretamente para farm de servidores, aplicativo Web ou serviços

Verifique as configurações do aplicativo Web e do farm, e crie e inicialize os serviços ausentes.

Verifique se os caminhos gerenciados (caminhos incluídos ou excluídos) estão configurados corretamente para cada aplicativo Web.

Nos arquivos de log da atualização, vários erros podem ser exibidos, entre os seguintes:

  • ERRO Não foi possível acessar o modelo Id do Modelo: SPSite Id=Id do Site devido a uma exceção. Ignorando SPWeb Id=Id da Web para atualização do modelo. Exceção: System.IO.FileNotFoundException: Não foi possível encontrar o site com a id Id do Site.

    O erro indica que um caminho gerenciado está ausente. Adicione o caminho gerenciado do conjunto de sites ao aplicativo Web e reinicie a atualização para o banco de dados de conteúdo que contém esse conjunto de sites.

Níveis de atualização inconsistentes ou incorretos

É necessário estar executando o Windows SharePoint Services 3.0 com Service Pack 2 para realizar a atualização. Se você não atender a esse requisito mínimo, ocorrerá um erro e a atualização não será executada.

Outro erro comum é a navegação global ausente para blogs atualizados. Isso ocorre porque o recurso Navegação no Meu Site (6adff05c-d581-4c05-a6b9-920f15ec6fd9) não foi habilitado durante a atualização. Para habilitá-lo, execute o cmdlet Enable-SPFeature do Windows PowerShell 2,0.

Para obter mais informações, consulte Enable-SPFeature.

Problemas de dados

Os seguintes problemas de dados podem causar erros ou avisos durante a atualização:

  • Conectividade a fontes de dados. Se os servidores não puderem se conectar aos bancos de dados, não poderão ser atualizados.

  • Listas ou sites órfãos ou outros danos aos bancos de dados. Para obter mais informações, consulte Limpando o ambiente antes da atualização (SharePoint Foundation 2010).

  • Dados de coluna ocultos. Se o processo de atualização adicionar uma coluna a uma lista, e já existir na lista uma coluna personalizada com esse mesmo nome, a coluna personalizada será renomeada. Após a atualização, talvez você precise reajustar suas exibições para incluir a coluna renomeada.

Nos arquivos de log da atualização, vários erros podem ser exibidos, entre os seguintes:

  • AVISO Os sites órfãos podem causar falhas de atualização.

  • ERRO O banco de dados [Nome de Banco de Dados de Conteúdo] contém um site (Id = [Identificador do Conjunto de Sites], Url = [URL do Conjunto de Sites]) que não foi encontrado no mapa do site.

Corrija os danos dos bancos de dados ou os itens órfãos e execute a atualização novamente.

Alterações na interface do usuário

As alterações na interface do usuário, como a adição da interface do usuário do Fluent (também conhecida como faixa de opções) ou a adesão aos padrões de XHTML, podem causar problemas em sites. Ocasionalmente, elementos personalizados (como um tipo de conteúdo) podem ter um nome que esteja em conflito com um nome na nova versão. Também pode haver páginas que precisem ser revertidas à definição de site padrão ou listas grandes para as quais seja necessário criar novas exibições.

Para obter mais informações sobre como examinar problemas da interface do usuário em sites, consulte Verificar a atualização e examinar os sites atualizados (SharePoint Foundation 2010).

Nos arquivos de log da atualização, vários erros podem ser exibidos, entre os seguintes:

  • Falha ao ativar recursos do conjunto de sites no site Url do Site. Exceção: um nome de tipo de conteúdo duplicado "nome" foi encontrado.

    O erro indica que um tipo de conteúdo "Informações de Resumo" de terceiros foi adicionado ao site especificado no o12 e, durante a atualização para o o14, seu nome está em conflito com nosso tipo de conteúdo "Informações de Resumo" pronto para uso. Exclua o tipo de conteúdo de terceiros do site especificado ou renomeie-o como algo diferente de "Informações de Resumo" e execute a atualização novamente.

Espaço insuficiente

Se você ficar sem espaço (por exemplo, para arquivos de logs de transações nos servidores de bancos de dados), a atualização não poderá continuar. Libere espaço ou aumente o tamanho do arquivo de log de transações antes de continuar a atualização. Para obter mais informações, consulte o artigo sobre gerenciamento do tamanho do arquivo de log de transações (https://go.microsoft.com/fwlink/?linkid=124882&clcid=0x416).

Autenticação baseada em formulários

Etapas adicionais serão necessárias se você estiver atualizando um ambiente que use a autenticação baseada em formulários. Siga as etapas descritas em Configurar a autenticação baseada em formulários para um aplicativo Web baseado em declarações (SharePoint Foundation 2010) para atualizar provedores de autenticação baseada em formulários.

Segurança e permissões

Se você receber um erro sobre uma conta desconhecida ou se um banco de dados não estiver atualizado, verifique o seguinte:

  • Para uma atualização in-loco, verifique se a conta que você usa para executar o Assistente de Configuração de Produtos do SharePoint é membro da função fixa de banco de dados db_owner para todos os bancos de dados a serem atualizados. Se a conta não for membro dessa função, talvez seja exibido um erro sobre uma conta de usuário desconhecida assim que o assistente iniciar a atualização dos bancos de dados.

  • Para uma atualização com anexação de banco de dados, se você estiver movendo bancos de dados entre instâncias do SQL Server, verifique se a segurança está configurada corretamente. Verifique se as contas que você está usando têm as funções fixas e as permissões apropriadas nos bancos de dados e se as contas ainda serão válidas se a atualização estiver sendo realizada entre domínios.

Os arquivos .stp não funcionam após a atualização

Os modelos de site (.stp files) foram substituídos no SharePoint Foundation 2010 e não podem ser usados para criar novos sites. Os sites existentes baseados nos arquivos .stp continuarão funcionando como de costume. Os pacotes de solução (arquivos .wsp) são o método com suporte para criação de sites baseados em um modelo no SharePoint Foundation 2010. É possível converter um arquivo .stp em arquivo .wsp para continuar usando o modelo após a atualização.

Para converter um arquivo .stp em arquivo .wsp

  1. No Windows SharePoint Services 3.0, crie um site que seja baseado no modelo e, em seguida, atualize o site para o SharePoint Foundation 2010.

  2. No SharePoint Foundation 2010, no menu Ações do Site no site atualizado, clique em Configurações do Site.

  3. Na página Configurações do Site, em Ações do Site, clique em Salvar site como Modelo.

  4. Na página Salvar como Modelo, insira o Nome do arquivo e o Nome do modelo e clique em OK.

    O modelo de site é salvo como um arquivo .wsp na Galeria de Soluções desse conjunto de sites e você pode criar novos sites com base nessa solução.

Não é possível encontrar novas versões dos modelos de aplicativo Fabulous 40

Muitas pessoas usaram os modelos "Fabulous 40" que foram criados para o Windows SharePoint Services 3,0. Alguns desses modelos foram criados como modelos de administração de site (arquivos .stp) e alguns como modelos de administração de servidor (arquivos .wsp). A Microsoft não está lançando novas versões desses modelos para o Produtos do SharePoint 2010. Além disso, os arquivos .stp foram substituídos e não podem ser usados para criar novos sites durante a atualização para o SharePoint Foundation 2010.

É possível atualizar sites baseados nesses modelos. Porém, você deve tentar atualizar esses sites em um ambiente de teste antes de atualizar o ambiente de produção, assim você pode descobrir qualquer problema potencial. Use o verificador de pré-atualização para descobrir qualquer problema. (Algumas pessoas tiveram problemas com os fluxos de trabalho personalizados ou os modos de exibição baseados em CAML nos modelos.) Observe que após a atualização, não será possível usar os arquivos .stp para criar novos modelos.

A tabela a seguir descreve como é possível usar os modelos.

Tipo de modelo Posso atualizar sites com base nesse modelo? Posso usar o modelo após a atualização?

Administração de site (arquivo .stp ou modelo de site)

Sim

Não

Administração de servidor (arquivo .wsp ou pacote de soluções)

Sim*

Sim*

*Há problemas com alguns arquivos .wsp após a atualização. Em particular, após a atualização, alguns clientes não conseguem criar novos sites com base nos seguintes modelos: Solicitação de Ausência e Gerenciamento do Cronograma de Férias, Call Center, Assistência Técnica, Espaço de Trabalho da Equipe de TI, Base de Dados de Conhecimento e Acompanhamento e Gerenciamento de Ativos Físicos. Caso tenha problemas ao usar qualquer um desses modelos, você poderá postar o problema no fórum do TechNet SharePoint 2010 – Setup, Upgrade, Administration and Operation (https://go.microsoft.com/fwlink/?linkid=201600&clcid=0x416), ou contate o Atendimento Microsoft.

Para continuar criando sites baseados nos modelos de administração de site (arquivos .stp) no SharePoint Foundation 2010, converta-os em pacotes de solução (arquivos .wsp). Para obter mais informações, consulte a seção Os arquivos .stp não funcionam após a atualização já abordada neste artigo.

See Also

Concepts

Usar uma atualização de avaliação para encontrar possíveis problemas (SharePoint Foundation 2010)
Verificar a atualização e examinar os sites atualizados (SharePoint Foundation 2010)
Continuar a atualização (SharePoint Foundation 2010)