Gerenciar agentes privados e grupos de agentes na página de Agentes no Jitterbit Management Console

Introdução

Para gerenciar agentes privados e grupos de agentes, use a aba Privado:

Ela contém uma barra de ferramentas e uma tabela de grupos de agentes privados. Clique em um grupo para gerenciar os agentes do grupo.

Barra de ferramentas

A barra de ferramentas possui os seguintes controles:

• Pesquisa: Insira uma string de pesquisa para realizar uma busca sem diferenciação entre maiúsculas e minúsculas em qualquer coluna (exceto por Registro em nuvem e Ações). Apenas grupos com colunas que correspondem à string de pesquisa são exibidos, com a parte correspondente do texto destacada.

• Um conjunto de menus para filtrar a lista de grupos de agentes pelos seguintes critérios:

  • Status: Selecione Todos os status para ver grupos de agentes com agentes de todos os status, Sem status para ver grupos de agentes com agentes sem status, ou qualquer um dos nomes de status listados para ver apenas grupos de agentes com agentes que possuem os status selecionados. (Quando Todos os status é selecionado, todas as outras opções também são selecionadas.)

  • Grupo de agentes: Selecione Todos os grupos para ver todos os grupos de agentes, ou qualquer um dos nomes de grupos de agentes listados para ver apenas aqueles grupos de agentes selecionados.

  • Nome do agente: Selecione Todos os agentes para ver grupos de agentes para todos os agentes, Sem agentes associados para ver grupos de agentes sem nenhum agente, ou qualquer um dos nomes de agentes listados para ver apenas os grupos de agentes daquele agente.

  • Nome do ambiente: Selecione Todos os ambientes para ver grupos de agentes em todos os ambientes, Sem ambientes associados para ver grupos de agentes sem um ambiente associado, ou qualquer um dos nomes de ambientes listados para ver apenas aqueles grupos de agentes associados a eles.

• Atualizar: Atualiza a tabela.

• Filtrar Colunas: Abra a gaveta Colunas para reorganizar colunas ou alterar sua visibilidade.

• Adicionar grupo de agentes: Adicione um grupo de agentes privado.

Gerenciar grupos de agentes privados

Os grupos de agentes privados são exibidos em uma tabela com as seguintes colunas (algumas das quais podem estar ocultas pelas configurações de Filtrar Colunas):

• ID do grupo de agentes: O número de identificação do grupo de agentes privado. Para copiar o ID para a área de transferência, passe o mouse sobre a coluna e clique no ícone Copiar.

• Nome do grupo de agentes: O nome do grupo de agentes privado. Para copiar o nome para a área de transferência, passe o mouse sobre a coluna e clique no ícone Copiar.

• Descrição: A descrição do grupo de agentes privado.

• Ambientes: O ambiente associado ao grupo de agentes.

• Registro em nuvem: Quando ativado, você pode acessar mensagens de log detalhadas na aba Mensagens das Operações de Tempo de Execução e baixar logs de agentes. Quando desativado, a aba Mensagens fornece um link para os detalhes do log de operações no host do agente. Se o seu firewall permitir, o log é aberto em uma nova aba do navegador.

  Importante

  Você deve reiniciar todos os agentes privados no grupo sempre que alterar esta configuração.

  Nota

  O interruptor de Registro em nuvem não ativa nem desativa o registro de operações, nem afeta se os dados de entrada e saída dos componentes (gerados quando o registro de depuração de operações está ativado) são armazenados na nuvem Harmony. O interruptor afeta apenas se os logs de operações e mensagens de log detalhadas são armazenados na nuvem Harmony.

• Classe do grupo de agentes: Use o menu para selecionar uma dessas classificações:

  • Padrão: Permite um máximo de um agente no grupo.

  • Alta Disponibilidade: Permite dois ou mais agentes no grupo e requer uma licença de Agrupamento de Agentes para HA (alta disponibilidade). Este tipo de classe permite que múltiplos agentes dentro de um grupo compartilhem a carga operacional e fornece redundância para cenários de alta disponibilidade.

  Nota

  A licença de Agrupamento de Agentes para HA não é aplicada no nível do sistema. Se você reclassificar um grupo Padrão para Alta Disponibilidade sem uma licença ou além do limite da sua licença, um aviso informativo aconselha você a entrar em contato com seu representante da Jitterbit para ajustar sua alocação, e um ícone de aviso aparece ao lado do nome do grupo de agentes. Quando você passa o mouse sobre o ícone, o mesmo aviso informativo é revelado.

  Você pode ver suas informações de licença e uso na página Dashboard do Console de Gerenciamento.

