Introducción a Nimble Studio File Transfer

En este tutorial, se muestra cómo instalar y configurar File Transfer. Antes de comenzar con los siguientes pasos, asegúrese de que el administrador haya completado el tutorial Configuración de Nimble Studio File Transfer.

Si encuentra algún problema al seguir este tutorial, consulte la página Soporte para Nimble Studio File Transfer.

Requisitos previos

Complete la sección Configuración de Nimble Studio File Transfer antes de instalar y configurar File Transfer.

Configuración del hardware

Para poder utilizar File Transfer, le recomendamos que su equipo cumpla los siguientes requisitos: Para obtener más información acerca de cómo aumentar la velocidad de las transferencias, consulte Optimización del rendimiento.

• 8 núcleos lógicos de CPU

• 8 GB de RAM

Las velocidades de transferencia dependen del hardware, de la configuración de la red y del ancho de banda. File Transfer puede transferir archivos según lo permitan la red y el hardware. Por ejemplo, si a su equipo se le ha asignado un ancho de banda de la red de 500 Mbps, la velocidad máxima a la que File Transfer puede intentar completar las transferencias es de 500 Mbps.

Paso 1: Instalar File Transfer

El instalador de File Transfer le guiará a través del proceso de configuración y configurará los subprocesos y el tamaño de los fragmentos correctos en función de sus equipos.

Descargue e instale el cliente de Nimble Studio File Transfer desde Clientes de File Transfer.

Paso 2: Configurar File Transfer

Con File Transfer, puede utilizar la interfaz gráfica de usuario (GUI) o la interfaz de la línea de comandos (CLI). Si utiliza un sistema operativo (SO) con escritorio, puede configurar File Transfer en la GUI. Si no utiliza un sistema operativo con escritorio, puede utilizar la CLI de File Transfer para configurar y ejecutar File Transfer. La CLI proporciona más flexibilidad para el uso de File Transfer.

GUI

Para poder transferir archivos con File Transfer, antes debe agregar una configuración remota. Las configuraciones remotas se tratan como configuraciones diferentes que pueden utilizarse para transferir archivos a distintos buckets y directorios.

Para agregar una configuración remota

1. Elija Crear una configuración remota en la ventana del explorador de archivos Bucket de S3 de la GUI.

2. En la sección Agregar configuración remota, escriba la siguiente información:

   1. En Nombre de la configuración remota, escriba un nombre para esta. El nombre no se puede modificar una vez establecido.

   2. En Bucket de S3, escriba el nombre del bucket de S3 que quiere utilizar para File Transfer. Para crear un bucket de S3, consulte Creación de un bucket de S3.

   3. En Región de AWS, escriba la región en la que está ubicado el bucket de S3.

   4. En Perfil con nombre de AWS, escriba un perfil con nombre de AWS para usarlo en el acceso a S3. Si opta por usar una clave de acceso de AWS o una clave secreta de AWS en su lugar, deje este campo en blanco. Si no tiene un perfil con nombre de AWS, consulte los temas Creación de una política de acceso de IAM y Configure el AWS CLI.

3. Elija Agregar para continuar.

4. Escriba la siguiente información en la sección Avanzado:

   1. El valor Clase de almacenamiento especifica la clase de almacenamiento del bucket de S3. Para obtener información acerca de las clases de almacenamiento, consulte Clases de almacenamiento de Amazon S3.

   2. El valor Algoritmo de suma de comprobación especifica qué algoritmo de este tipo se usa para los cálculos de la suma de comprobación.

   3. (Opcional) Directorio local especifica el directorio predeterminado de la máquina local.

   4. (Opcional) Prefijo del bucket de S3 especifica el directorio predeterminado del bucket de S3.

   5. Filtro especifica un filtro para los archivos en función del formato. Este campo acepta expresiones regulares válidas. Por ejemplo, "^.*\.(mov)$" solo carga archivos que terminan en .mov.

   6. Antigüedad máxima limita File Transfer a los archivos creados o modificados después del valor temporal de Max Age y antes del momento actual. Las unidades se expresan como m (minutos), h (horas), d (días) y w (semanas). Si no se proporciona ninguna unidad, el valor se especifica en segundos. Por ejemplo, una entrada de 5d transfiere los archivos creados o modificados en los últimos cinco días. Una entrada de 350 transfiere los archivos creados o modificados en los últimos 350 segundos.

   7. (Opcional) Lista de orden de archivos establece la prioridad de transferencia por extensión de archivo. Especifique una extensión para agregarla a la lista. Los archivos con extensiones no incluidas en la lista son los de menor prioridad y se transfieren en el orden en el que aparecen en el sistema de archivos.

      

   8. Cuando está habilitada, la opción Ajuste automático de transferencias establece de forma dinámica el número de subprocesos y el tamaño de los fragmentos para las transferencias de archivos. Esto está habilitado de forma predeterminada. Recomendamos que mantenga esta opción habilitada.

      Número de subprocesos

      Número de subprocesos individuales que se utilizan para transferir cada archivo individual.

      Tamaño del fragmento

      Tamaño del fragmento (en megabytes) que proporciona cada subproceso.

   9. Cuando está habilitada la opción Usar la aceleración de transferencias de S3, se mejora la velocidad de transferencia de los archivos de gran tamaño. Se recomienda mantener desactivada la opción Aceleración de transferencias de S3, ya que no es necesaria para lograr transferencias de alta velocidad en File Transfer. Active esta característica si el bucket está geográficamente lejos de usted. Para obtener más información, consulte Aceleración de transferencias de S3. Si está habilitada, puede que se apliquen cargos adicionales. Para obtener más información, consulte Precios de Amazon S3.

   10. Habilitar filtro de metadatos filtra los archivos de metadatos del sistema de forma automática si está habilitada. Entre estos archivos se incluyen los que empiezan por ._, así como los archivos thumbs.db y .DS_Store.

