Ir para o conteúdo

Programas utilitários em agentes privados Jitterbit

Introdução

Esta página descreve os seguintes programas utilitários incluídos no pacote de instalação do agente privado:

  • jitterbit: Uma ferramenta de operações e gerenciamento de uso geral, utilizada para parar e iniciar serviços de agentes privados.

  • jitterbit-config: Um utilitário de configuração do agente privado, usado para configurar a conexão do agente privado com o Harmony e o banco de dados interno do agente privado.

  • jitterbit-utils: Um script de conveniência para jitterbit, utilizado para operações gerais e tarefas de configuração.

Estes podem ser encontrados nos seguintes locais em cada plataforma:

Plataforma Locais
Windows C:\Program Files\Jitterbit Agent\bin
C:\Program Files\Jitterbit Agent\jitterbit-agent-config-util
Linux, Docker /usr/bin, cada um vinculado a /opt/jitterbit/bin

jitterbit

Esta é uma ferramenta de operações e gerenciamento de uso geral, utilizada para parar e iniciar serviços de agentes privados.

Não está disponível no Microsoft Windows. Use o menu Iniciar para parar e iniciar os serviços do agente.

Uso

jitterbit COMMAND [OPTIONS]

Comandos

Mudança na sintaxe do comando na versão 11.54

Na versão 11.54 do agente privado, houve uma mudança na sintaxe do comando que substituiu os sublinhados por espaços em todos os comandos da categoria de operações de serviço.

Categoria Comando
(11.53 e anteriores)		 Comando
(11.54 e posteriores)		 Descrição
Operações
do Agente		 start Iniciar todos os serviços do agente privado.
stop Parar todos os serviços do agente privado.
restart Reiniciar todos os serviços do agente privado.
status Mostrar o status dos processos do Motor de Processos, Agendador e serviço de Limpeza.
details Mostrar detalhes do Motor de Processos.
details_all Mostrar todos os detalhes do Motor de Processos.
Operações
de Serviço		 start_apache start apache Iniciar o serviço Apache.
stop_apache stop apache Parar o serviço Apache.
reload_apache reload apache Recarregar o serviço Apache. (Disponível apenas em agentes Docker e Linux.)
start_tomcat start tomcat Iniciar o serviço Tomcat.
stop_tomcat stop tomcat Parar o serviço Tomcat.
start_pgsql start pgsql Iniciar o servidor PostgreSQL incluído.
stop_pgsql stop pgsql Parar o servidor PostgreSQL incluído.
start_pgbouncer start pgbouncer Iniciar o servidor PgBouncer incluído.
stop_pgbouncer stop pgbouncer Parar o servidor PgBouncer incluído.
start_scheduler start scheduler Iniciar o serviço Agendador.
stop_scheduler stop scheduler Parar o serviço Agendador.
start_verboselogshipper start verboselogshipper Iniciar o serviço VerboseLogShipper.
stop_verboselogshipper stop verboselogshipper Parar o serviço VerboseLogShipper.
start_processengine start processengine Iniciar o serviço Motor de Processos.
stop_processengine stop processengine Parar o serviço Motor de Processos.
start_cleanup start cleanup Iniciar o serviço de limpeza de arquivos.
stop_cleanup stop cleanup Parar o serviço de limpeza de arquivos.
start_metrics start metrics Iniciar o serviço de [observabilidade nativa].
stop_metrics stop metrics Parar o serviço de [observabilidade nativa].
status_metrics status metrics Verificar o status do serviço de [observabilidade nativa].
Utilitários utils OPTIONS Chama e passa OPTIONS para JitterbitUtils.
gen_server_cert Gerar um novo certificado de servidor se ainda não estiver instalado.
initdb Inicializar um novo cluster de banco de dados incluído. Força uma sincronização completa de todos os projetos implantados e remove todos os ambientes atuais do agente.
Informações top Mostrar os principais processos em execução como o usuário jitterbit.
version Imprimir a versão e a data de construção do Motor de Processos.
help Mostrar ajuda.

