Atualize o Servidor do UIM antes de atualizar o UMP.

Este artigo descreve o processo de atualização do UIM Server.
uim902
Este artigo descreve o processo de atualização do UIM Server.
Índice
Antes de começar
Execute as tarefas a seguir antes de atualizar o UIM Server.
Verificar o caminho de atualização
Certifique-se de seguir um caminho de atualização com suporte descrito na Matriz de compatibilidade do suporte.
Verificar os requisitos de serviços Web RESTful
Os serviços web RESTful do UIM podem exigir uma versão específica do UIM para funcionar corretamente. Consulte Serviços web RESTful na documentação de probes para verificar se é necessário fazer uma atualização para esta versão do UIM.
Fazer backup da configuração do hub principal
Salve uma cópia do arquivo hub.cfg na pasta
<Servidor_do_UIM>
\hub. Os parâmetros ideais de tempo limite para o hub atualizado são definidos durante a atualização, substituindo configurações de tempo limite existentes. A CA recomenda executar o hub atualizado com estes valores ideais para obter um desempenho aprimorado. No entanto, se você deseja reverter para as configurações antigas de tempo limite por qualquer motivo, mantenha um backup do antigo arquivo de configuração do hub.
Remova todos os probes personalizados do arquivo de probes
Se você tiver desenvolvido probes personalizados usando um dos SDKs de probe do UIM, mova-os ou exclua-os do arquivo antes de iniciar uma atualização. Após a conclusão da atualização, você poderá mover os probes personalizados de volta para o arquivo.
Desative o encaminhamento do distsrv
Caso tenha o encaminhamento de pacotes configurado para o probe distsrv, desative-o antes de atualizar.  Além disso, certifique-se de que o encaminhamento no probe distsrv esteja desativado até que a atualização completa do UIM seja concluída para o hub principal, do UMP para OC e CABI.
Siga estas etapas:
  1. No Console de administração, clique no menu de três pontos ao lado do probe distsrv e selecione
    Configurar.
  2. Clique na pasta
    Encaminhamento
    . Se houver algum registro de Encaminhamento com
    Tudo
    na coluna
    Tipo
    , desative o encaminhamento. Para outros tipos de registros (
    Específico
    ,
    Atualizar
    ou
    Licenças
    ), não é necessário desativar o encaminhamento.
  3. Desmarque
    Encaminhamento ativo
    .
A partir do UIM 9.2.0, os requisitos de licenciamento no nível do hub/robô e do probe foram removidos. Implante as versões do hub, do robô e do distsrv lançadas com o UIM mais recente para remover a dependência da licença. Se desejar continuar com as versões mais antigas do hub e dos probes que requerem uma extensão da licença, entre em contato com o suporte técnico para obter ajuda com a extensão da licença (se necessário).
Desativar a verificação do antivírus
Desative os programas antivírus em execução no servidor. Esses verificadores podem aumentar significativamente o tempo de instalação. Você pode ativar o programa antivírus novamente após a conclusão da atualização.
Preparar o banco de dados do UIM
Dependendo do software de banco de dados usado para hospedar o banco de dados do UIM, você poderá ter requisitos adicionais.
Microsoft SQL Server
Desative o índice de manutenção no mecanismo de dados. Em tabelas muito grandes (mais de 10 GB), a execução do índice de manutenção será mais demorada do que o esperado. É recomendável que os usuários desativem este recurso durante a atualização para uma release mais recente do UIM e, em seguida, reativem sua execução fora do horário de pico, monitorando atentamente os processos de manutenção do índice. Esta configuração pode ser feita no Console de administração ou no Gerenciador de infraestrutura.
Oracle
  • Se você estiver atualizando para esta release, como administrador do banco de dados Oracle, execute o seguinte comando para conceder permissão ao usuário do UIM:
    Grant execute on DBMS_CRYPTO TO <
    UIM_USER
    >;
  • (Somente atualização a partir do NMS 7.6) Se você estiver atualizando do NMS v7.6 para o UIM 8.0 ou posterior, execute o procedimento abaixo. Se você estiver executando uma versão do UIM e estiver atualizando para uma release mais recente, não será necessário concluir o procedimento a seguir.
    Siga estas etapas:
    1. Como SYSDBA, execute:
      grant execute on dbms_redefinition to
      <UIM_USER>
      ;
      grant create type to
      <UIM_USER>
      ;
      grant execute any type to
      <UIM_USER>
      ;
      grant under any type to
      <UIM_USER>
      ;
      grant select any table to
      <UIM_USER>
      ;
      grant alter any table to
      <UIM_USER
      >;
      grant create any table to
      <UIM_USER>
      ;
      grant drop any table to
      <UIM_USER>
      ;
      grant lock any table to
      <UIM_USER>
      ;
    2. Desative e elimine a lixeira do Oracle.
      Se estiver fazendo a atualização do NMS 7.6, a atualização falhará se você não eliminar a lixeira.
      1. Use uma ferramenta como o Desenvolvedor SQL para se conectar ao banco de dados do Oracle.
      2. Elimine a lixeira. Execute:
        PURGE DBA_RECYCLEBIN
      3. Desative a lixeira. Execute:
        ALTER SYSTEM SET recyclebin = OFF DEFERRED;
        ALTER SESSION SET recyclebin = off;
      4. Verifique se a lixeira está desativada. Execute:
        show parameter recyclebin;
