Programas de utilidad en agentes privados de Jitterbit

Introducción

Esta página describe los siguientes programas de utilidad incluidos con el paquete de instalación del agente privado:

jitterbit: Una herramienta de operaciones y gestión de propósito general, utilizada para detener y iniciar servicios de agentes privados.
jitterbit-config: Una utilidad de configuración del agente privado, utilizada para configurar la conexión del agente privado a Harmony y la base de datos interna del agente privado.
jitterbit-utils: Un script envoltorio de conveniencia para jitterbit, utilizado para operaciones generales y tareas de configuración.

Estos se encuentran en las siguientes ubicaciones en cada plataforma:

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

`jitterbit`

Esta es una herramienta de operaciones y gestión de propósito general, utilizada para detener y iniciar servicios de agentes privados.

No está disponible en Microsoft Windows. Utilice el menú Inicio para detener e iniciar los servicios del agente.

Uso

jitterbit COMMAND [OPTIONS]

Comandos

Categoría	Comando	Descripción
Operaciones del agente	`start`	Iniciar todos los servicios del agente privado.
	`stop`	Detener todos los servicios del agente privado.
	`restart`	Reiniciar todos los servicios del agente privado.
	`status`	Mostrar el estado del Motor de Procesos, el Programador y los procesos del servicio de Limpieza.
Operaciones del servicio	`start_apache`	Iniciar el servicio de Apache.
	`stop_apache`	Detener el servicio de Apache.
	`start_tomcat`	Iniciar el servicio de Tomcat.
	`stop_tomcat`	Detener el servicio de Tomcat.
	`start_pgsql`	Iniciar el servidor PostgreSQL incluido.
	`stop_pgsql`	Detener el servidor PostgreSQL incluido.
	`start_pgbouncer`	Iniciar el servidor PgBouncer incluido.
	`stop_pgbouncer`	Detener el servidor PgBouncer incluido.
	`start_scheduler`	Iniciar el servicio del Programador.
	`stop_scheduler`	Detener el servicio del Programador.
	`start_verboselogshipper`	Iniciar el servicio VerboseLogShipper.
	`stop_verboselogshipper`	Detener el servicio VerboseLogShipper.
	`start_processengine`	Iniciar el servicio del Motor de Procesos.
	`stop_processengine`	Detener el servicio del Motor de Procesos.
	`start_cleanup`	Iniciar el servicio de limpieza de archivos.
	`stop_cleanup`	Detener el servicio de limpieza de archivos.
	`start_metrics`	Iniciar el servicio de [observabilidad nativa]
	`stop_metrics`	Detener el servicio de [observabilidad nativa].
	`status_metrics`	Verificar el estado del servicio de [observabilidad nativa].
Utilidades	`utils OPTIONS`	Llama y pasa `OPTIONS` a `JitterbitUtils`.
	`gen_server_cert`	Generar un nuevo certificado de servidor si no está instalado.
	`initdb`	Inicializar un nuevo clúster de base de datos incluido. Fuerza una sincronización completa de todos los proyectos desplegados y elimina todos los entornos actuales del agente.
Información	`top`	Mostrar los procesos principales que se ejecutan como el usuario `jitterbit`.
	`version`	Imprimir la versión y la fecha de construcción del Motor de Procesos.
	`help`	Mostrar ayuda.

`jitterbit-config`

Esta es una utilidad de configuración del agente privado, utilizada para configurar la conexión del agente privado a Harmony y la base de datos interna del agente privado.

No está disponible en Microsoft Windows.

Uso

jitterbit-config [OPTIONS]

Opciones