• Contagem de Agentes: O número de agentes no grupo de agentes.

• Ações: Esta coluna contém os seguintes ícones:

  • Detalhes: Abra a gaveta de Detalhes do grupo de agentes. Quando aberta, os seguintes controles aparecem no canto superior direito da gaveta:

    • Anterior: Selecione o grupo de agentes privados anterior.

    • Próximo: Selecione o próximo grupo de agentes privados.

    • Expandir: Expanda a gaveta de Detalhes do grupo de agentes para o tamanho da página. Quando expandida, clique no ícone Minimizar para retornar ao seu tamanho original.

    • Fechar: Feche a gaveta.

  • Atualizar conectores: Atualize os conectores baseados no SDK de Conectores do Integration Studio em todos os agentes do grupo. (Isso substitui a configuração de política organizacional Desativar Atualização Automática de Conectores que inibe atualizações automáticas.)

  • Editar: Editar o grupo de agentes privados.

  • Excluir: Excluir o grupo de agentes privados. Você não pode excluir um grupo até que todas as associações de ambiente sejam removidas.

Adicionar um grupo de agentes privados

Para adicionar um grupo de agentes privado, siga estas etapas:

1. Clique no botão Adicionar grupo de agentes na barra de ferramentas da aba Privado. O painel Adicionar grupo de agentes se abre:

   

2. Insira um valor no campo Nome do grupo.

3. (Opcional) Insira um valor no campo Descrição.

   Dica

   O nome do grupo e a descrição devem conter apenas caracteres alfanuméricos, sublinhados _, parênteses (), hífens - e espaços.

4. Ative ou desative o toggle de Registro em nuvem.

5. Abra o menu Classe do grupo de agentes, e selecione Padrão ou Alta Disponibilidade:

   

6. Clique no botão Salvar.

7. Quando o novo grupo (Grupo de Agentes C neste exemplo) aparecer na tabela, você pode adicionar agentes a ele:

   

Editar um grupo de agentes privado

Para editar um grupo de agentes privado, siga estas etapas:

1. Passe o mouse sobre um grupo de agentes privado, e clique no ícone Editar na coluna Ações. O painel Editar grupo de agentes se abre:

   

2. Edite os campos Nome do grupo ou Descrição, ou altere as configurações de Registro em nuvem ou Classe do grupo de agentes. Grupos de agentes com dois ou mais agentes não podem mudar de classe de Alta Disponibilidade para Padrão até que o número de agentes no grupo seja um.

3. Clique no botão Salvar.

Excluir um grupo de agentes privado

Para excluir um grupo de agentes privado, siga estas etapas:

1. Passe o mouse sobre um grupo de agentes privado, e clique no ícone Excluir na coluna Ações. A caixa de diálogo Excluir grupo de agentes se abre:

   

2. Para continuar a ação, digite a palavra DELETE onde indicado e clique no botão Excluir.

Gerenciar agentes privados

Para ver os detalhes de um grupo de agentes privado, você pode clicar em uma linha na tabela ou passar o mouse sobre uma linha e clicar no ícone Detalhes na coluna Ações. O painel Detalhes do grupo de agentes se abre na parte inferior da página, contendo as seguintes abas:

• Agentes

• Plugins

• Ambientes

Se o grupo de agentes privado tiver pelo menos um agente em execução e a configuração de agente remoto estiver habilitada na aba Gerenciamento de Agentes em Organizações, as seguintes abas também aparecem:

• Configuração do Jitterbit

• Drivers de banco de dados

Ver detalhes do grupo

Para gerenciar os agentes em um grupo de agentes privado, siga estas etapas:

1. Abra o painel Detalhes do grupo de agentes para o grupo de agentes privado que você deseja gerenciar.

2. No painel Detalhes do grupo de agentes, selecione a aba Agentes:

   

A aba Agentes dos detalhes do grupo contém o seguinte:

• Uma barra de ferramentas, com os seguintes controles:

  • Pesquisar: Digite uma string de pesquisa para fazer uma busca sem diferenciação entre maiúsculas e minúsculas em qualquer coluna (exceto em Ações). Apenas os agentes com colunas que correspondem à string de pesquisa são exibidos, com a parte correspondente do texto destacada.

  • Atualizar: Atualiza a tabela.

  • Filtrar Colunas: Abra o Painel de Colunas para reorganizar colunas ou alterar sua visibilidade.

