Resolver problemas de atualização do banco de dados no SharePoint 2013

APLICA-SE A:2013 2019 Subscription Edition SharePoint no Microsoft 365

Mesmo depois de testar o processo de atualização para identificar possíveis problemas, você poderá enfrentar problemas inesperados durante uma atualização do SharePoint 2010 Products para o SharePoint 2013. Se houver problemas após a atualização, quanto mais cedo você os detectar e corrigir, melhor será a experiência do usuário final.

Este artigo inclui uma lista de problemas comuns e descreve os princípios gerais para ajudar a identificar e os problemas de atualização. Depois de identificar e solucionar esses problemas, você poderá continuar a atualização. Para obter mais informações sobre como retomar a atualização, consulte Reiniciar uma atualização de anexação de banco de dados ou uma atualização de coleção de sites para o SharePoint 2013.

Princípios gerais para identificar problemas

Verifique 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

Os indicadores de status e os arquivos de log da atualização mostram o que não deu certo durante o processo de atualização. Convém examinar 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 examinar todos eles para determinar se existe a possibilidade de que um deles cause ainda mais problemas.

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

   Confira mais informações sobre como verificar o status da atualização em Verificar atualizações do banco de dados no SharePoint 2013.

2. Examine os seguintes arquivos de log:

• O arquivo de log de erros da atualização e o arquivo de log de 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 são armazenados na pasta %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\15\LOGS e são chamados servername_ YYYYYMMDD- 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 atualização, consulte Verificar atualizações de banco de dados no SharePoint 2013. Para obter mais informações sobre o arquivo de log de rastreamento, consulte Rastrear logs 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.

   Instale todas as personalizações no lado do servidor, como recursos, Web Parts e assim por diante. Instale-as no local correto do seu novo farm. Por exemplo, folhas de estilo adicionais que você deve ter para Produtos do SharePoint 2010 devem ser instaladas no caminho /14, não no novo caminho /15 para que as coleções de sites que você não atualizou possam usá-las. Não se esqueça de transferir as configurações exclusivas de arquivos Web.config de cada aplicativo da web para os novos servidores.

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

3. Problemas adicionais descobertos em cada site, começando pelos sites de grande visibilidade ou muito importantes.

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

Problemas comuns

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

Quero atualizar de uma versão de pré-lançamento do SharePoint 2013

• R: A atualização de uma versão pré-lançamento do SharePoint 2013 para a versão de lançamento do SharePoint 2013 não é suportada.

  As versões de pré-lançamento servem apenas para teste e não devem ser usadas em ambientes de produção. A atualização de uma versão de pré-lançamento para outra também não é suportada.

P: O log informa que modelos, recursos ou outras personalizações do servidor estão ausentes

• R: Identifique todas as personalizações no lado do servidor e instale-as antes de atualizar

Um erro comum durante a atualização é a falta de arquivos do lado do servidor – arquivos instalados com produtos do SharePoint 2010 ou arquivos 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. Consulte o inventário para garantir que todos os arquivos necessários às personalizações estejam instalados no novo ambiente.

Você pode usar o cmdlet do Microsoft PowerShell de teste-spcontentdatabase 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, podem ser relacionados vários erros, como:

• 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.

• ERROR Encontrou uma ID de recurso ausente = [Identificador de Recurso]

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

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

• O assembly WARNING [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ê puder obter um arquivo ou uma dependência ausente do servidor, instale-o e 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 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, você não poderá atualizar o site.

Depois de instalar o arquivo ou a dependência ausentes, use o cmdlet test-SPContentDatabase Microsoft PowerShell em um servidor de teste para determinar se outros arquivos desse banco de dados estão ausentes. Se você executar apenas a atualização novamente, talvez o erro não apareça nos arquivos de log, embora ainda possa estar ocorrendo.

P: O arquivo de log informa que há algo errado nas configurações do meu farm, aplicativo da web ou aplicativo de serviço

• R: Verifique as configurações do farm e do aplicativo da web.

• R: Crie e inicie os aplicativos de serviço ausentes

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

Nos arquivos de log da atualização, podem ser relacionados vários erros, como:

• ID do modelo ERROR: A Id do site do SPSite= não pôde ser acessada devido à exceção. Ignorando a Id= ID da Web do SPWeb para atualização de modelo. Exceção: System.IO.FileNotFoundException: Não foi possível encontrar o site com o id Id do Site .

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

P: Recebo erros e avisos durante a atualização, sobre conectividade ou corrupção

• Um: Verifique suas conexões de energia e conexão com a rede e SQL Server. A perda de conectividade para as fontes de dados pode causar erros. Se os servidores não puderem se conectar aos bancos de dados, não poderão ser atualizados.

P: Eu estou sem espaço em disco

• Um: Libere algum espaço ou aumente o tamanho do arquivo de log de transações antes de retomar a atualização. Se você ficar sem espaço (por exemplo, para os arquivos de log de transação nos servidores do banco de dados), a atualização não poderá continuar.

  Para saber mais, veja Gerenciamento do tamanho do arquivo de log de transações.

P: Recebi um erro de autenticação

• R: Verifique se o aplicativo Web está usando o método de autenticação correto.

A incompatibilidade entre os métodos de autenticação pode causar problemas durante a atualização. Os seguintes recursos podem ajudar nesse caso:

• Autenticação clássica para declarações

  Verifique se os aplicativos Web criados no SharePoint 2013 usam o mesmo método de autenticação usado em Produtos do SharePoint 2010. A autenticação baseada em declarações é o método de autenticação padrão para aplicativos Web no SharePoint 2013. Se o aplicativo estava usando um modo clássico, atualize-o para o de declarações antes de atualizar o banco de dados, ou crie um aplicativo da web no modo clássico e depois migre-o para as declarações. Para obter mais informações sobre como criar um aplicativo Web que usa o modo clássico e migrar para declarações, consulte [Criar aplicativos Web que usam autenticação de modo clássico no SharePoint Server]/versões anteriores/office/sharepoint-server-2010/gg276326(v=office.14)) e Migrar do modo clássico para a autenticação baseada em declarações no SharePoint 2013