jitterbit-config

Esta é uma ferramenta de configuração de agente privado, usada para configurar a conexão do agente privado com o Harmony e o banco de dados interno do agente privado.

Não está disponível no Microsoft Windows.

Uso

jitterbit-config [OPÇÕES]

Opções

Categoria Opção Curta Opção Longa Valor Padrão Descrição
Harmony -l --login-url https://login.jitterbit.com URL de login do Harmony.
-U --user Seu nome de usuário do Harmony.
-P --password Sua senha do Harmony.
-f --credentials-file Arquivo para ler o arquivo de credenciais do Harmony.
--xh --proxy-host Host e porta do servidor proxy no formato hostname:port.
--xu --proxy-user Nome de usuário do servidor proxy se o seu proxy exigir autorização.
--xp --proxy-password Senha do servidor proxy se o seu proxy exigir autorização.
--xn --proxy-ntlm-domain Domínio do servidor proxy se você estiver usando um proxy NTLM.
--xc --no-verify-proxy-cert false Não verificar certificados de proxy. (Não recomendado.)
-o --organization Organização para configurar o agente.
-g --agent-group Nome do grupo de agentes que você deseja configurar.
-a --agent Nome do agente que você deseja configurar.
Banco de Dados -c --configure-postgres false Configurar uma instância PostgreSQL para servir como o armazenamento de dados de backend.
-u --unattended false Não solicitar nada, exceto a senha do administrador do PostgreSQL (a menos que especificado com a opção -w). Valores padrão são usados para opções não especificadas.
-s --server 127.0.0.1 Nome ou endereço IP do servidor PostgreSQL.
-p --port 5432 Porta na qual o PostgreSQL está escutando.
-d --driver PostreSQL-jitterbit Driver ODBC do PostgreSQL a ser usado.
-m --db-admin-user postgres Nome do usuário administrativo do PostgreSQL.
-w --db-password Senha para o usuário administrativo do PostgreSQL. Esta opção é obrigatória e você será solicitado a fornecê-la se não for especificada.
-t --update false Atualiza o banco de dados de backend para a versão instalada do Jitterbit em vez de criá-los.
Outros -q --quiet false Não solicitar entrada se houver apenas uma opção disponível. Não imprimir informações desnecessárias no terminal.
-k --skip-metrics-config Não configurar automaticamente as métricas do Jitterbit.
--bundledb false Opção interna para uso pelo suporte do Jitterbit.

Exemplos

  1. Configure uma instância local do PostgreSQL rodando na porta padrão com o usuário administrativo postgres e a senha PASSWORD:

    jitterbit-config -c -u -w PASSWORD

  2. Use uma instância remota do PostgreSQL rodando na porta 5433. Você será solicitado a informar o nome de usuário e a senha do servidor PostgreSQL, que deve ser configurado para aceitar conexões remotas:

    jitterbit-config -c --unattended --server 192.168.1.102 --port 5433

  3. Reconfigure um agente privado:

    jitterbit-config -U USERNAME -P PASSWORD -l https://REGION.jitterbit.com -o ORG_NAME -g GROUP_NAME -a AGENT_NAME
    Valor Substitua por Exemplo
    REGION A região da sua conta Harmony (na-east, emea-west ou apac-southeast). https://na-east.jitterbit.com
    USERNAME Seu nome de usuário da conta Harmony. my.name@example.com
    PASSWORD Sua senha da conta Harmony. P@55w0rd
    GROUP_NAME O nome do grupo de agentes e o nome do ambiente, separados por um sublinhado. My Agent Group_Default Environment
    AGENT_NAME O nome do agente. My Agent 1
    ORG_NAME O nome da sua organização Harmony. My Org

jitterbit-utils

