Programas de utilidad en agentes privados de Jitterbit

Introducción

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

jitterbit: Una herramienta de operaciones y gestión de propósito general, utilizada para detener e 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 e iniciar servicios de agentes privados.

No está disponible en Microsoft Windows. Utilice el menú Inicio para detener e iniciar servicios de agentes.

Uso

jitterbit COMMAND [OPTIONS]

Comandos

Cambio en la sintaxis del comando en la versión 11.54

En la versión 11.54 del agente privado, hubo un cambio en la sintaxis del comando que reemplazó los guiones bajos por espacios en todos los comandos de la categoría de operaciones de servicio.

Categoría	Comando (11.53 y anteriores)	Comando (11.54 y posteriores)	Descripción
Operaciones de 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.
	`details`			Mostrar detalles del Motor de Procesos.
	`details_all`			Mostrar todos los detalles del Motor de Procesos.
Operaciones de Servicio	`start_apache`	`start apache`	Iniciar el servicio Apache.
	`stop_apache`	`stop apache`	Detener el servicio Apache.
	`reload_apache`	`reload apache`	Recargar el servicio Apache. (Solo disponible en agentes Docker y Linux.)
	`start_tomcat`	`start tomcat`	Iniciar el servicio Tomcat.
	`stop_tomcat`	`stop tomcat`	Detener el servicio Tomcat.
	`start_pgsql`	`start pgsql`	Iniciar el servidor PostgreSQL incluido.
	`stop_pgsql`	`stop pgsql`	Detener el servidor PostgreSQL incluido.
	`start_pgbouncer`	`start pgbouncer`	Iniciar el servidor PgBouncer incluido.
	`stop_pgbouncer`	`stop pgbouncer`	Detener el servidor PgBouncer incluido.
	`start_scheduler`	`start scheduler`	Iniciar el servicio del Programador.
	`stop_scheduler`	`stop scheduler`	Detener el servicio del Programador.
	`start_verboselogshipper`	`start verboselogshipper`	Iniciar el servicio VerboseLogShipper.
	`stop_verboselogshipper`	`stop verboselogshipper`	Detener el servicio VerboseLogShipper.
	`start_processengine`	`start processengine`	Iniciar el servicio del Motor de Procesos.
	`stop_processengine`	`stop processengine`	Detener el servicio del Motor de Procesos.
	`start_cleanup`	`start cleanup`	Iniciar el servicio de limpieza de archivos.
	`stop_cleanup`	`stop cleanup`	Detener el servicio de limpieza de archivos.
	`start_metrics`	`start metrics`	Iniciar el servicio de [observabilidad nativa] .
	`stop_metrics`	`stop metrics`	Detener el servicio de [observabilidad nativa] .
	`status_metrics`	`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á ya 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 de 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`	(Por defecto) Verificar certificados del proxy. Desactivar con `--no-verify-proxy-cert`.
	`--no-verify-proxy-cert`	No verificar certificados del proxy. Utilizar esto si su proxy utiliza un certificado que Jitterbit no puede verificar.
	`--negotiate-ntlm-proxy-authentication`	Negociar autenticación de proxy NTLM. Por defecto está desactivado, lo que es más rápido. Activar 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 ejecución pueden completarse; no se aceptan nuevos trabajos.
	`--drain-pause`	Activar una pausa de drenaje del agente. Se permitirá que las operaciones en ejecución 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. Elimina 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. Elimina 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).