Categoría	Opción Corta	Opción Larga	Valor por Defecto	Descripción
Harmony	`-l`	`--login-url`	`https://login.jitterbit.com`	URL de inicio de sesión de Harmony.
	`-U`	`--user`		Tu nombre de usuario de Harmony.
	`-P`	`--password`		Tu contraseña de Harmony.
	`-f`	`--credentials-file`		Archivo desde el cual leer el archivo de credenciales de Harmony.
	`--xh`	`--proxy-host`		Host y puerto del servidor proxy en el formato `hostname:port`.
	`--xu`	`--proxy-user`		Nombre de usuario del servidor proxy si tu proxy requiere autorización.
	`--xp`	`--proxy-password`		Contraseña del servidor proxy si tu proxy requiere autorización.
	`--xn`	`--proxy-ntlm-domain`		Dominio del servidor proxy si estás utilizando un proxy NTLM.
	`--xc`	`--no-verify-proxy-cert`	`false`	No verificar certificados proxy. (No recomendado.)
	`-o`	`--organization`		Organización para configurar el agente.
	`-g`	`--agent-group`		Nombre del grupo de agentes que deseas configurar.
	`-a`	`--agent`		Nombre del agente que deseas configurar.
Base de Datos	`-c`	`--configure-postgres`	`false`	Configurar una instancia de PostgreSQL para servir como el almacén de datos de backend.
	`-u`	`--unattended`	`false`	No solicitar nada excepto la contraseña de administrador de PostgreSQL (a menos que se especifique con la opción `-w`). Se utilizan valores predeterminados para las opciones no especificadas.
	`-s`	`--server`	`127.0.0.1`	Nombre o dirección IP del servidor PostgreSQL.
	`-p`	`--port`	`5432`	Puerto en el que PostgreSQL está escuchando.
	`-d`	`--driver`	`PostreSQL-jitterbit`	Controlador ODBC de PostgreSQL a utilizar.
	`-m`	`--db-admin-user`	`postgres`	Nombre del usuario administrativo de PostgreSQL.
	`-w`	`--db-password`		Contraseña para el usuario administrativo de PostgreSQL. Esta opción es obligatoria y se te pedirá si no se especifica.
	`-t`	`--update`	`false`	Actualiza la base de datos de backend a la versión instalada de Jitterbit en lugar de crearla.
Otros	`-q`	`--quiet`	`false`	No solicitar entrada si solo hay una opción disponible. No imprimir información innecesaria en la terminal.
	`-k`	`--skip-metrics-config`		No configurar automáticamente las métricas de Jitterbit.
		`--bundledb`	`false`	Opción interna para uso del soporte de Jitterbit.

Ejemplos

Configura una instancia local de PostgreSQL que se ejecute en el puerto predeterminado con el usuario administrativo postgres y la contraseña PASSWORD:
```
jitterbit-config -c -u -w PASSWORD
```
Utiliza una instancia remota de PostgreSQL que se ejecute en el puerto 5433. Se te pedirá el nombre de usuario y la contraseña del servidor PostgreSQL, que debe estar configurado para aceptar conexiones remotas:
```
jitterbit-config -c --unattended --server 192.168.1.102 --port 5433
```

Reconfigura un agente privado:

jitterbit-config -U USERNAME -P PASSWORD -l https://REGION.jitterbit.com -o ORG_NAME -g GROUP_NAME -a AGENT_NAME

Valor	Reemplazar con	Ejemplo
`REGION`	La región de tu cuenta de Harmony (`na-east`, `emea-west` o `apac-southeast`).	`https://na-east.jitterbit.com`
`USERNAME`	Tu nombre de usuario de la cuenta de Harmony.	`my.name@example.com`
`PASSWORD`	Tu contraseña de la cuenta de Harmony.	`P@55w0rd`
`GROUP_NAME`	El nombre del grupo de agentes y el nombre del entorno, separados por un guion bajo.	`My Agent Group_Default Environment`
`AGENT_NAME`	El nombre del agente.	`My Agent 1`
`ORG_NAME`	El nombre de tu organización en Harmony.	`My Org`

`jitterbit-utils`

Este es un script envoltorio de conveniencia para jitterbit, utilizado para operaciones generales y tareas de configuración. El script llama a jitterbit utils OPTIONS, que a su vez llama a JitterbitUtils.

Uso

WindowsDocker/Linux

JitterbitUtils.exe [OPTIONS]

jitterbit-utils [OPTIONS]

Options

