Verificação de pré-upgrade 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

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

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.

Erros que bloqueiam o upgrade

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.
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 para obter mais informações.

Avisos que não geram bloqueio

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

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.

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.

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

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.