• Criar: Adicione um agente privado ao grupo de agentes privados. Esta opção está desabilitada se o grupo tiver uma Classe de grupo de agentes Standard que já possui um máximo de um agente.

• Uma tabela de agentes privados, com as seguintes colunas:

  • Nome: O nome do agente privado.

  • ID: O número de identificação do agente privado.

  • IP: O endereço IP do host do agente privado.

  • SO: O sistema operacional do host do agente privado.

  • Versão: O número da versão do software do agente privado.

  • Status: O status do agente privado.

  • Ações:

    • Baixar logs do agente: Para baixar arquivos de log do agente privado, abra o menu, selecione quais logs do agente privado deseja baixar e clique no botão Baixar. Você pode selecionar qualquer um ou todos os seguintes:

      • Logs do Jitterbit: Todos os arquivos no diretório JITTERBIT_HOME/log do host do agente privado.

      • Logs do Apache: Todos os arquivos no diretório JITTERBIT_HOME/apache/log do host do agente privado.

      • Logs de transformação: Todos os diretórios e arquivos no diretório JITTERBIT_HOME/DataInterchange/Temp/LOG do host do agente privado.

      • Logs do Tomcat: Todos os arquivos no diretório JITTERBIT_HOME/tomcat/logs do host do agente privado.

      • Logs de depuração: Todos os diretórios e arquivos no diretório JITTERBIT_HOME/DataInterchange/Temp/Debug do host do agente privado.

      Logs individuais são compactados, combinados, compactados novamente e, em seguida, baixados com o nome de arquivo log.zip.

    • Baixar Agente Jitterbit: Baixe o software do agente privado. Selecione a versão e o sistema operacional e clique no botão Baixar.

    • Parar drenagem: Ativo apenas quando o agente está em execução. Uma caixa de diálogo é aberta para você confirmar a ação.

    • Mais ações: Clique para revelar as seguintes opções:

      • Editar agente: Edite o nome do agente privado. Ativo apenas quando o agente está parado ou não registrado.

      • Excluir agente: Exclua o agente privado, removendo-o do grupo de agentes privados e da sua organização.

Status do agente

O status de um agente privado é um dos seguintes:

• Não registrado: O agente foi adicionado, mas não está pronto para executar operações.

• Iniciando: O agente está registrado e está se tornando pronto para executar operações.

• Em execução: O agente está pronto para executar operações.

• Parando: O agente está respondendo a um pedido de drain stop. Operações em execução são permitidas até agent.drainstop.api.wait segundos (por padrão, 180) para terminar antes de serem canceladas.

• Parado: O agente permanece registrado, mas não executa operações.

• Desconhecido: O agente está registrado, mas não houve batimento cardíaco nos últimos 5 minutos (o intervalo padrão).

O diagrama a seguir mostra como o status de um agente privado pode mudar:

%%{
init: {
    'state': { 'nodeSpacing': 50, 'rankSpacing': 25 }
    }
}%%
stateDiagram-v2
  direction LR
  state "     Unknown\n(Lost heartbeat)" as U
  Unregistered --> Starting
  state Registered {
    Stopped --> Starting
    Starting --> Running
    Running --> Stopping: \nDrain stop
    Stopping --> Stopped
  Starting --> U
    Running --> U
    Stopping --> U
    Stopped --> U
  }

Adicionar agentes

Para adicionar um agente privado a um grupo de agentes privados, siga estas etapas:

1. Abra o painel de Detalhes do grupo de agentes para o grupo de agentes privados onde o novo agente privado deve ir.

2. Clique no ícone Criar na barra de ferramentas da aba Agente do painel. Uma linha Novo agente aparece na tabela:

   

3. Insira um valor no campo Nome:

   

4. Clique no ícone Salvar:

   

5. Agora você pode registrar seu agente privado usando o novo nome e ID do agente.

Excluir agentes

Para excluir um agente privado de um grupo de agentes privados, siga estas etapas:

1. Abra o painel Detalhes do grupo de agentes para o grupo de agentes privados que contém o agente privado que você deseja excluir.

2. No painel Detalhes do grupo de agentes, passe o mouse sobre um agente privado e clique no ícone Mais ações.

3. No menu, selecione Excluir agente. O diálogo Excluir agente é aberto:

   Texto do diálogo

   Excluir Agente
   Você tem certeza de que deseja excluir o agente agentName?

   Por favor, digite "DELETE" para confirmar.

4. Para continuar a ação, insira a palavra DELETE onde indicado e clique no botão Excluir.

Gerenciar plugins

