---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Verificação de pré-upgrade do MID Server

# Verificação de pré-upgrade do MID Server {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

Antes de um upgrade, o MID Server realiza testes para identificar problemas que podem fazer com que o processo de upgrade falhe ou resulte em uma indisponibilidade do MID Server.
Cada MID Server contém um monitor de Upgrade automático que compara a versão do MID Server com a da instância para determinar se o MID Server precisa de um upgrade. Se o monitor de Upgrade automático descobrir que a versão do MID Server está desatualizada, o monitor executará testes de validação de pré-upgrade para esse servidor. Se um problema for detectado, uma mensagem será registrada na tabela Problema do MID Server \[ecc_agent_issue\] e o upgrade será bloqueado. O monitor de Upgrade automático continua sendo executado a cada hora até que todos os testes sejam aprovados. Se não houver problemas que causem bloqueio, o MID Server baixará o pacote de upgrade adequado e iniciará o processo de upgrade. A verificação de pré-upgrade do MID Server também é executada para os upgrades acionados pela instância quando ela é atualizada, bem como para os upgrades manuais.

## Testes de pré-upgrade {#mid-server-pre-upgrade-check__section_xnl_vr1_fqb}

O pré-upgrade realiza dois conjuntos de testes: testes obrigatórios e testes de alerta. Todos os testes obrigatórios precisam ser aprovados para que o upgrade do MID Server inicie. Se um teste obrigatório não tiver sido aprovado, ele será registrado no log do agente e um [problema ativo do MID Server](https://servicenow-prod.fluidtopics.net/74NMGhqLwQJD~HoqIVYQ2g "A instância ServiceNow tem uma tabela dedicada que publica problemas ativos com MID Servers e alerta os administradores quando um MID Server está em risco de exceder seus recursos.") será criado na tabela de problemas do MID Server \[ecc_agent_issue\]. Esses erros serão publicados antes que o upgrade do MID Server ocorra e deverão ser resolvidos antes que o upgrade possa continuar. O MID Server interrompe o processo de upgrade e muda o status com base nos [Estados do MID Server](https://servicenow-prod.fluidtopics.net/BUH86E6VZA5MlYcoDLORHQ#c_UpgradeAndTestMIDServer__section_t1p_jc4_1qb). Se algum teste de alerta não for aprovado, uma mensagem será adicionada ao log do agente e à tabela de problemas do MID Server, mas a verificação de pré-atualização continuará e o upgrade do MID não será interrompido.  
Os testes de validação de pré-upgrade verificam os seguintes testes obrigatórios:

* Pelo menos 1 GB de espaço livre em disco
* Acesso ao site de download em install.service-now.com
* Verificação da assinatura digital de um arquivo de amostra baixado
* Permissão para executar, que envolve o seguinte:
  * Extrair um arquivador zip para uma pasta temporária
  * Copiar um arquivo da pasta temporária para a pasta do agente
  * Ler um arquivo de texto e validar o conteúdo
  * Excluir o conteúdo de verificação de pré-upgrade
  {#mid-server-pre-upgrade-check__ul_b4m_zs1_fqb}
* A máquina host do MID Server não é um sistema de 32 bits
* Em MID Servers no Linux, a versão de glibC é pelo menos 2.17
{#mid-server-pre-upgrade-check__ul_lj5_ws1_fqb}  
Nos MID Servers no Windows, a validação de pré-upgrade executa os seguintes testes de alerta:

* Todos os serviços bloqueadores de upgrade do MID Server estão em execução na máquina host
* Status da Experiência da aplicação na máquina host
* O MID Server deve ser executado como um usuário não administrador. Se a conta de Logon como usuário atual para o MID Server for LocalSystem ou for um usuário que faz parte do grupo de Administradores, o upgrade falhará e gerará um log de erro.
{#mid-server-pre-upgrade-check__ul_hbw_2t1_fqb}

## Erros que bloqueiam o upgrade {#mid-server-pre-upgrade-check__section_cdl_3t1_fqb}

As mensagens abaixo descrevem a falha em um teste obrigatório e são publicadas na tabela Problemas do MID Server \[ecc_agent_issue\]. A falha em qualquer um desses testes bloqueia o upgrade.

Não há espaço em disco suficiente. O sistema relata \<n\> bytes livres
:   Essa mensagem é exibida quando menos de 1 GB de espaço livre em disco é detectado no host do MID Server. Esse erro também é gravado no log do agente do MID Server.

Não é possível baixar atualizações no servidor de instalação
:   Essa mensagem indica que o host do MID Server não tem permissão para baixar o pacote de instalação em install.service-now.com ou que problemas de rede impedem a conexão. Esse erro também é gravado no log do agente do MID Server.

Falha na verificação da assinatura: \<message\>
:   Essa mensagem indica que ocorreu uma exceção de verificação quando a verificação de pré-upgrade tentou verificar a assinatura digital do arquivo de verificação baixado.

Não é possível verificar a assinatura digital: \<mensagem\>
:   Essa mensagem indica que o processo de assinatura de verificação foi interrompido por uma exceção.

Não é possível extrair o conteúdo do zip de verificação de pré-upgrade
:   Essa mensagem indica que a conta de serviço no host do MID Server não tem permissão para extrair o arquivo ZIP de pré-upgrade para a pasta temporária.

Não é possível criar a pasta \<caminho do arquivo de verificação de upgrade\>
:   Essa mensagem indica que a conta de serviço do MID Server não tem permissão para criar a pasta upgradeCheck para os arquivos de verificação de pré-atualização no caminho agent/package.

Não é possível verificar as permissões do arquivo: \<mensagem\>
:   Essa mensagem indica que ocorreu uma exceção ao verificar as permissões do arquivo, como um arquivo que não existe ou uma falha de acesso.

O Serviço do Windows do MID Server não está sendo executado como LocalSystem ou como um administrador local
:   Essa mensagem avisa que o serviço do Windows não está sendo executado com as permissões desejadas.

Falha de upgrade: a máquina host não atende aos requisitos mínimos do sistema para atualizar o MID Server.
:   Não há suporte para o upgrade do MID com o host de 32 bits. Para obter mais informações, consulte [KB0863694](https://support.servicenow.com/nav_to.do?uri=/kb?id=kb_article_view&sysparm_article=KB0863694).

Falha de upgrade: o host não atende aos requisitos mínimos do sistema para atualizar o MID Server. Consulte a documentação do produto MID Server na biblioteca GlibC para obter mais informações.
:   Esse erro só pode ocorrer em MID Servers no Linux. Consulte [Suporte à versão Java](https://servicenow-prod.fluidtopics.net/NXzOqUZMfKAor4chulECSQ "Use estes requisitos mínimos de sistema para alocar recursos para hospedagem de computadoresMID Servers.") para obter mais informações.

## Avisos que não geram bloqueio {#mid-server-pre-upgrade-check__section_grh_g51_fqb}

Esses avisos são exibidos na tabela Problemas do MID Server \[ecc_agent_issue\] e não impedem a atualização de um MID Server no Windows:

Não é possível analisar $ logOnAsUser
:   Essa mensagem avisa que o valor Conectar como usuário para o serviço do Windows não está em nenhum destes formatos esperados:

    * user@domain.company.com
    * domínio\\usuário
    {#mid-server-pre-upgrade-check__ul_abl_351_fqb}

Não é possível consultar grupos de Conectar como usuário

:   Quando a instância tenta consultar as associações de grupo do usuário conectado, ela executa o comando usuário da rede\<nomedeusuario\>. A instância espera determinada estrutura de saída pelo serviço do Windows a partir deste comando e emite esse aviso se a saída esperada não corresponder à saída real.

    Esses avisos do PowerShell são gravados somente no log do agente do MID Server. Como o PowerShell não é obrigatório para usar um MID Server, esses problemas de configuração não impedem a atualização de um MID Server no Windows. No entanto, esses avisos podem indicar problemas em seu ambiente que exigem atenção.

Ignorando as verificações de upgrade do PowerShell, já que o PowerShell não pode ser usado
:   O PowerShell 3.0 (no mínimo) não está instalado ou o powershell.exe não está disponível para o usuário do serviço do MID Server.

Ignorando o teste do Powershell: a pasta de destino não foi inicializada
:

Ignorando o teste Powershell: não é possível detectar o nome do serviço
:

O serviço CiscoAMP em execução na máquina host do MID Server é identificado como um bloqueador de upgrade do MID Server
:   Para obter mais informações, consulte [KB0870329](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0870329).

A Experiência da aplicação está desativada no host do MID Server, o que pode fazer com que o processo de upgrade automático falhe e o MID Server seja desativado. Ative o serviço no host para garantir um upgrade automático bem-sucedido
:   Para obter mais informações, consulte [KB0597552](https://support.servicenow.com/kb_view.do?sysparm_article=KB0597552#appex&_ga=2.137899701.402632408.1615226320-1555493315.1610383440).

Continuando com o upgrade, mas o seguinte problema foi encontrado durante a verificação de upgrade: \<mensagem de exceção\>
:   Essa mensagem indica que houve um problema ao executar a parte do PowerShell dos testes de pré-upgrade.

## Desativação da verificação de pré-upgrade {#mid-server-pre-upgrade-check__section_by4_w51_fqb}

Um parâmetro de configuração do MID Server chamado mid.upgrade.run_precheck é definido como verdadeiro por padrão, o que permite a execução do teste automático de pré-atualização. Para desativar esses testes para um único MID Server, adicione esse parâmetro ao arquivo config.xml do MID Server e configure-o como false. Para desativar esses testes para todos os servidores MID, adicione um novo registro à tabela Propriedade do MID Server \[ecc_agent_property\] chamada mid.upgrade.run_precheck. Defina o valor dessa propriedade como false e deixe o campo MID Server em branco.

