Instalar ou atualizar um pacote do JasperReports Server do CA Business Intelligence

Há dois caminhos de implantação possíveis para o JasperReports Server do servidor do CABI (CA Business Intelligence). Este artigo descreve a implantação do servidor do CABI em pacote.
uim203
Há dois caminhos de implantação possíveis para o JasperReports Server do servidor do CABI (CA Business Intelligence). Este artigo descreve a implantação do servidor do CABI em pacote.
cabiBundled
A implantação do pacote instala e configura uma instância do servidor do CABI em um robô. Essa configuração simplificará o processo de instalação do servidor do CABI se for necessário usar apenas uma instância do servidor do CABI com o CA UIM.
Não é possível
usar essa instância do servidor do CABI com outros produtos do CA Agile Operations.
  • Aviso!
    Durante a implantação do pacote do probe cabi, o wasp é reiniciado no robô com o servidor do CABI. A implantação pode levar aproximadamente de 20 a 30 minutos para ser concluída.
    Não tente reiniciar o wasp antes de concluir a implantação.
    Se você tentar reiniciar o wasp antes da conclusão da implantação, o servidor do CABI poderá não ser instalado com êxito.
  • O UIM 20.3.3 eliminou a dependência do CABI (CA Business Intelligence) para o processamento das telas do OC nativo: página inicial, página de exibição de grupos, página de exibição de dispositivos e página de exibição de tecnologias de monitoramento (probes). Os painéis e relatórios personalizados e prontos para uso ainda são processados por meio do CABI, ou seja, eles dependem do CABI. Contudo, as telas do console do operador nativo não dependem mais do CABI (Jaspersoft) e são processadas por meio de HTML5. Para obter mais informações sobre as telas do OC nativo que usam HTML5, consulte o artigo Configurando e exibindo dados de monitoramento ou a seção Removendo a dependência do CABI (Console do operador nativo) do artigo UIM 20.3.3.
Índice
3
Requisitos de software
A tabela a seguir lista o software mínimo necessário. Para obter uma matriz de versões de software para uma release específica, consulte o CA Business Intelligence com o CA UIM.
Software
Fazer download
Observações
O JasperReports Server do CA Business Intelligence para Painéis unificados e geração de relatórios para o Infrastructure Management
N/D
Instalado pelo probe cabi.
CA UIM
É necessário efetuar logon no suporte da CA.
probe cabi
Adicione ao arquivo do CA UIM. É necessário efetuar logon no suporte da CA para fazer download.
portlet ump_cabi
Adicione ao arquivo do CA UIM. É necessário efetuar logon no suporte da CA para fazer download.
uim_core_dashboards_pack
Adicione ao arquivo do CA UIM. É necessário efetuar logon no suporte da CA para fazer download.
Pacotes de relatórios:
  • uim_unified_reporter_pack
  • uim_cabi_health_report_pack
Adicione ao arquivo do CA UIM. É necessário efetuar logon no suporte da CA para fazer download.
Pacotes de painéis: uim_<
nome_da_tecnologia
>_dashboards_pack
Adicione os pacotes de painéis apropriados ao arquivo do CA UIM. É necessário efetuar logon no suporte da CA para fazer download.
Os pacotes de painéis só são necessários se você precisar exibir dados para a tecnologia específica. Por exemplo, o pacote de painéis uim_aws_dashboards_pack só é necessário se você precisar exibir dados de seu ambiente AWS. Para obter uma lista de pacotes de painel disponíveis, consulte o CA Business Intelligence com o CA UIM.
Requisitos do ambiente
Este processo requer o seguinte ambiente:
  • Uma instância do CA UIM. Para obter mais informações sobre a instalação, consulte:
  • Faça download, atualize ou importe os seguintes pacotes no arquivo:
    • probe cabi
    • portlet cabi
    • pacotes de painéis
    • pacotes de relatórios
  • Um robô dedicado no hub principal se não houver um robô sem o OC. Para obter mais informações, consulte o artigo Implantar robôs.
  • (Opcional) Hub e robô seguros – o hub e robô seguros fornecem comunicação robusta entre hubs e de robô para hub. Para atualizar o CABI em uma configuração segura, atualize o robô do CABI para uma configuração segura e, em seguida, execute a atualização do CABI. Para obter mais informações sobre a instalação segura e como implantar certificados, consulte Hub e robô seguros.
  • (
    Somente MySQL
    ) Se você estiver usando o MySQL para o banco de dados do CA UIM, altere as seguintes configurações padrão do banco de dados MySQL para que a implantação do painel do CA Business Intelligence seja bem-sucedida:
    • Defina
      max_allowed_packet=500M
    • Defina 
      innodb_log_file_size=356M
    • Defina
      table_definition_cache=2000