• Autenticação baseada em formulários

  Serão necessárias etapas adicionais se você estiver atualizando um ambiente que use a autenticação baseada em formulários. Siga as etapas em Configurar autenticação baseada em formulários para um aplicativo Web baseado em declarações no SharePoint Server para atualizar provedores de autenticação baseados em formulários.

P: O SQL Server informa eu não tenho permissões

• Um: Se você receber um erro sobre uma conta desconhecida ou se um banco de dados não for atualizado, verifique as permissões do banco de dados. Em particular, entre instâncias de SQL Server, verifique se a segurança está configurada corretamente. Veja se as contas de logon usadas possuem as funções fixas e permissões adequadas nos bancos de dados, e se ainda serão válidas se você atualizar em diferentes domínios.

• R: Verifique se a conta usada para anexar os bancos de dados é membro da função de banco de dados fixa db_owner para os bancos de dados que você deseja atualizar.

P: Um banco de dados não atualiza

• **A: ** Verifique se o banco de dados não está definido como somente leitura. Não é possível atualizar um banco de dados que esteja definido como somente leitura. Certifique-se de definir os bancos de dados para leitura-gravação antes de anexar e atualizar os bancos de dados.

P: Eu alterei o nome do banco de dados durante a restauração, mas não consigo encontrar os arquivos com esse nome

• **R: ** Quando você renomeia um banco de dados no momento da restauração, também deve renomear o banco e os arquivos de log no sistema de arquivos (arquivos MDF e LDF), de forma que eles correspondam.

P: Eu não consigo fazer o backup do banco de dados de Administração do aplicativo de serviço de Pesquisa

• **A: ** Antes de fazer backup do banco de dados de administração do aplicativo serviço Pesquisa, você deve interromper o serviço Pesquisa em seu farm do SharePoint Server 2010. Para interromper o serviço de Pesquisa, no menu Iniciar, do farm original, clique em Ferramentas Administrativas e em Serviços. Clique com o botão direito em Pesquisa do SharePoint Server 14 e em Parar. Inicie o serviço novamente depois de fazer o backup do banco de dados.

P: As conexões confiáveis não funcionam nos Serviços do Excel depois da atualização

• **R: ** Você deve criar manualmente todas as conexões de dados confiáveis para o Serviços do Excel depois da atualização.

P: Meus fluxos de trabalho não estão mais corretamente associados

• **A: ** Verifique se o trabalho de temporizador de limpeza automática do fluxo de trabalho está desativado. Se você tiver desabilitado o trabalho de temporizador de Limpeza Automática do Fluxo de Trabalho em seu ambiente de Produtos do SharePoint 2010, certifique-se de desabilitar esse trabalho de temporizador no novo ambiente também. Se esse trabalho de temporizador estiver habilitado no novo ambiente e desabilitado no ambiente de Produtos do SharePoint 2010, você poderá perder associações de fluxo de trabalho ao atualizar.

P: Migrei os usuários da autenticação clássica para a autenticação baseada em declarações após a atualização. Mas alguns usuários têm informações desatualizadas

• **R: ** Em caso de problemas com os perfis de usuário, verifique se o serviço Sincronização total do perfil de usuário com o SharePoint foi executado.

  Se você iniciou o serviço Sincronização total do perfil de usuário com o SharePoint (automática ou manualmente) antes do processo de migração ter concluído, alguns usuários poderão não ser migrados. Você pode executar o cmdlet a seguir no Microsoft PowerShell depois que a migração for concluída para limpar os dados de sincronização e, em seguida, você pode executar o perfil de usuário para o trabalho de sincronização completa do SharePoint novamente para incluir os usuários adicionais.

  $database = Get-SPContentDatabase "DatabaseName"
  [Microsoft.Office.Server.UserProfiles.WSSProfileSynch]::ClearSyncDataForContentDatabase($database)
  

  Em que DatabaseName é o nome do banco de dados de conteúdo da coleção de sites associada ao perfil de usuário desatualizado.

• **R:** Verifique se o usuário existe no domínio do Active Directory.

  Se o usuário não existir, você poderá designá-lo como excluído na tabela UserInfo. Se o usuário existir, poderá executar a migração novamente. Para saber mais, confira Migrar da autenticação de modo clássico para a autenticação baseada em declarações SharePoint 2013.

Confira também

Outros recursos

Usar uma atualização de avaliação para encontrar problemas em potencial no SharePoint 2013

Verificar atualizações do banco de dados no SharePoint 2013

Revisar conjuntos de sites atualizados para o SharePoint 2013

[Reiniciar uma atualização de anexação de banco de dados ou uma atualização de coleção de sites para o SharePoint 2013] (/versão anterior/office/sharepoint-server-2010/ff382638(v=office.14)