Considerações
Revise as seguintes considerações:
  • Para obter mais informações sobre a release do UIM 20.3.3, consulte o artigo UIM 20.3.3.
  • O UIM 20.3.1 é uma release de patch. O patch UIM 20.3.1 não inclui qualquer programa de instalação de atualização para o UIM Server. O patch inclui os artefatos autônomos separados que podem ser usados para atualizar os respectivos componentes. Para obter mais informações sobre os artefatos que estão disponíveis como parte da release de patch UIM 20.3.1, consulte o artigo do UIM 20.3.1.
  • O UIM 9.2.0 (ou posterior) usa o OpenJDK em vez do Oracle JDK. A atualização para o UIM Server atualiza automaticamente o Oracle JDK existente para o OpenJDK no ambiente do CA UIM. Além disso, essa atualização também exclui as instâncias anteriores do Oracle JDK.Para obter mais informações sobre o uso do OpenJDK no CA UIM, consulte Adotando o OpenJDK.
  • O programa de instalação de atualização do UIM 20.3.0 instala o
    serviço web uimesdplatelemetry
    no wasp uimserver quando você atualiza do UIM 9.0.2 para o UIM 20.3.0. Esse serviço foi adicionado para os clientes de PLA por ser obrigatório para eles carreguem suas informações e seus dados de uso no segmento. Para obter mais informações sobre como configurar as propriedades de telemetria, consulte Configurar a telemetria para o modelo de PLA.
  • O UIM também fornece as opções de hub e robô seguros e não seguros ao atualizar o UIM Server. A ativação da opção segurança significa que você deseja usar a versão segura do hub e do robô. Se você não ativar a opção de segurança, significa que deseja usar a versão não segura do hub e do robô, que se baseia no modelo de segurança herdado.Para obter mais informações o hub e o robô seguros, consulte Hub e robô seguros.
  • Se o pacote mon_config_service_ws estiver instalado no UIM Server e o OC (Operator Console - Console do Operador) estiver instalado em outro robô, analise os seguintes pontos ao executar a atualização:
    Cenário 1:
    antes de atualizar o UIM Server existente para 20.3.0 (UIM Server):
    1. Faça backup da pasta wasp disponível no UIM Server existente.
    2. Exclua o probe wasp do UIM Server existente.
    3. Inicie o processo para atualizar o UIM Server existente para a versão 20.3.0 (UIM Server).
      Após a conclusão da atualização do UIM Server, você poderá atualizar o UMP existente para 20.3.0 (OC). Você terá problemas se tentar atualizar o UMP para a versão 20.3.0 (OC) sem executar essas etapas.
    Cenário 2:
    se você não excluir o probe wasp antes de atualizar o UIM Server para a versão 20.3.0:
    1. Faça backup da pasta wasp disponível no UIM Server.
    2. Exclua o probe wasp do UIM Server atualizado.
    3. Atualize o UMP existente para a versão 20.3.0 (OC).
    4. Implante o wasp disponibilizado com o 20.3.0 no UIM Server atualizado.
    5. Implante os pacotes adminconsole, mps e telemetry disponibilizados com o 20.3.0.
      Você terá problemas se tentar atualizar o UMP existente para a release 20.3.0 (OC) sem executar essas etapas.
  • Como parte do processo de instalação, o programa de instalação executa uma consulta SQL para verificar se seu ambiente está pronto para a atualização. Se um problema for encontrado, uma mensagem será exibida:
    Foram detectadas entradas duplicadas no banco de dados do MCS. Entre em contato com o suporte do CA UIM para continuar com a atualização.
    Entre em contato com o suporte do CA UIM para validar o ambiente para a instalação. Anexe ao caso, em formato csv, extrações das seguintes tabelas:
    • ssrv2template
    • ssrv2devicegroup
    • ssrv2field
    • ssrv2profile
    • ssrv2ConfigValue
    Se a consulta SQL resultar na mensagem "It is safe to upgrade to UIM x.x.x", continue com a instalação da versão x.x.x.
  • O discovery_agent e alguns outros probes podem enviar um único alarme informativo ao atualizar para a versão mais recente do UIM Server. Esse alarme é benigno e pode ser ignorado com segurança.
  • Para o data_engine lançado com versões anteriores ao UIM 9.0.2, a tabela S_QOS_DATA contém dados de objeto para cada combinação exclusiva de atributos de QoS, origem e destino. Ele não inclui o valor de origem na identificação da combinação exclusiva. No entanto, o probe data_engine no UIM 9.0.2 foi aprimorado para usar a combinação exclusiva de atributos de QoS, fonte, destino e origem. Portanto, quando você atualizar o UIM Server de uma versão anterior para o UIM 9.0.2, o processo de atualização poderá demorar algum tempo, pois o data_engine usa o valor de origem para recalcular a combinação exclusiva. Esse recálculo resulta na atualização dos valores existentes na coluna de soma de verificação da tabela S_QOS_DATA. O probe data_engine executa scripts de banco de dados durante o processo de atualização para atualizar os registros existentes.Por exemplo, para o Microsoft SQL Server e o MySQL, os respectivos scripts levam cerca de 20 a 30 segundos para atualizar 700.000 registros na tabela S_QOS_DATA. Nesse caso, o computador tem 16 GB de memória e processador de 8 núcleos.
  • O programa de instalação do UIM Server cria um arquivo .pem (certificate.pem) na pasta
    <Nimsoft>\security
    . O arquivo .pem é uma chave simétrica, compartilhada com os devidos robôs, que é usada para comunicação com o probe data_engine. Você copia esse arquivo .pem no OC (Operator Console - Console do Operador) e os robôs do CABI fornecem o local do arquivo no arquivo robot.cfg (
    cryptkey = <local do arquivo .pem>
    ). Além disso, se qualquer probe afetado não estiver no mesmo computador em que o data_engine se encontra, copie o arquivo .pem gerado no computador do robô (em que o data_engine não está disponível) e atualize o arquivo robot.cfg com o local do arquivo .pem no computador. Para obter mais informações sobre a configuração do arquivo robot.cfg, consulte Configurar robot.cfg.
  • O UIM 9.2.0 remove a dependência dos pacotes redistribuíveis do Microsoft Visual C++ de EOL (End of Life - Fim da Vida Útil) para alguns probes e pacotes. Devido a essa remoção da dependência, a instalação do UIM implanta o pacote de redistribuíveis do Microsoft Visual C++ 2017 (por exemplo, vs2017_vcredist_x86) por padrão. Com essa implantação do pacote, somente os probes listados podem funcionar. Para outros probes que usam os pacotes redistribuíveis do Microsoft VC++ EOL ou para versões mais antigas dos probes afetados, você deve baixar e implantar o pacote redistribuível do Microsoft VC++ EOL necessário (por exemplo, vs2008_redist_x86) usando o arquivo.
    Além disso, se você desejar usar os probes afetados com releases do UIM anteriores ao UIM 9.2.0, certifique-se de fazer download e implantar o pacote de redistribuíveis do Microsoft Visual C++ 2017 que está disponível no arquivo.
  • No ambiente Linux, após a atualização do UIM Server 9.0.2/9.2.0 para o UIM 20.3.0, a permissão de acesso ao diretório
    nimsoft
    no caminho de instalação do CA UIM será alterada para 750. Isso garante que apenas o usuário raiz possa acessar o conteúdo do diretório. Outros usuários não terão permissão para acessar o conteúdo. Se necessário, o usuário raiz poderá alterar as permissões de acesso.