Se você tiver uma configuração do servidor de replicação, a variável "gtid-mode" deverá ser definida como
OFF
e a variável "enforce-gtid-consistency" deverá ser definida como
0
na configuração de my.cnf ou my.ini, como mostrado abaixo:
gtid-mode=off
enforce-gtid-consistency=0
A importação dos painéis falhará se as configurações recomendadas acima não forem atualizadas para o MySQL.
  • (
    Somente Autenticação do Windows no Microsoft SQL Server
    ) Se você estiver usando a Autenticação do Windows no Microsoft SQL Server, o robô do servidor do CABI e o robô do OC deverão ter sistemas operacionais Windows. Não será obrigatório coincidir os sistemas operacionais se você não estiver usando a autenticação do Windows no Microsoft SQL Server.
Requisitos de hardware para o servidor do CABI
Certifique-se de que o robô para o servidor do CABI atenda aos seguintes requisitos mínimos de hardware:
  • 10 GB de espaço livre em disco
  • 8 GB de memória
  • Quatro CPUs de 2 GHz
Matriz de versões do JasperServer, CABI agrupado e UIM Server
A seguinte tabela mostra a matriz de versões do JasperServer, CABI agrupado e UIM Server: 
Versão do JasperServer
Versão do CABI agrupado (probe)
Versão do UIM Server
7.5
4.30
20.3
7.1.1
4.20
20.1
7.1.1
4.10
9.20
6.4.3
3.40
9.0.2 SP1 (9.1.0)
6.3.0
3.32
9.0.2
6.3.0
3.20
8.51
Configuração de implantação para o servidor do CABI em um ambiente do CA UIM
Instale o servidor do CABI em um robô que esteja conectado diretamente ao hub principal.
Não implante o servidor do CABI em um robô que esteja executando o OC ou em um hub secundário.
É necessário um robô separado para evitar problemas de escala e de desempenho. O Servidor do CABI é implantado por meio do probe cabi.
Não instale o servidor do CABI em um robô conectado a um hub secundário nem em um robô executando o OC. Essas configurações não são suportadas.
A figura a seguir mostra a configuração de implantação suportada para adicionar o CABI a um ambiente do CA UIM.
Diagrama de implantação do CA UIM com CABI
CA UIM with CABI Deployment Diagram
Etapas gerais de implantação
Esta seção inclui etapas gerais de implantação que ajudam a compreender rapidamente o processo geral. Para obter informações detalhadas sobre cenários específicos, você pode analisar as seções apropriadas neste artigo.
Siga estas etapas:
  1. Instale o wasp no servidor do CABI.
  2. Verifique se o wasp é executado com uma porta e um PID.
    • O arquivo certificate .pem deve estar em vigor e ser referenciado no arquivo robot.cfg.
  3. Edite a configuração do wasp com o caminho de data_engine correto (/domain/primaryhub/primaryhubrobot/data_engine).
  4. Permita que o wasp seja reiniciado.
    • Verifique a porta e o PID. Além disso, verifique se o arquivo wasp.log não contém erros.
  5. Implante o probe CABI no servidor do CABI.
  6. Implante os seguintes pacotes no servidor do CABI:
    • uim_unified_reporter_pack
    • uim_cabi_health_report_pack
    • uim_core_dashboards_pack
  7. Implante o pacote ump_cabi no servidor do OC.
Determinar o processo de implantação
Use o fluxograma a seguir para determinar qual processo de implantação é necessário para o ambiente do CA UIM.
fluxo do cabi
cabi flow
Primeira instalação do servidor do CABI em um novo UIM Server.
Use este procedimento para instalar um novo servidor do CABI em um novo ambiente do CA UIM.
Visão geral do processo
O diagrama a seguir mostra a sequência de tarefas a serem concluídas.
Novo fluxo de instalação do CABI
New Install Flow CABI
(Opcional) Alterar a porta padrão do servidor do CABI
Somente siga estas etapas se a porta 80 não estiver disponível no robô ou se uma porta http fora do padrão for desejada. Use as etapas a seguir para alterar o valor da porta padrão do servidor do CABI.
  1. Implante o wasp no robô do servidor do CABI, caso não esteja instalado no momento.
  2. Edite o probe wasp no robô do servidor do CABI por meio da Configuração de dados brutos.
  3. Selecione Configuração.
  4. Edite o valor da chave http_port e atualize a configuração. A mensagem de erro "Falha ao reiniciar o probe" é exibida.
  5. Selecione
    Cancelar
    para fechar a janela.
  6. NÃO reinicie o wasp.
    A instalação do probe cabi reiniciará o wasp.
  7. Verifique sua alteração na Configuração de dados brutos para o wasp.
(Somente para a autenticação do Windows no Microsoft SQL Server) Configurar a autenticação do Windows para CABI
Se você estiver usando o Microsoft SQL Server com a autenticação do Windows, o CABI não funcionará até que a autenticação do Windows seja configurada no servidor do CABI. A autenticação do Windows deve ser configurada no CA UIM, OC e CABI.
Siga estas etapas:
  1. No robô do servidor do CABI, vá para
    Ferramentas administrativas > Serviços
    e clique duas vezes no
    Nimsoft Robot Watcher
    .
  2. Selecione a guia
    Efetuar logon
    .
  3. Altere a conta para a mesma conta e senha usadas no
    data_engine
    e no servidor principal do UIM.
  4. Clique em
    OK
    .
  5. Clique com o botão direito no 
    Nimbus Robot Watcher
     e selecione a opção
    Reiniciar
    .
  6. Feche as janelas.
  7. Reinicie o robô do servidor do CABI.
