---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Fazer upgrade de um agente em uma instância

# Fazer upgrade de um agente em uma instância {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Execute o upgrade automático seletivo em vez do upgrade em massa para aumentar a eficiência ao trabalhar com agentes de difícil acesso, como agentes implantados na nuvem. Você pode executar o upgrade seletivo em até 20 agentes por vez.

## Antes de Iniciar

Sistemas operacionais compatíveis: Windows e Linux.  
Ao trabalhar em um ambiente Linux, verifique se você tem permissões sudo e se as seguintes configurações estão definidas:{#upgrade-agent-from-instance__id_gcj_ftm_cyb__entry__4}

| SO | Versão do SO | Comandos | Versão do agente |
|-|-|-|-|
| CentOS,Red Hat | 7, 8 | * `/usr/bin/systemctl iniciar conta` * `/usr/bin/systemctl parar conta` * \<systemctl location`daemon-reload` (o local padrão é `/usr/bin`) * `/usr/bin/rpm -Uv<cache dir location> /upgrade/agent-client-collector-upgrade.rpm` {#upgrade-agent-from-instance__ul_tyf_4vm_jyb} Local do diretório de cache padrão: `/var/cache/servicenow/agent-client-collector` * `unzip -o`: descompacta o arquivo de assinatura para validar a instalação. * `openssl dgst -sha256 -verify`: verifica o uso de uma assinatura de um arquivo de instalação da ServiceNow. {#upgrade-agent-from-instance__ul_acz_1wm_jyb} | 2,7 |
| Debian, Ubuntu |   | * `/usr/bin/systemctl iniciar conta` * `/usr/bin/systemctl parar conta` * \<systemctl location`daemon-reload` (o local padrão é `/usr/bin`) * `/usr/bin/dpkg --install --refuse-downgrade --skip-same-version<cache dir location> /upgrade/agent-client-collector-upgrade.rpm` {#upgrade-agent-from-instance__ul_gjn_lxm_jyb} Local do diretório de cache padrão: `/var/cache/servicenow/agent-client-collector` | 2,7 |
[Tabela 1. Sistemas operacionais Linux]

{#upgrade-agent-from-instance__id_gcj_ftm_cyb}

Função necessária:

* Linux: sudo rpm/dpkg
* Windows: conta do SISTEMA local
{#upgrade-agent-from-instance__ul_owx_1ll_cyb}

## Por Que e Quando Desempenhar Esta Tarefa

Agent Client Collector O é compatível com o upgrade automático seletivo nos seguintes sistemas operacionais:

* Windows: devido a Windows restrições de UAC, o agente deve ser executado como uma conta do SISTEMA local para executar o upgrade por meio de msiexec.
* Linux: RPM e DEB
{#upgrade-agent-from-instance__ul_yd4_dmb_bvb}

## Procedimento

1. Navegar até TodosAgent Client CollectorAgentes.
2. Selecione o agente do qual você deseja fazer upgrade.
3. Na seção Links relacionados, selecione Agente de upgrade.
4. Na caixa de diálogo de confirmação, selecione Fazer upgrade.  
   A página Históricos de upgrade do agente é exibida, onde você pode monitorar o andamento do upgrade na coluna Estado, que exibe Êxito ou Falha.
5. Exiba o log do upgrade do agente na coluna Mensagem.  
   Para um upgrade com falha em uma máquina Linux, navegue até o\<cache directory location\> Arquivo /upgrade/agent-client-collector-upgrade.rpm e certifique-se de que as configurações a seguir estejam definidas, com base no SO indicado.{#upgrade-agent-from-instance__table_rvw_phx_l5b__entry__5}

   | SO | Versão do SO | Comandos | Comandos adicionais | Versão do agente |
   |-|-|-|-|-|
   | CentOS,Red Hat | 7, 8 | * `/usr/bin/systemctl iniciar conta` * \<systemctl location`daemon-reload` (o local padrão é `/usr/bin`) * `/usr/bin/rpm -Uv<cache dir location> /upgrade/agent-client-collector-upgrade.rpm` {#upgrade-agent-from-instance__ul_vxw_rlz_jyb} Local do diretório de cache padrão: `/var/cache/servicenow/agent-client-collector` | * `unzip -o`: descompacta o arquivo de assinatura para validar a instalação. * `openssl dgst -sha256 -verify`: verifica o uso de uma assinatura de um arquivo de instalação da ServiceNow. {#upgrade-agent-from-instance__ul_svw_phx_l5b} | 2,7 |
   | Debian, Ubuntu |   | * `/usr/bin/systemctl iniciar conta` * `/usr/bin/systemctl parar conta` * \<systemctl location`daemon-reload` (o local padrão é `/usr/bin`) * `/usr/bin/dpkg --install --refuse-downgrade --skip-same-version<cache dir location> /upgrade/agent-client-collector-upgrade.rpm` {#upgrade-agent-from-instance__ul_ej1_hmz_jyb} Local do diretório de cache padrão: `/var/cache/servicenow/agent-client-collector` | * `unzip -o`: descompacta o arquivo de assinatura para validar a instalação. * `gpg -import && dpkg-sig --verify`: verifica o uso de uma assinatura de um arquivo de instalação da ServiceNow. {#upgrade-agent-from-instance__ul_uvw_phx_l5b} | 2,7 |
   [Tabela 2. Sistemas operacionais Linux]

   {#upgrade-agent-from-instance__table_rvw_phx_l5b}Para um upgrade com falha em uma máquina Windows, verifique o arquivo de log relevante, localizado em\<user folder\> \\AppData\\Local\\Temp\\ACC_Logs:
   * Logs do ACC: ACC_Upgrade.log
   * Logs do MSI: MSI_ACC_Upgrade.log
   {#upgrade-agent-from-instance__ul_vrp_pdk_3yb}