5. Seleccione Save.

Para añadir un ID de estudio

1. Abra File Transfer.

   1. Vaya al menú Inicio y busque File Transfer.

   2. Seleccione Nimble Studio File Transfer en la lista.

2. En el menú desplegable ( ), elija Configuración.

3. Introduzca el ID de estudio que encontró en el tutorial Configuración de un estudio en Nimble Studio.

4. Elija Guardar.

CLI

Ahora que File Transfer está instalado, edite el archivo de configuración.

Para editar el archivo de configuración

1. Abra el archivo de configuración con cualquier software de edición de texto de su equipo.

   1. Windows: vaya a la carpeta User/<your username> de su equipo. Abra la carpeta .filetransfer y luego abra el archivo filetransfer.yaml en un editor de texto.

   2. macOS: introduzca Cmd+Shift+G. Luego introduzca ~/.filetransfer. Abra el archivo filetransfer.yaml en un editor de texto.

   3. Linux: abra el archivo filetransfer.yaml con cualquier editor de texto. El archivo se encuentra en ~/.filetransfer/configuration.yaml.

2. Defina las siguientes variables en el archivo de configuración. Los valores requeridos están rellenados. Debe proporcionar los valores opcionales.

   1. studio_id: introduzca el ID de estudio que encontró en el tutorial Configuración de un estudio en Nimble Studio.

   2. max_active_checksums: introduzca el número de sumas de control individuales que se procesan al mismo tiempo. Si este valor supera el número de núcleos de CPU disponibles en el sistema, aparece un mensaje de advertencia y el valor se limita al número de núcleos de CPU. Para obtener más información, consulte Sumas de comprobación de File Transfer.

   3. max_active_transfers: introduzca el número de archivos individuales que se procesan al mismo tiempo.

3. Defina al menos una configuración remota en el archivo de configuración. Los valores requeridos para la configuración remota no se han rellenado, por lo que debe especificarlos de forma manual. Defina las siguientes variables para cada configuración remota.

   protocols:
       s3:
           remote_configuration:
               demo:
                   name: demo
                   bucket: my-bucket
                   region: us-west-2
                   profile: my-profile
                   storage_class: standard
                   auto_tuning: true
                   chunk_size: 25
                   threads: 10
                   checksum_algorithm: md5_hex
                   max_age: ""
                   accelerated: false
                   file_order: []
                   filter: ""
                   upload_hot_folder:
                       enabled: false
                       local_source_folder: ""
                       s3_destination_folder: ""
                   enable_metadata_filter: true
                   paths:
                       local: ""
                       remote: ""

4. name: introduzca un nombre para el perfil de transferencia.

5. bucket: introduzca el nombre del bucket de S3 en el que desea realizar las cargas y descargas. El administrador debería haber creado el bucket en Creación de un bucket de S3.

6. region: introduzca la Región de AWS en la que se encuentra el bucket.

7. profile: introduzca el nombre del perfil que el administrador creó en el paso 4 de Configure el AWS CLI. Este perfil le permite acceder a Amazon Simple Storage Service (Amazon S3). Para obtener una lista de los perfiles configurados, ejecute el siguiente comando en una ventana de terminal: aws configure list