Para gerenciar os plugins de um grupo de agentes privados, siga estas etapas:

1. Abra o painel Detalhes do grupo de agentes para um grupo de agentes privados.

2. No painel Detalhes do grupo de agentes, selecione a aba Plugins:

   

Para associar ou desassociar plugins com o grupo de agentes privados selecionado, use o interruptor na coluna Associação.

Para ir para a entrada do plugin na página Plugins do Console de Gerenciamento, passe o mouse sobre a coluna Ações e clique no ícone Ir para plugin.

Ver associações de ambiente

Para ver com quais ambientes o agente privado está associado, siga estas etapas:

1. Abra o painel Detalhes do grupo de agentes para um grupo de agentes privados.

2. No painel Detalhes do grupo de agentes, selecione a aba Ambientes:

   

Para alterar o status de associação, passe o mouse sobre a coluna Ações e clique no ícone Ir para o ambiente. A página Ambientes do Console de Gerenciamento é aberta para o ambiente.

Gerenciar configurações do agente

Se o grupo de agentes privados selecionado tiver agentes privados ativos, você pode configurar remotamente todos os agentes em um grupo sem precisar fazer login em cada host de agente individual. Para fazer isso, você deve atender a estas condições:

• Deve haver pelo menos um agente privado no grupo que tenha um status de Executando.

• Você deve habilitar a configuração remota de agentes na aba Gerenciamento de Agentes da Organizações.

Quando essas condições forem atendidas, as abas Configuração do Jitterbit e Drivers de Banco de Dados também estarão visíveis no painel Detalhes do grupo de agentes.

Configuração do Jitterbit

Para gerenciar a configuração de um grupo de agentes privados, siga estas etapas:

1. Abra o painel Detalhes do grupo de agentes para o grupo de agentes privados que você deseja configurar.

2. No painel Detalhes do grupo de agentes, selecione a aba Configuração do Jitterbit:

   

A aba Configuração do Jitterbit reproduz o arquivo padrão de agente privado jitterbit.conf em forma de tabela. Entre a barra de abas e a tabela, há uma barra de ferramentas com os seguintes controles:

• Pesquisar: Pesquise itens de configuração por seção, status habilitado, chave, valor ou descrição.

• Redefinir para o padrão: Redefina a configuração de todos os agentes no grupo para seus valores padrão. Para fazer isso, siga estas etapas:

  1. Clique no ícone.

  2. Leia as informações na caixa de diálogo Redefinir configuração para o padrão.

  3. Digite a palavra RESET onde indicado, e clique no botão Reset.

  Dica

  Os valores padrão para cada chave são exibidos em dicas de ferramenta na coluna Value.

• Atualizar: Atualiza a tabela.

• Editar configuração: Edite os itens de configuração para todos os agentes no grupo. Para fazer isso, siga estas etapas:

  1. Clique no ícone.

  2. Leia as informações na caixa de diálogo Edit Jitterbit Configuration, e clique no botão Continue.

  3. Faça alterações nos itens de configuração, e clique no ícone Save.

  4. Leia novamente as informações na caixa de diálogo Edit Jitterbit Config, e clique no botão Save.

• Adicionar configuração: Adicione um item de configuração para todos os agentes no grupo. Para fazer isso, siga estas etapas:

  1. Clique no ícone.

  2. Leia as informações na caixa de diálogo Add a new Jitterbit Configuration, e clique no botão Continue.

  3. Uma nova linha aparece na tabela. Defina os valores para Section, Key, e Value, ative ou desative o interruptor Enabled, e clique no ícone Save.

  4. Leia novamente as informações na caixa de diálogo Add a new Jitterbit Configuration, e clique no botão Save.

Gerenciar drivers de banco de dados

Para gerenciar os drivers de banco de dados de um grupo de agentes privados, siga estas etapas:

1. Abra o painel Agent group details para um grupo de agentes privados.

2. No painel Agent group details, selecione a aba Database drivers:

   

A aba Database drivers contém um campo de texto com o conteúdo da seção [DbDrivers] do arquivo jitterbit.conf.

Para editar a configuração do driver de banco de dados para todos os agentes no grupo, siga estas etapas:

1. Clique no ícone Editar.

2. Leia as informações na caixa de diálogo Editar Driver de Banco de Dados, em seguida, clique no botão Continuar.

3. Edite o arquivo, em seguida, clique no ícone Salvar.

4. Leia novamente as informações na caixa de diálogo Editar Driver de Banco de Dados, em seguida, clique no botão Salvar.