Como solucionar problemas de atualização da coleção de sites no SharePoint Server 2016

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

Quando você atualiza uma coleção de sites para o SharePoint Server 2016, erros podem ocorrer ocasionalmente. Este artigo ajuda a entender esses erros e resolvê-los.

Verificação do status de atualização e os arquivos de log

Os indicadores do status de atualização e os arquivos de log devem lhe dar uma indicação do que saiu errado durante o processo de atualização. Recomendamos revisar cuidadosamente todos os erros nos arquivos de log de atualização. Os avisos nem sempre podem indicar um problema, mas você deve revisar todos para determinar se é provável que algum deles cause mais problemas.

1. Revise a página de status de atualização para seu conjunto de sites.

   Na página Configurações do Site para o conjunto de sites, na seção Administração do Conjunto de Sites, clique em Atualização do conjunto de sites. Na página Atualização do Conjunto de Sites, clique em Revisar Status da Atualização do Conjunto de Sites.

2. Se as páginas não forem renderizadas, verifique a página Configurações do Site. Se a página Configurações do Site funciona e a atualização foi bem-sucedida, pode haver problemas com a página mestra ou a home page. Se a página Configurações do Site não funcionar, verifique o arquivo de log da atualização do conjunto de sites para encontrar informações sobre o problema.

3. Revise os arquivos de log da atualização do conjunto de sites. Você pode revisá-los nos seguintes locais:

• Para administradores de coleção de sites: Há também arquivos de log para atualização de coleção de sites armazenados dentro da própria coleção de sites, no catálogo logs de manutenção em (http://<SiteName>/_catalogs/MaintenanceLogs/YYYYMMDD-HHMMSS-SSS.txtonde YYYYYMMDD é a data e HHMMSS-SSS é a hora (horas em formato de relógio 24 horas, minutos, segundos e milissegundos).

• Para administradores do farm: O arquivo de log da atualização do conjunto de sites e o de erros na atualização estão em %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\16\LOGS. Os logs são nomeados no seguinte formato: SiteUpgrade- YYYYMMDD-HHMMSS-SSS.log, onde YYYYYMMDD é a data e HHMMSS-SSS é a hora (horas em formato de relógio 24 horas, minutos, segundos e milissegundos). Esses logs do sistema de arquivos têm mais informações se você deseja detalhes dos problemas.

Problemas comuns

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

P: Eu não vejo um controle de interface de usuário que estava presente anteriormente na página

• R: Redefina a página para a versão padrão (isto é, aplique o reghost).

As alterações na UI do site podem causar problemas nas atualizações do site. Se uma página for personalizada para colocar um controle de UI em um local não padrão, você pode redefinir a página para a versão padrão recuperar o controle.

Para redefinir a página, você pode usar o link Redefinir para definição do site em Ações do Site na página Configurações do Site para redefinir a página, ou o comando Redefinir para Modelo no SharePoint Designer.

P: A exibição em uma lista grande não está mais funcionando

• R: Crie colunas indexadas, pastas, ou novas exibições para listas grandes. Você pode ter que adicionar a coluna indexada às exibições existentes.

Se uma lista é muito grande e os usuários usam uma exibição ou executam uma consulta que excede o limite, a exibição ou consulta não é permitida. Você pode criar colunas indexadas com exibições filtradas, organizar itens em pastas, definir um limite de itens na página para uma exibição grande ou usar uma lista externa. Para obter mais informações sobre limitação de lista grande e como resolver problemas com listas grandes, consulte Gerenciar listas e bibliotecas com muitos itens.

P: Eu recebo um erro sobre um nome de tipo de conteúdo duplicado

• R: Renomeie os tipos de conteúdo ou campos que estão em conflito com os nomes padrão.

Ocasionalmente, elementos personalizados (como um tipo de conteúdo) podem ter um nome que esteja em conflito com um nome na nova versão.

Nos arquivos de log da atualização, você pode ver um erro como segue:

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

Esse erro indica que um tipo de conteúdo de terceiros foi adicionado ao site especificado no SharePoint Server 2013 com o Service Pack 1 (SP1). Durante a atualização para o SharePoint Server 2016, seu nome entrou em conflito com o tipo de conteúdo padrão pelo mesmo nome. Atribua um nome diferente ao tipo de conteúdo de terceiros no site especificado e execute a atualização novamente. Para obter mais informações, consulte Criar ou personalizar um tipo de conteúdo do site.

Observação

A atribuição de um novo nome ou a remoção de um tipo de conteúdo pode fazer com que todas as personalizações dependentes de tal tipo de conteúdo parem de funcionar.

P: Meu site está feio, não se comporta como esperado ou recebo erros de script

• R: Edite ou redefina a página para a versão padrão, ou remova ou substitua os arquivos personalizados.

  Um problema no JavaScript personalizado ou inline ou nos arquivos CSS pode causar esses erros.

P: O conteúdo personalizado em meu site desapareceu ou não funciona

• R: Altere a página mestra ou mude o conteúdo de forma que ele exija zonas específicas.

  A página mestra pode ter layouts de zona diferentes e o conteúdo pode não fazer referência a ela corretamente. Como último recurso, você também pode redefinir a página para a versão padrão. No entanto, se redefinir a página, você pode perder o conteúdo específico da zona.

P: Eu recebo um erro informando que um controle ou página não pode renderizar

• R: Siga um destes procedimentos:

  • Se um Web Part foi adicionado, que não está instalado, contate o administrador do farm para que o instale. Se esse Web Part não estiver mais disponível ou suportado, use a exibição de manutenção para removê-lo da página (remova, não somente fecha o Web Part).

  • Se uma página foi editada diretamente, edite-a novamente para remover o controle ou Web Part, ou a redefina para a versão padrão.

    Um Web Part ou controle pode ter sido adicionado à página, que não está instalado ou não é mais suportado. O Web Part foi adicionado a uma zona ou página diretamente editada para adicionar um controle ou a referência do Web Part diretamente inline (possivelmente em uma página mestre).

    Talvez seja necessário ativar um recurso do SharePoint. Para obter mais informações, consulte Habilitar ou desabilitar recursos de coleção de sites e Abrir e usar a Página de Manutenção da Web Part.

P: Meu site atualizado não renderiza de nenhuma maneira, em vez disso, eu vejo um "erro inesperado" com um ID de correlação

R: Sua identidade visual personalizada pode usar uma página mestra personalizada que contém um espaço reservado para conteúdo personalizado.

Se sua página mestra personalizada contém um espaço reservado para conteúdo personalizado e layouts de página personalizados também contêm esse espaço reservado personalizado, um erro pode impedir que a home page de seu site seja renderizada após a atualização. Em vez de renderizar após a atualização, você pode ver a mensagem de erro "Erro inesperado".

Confira também

Conceitos

Atualização de um conjunto de sites para o SharePoint Server 2016