8. storage_class: de forma predeterminada, se establece en standard. Los valores aceptados para esta variable son los siguientes:

   • reduced_redundancy

   • standard_ia

   • onezone_ia

   • intelligent_tiering

   • glacier

   • deep_archive

   • glacier_ir

   nota

   Puede cargar archivos directamente en cualquier clase de almacenamiento de Amazon S3. Si utiliza S3 Glacier Deep Archive o S3 Glacier Flexible Retrieval, no podrá descargar los objetos que haya cargado con File Transfer directamente desde File Transfer. Para obtener más información sobre las clases de almacenamiento, consulte Clases de almacenamiento de Amazon S3.

9. auto_tuning: ajusta automáticamente el tamaño del fragmento y el número máximo de transferencias activas en función del tamaño del archivo. De forma predeterminada, se establece en true.

10. chunk_size: introduzca el tamaño del fragmento (en MB) que entrega cada subproceso. Este campo no es obligatorio si auto_tuning está establecido en true.

11. threads: introduzca el número de subprocesos individuales que se utilizan para transferir cada archivo individual. Este campo no es obligatorio si auto_tuning está establecido en true.

12. checksum_algorithm: este es el algoritmo de suma de comprobación que se utilizará al cargar los archivos en S3. Puede elegir md5-hex (el valor predeterminado), xxhash, xxhash64 y xxh3 checksum algorithms.

13. (Opcional) Max Age: limita File Transfer a los archivos creados o modificados después del valor de temporal de Max Age y antes del momento actual. Las unidades se expresan como m (minutos), h (horas), d (días) y w (semanas). Si no se proporciona ninguna unidad, el valor se especifica en segundos. Por ejemplo, una entrada de 5d transfiere los archivos creados o modificados en los últimos cinco días. Una entrada de 350 transfiere los archivos creados o modificados en los últimos 350 segundos.

14. accelerated: habilita la Aceleración de transferencias de S3. De forma predeterminada, este es false. Se recomienda mantener desactivada la opción Aceleración de transferencias de S3, ya que no es necesaria para lograr transferencias de alta velocidad en File Transfer. Active esta característica si el bucket está geográficamente lejos de usted. Para obtener más información, consulte Aceleración de transferencias de S3. Si está habilitada, puede que se apliquen cargos adicionales. Para obtener más información, consulte Precios de Amazon S3.

15. (Opcional) file_order: introduzca una lista de extensiones de archivo separadas por comas para definir la prioridad de los archivos que se van a transferir. Las extensiones de archivo que no incluya en la lista se transferirán en último lugar en el orden en que el sistema de archivos las muestre. Por ejemplo, ".mov,.txt" da prioridad a la transferencia de archivos .mov sobre la de los archivos .txt.

16. (Opcional) filter: filtra los archivos que se transfieren en función del formato. El campo filter acepta expresiones regulares válidas. Por ejemplo, "^.*\.(mov)$" solo carga archivos que terminan en .mov

17. (Opcional) upload_hot_folder enabled: activa la funcionalidad de carpeta activa de carga.

18. (Opcional) upload_hot_folder local_source_folder: es necesario si la opción upload hot folder está habilitada. File Transfer supervisa recursivamente todos los eventos del sistema de archivos en la carpeta especificada e inicia las cargas cuando se agregan o se modifican archivos.

19. (Opcional) upload_hot_folder s3_destination_folder: es necesario cuando la opción upload hot folder está habilitada. Los archivos de carpetas activas que se cargan se agregan a esta carpeta.

20. enable_metadata_filter: cuando es true, File Transfer filtra los archivos de metadatos del sistema de forma automática. Estos archivos son Thumbs.db, .DS_Store y los archivos que comienzan por ._.

21. (Opcional) paths local: la carpeta raíz de los archivos de File Transfer en el sistema de archivos local.

22. (Opcional) paths remote: la carpeta raíz de los archivos de File Transfer en el bucket de S3.

23. (Opcional) paths local: introduzca una ruta de archivo. Las transferencias comenzarán en esa ruta local en el explorador de archivos del sistema de archivos local.

24. (Opcional) paths remote: introduzca una ruta de archivo. Las transferencias comenzarán en esa ruta en el explorador de archivos del bucket de S3.

25. Guarde el archivo de configuración.

26. Ejecute el comando siguiente para validar sus credenciales de AWS: filetransfer validate-credentials remote configuration

    1. Sustituya remote configuration por el nombre de la configuración que haya creado.

    2. Este comando comprueba las credenciales AWS proporcionados, como la clave de IAM. Este comando comprueba si File Transfer se puede conectar a Amazon S3 y muestra los objetos del bucket que se especifica en el archivo de configuración.

Tras completar la instalación y la configuración, ya está listo para usar File Transfer.