Guía de Referencia AFT

El directorio desde el que los archivos serán extraídos (en configuraciones agent-src) o hacia donde los archivos serán enviados (en configuraciones agent-dst.)

Un comando a ser ejecutado mediante la facilidad ProcessBuilder de Java, después de que cada archivo es transferido hacia/desde el agente. el nombre del archivo es proporcionado al comando. Si la ejecución falla, se registra en el log, pero el proceso de transferencia continua.

Un patrón de reemplazo para renombrar archivos que son transferidos (válido para [agent-dst].) La sintaxis es rename-destination=search-pattern⇒replacement-pattern. El search-pattern (patrón de búsqueda) se implementa mediante el método de Java Matcher#matches(), mientras que el replacement-patterns (patrón de reemplazo) lo hace mediante el el método de Java Matcher#replaceAll(). Es posible declarar directivas rename-destination más de una vez en la configuración de la transferencia, posibilitando distintos tipos de reemplazo.

El hostname del hub, o su dirección IP.

El número de puerto de escucha el hub.

Cuándo conectarse al hub para transferir archivos pendientes. Puede tomar la forma form delay:# para un tiempo fijo de reintentos especificando una cantidad de segundos; cron:expr donde expr es una expresión crontab; none (no intentar conectar; el hub iniciará la conexión (comportamiento por omisión.) Finalmente once significa intentar la conexión, hacer el trabajo, y terminar el proceso AFT.

Nombre de host o dirección IP del "agente fuente" a donde el hub intentará extraer archivos. Válido para los modos "GET" y "A2A". Si no está presente se asume que el agente fuente iniciará la conexión.

Número de puerto de el agente fuente a fin de establecer la comunicación.

Directorio de destino final para los archivos en el hub. Válido sólo para transferencias GET. AFT no crea ese directorio por lo que debe ser creado por el usuario.

Nombre de host o dirección IP del "agente destinatario" a donde el hub intentará enviar archivos. Válido para los modos "PUT" y "A2A". Si no está presente, entonces se asume que el agente destinatario iniciará la conexión.

Número de puerto de el agente destinatario a fin de establecer la comunicación.

Directorio desde donde los archivos serán extraídos. Sólo válido para transferencias en modo PUT.

Directorio en el computador hub para almacenamiento temporal (encolamiento) de los archivos extraídos previamente a ser enviados a su destino final. Válido sólo para el modo "A2A". El directorio debe existir (AFT no lo crea) y debe permitir la creación de archivos. Los directorios de encolamiento no pueden ser compartidos por dos o más transferencias configuradas.

Cuando un archivo va a ser leído, AFT verifica su hora de modificación para evitar la transmisión de un archivo incompleto que está siendo escrito. Esta directiva configura la "antigüedad" (en segundos) que debe tener el archivo para garantizar razonablemente el término del proceso de escritura. Cuando el archivo es "muy nuevo" entonces se realizará otro intento tras un número de segundos definido en la directiva op-timeout-seconds. Un valor cero deshabilita esta verificación. Sólo es válido para el modo "PUT".

Cuántas veces reintentar la extracción si el archivo es "muy nuevo" en función del valor de no-change-check-seconds.

Cuándo conectarse al "agente fuente" para extraer archivos pendientes. Puede tomar las formas delay:#, cron:expr y none, siguiendo la explicación de la directiva hub-connect-check.

Qué archivos serán extraídos y transferidos. Los formatos válidos son all, list:name,…​, ereg:expr, y tereg:expr; por omisión es all (todos los archivos en el directorio.) El modo list permite una lista de archivos separada por comas conteniendo los nombres de archivos a extraer; el modo ereg es usado para especificar una expresión regular a fin de indicar los nombres de los archivos de interés. Finalmente, el modo tereg es un proceso en dos pasos donde las subexpresiones encerradas entre %…​% se usan como formateadores de la clase Java SimpleDateFormat con la fecha y hora actual (a fin de construir un patrón generado en función del tiempo) y finalmente el resultado se usa como expresión regular (como en el caso ereg.) Dos signos de porcentaje consecutivo se usan para generar un único signo de porcentaje.

Indica si se debe transferir los archivos del directorio de origen conjuntamente con el contenido de sus subdirectorios. Por omisión es false. Esta es una directiva experimental por lo que debe ser utilizada con cuidado.

Cuándo intentar conectar para enviar archivos a un agente destinatario. Ver src-connect-check para su sintaxis.

En modo A2A, si se debe intentar conectar al agente de destino inmediatamente tras la extracción del agente fuente, adicionalmente al régimen programado en dst-connect-check. Fijar a true o false. Por omisión es false.

Tras una extracción exitosa de un archivo desde un agente fuente, se puede ejecutar un comando con esta directva. El nombre de archivo es proporcionado como único argumento. Válido para los modos "GET" y "A2A".

Similar al anterior pero para archivos recién enviados a su destino. Válido para modos "PUT" y "A2A".

Qué hacer con el archivo fuente tras su transferencia exitosa. Las opciones válidas son remove (eliminar), truncate (eliminar contenido pero el archivo permanece vacío), y none (no hacer nada); por omisión es remove.

Modo de operación de la compresión. Los modos válidos son:

Un entero en el rango 1-9, señalando 1=mejor velocidad, 9=mejor compresión. Por omisión es 1.

Las opciones válidas son simple y tmp. El modo simple simplemente abre el archivo para escritura con su nombre de archivo correspondiente y graba los datos en tanto éstos son transferidos. El modo tmp abre un archivo temporal (en el mismo directorio de destino) y sólo cuando todos el contenido ha sido transferido, renombra el temporal al nombre final. Por omisión es simple.

El timeout para las respuestas del agente. Por omisión es 15 segundos. En redes muy congestionadas este parámetro puede requerir ser incrementado.

Válido para [hub-get]. Mismo comportamiento que en el caso [agent-dst].

El tamaño del buffer de lectura de archivos en bytes. Por omisión es 131072 (128 kilobytes.) La calibración de este parámetro puede incrementar la tasa de transferencia en algunas infraestructuras de red (el usuario debe realizar las pruebas correspondientes.)