Baixe o pacote de instalação do UIM Server
Siga estas etapas:
  1. Efetue logon servidor do hub principal como administrador.
  2. É necessário efetuar logon no suporte da CA.
  3. Baixe os seguintes pacotes de instalação para seu sistema operacional:
    • O programa de instalação do UIM (executável
      setupCAUIMServer
      )
    • Os pacotes do UIM Server (arquivo zip
      uimserverpackages
      )
      Ambos os arquivos são necessários no sistema que hospeda o UIM Server. Se o arquivo zip uimserverpackages não estiver presente, haverá falha na instalação.
  4. (Somente atualização em modo silencioso)
    Baixe os pacotes zip dos
    modelos de instalação silenciosa do UIM Server
    .
  5. (Somente Linux)
    Execute o comando
    chmod 755
    no arquivo executável setupCAUIMServer.
Execute o programa de instalação do UIM Server
É possível executar o programa de instalação em três modos. O modo da GUI (Graphical User Interface - Interface Gráfica do Usuário) o orienta durante o processo de instalação. O modo de console fornece uma interface de linha de comando interativa. No modo silencioso, o programa de instalação lê as informações de configuração de um arquivo de resposta que você cria e, em seguida, executa com nenhuma interação adicional.
Modo de atualização da GUI
Todos os campos do programa de instalação diferenciam maiúsculas de minúsculas.
Para concluir uma atualização do modo de interface gráfica do usuário, execute o programa de instalação e siga os prompts para concluir a instalação. Sempre que possível, o programa de instalação exibe os valores de configuração atuais para sua confirmação.
Atualizar modo de console
Siga estas etapas:
  1. Execute o programa de instalação. Em uma linha de comando, execute:
    • Windows:
      setupCAUIMServer.exe -i console
    • Linux:
      setupCAUIMServer_linux.bin -i console
  2. Siga os prompts para concluir a instalação. Sempre que possível, o programa de instalação exibe os valores de configuração atuais para sua confirmação.
  3. Quando a atualização estiver concluída, certifique-se de:
    • Ativar os programas antivírus novamente, se necessário.
    • Ativar o encaminhamento de pacotes
    • Mover os probes personalizados de volta para o arquivo morto de probes, se necessário.