Tipo	Opción	Descripción
General	`--quiet`	No mostrar nada excepto mensajes de error fatales.
General	`--help`	Mostrar ayuda.
Mantenimiento	`--restore-db DB DIR`	Restaurar la base de datos `DB` desde archivos en el directorio `DIR`.
	`--backup-db DB DIR`	Hacer una copia de seguridad de la base de datos `DB` en el directorio `DIR`.
	`--vacuum-db [DB]`	Limpiar la base de datos `DB`. Si `DB` es `all` o está en blanco, se limpian todas las bases de datos.
	`--reindex-db [DB]`	Reindexar la base de datos `DB`. Si `DB` es `all` o está en blanco, se reindexan todas las bases de datos.
	`--reclaim-disk-space`	Recuperar agresivamente el espacio en disco utilizado por el backend. Las tablas de archivo se truncan y todas las tablas se limpian.
Proxy	`--set-http-proxy-host HOSTNAME[:PORT]`	Nombre del host del servidor proxy HTTP y puerto opcional.
	`--set-http-proxy-username USERNAME`	Nombre de usuario del servidor proxy HTTP.
	`--set-http-proxy-pwd PASSWORD`	Contraseña del servidor proxy HTTP.
	`--set-http-proxy-domain NTLM_DOMAIN`	Dominio NTLM del servidor proxy HTTP.
	`--verify-proxy-cert`	(Predeterminado) Verificar certificados del proxy. Desactivar con `--no-verify-proxy-cert`.
	`--no-verify-proxy-cert`	No verificar certificados del proxy. Utilizar esto si su proxy usa un certificado que Jitterbit no puede verificar.
	`--negotiate-ntlm-proxy-authentication`	Negociar autenticación NTLM del proxy. El valor predeterminado es desactivado, lo que es más rápido. Habilitar solo si el valor predeterminado causa problemas.
	`--set-http-proxy-inclusions INCLUSIONS`	Lista separada por comas de nombres de host para los cuales se debe utilizar la configuración del proxy. Se admiten comodines (`*` y `?`). Incompatible con `--set-http-proxy-exceptions`.
	`--set-http-proxy-exceptions EXCEPTIONS`	Lista separada por comas de nombres de host para los cuales no se debe utilizar la configuración del proxy. Se admiten comodines (`*` y `?`). Incompatible con `--set-http-proxy-inclusions`.
	`--disable-http-proxy`	Desactivar la configuración del proxy HTTP.
	`--print-http-proxy-configuration`	Imprimir la configuración del proxy HTTP.
Operaciones	`--drain-stop`	Activar una detención de drenaje del agente. Las operaciones en curso pueden completarse; no se aceptan nuevos trabajos.
	`--drain-pause`	Activar una pausa de drenaje del agente. Se permitirá que las operaciones en curso se completen, pero no se aceptarán nuevos trabajos.
	`--list-operations`	Listar todas las operaciones.
	`--list-operations --project PROJECT --environment ENVIRONMENT`	Listar operaciones para `PROJECT` y `ENVIRONMENT` (como nombres).
	`--run-scheduled-operations`	Agregar todas las operaciones programadas a la cola de procesos.
	`--add-operation-to-queue OPERATION`	Agregar `OPERATION` (como nombre, GUID o ID de base de datos) a la cola de procesos. No recomendado. Ignora los límites de tasa y otras verificaciones del agente.
	`--add-operation-to-queue OPERATION --project PROJECT --environment ENVIRONMENT`	Agregar `OPERATION` para `PROJECT` y `ENVIRONMENT` (como nombres) a la cola de procesos. No recomendado. Ignora los límites de tasa y otras verificaciones del agente.
	`--send-command MODULE COMMAND`	Enviar `COMMAND` a `MODULE`.
Utilidad	`--encrypt-credentials USERNAME PASSWORD`	Cifrar `USERNAME` y `PASSWORD` y mostrar en dos líneas.
	`-e USERNAME PASSWORD`	Forma corta de `--encrypt-credentials`.
	`--resync-environment ENVIRONMENT`	Activar una re-sincronización de `ENVIRONMENT` (nombre).