Este é um script de conveniência para jitterbit, usado para operações gerais e tarefas de configuração. O script chama jitterbit utils OPTIONS, que por sua vez chama JitterbitUtils.

Uso

JitterbitUtils.exe [OPTIONS]

jitterbit-utils [OPTIONS]

Options

Tipo Opção Descrição
Geral --quiet Não exibir nada, exceto mensagens de erro fatais.
--help Mostrar ajuda.
Manutenção --restore-db DB DIR Restaurar o banco de dados DB a partir de arquivos no diretório DIR.
--backup-db DB DIR Fazer backup do banco de dados DB para o diretório DIR.
--vacuum-db [DB] Limpar o banco de dados DB. Se DB for all ou em branco, todos os bancos de dados serão limpos.
--reindex-db [DB] Reindexar o banco de dados DB. Se DB for all ou em branco, todos os bancos de dados serão reindexados.
--reclaim-disk-space Recuperar agressivamente o espaço em disco usado pelo backend. Tabelas de arquivo são truncadas e todas as tabelas são limpas.
Proxy --set-http-proxy-host HOSTNAME[:PORT] Nome do host do servidor proxy HTTP e porta opcional.
--set-http-proxy-username USERNAME Nome de usuário do servidor proxy HTTP.
--set-http-proxy-pwd PASSWORD Senha do servidor proxy HTTP.
--set-http-proxy-domain NTLM_DOMAIN Domínio NTLM do servidor proxy HTTP.
--verify-proxy-cert (Padrão) Verificar certificados do proxy. Desativar com --no-verify-proxy-cert.
--no-verify-proxy-cert Não verificar certificados do proxy. Use isso se seu proxy usar um certificado que o Jitterbit não consegue verificar.
--negotiate-ntlm-proxy-authentication Negociar autenticação NTLM do proxy. O padrão é desativado, o que é mais rápido. Ativar apenas se o padrão causar problemas.
--set-http-proxy-inclusions INCLUSIONS Lista separada por vírgulas de nomes de host para os quais a configuração do proxy deve ser usada. Caracteres curinga (* e ?) são suportados. Incompatível com --set-http-proxy-exceptions.
--set-http-proxy-exceptions EXCEPTIONS Lista separada por vírgulas de nomes de host para os quais a configuração do proxy não deve ser usada. Caracteres curinga (* e ?) são suportados. Incompatível com --set-http-proxy-inclusions.
--disable-http-proxy Desativar a configuração do proxy HTTP.
--print-http-proxy-configuration Imprimir configuração do proxy HTTP.
Operações --drain-stop Acionar uma parada de drenagem do agente. Operações em execução podem ser concluídas; novos trabalhos não serão aceitos.
--drain-pause Acionar uma pausa de drenagem do agente. Operações em execução poderão ser concluídas, mas novos trabalhos não serão aceitos.
--list-operations Listar todas as operações.
--list-operations --project PROJECT --environment ENVIRONMENT Listar operações para PROJECT e ENVIRONMENT (como nomes).
--run-scheduled-operations Adicionar todas as operações agendadas à fila de processos.
--add-operation-to-queue OPERATION Adicionar OPERATION (como nome, GUID ou ID do banco de dados) à fila de processos. Não recomendado. Ignora limites de taxa e outras verificações de agente.
--add-operation-to-queue OPERATION --project PROJECT --environment ENVIRONMENT Adicionar OPERATION para PROJECT e ENVIRONMENT (como nomes) à fila de processos. Não recomendado. Ignora limites de taxa e outras verificações de agente.
--send-command MODULE COMMAND Enviar COMMAND para MODULE.
Utilitário --encrypt-credentials USERNAME PASSWORD Criptografar USERNAME e PASSWORD e imprimir em duas linhas.
-e USERNAME PASSWORD Forma curta de --encrypt-credentials.
--resync-environment ENVIRONMENT Acionar uma re-sincronização de ENVIRONMENT (nome).