Atualização do Modo silencioso
Siga estas etapas:
  1. Prepare seu arquivo de resposta:
    1. Extraia os modelos de instalação silenciosa.
    2. Localize o arquivo
      installer.upgrade.properties
      e salve-o como
      installer.properties
      no mesmo diretório que o programa de instalação.
    3. Adicione sua senha de administrador do UIM à linha
      NMS_PASSWORD=
      de
      installer.properties
      .
    4. Salve o arquivo, garantindo que o tipo de arquivo ainda é
      PROPERTIES
      . Se o tipo de arquivo for
      Text Document
      , remova a extensão
      .txt
      (que pode não ser exibida na pasta).
  2. Execute o programa de instalação. Em uma linha de comando, execute:
    • Windows:
      setupCAUIMServer.exe -i silent
    • Linux:
      setupCAUIMServer_linux.bin -i silent
  3. O programa de instalação descompacta os arquivos e conclui a instalação. Esse processo pode levar vários minutos ou mais.
  4. Servidor do UIM é iniciado. Se por algum motivo não for iniciado, execute:
    • Windows:
      net start "Nimsoft Robot Watcher"
    • Linux:
      /etc/init.d/nimbus start
Atualização do servidor de cluster da Microsoft
Use o procedimento a seguir para atualizar o UIM Server em um cluster de tolerância a falhas do Microsoft Server 2012.
Siga estas etapas:
  1. Atualize o nó principal (ativo) usando o procedimento Modo GUI ou o Modo silencioso.
  2. Ative o nó secundário (passivo), e atualize o nó usando o mesmo processo usado no nó principal.
Isso garante que as chaves de registro nos nós principal (ativo) e secundário (passivo) estejam atualizadas para a nova versão.
Tarefas após a atualização
Ao concluir a atualização:
  • Ative o software antivírus novamente.
  • Ativar o encaminhamento de pacotes.
  • Mova os probes personalizados de volta para o arquivo morto de probes, se necessário.
  • Se necessário, atualize UMP para OC.
  • Se necessário, atualize os serviços web RESTful do UIM.
A CA fornece versões mais recentes de alguns probes entre as releases dos pacotes do servidor. Durante uma atualização, o programa de instalação substituirá probes e componentes já instalados. Se você baixou o "hot fix" ou atualizou probes, atualizar o UIM Server pode resultar em downgrades de componente. Se isso acontecer, vá para a página
Arquivo morto
do site de Suporte e baixe novamente os componentes substituídos.