Atualização do Agente Remoto do Data Virtualization em Windows

Atualize o Agente Remoto do Data Virtualization no Windows.

Sobre essa tarefa

Se você instalou o agente remoto a partir de uma versão anterior do Data Virtualization e, em seguida, atualizou para a versão mais recente do Data Virtualization, certifique-se de concluir esta tarefa para atualizar o agente remoto.

Procedimento

  1. Faça login na máquina Windows virtual onde o agente remoto está em execução. Em seguida, em Serviços, pare o DataVirtualizationService (com o sufixo da porta).
  2. Condição : Se você não tiver o Java 21 instalado da versão anterior do agente remoto, instale-o na sua máquina Windows virtual. Consulte os requisitos de sistema para configurar o Agente Remoto do Data Virtualization.
  3. Faça backup de todo o conteúdo da pasta original do agente remoto em outra pasta.
  4. Exclua todo o conteúdo do diretório original do agente remoto e, em seguida, extraia o conteúdo do arquivo de DATAVIRTUALIZATION_REMOTE_AGENT_V3.2.1_20251020_123451.zip correção para o diretório original do agente remoto.
    Observação: certifique-se de desbloquear este arquivo zip antes de extraí-lo. Consulte Desbloqueio de arquivos baixados da Internet.
  5. Da pasta de backup, copie os .bat arquivos para a nova pasta do agente remoto.
  6. No datavirtualization.env.bat file, atualize o JAVA_HOME valor com o caminho do Java 21. Certifique-se de remover as novas linhas e os espaços indesejados do arquivo. Por exemplo:
      set DATAVIRTUALIZATION_INSTALL="C:\Users\Administrator\Endpoint"
  set JAVA_HOME="C:\Program Files\Java21\jdk-21.0.6"
    Observação: não é necessário atualizar o DATAVIRTUALIZATION_INSTALL caminho.
  7. Acesse o console do IBM Cloud Data Virtualization e, em RunSQL, execute o seguinte comando.
    • Substitua <RA_NAME> pelo nome do seu agente remoto.
    • Substitua <RA_NAME_SC> pelo nome do seu agente remoto para o conector do Satellite.
    • Substitua <SC_ENDPOINT> pelo ponto de extremidade do conector Satellite.
    • Substitua <SC_PORT> pelo número da porta do conector do Satellite.
    call dvsys.generateconfighash('<RA_NAME>', '<RA_NAME_SC>', port, 7777,'peerAuthentication', null, -1, -1, 'DV_EXTERNAL_NODE_HOSTNAME_PORT=<SC_ENDPOINT>:<SC_PORT>',?,?,?);
    Por exemplo:
     call dvsys.generateconfighash('SC_RA_CLOUD', 'RA for satelite connector', 6416, 7777,'peerAuthentication', null, -1, -1, 'DV_EXTERNAL_NODE_HOSTNAME_PORT=c-01.private.us-south.link.satellite.test.cloud.ibm.com:44612',?,?,?);
  8. Abra o Windows terminal no diretório do agente remoto.
  9. No terminal, execute o seguinte comando. Substitua <INSTANCEID> e <CONFIGHASH> pelos valores INSTANCEID de CONFIGHASH saída da etapa 7. Esta etapa configura o seu agente remoto para que ele se conecte corretamente à sua formação do Data Virtualization.
    .\config.bat -i <INSTANCEID> -c <CONFIGHASH>
    Por exemplo:
    .\config.bat -i 705302ff-0c68-42c0-bcdc-f7238434e58b -c 3lmL8n1tf20KAQAQOk07Xu/xqn9DIfErjBl3Azsbgwq5ZF4wHG8rW1iwHf8BzJ1zR1PCq4T9aKDnTpaXOks7SqQh51g+iSk2VZ6EFa3heT6TXmYR9BHOqIPFKknb3HDm6SXX7qyrLcBS5MkaW1L7YZ2KPTBGPDMnLA6LeCquduDJjTrrF+/naqGmjJz2QoHbKgEKbVYAuysitqqr8RQ3Yvfz9A3VsG77f4A8GsX8Pt7ucwDGeK92KrNxcDPElY9gKTtI5PWtWtdNPRDxSbxiNd1M/rYaN0Xv5QCrn54nXaOSVaRV44zVDTPmWtBc10SCwhI33sG2irUDwoBdSAXhEw6JjDBMNvbZ+ymKct1Ll7V2IJQSBngyAguwynVT29qt62d/iOvwoE7SNy50Tlx1YnrXHCjiSgGyxHA1YK1paqX+8TbiSZhaehOG9ISM6HBLpVonFl27/g3afdsNXXetCOHxF5VPQINY9kjlMA/0u2ziIFmjvz8Xo3aA5YRLl/LRzmbdNSPhB3St1BmPR504uUlVA01JZdUH9Gzo7HTQyvYh/xhjx18cDZYn1Lg2XmT9FZBAg3kOqRD8Tzax/XVZNh7TXVsiIXHrE43eGsf616o/ivZmTuTCjmpuNd3KABMPtx3p51YfvPZtjz6VX/IW2vOmOhV6Pg0fOmw/Kcl8EdSm1X0XbiJ3mvEQ1gjzYK2yv+15XuV2o0MIPFECJzNR4cJlFkI6va4C+oMqKSPXWxtPv2XxcZRxk+nh9uDr1QUTeTDfhftlcQKDKk+//M0d4RuT+Ewiv4FmwmMLZV4UClQp9twjQH4Y4Er7dQFGIOZsMlicoxLsxhJaL/iKC0onidd7dfK0DOjFywSmpS7AhDQ=
  10. Inicie o serviço do agente remoto e verifique se o agente remoto está agora conectado com sucesso à sua formação do Data Virtualization.
    Observação: Se esta etapa falhar, entre em contato com o suporte da IBM e não prossiga para as próximas etapas.
  11. Encerre o serviço do seu agente remoto.
  12. Substitua todo o conteúdo da pasta original do agente sysroot\data remoto pelo conteúdo da pasta de sysroot\data backup.
    1. Em gaiandb_config.properties, substitua:
      EXTENDER_CLASS_NAME=com.ibm.gaiandb.confluence.ConfluenceExtender
      com o seguinte:
      EXTENDER_CLASS_NAME=com.ibm.gaiandb.queryplex.ConfluenceExtender
    2. Em derby.properties, substitua:
      derby.authentication.provider=com.ibm.gaiandb.confluence.DVAuthenticator
      com o seguinte:
      derby.authentication.provider=com.ibm.gaiandb.queryplex.DVAuthenticator
  13. Em Windows Serviços, inicie o DataVirtualizationService e, em seguida, verifique se o agente remoto está conectado à sua formação do Data Virtualization.