Implantar o probe cabi
Durante a implantação, o probe cabi instala e configura uma instância do servidor do CABI em um robô.
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. Copie o arquivo .pem nos robôs do CABI e OC remotos e forneça 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ô (onde 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.
Siga estas etapas:
  1. Verifique se o probe cabi, uim_core_dashboards_pack e pacotes de relatórios estão no arquivo.
  2. Implante o pacote do probe cabi em um robô. O probe implementa automaticamente todas as dependências de pacote existentes no arquivo. Por exemplo, os pacotes de relatórios e o uim_core_dashboards_pack. Para obter mais informações sobre como implantar um pacote do probe, consulte o artigo Implantar pacotes.
    Aviso!
    Durante a configuração do pacote do probe cabi, o wasp é reiniciado no robô com o servidor do CABI. A implantação pode levar aproximadamente de 20 a 30 minutos para ser concluída.
    Não tente reiniciar o wasp antes de concluir a implantação.
    Se você tentar reiniciar o wasp antes da conclusão da implantação, o servidor do CABI poderá não ser instalado com êxito.
  3. Certifique-se de que a instalação do CABI tenha sido concluída. O probe cabi pode estar ativo, mas o processo de instalação pode não ter sido concluído. Vá para o arquivo de log do probe cabi e procure as seguintes mensagens:
    <
    data_hora
    >[main, cabi] CABI instalado com êxito.
        ...
    <
    data_hora
    >[UserSynchronizationThread, cabi] Concluída a sincronização de usuários entre o UIM e o CABI
    Durante a instalação, o probe cabi carregará a fonte de dados, o domínio, o tópico e os usuários. Os pacotes de relatórios e o uim_core_dashboards_pack são implantados com o probe.
    O probe wasp será iniciado automaticamente quando o processo estiver concluído.
Alterar as credenciais padrão do CABI
Uma conta de superusuário padrão existe no CABI Server. Você deve alterar as credenciais para manter a segurança do sistema. Você pode usar a conta de superusuário para gerenciar as configurações do servidor.
Altere o nome de usuário e a senha padrão assim que possível para manter a segurança do sistema.
Siga estas etapas:
  1. Insira em um navegador:
    http://<IP_do_servidor_do_CABI ou nome_do_host>:<porta>/cabijs
    Sendo que
    <porta>
    é a porta para o robô que executa o wasp e o servidor do CABI. O número da porta padrão é 80. Por exemplo,
    http://12.123.123.12:80/cabijs
    .
  2. Digite o nome de usuário padrão e a senha para o CABI Server. O nome de usuário e a senha padrão são superuser.
  3. Selecione Gerenciar e Usuários para exibir a lista de usuários.
  4. Selecione e edite a entrada de superusuário para alterar a senha.
Implantar o portlet ump_cabi
Use este procedimento para implantar o pacote do portlet ump_cabi de modo a exibir os painéis predefinidos do CABI no OC.
Siga estas etapas:
  1. No robô que está executando o OC, implante a versão mais recente do pacote
    ump_cabi
    .
  2. Certifique-se de poder exibir os painéis predefinidos. Vá para os
    Painéis
    na navegação à esquerda do OC (Operator Console - Console do Operador) e selecione um painel do CA Business Intelligence. Por exemplo,
    Visão geral do Infrastructure Management
    .
Primeira instalação do servidor do CABI em uma atualização do UIM Server
Essas instruções detalham como implantar o servidor do CABI em um ambiente atualizado do CA UIM pela primeira vez.
Visão geral do processo
O diagrama a seguir mostra a sequência de tarefas a serem concluídas.
Fluxo de processo do CABI - novo servidor na atualização do UIM
CABI Process flow - new server on upgrade UIM
(Opcional) Alterar a porta padrão do servidor do CABI
Somente siga estas etapas se a porta 80 não estiver disponível no robô ou se uma porta http fora do padrão for desejada. Use as etapas a seguir para alterar o valor da porta padrão do servidor do CABI.
  1. Implante o wasp no robô do servidor do CABI, caso não esteja instalado no momento.
  2. Edite o probe wasp no robô do servidor do CABI por meio da Configuração de dados brutos.
  3. Selecione Configuração.
  4. Edite o valor da chave http_port e atualize a configuração. A mensagem de erro "Falha ao reiniciar o probe" é exibida.
  5. Selecione
    Cancelar
    para fechar a janela.
  6. NÃO reinicie o wasp.
    A instalação do probe cabi reiniciará o wasp.
  7. Verifique sua alteração na Configuração de dados brutos para o wasp.
(Somente para a autenticação do Windows no Microsoft SQL Server) Configurar a autenticação do Windows para CABI
Se você estiver usando o Microsoft SQL Server com a autenticação do Windows, o CABI não funcionará até que a autenticação do Windows seja configurada no servidor do CABI. A autenticação do Windows deve ser configurada no CA UIM, OC e CABI.
Siga estas etapas:
  1. No robô do servidor do CABI, vá para
    Ferramentas administrativas > Serviços
    e clique duas vezes no
    Nimsoft Robot Watcher
    .
  2. Selecione a guia
    Efetuar logon
    .
  3. Altere a conta para a mesma conta e senha usadas no
    data_engine
    e no servidor principal do UIM.
  4. Clique em
    OK
    .
  5. Clique com o botão direito no 
    Nimbus Robot Watcher
     e selecione a opção
    Reiniciar
    .
  6. Feche as janelas.
  7. Reinicie o robô do servidor do CABI.
Implantar o probe cabi
Durante a implantação, o probe cabi instala e configura uma instância do servidor do CABI em um robô.
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. Copie o arquivo .pem nos robôs do CABI e OC remotos e forneça 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ô (onde 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.
Siga estas etapas:
  1. Verifique se o probe cabi, uim_core_dashboards_pack e pacotes de relatórios estão no arquivo.
  2. Implante o pacote do probe cabi em um robô. Para obter mais informações sobre como implantar um pacote do probe, consulte o artigo Implantar pacotes.
    Aviso!
    Durante a implantação do pacote do probe cabi, o wasp é reiniciado no robô com o servidor do CABI. A implantação pode levar entre 10 e 20 minutos para ser concluída.
    Não tente reiniciar o wasp antes de concluir a implantação.
    Se você tentar reiniciar o wasp antes da conclusão da implantação, o servidor do CABI poderá não ser instalado com êxito.
  3. Certifique-se de que a instalação do servidor do CABI tenha sido concluída. O probe cabi pode estar ativo, mas o processo de instalação pode não ter sido concluído. Vá para o arquivo de log do probe cabi e procure as seguintes mensagens:
    <
    data_hora
    >[main, cabi] CABI instalado com êxito.
         ...
    <
    data_hora
    >[UserSynchronizationThread, cabi] Concluída a sincronização de usuários entre o UIM e o CABI
    Durante a instalação, o probe cabi carregará a fonte de dados, o domínio, o tópico e os usuários. Os pacotes uim_core_dashboards_pack e de relatório também são implantados com o pobre. O probe wasp é iniciado automaticamente quando o processo é concluído.
Alterar as credenciais padrão do CABI
Uma conta de superusuário padrão existe no CABI Server. Você deve alterar as credenciais para manter a segurança do sistema. Você pode usar a conta de superusuário para gerenciar as configurações do servidor.
Altere o nome de usuário e a senha padrão assim que possível para manter a segurança do sistema.
Siga estas etapas:
  1. Insira em um navegador:
    http://<IP_do_servidor_do_CABI ou nome_do_host>:<porta>/cabijs
    Sendo que
    <porta>
    é a porta para o robô que executa o wasp e o servidor do CABI. O número da porta padrão é 80. Por exemplo,
    http://12.123.123.12:80/cabijs
    .
  2. Digite o nome de usuário padrão e a senha para o CABI Server. O nome de usuário e a senha padrão são superuser.
  3. Selecione Gerenciar e Usuários para exibir a lista de usuários.
  4. Selecione e edite a entrada de superusuário para alterar a senha.
Implantar o portlet ump_cabi
Use este procedimento para implantar o pacote do portlet ump_cabi de modo a exibir os painéis predefinidos do CABI no OC.
Siga estas etapas:
  1. No robô que está executando o OC, implante a versão mais recente do pacote
    ump_cabi
    .
  2. Certifique-se de poder exibir os painéis predefinidos. Vá para o menu
    Painéis
    na navegação à esquerda do OC (Operator Console - Console do Operador) e selecione um painel do CA Business Intelligence. Por exemplo,
    Visão geral do Infrastructure Management
    .
Atualizar o servidor do CABI
A introdução desta seção destina-se aos usuários que implantaram o servidor do CABI e desejam realizar uma atualização.
Visão geral do processo
O diagrama a seguir mostra a sequência de tarefas a serem concluídas.
fluxo de processo do cabi - atualização
cabi process flow - upgrade
Em um cenário de atualização, se você estiver atualizando o CABI em uma configuração segura, certifique-se de colocar o robô do CABI no estado seguro implantando os certificados apropriados e, em seguida, atualizando a versão do robô para a versão segura. Depois disso, atualize o CABI. Para obter mais informações sobre a instalação segura e como implantar certificados, consulte Hub e robô seguros.
Se você estiver usando uma versão mais antiga do CABI que seja anterior a 3.40, primeiramente, será necessário atualizar para o CABI 3.40, ou 4.10, ou 4.20 e, em seguida, atualizar para o CABI 4.30.
Sempre faça backup dos relatórios personalizados (se houver) antes de atualizar o servidor do CABI.
Alterar as credenciais do CABI
Antes de atualizar o probe cabi, certifique-se de alterar a senha do superusuário para a senha padrão, que é o superusuário. Em seguida, você pode atualizar o probe cabi.
Siga estas etapas:
  1. Insira em um navegador:
    http://<IP_do_servidor_do_CABI ou nome_do_host>:<porta>/cabijs
    Sendo que
    <porta>
    é a porta para o robô que executa o wasp e o servidor do CABI. O número da porta padrão é 80. Por exemplo,
    http://12.123.123.12:80/cabijs
    .
  2. Digite as credenciais do servidor do CABI.
  3. Selecione Gerenciar e Usuários para exibir a lista de usuários.
  4. Selecione e edite a entrada de superusuário para alterar a senha para superusuário.
Após a conclusão bem-sucedida da atualização do probe cabi, é possível alterar a senha padrão com base em seus requisitos seguindo as etapas acima.
Reimplante o probe cabi
Para atualizar o servidor do CABI, implante novamente a versão mais recente do probe cabi.
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. Copie o arquivo .pem nos robôs do CABI e OC remotos e forneça 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ô (onde 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.
Siga estas etapas:
  1. Verifique se o probe cabi, uim_core_dashboards_pack e pacotes de relatórios estão no arquivo.
  2. Implante o pacote mais recente do probe cabi no local do probe cabi existente.
    Para obter mais informações sobre como implantar um pacote do probe, consulte o artigo Implantar pacotes.
    Aviso!
    Durante a implantação do pacote do probe cabi, o wasp é reiniciado no robô com o servidor do CABI. A implantação pode levar entre 10 e 20 minutos para ser concluída.
    Não tente reiniciar o wasp antes de concluir a implantação.
    Se você tentar reiniciar o wasp antes da conclusão da implantação, o servidor do CABI poderá não ser instalado com êxito.
  3. Certifique-se de que a instalação do servidor do CABI tenha sido concluída. Vá para o arquivo de log do probe cabi e procure a seguinte mensagem:
    <
    data_hora
    >[main, cabi] CABI instalado com êxito.
         ...
    <
    data_hora
    >[UserSynchronizationThread, cabi] Concluída a sincronização de usuários entre o UIM e o CABI
    O probe wasp será iniciado automaticamente quando o processo estiver concluído.
Implantar o portlet ump_cabi
Use este procedimento para implantar o pacote do portlet ump_cabi de modo a exibir os painéis predefinidos do CABI no OC.
Siga estas etapas:
  1. No robô que está executando o OC, implante a versão mais recente do pacote
    ump_cabi
    .
  2. Certifique-se de poder exibir os painéis predefinidos. Vá para o menu
    Painéis
    na navegação à esquerda do OC (Operator Console - Console do Operador) e selecione um painel do CA Business Intelligence. Por exemplo,
    Visão geral do Infrastructure Management
    .
Definir a configuração de email SMTP para enviar por email relatórios programados
Os relatórios no UIM são gerenciados pelo CABI. Portanto, você deve definir as configurações de SMTP no robô do CABI.
Siga estas etapas:
  1. Interrompa o robô em que o CABI está em execução.
  2. Vá para a pasta C:\Arquivos de programas (x86)\Nimsoft\probes\service\wasp\webapps\cabijs\WEB-INF.
  3. Crie um backup do arquivo js.quartz.properties.
  4. Edite o arquivo js.quartz.properties, conforme mostrado abaixo. Edite os valores em negrito para corresponder à sua configuração:
    • report.scheduler.web.deployment.uri=
      http://CABI:port/cabijs (http(s)://<ip-ou-fqdn-cabi>:<porta>/cabijs
    • report.scheduler.mail.sender.host=
      smtp.corp.com (O nome do computador que está hospedando o servidor de email.)
    • report.scheduler.mail.sender.username=
      smtp_user_name_(O nome do usuário do servidor de email que o JasperReports Server pode usar.)
    • report.scheduler.mail.sender.password=
      smtp_password_ (A senha do usuário do servidor de email.)
    • report.scheduler.mail.sender.from=
      [email protected] (O endereço que aparece no campo De nas notificações por email.)
    • report.scheduler.mail.sender.protocol=
      smtp (O protocolo que o servidor de email usa. O JasperReports Server oferece suporte apenas ao SMTP.)
    • Se o servidor de email não exigir um nome de usuário ou uma senha, deixe os valores em branco; por exemplo:
      • report.scheduler.mail.sender.username=
      • report.scheduler.mail.sender.password=
    Se você adicionar # no início das linhas acima, o arquivo será corrompido e o CABI não poderá ser iniciado.
  5. Reinicie o robô do CABI.
Tarefas opcionais
As tarefas a seguir são opcionais e não são necessárias para todos os ambientes do CA UIM. Após ter instalado o servidor do CABI com êxito, revise as tarefas a seguir. Conclua as tarefas necessárias para o seu ambiente.
Atualizar os certificados autoassinados existentes para o Java 1.8
Execute este procedimento se sua versão do CABI tiver sido previamente configurada para usar HTTPS. Desde o CA UIM versão 8.5.1, o Java foi atualizado para a versão 1.8. É necessário atualizar todos os certificados autoassinados gerados por versões anteriores do CA UIM.  Se você não atualizar os certificados existentes, as conexões HTTPS com o servidor do CABI não funcionarão devido a uma alteração nos níveis de criptografia de segurança no Java 1.8.
Siga estas etapas:
  1. Repita as etapas a seguir para cada instância do wasp que você tenha configurado para usar HTTPS.
  2. No robô do servidor do CABI com o wasp, navegue até o arquivo wasp.keystore no caminho 
    <pasta_de_instalação_do_UIM>\probes\service\wasp\conf\wasp.keystore
    .
  3. Exclua o arquivo wasp.keystore.
  4. Vá para o Console de administração.
  5. Reinicie o wasp no robô do servidor do CABI. O arquivo wasp.keystore é gerado novamente de acordo com o padrão do algoritmo SHA256.
  6. Certifique-se de que seja possível restabelecer a conectividade do navegador para o sistema. Aceite quaisquer prompts para aceitar o novo certificado autoassinado no navegador.
Usando um URL externo para acessar o servidor do CABI
Use este procedimento se você for um MSP que exige que os clientes se conectem por meio de um URL externo para acessar os painéis.
Siga estas etapas:
  1. Obter o FQDN (Fully Qualified Domain Name - Nome de Domínio Totalmente Qualificado) para o URL externo.
  2. Vá para o sistema de arquivos no servidor do CABI.
  3. Edite o arquivo de hosts. O local depende do tipo de plataforma:
    • Windows -
      c:\windows\system32\drivers\etc\hosts
    • Linux -
      /etc/hosts
  4. Adicionar uma entrada com a sintaxe:
    <IP local do servidor do cabi><FQDN do URL externo>
    Por exemplo,
  5. Salve o arquivo.
  6. Abra a Configuração de dados brutos para o probe cabi.
  7. Vá para
    Configuração
    e adicione a chave
    cabi_url
    com o valor:
    http://<FQDN do URL externo>/cabijs
  8. Reinicie o probe cabi e aguarde a nova porta e o pid antes de prosseguir para a próxima etapa. Em cabi.log, o novo caminho apontando para o URL do FQDN é exibido.
  9. Reinicie o wasp no robô do OC.
  10. É possível acessar o servidor do CABI usando o novo FQDN e os painéis do cabi no OC são resolvidos para o novo URL.
Caso o https esteja sendo usado, siga as instruções em Configurar o servidor do CABI para usar HTTPS.
(Opcional) Configurar o servidor do CABI para usar HTTPS
Recomendamos consultar os engenheiros de segurança de rede e os especialistas em conformidade para se informar sobre os requisitos de segurança específicos. Em geral, os requisitos de segurança padrão do setor exigem o uso de criptografia SSL para a comunicação cliente-servidor por meio de uma rede não confiável.
Siga estas etapas:
  1. Configure o wasp para usar HTTPS no UIM ou no OC, conforme descrito no artigo Configurar HTTPS no Console de administração ou no OC.
  2. Vá para o robô que estiver executando o wasp e o servidor do CABI.
  3. Configure o wasp para usar HTTPS, conforme descrito no artigo Configurar HTTPS no Console de administração ou no OC.
  4. Abra a Configuração de dados brutos para o probe cabi.
  5. Vá para
    Configuração
    e adicione a chave
    cabi_url
    com o valor:
    https://<IP_do_servidor_do_CABI ou nome_do_host>:<porta>/cabijs
    Sendo que
    <porta>
    é a porta HTTPS.
  6. Reinicie o wasp no robô do OC.
  7. Instrua os usuários que acessam o servidor do CABI diretamente a usarem o URL:
    https://<IP_do_servidor_do_CABI ou nome_do_host>:<porta>/cabijs
    Sendo que
    <porta>
    é a porta para a comunicação https. O número da porta HTTPS padrão é 8443. Por exemplo,
    https://12.123.123.12:8443/cabijs
    .
  8. Instrua os usuários a aceitar os avisos do certificado de segurança específicos do navegador que forem necessários para prosseguir para a página inicial do servidor do CABI.
Alterar a frequência dos backups
Um backup do pacote de painéis é criado quando você atualiza o pacote de painéis ou o probe cabi. Use as configurações de backup automático para controlar a frequência de criação do arquivo de backup. Você pode usar essas opções para salvar os recursos se você atualizar com frequência os painéis e o probe cabi.
Siga estas etapas:
  1. Vá para a configuração de dados brutos para o probe cabi.
  2. Defina o valor para as seguintes chaves, conforme necessário:
    • auto_backup_fequency_in_hours - o probe cabi usa essa chave somente quando um painel está disponível para importação e a chave auto_backup_on_import_enabled está definida como
      yes
      . Se a duração do último backup for inferior à frequência especificada, um backup será criado. A configuração como 0 indica que nenhum backup será criado. A configuração padrão é
      24
      horas.
    • auto_backup_on_import_enabled - essa chave indica se um arquivo de backup será criado para pacotes de painéis. Um arquivo de backup será criado quando definido como yes. A configuração padrão é
      yes
      .
    • auto_backup_on_import_max_time_in_secs - esse é o intervalo de tempo permitido antes que uma mensagem de erro seja gerada no arquivo de log do probe cabi. A configuração padrão é de
      1800
      segundos.
Personalizar o logotipo do relatório
É possível personalizar a aparência dos relatórios do painel do CABI para que correspondam ao nome e ao logotipo da sua organização.
Siga estas etapas:
  1. Efetue logon no OC usando credenciais de administrador.
  2. Abra a página inicial do servidor do CABI
    usando o URL
    http(s)://<IP_do_servidor_do_CABI ou nome_do_host>:<porta>/cabijs
    em outra guia do navegador.
  3. No menu, selecione
    Exibir
    , Repositório e vá para Público, CA, Unified Infrastructure Management, Recursos, Biblioteca, Integridade, Imagens.
  4. Selecione company_logo.png e clique em
    Editar
    para substituir pelo seu logotipo.
  5. Da mesma forma, para alterar o logotipo para todos os relatórios globalmente, vá para Public, CA, Unified Infrastructure Management, Recursos, Common, Imagens.
  6. Selecione company_logo.png e clique em
    Editar
    para substituir pelo seu logotipo em todos os relatórios.
Regras de firewall do servidor do CABI em pacote
A tabela a seguir define as portas e as direções que devem estar abertas no firewall para uma configuração de pacote. Para obter mais informações, consulte Referência da porta de firewall.
Comunicação necessária
Portas
Direção
Regras de firewall
Detalhes
Servidor do CABI em pacote para o banco de dados do UIM
1433 (Microsoft SQL Server);
1521 (Oracle);
3306 (MySQL)
Entrada
Permita entrada na porta correspondente para o banco de dados do UIM.
Entrada do servidor do CABI para o banco de dados escolhido. A porta depende do tipo de banco de dados e da configuração.
Servidor do CABI agrupado para OC
80 ou 443; configurável
Entrada, saída
Permitir a entrada nas portas 80 ou 443 para os servidores do OC e do CABI.
Essa conexão oferece ao navegador e ao cliente conectividade com o OC e o servidor do CABI.Porta 80 por padrão ou porta 443 para HTTPS. Você pode usar outro valor de porta configurado para HTTP ou HTTPS. A porta pode variar de acordo com o cliente/navegador para o CABI e o OC. O valor depende da sua escolha durante a instalação do OC e do servidor do CABI. Por exemplo, a porta 80 ou a porta 443. O intervalo de portas configuráveis é de 1 a 65535.
Solução de problemas
  • Se os painéis não forem implantados automaticamente após a instalação do pacote do CABI, será preciso aumentar o tamanho da memória heap para o probe cabi com a configuração de dados brutos.
  • Durante a atualização do probe CABI, a inicialização do probe pode falhar e você receberá uma mensagem de alarme sobre o máximo de reinicializações. Você verá uma mensagem sobre o conteúdo relacionado ao backup no log e terá arquivos de despejo Java parciais no diretório cabi. Isso poderá acontecer se houver um grande número de relatórios personalizados que exijam uma quantidade maior de memória para backup do que a que está configurada no probe.
    Para resolver esse problema:
    • Aumente as opções
      java_mem_init
      e
      java_mem_max
      na seção inicialização -> opções da configuração de dados brutos do probe cabi.
    • Comece definindo o MÍNIMO para 1 GB e o MÁXIMO para 2 GB a fim de resolver esse problema. Talvez seja necessário aumentar esses números de acordo com a quantidade de relatórios personalizados. Isso pode ser feito no IM (Infrastructure Manager - Gerenciador de Infraestrutura) ou no AC (Admin Console - Console de Administração).
    • Desative e ative o probe cabi, que continuará com o processo de atualização.
  • Certifique-se de que o servidor do Jasper esteja acessível após a instalação usando o URL
    http(s)://<nome-do-host/endereço-IP>:<porta>/cabijs
    e verifique se os painéis predefinidos foram implantados. Você pode verificar os painéis acessando a pasta /public/ca/uim/dashboards/common no servidor do CABI.
    cabi flow
    Se não for possível ver a pasta acima, implante os pacotes de painéis manualmente.
  • Se o Console do operador estiver configurado com HTTPS, o CABI também deverá ser configurado com HTTPS. Veja que as seguintes combinações não são suportadas:
    • O Console do operador é configurado com HTTPS e CABI com HTTP
    • O Console do operador é configurado com HTTP e CABI com HTTPS
  • Se HTTPS para CABI estiver configurado com um certificado autoassinado ou um certificado inválido, pode ser que o Console do operador não carregue corretamente a página do CABI.
    • Como uma resolução temporária, você pode abrir o URL do CABI (https://<IP_do-robo-do-cabi>:<porta>/cabijs e https://<nome-do-host_do_robo-do-cabi>:<porta>/cabijs), aceitar a exceção e, em seguida, abrir o Console do operador. Ou adicione o certificado como um certificado confiável ao repositório de certificados do sistema ou ao repositório de certificados do navegador, conforme apropriado.
  • Em determinados casos, quando a página do Console do operador é deixada aberta por muito tempo, é possível que as páginas do CABI não carreguem. Você pode tentar as seguintes soluções possíveis:
    • Efetuar logoff na sessão do Console do operador
    • Efetuar logon novamente
  • Durante a instalação do CABI em uma instância nomeada de qualquer servidor de banco de dados (MS SQL ou Oracle), você pode enfrentar um problema em que o probe do CABI ficará vermelho e mostrará o problema de sincronização do usuário no arquivo de log.
    O log de erro contém mensagens relacionadas aos erros 401 e 403: "URL attempted http:<nome_do_host>:80/cabijs/login.html, Response code :403" e "Error getting all organizations, got unexpected response code '401' and body''".
    • Execute as etapas a seguir para corrigir esses erros:
      • Efetue logon no servidor do CABI com credenciais de superusuário.
      • Vá para Gerenciar -> Usuários. Selecione "CABI_REST_USER" e clique em Excluir usuário.
      • Reinicie o robô do CABI.
Cookies de terceiros e cookies same-site
:
  • Quando o Console do operador e o CABI estão em sistemas diferentes, pode haver problemas relacionados aos cookies same-site ou cookies de terceiros. Se o URL do CABI e do Console do operador não tiverem o mesmo subdomínio e domínio (por exemplo: endereços IP forem usados), os cookies do CABI serão considerados como terceiros durante o acesso ao Console do operador em um navegador. Alguns navegadores podem forçar o bloqueio de cookies de terceiros causando problemas com o carregamento das páginas do CABI. Uma dessas manifestações pode ser um "erro de acesso aos dados" nas páginas relacionadas ao CABI no Console do operador. Veja a seguir algumas sugestões, caso você esteja usando o Chrome:
    • O navegador Chrome mais recente aplica regras rígidas de cookies same-site (chrome://settings)
      cabi flow
      Nesses cenários, talvez seja necessário permitir os cookies de terceiros, como mostrado a seguir:
      cabi flow
      Além disso, opte por desativar os sinalizadores abaixo relacionados ao cookie same-site (chrome://flags)
      cabi flow
  • (Configurações opcionais)
    Somente se
    o URL do Console do operador e o URL do CABI puderem ser acessados com o
    mesmo
    domínio e subdomínio
    , você poderá optar por executar as configurações abaixo:
    • Por exemplo, o URL do Console do operador: http://OpCon.
      subdomain.com
      /operatorconsole_portlet/overview e o URL do CABI: http://cabirobot.
      subdomain.com
      /cabijs têm o mesmo subdomínio e domínio
      subdomain.com
      .
      Outro exemplo, se o CABI e o Console do operador estiverem instalados no mesmo sistema, o URL do Console do operador: http://OpCon.
      subdomain.com
      /operatorconsole_portlet/overview e o URL do CABI:
      http://OpCon.
      subdomain.com
      /cabijs têm o mesmo subdomínio e domínio
      subdomain.com
      .
    • Você pode alterar as configurações de sameSiteCookies de "None" (padrão) para "LAX", entre outras alterações, conforme indicado abaixo.
    • No robô do CABI:
      • Desative o probe cabi.
      • Defina o parâmetro de configuração do CABI
        cabi_url
        como
        http://<URLwithMatchingSubdomainAndDomain>:<porta>/cabijs
        .
      • Desative o probe wasp.
      • Modifique nimsoft/probes/service/wasp/webapps/cabijs/META-INF/context.xml com
        <CookieProcessor class="org.apache.tomcat.util.http.Rfc6265CookieProcessor" sameSiteCookies=
        "Lax"
        />.
      • Ative o probe cabi.
      • Ative o probe wasp.
    • No robô do Console do operador:
      • Desative o probe wasp.
      • Modifique nimsoft/probes/service/wasp/webapps/cabi/META-INF/context.xml com
        <CookieProcessor class="org.apache.tomcat.util.http.Rfc6265CookieProcessor" sameSiteCookies=
        "Lax"
        />.
      • Ative o probe wasp.
  • No caso do TLS 1.2, revise o seguinte URL de exemplo no arquivo context.xml e modifique os valores necessários com base no seu ambiente. Por exemplo, talvez seja necessário alterar o valor de trustServerCertificate para true se as configurações exigirem:
    url="jdbc:tibcosoftware:sqlserver://SV001:3000;databaseName=UIM_SQL;sendTimestampEscapeAsString=false;AuthenticationMethod=type2;encryptionMehtod=ssl;CryptoProtocolVersion=TLSv1.2;trustServerCertificate=true;"
  • Para a instalação do TLS 1.2 no UIM, consulte os artigos necessários: Suporte ao TLS v1.2 (Microsoft SQL Server) e Suporte ao TLS v1.2 (Oracle). Esses artigos também incluem as considerações apropriadas para o CABI.