View a markdown version of this page

Solución de problemas de Nimble Studio File Transfer - Nimble Studio File Transfer
Generación de un archivo de soporteSolución de problemas de la GUISolución de problemas de la CLI

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solución de problemas de Nimble Studio File Transfer

Si tiene problemas al utilizar Nimble Studio File Transfer, consulte la siguiente información para resolverlos.

Le recomendamos que active el registro siguiendo las instrucciones de la sección Registro.

Generación de un archivo de soporte

Puede generar un archivo de soporte que le ayude a solucionar problemas. Un archivo de soporte es un archivo zip que puede facilitar a un ingeniero de soporte.

GUI
Para generar un archivo de soporte con la interfaz gráfica de usuario (GUI)

  1. Abra File Transfer.

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

    2. Seleccione Nimble Studio File Transfer en la lista.

  2. Seleccione el menú desplegable en la esquina superior derecha de la pantalla y elija Soporte.

  3. Se abre un menú del Explorador de archivos. Elija dónde desea descargar el archivo.

CLI
Para generar un archivo de soporte con la CLI

  • Abra una ventana de terminal y ejecute el siguiente comando: filetransfer support-file

    1. Se generará un archivo zip en C:\Users\username\.filetransfer\support-files\support-file-20230310-110834.zip (Windows) o en /Users/username/.tiletransfer/support-files/supportfile-20230227-185212.zip (Linux y macOS).

    2. La CLI generará la ruta al archivo creado.

Solución de problemas de la GUI

Muchos errores de la interfaz gráfica de usuario pueden resolverse con la sección de solución de problemas de la interfaz de la línea de comandos (CLI). Si recibe errores en la GUI, pruebe los siguientes pasos:

  1. Reinicie File Transfer.

  2. Abra el terminal en macOS o cmd.exe en Windows.

  3. Ejecute el siguiente comando para iniciar una sesión activa: filetransfer daemon

  4. Inicie una carga de la forma habitual. Tras recibir un error en la aplicación, consulte la ventana de la CLI. Debería aparecer un error.

Puede solucionar este error en la sección Solución de problemas de la CLI.

File Transfer no puede conectarse después de actualizar de v1.x a v2.0

Problema: ha actualizado de File Transfer v1.x a v2.0 y la GUI de File Transfer no pasa al estado Conectado.

Solución: elimine el daemon local del menú desplegable Sistema de archivos local. Hemos actualizado la denominación de los componentes y algunos clientes podrían verse afectados en función de su configuración anterior.

File Transfer no se puede conectar

Problema: la GUI de File Transfer no entra en el estado Conectado.

Solución: actualice el archivo YAML.

  1. Abra el archivo de configuración en su editor de texto preferido.

    1. El archivo de configuración se encuentra en C:\Users\username\.filetransfer\configuration.yaml (Windows) o en ~/.filetransfer/configuration.yaml (Linux y macOS).

  2. Compruebe que api_server.enabled existe en el archivo y que está establecido en true.

    1. Si se establece en false, la GUI no podrá comunicarse con la CLI de File Transfer y se deshabilitarán todas las funciones de la GUI.

    2. Si api_server.enabled no está definido en el archivo configuration.yaml, el valor predeterminado es true.

Solución de problemas de la CLI

Credenciales caducadas o no válidas

Problema: si las credenciales que ha proporcionado a File Transfer tienen problemas, recibirá uno de los siguientes errores. 

FATAL  *[*202X-XX-XX XX:XX:XX*]* Failed establishing a session to AWS:InvalidAccessKeyId: The AWS Access Key Id you provided does not exist *in* our records. status code: 403, request id: FFYEFCKZX6F1YN8H, host id: aFtPOImvXdJQ+Ukf8SYRobDx4xmZsikoJUyJszJf3Wv74w0Q5cP9TCDz/YLKwSi53hc0hBScd58*=*
or
FATAL  *[*202X-XX-XX XX:XX:XX*]* Failed establishing a session to AWS:ExpiredToken: The provided token has expired. status code: 400, request id: 130NC8C984YZJMJH, host id: j7aA3Zs/O/H3QMYeoDv5Y62o7Mu/9tvi5m7jUVqTnveLZX4qrl/bKJl1j3dLVnhVda/WaUbEgO8*=*

Solución: actualice las credenciales del perfil de AWS siguiendo las instrucciones de la página Configuración y ajustes del archivo de credenciales de la Guía del usuario de AWS Command Line Interface.

Perfil de transferencia no válido

Error: : FATAL [202X-XX-XX XX:XX:XX] Invalid transfer profile. Valid transfer profiles:

Problema: está utilizando un nombre de configuración remota que aún no se ha configurado.

Solución: actualice las configuraciones remotas.

  1. Seleccione el menú desplegable ( The menu icon. ). A continuación, elija Guardar configuración.

  2. Si no se enumera ninguna configuración remota en la sección Configuraciones remotas válidas, siga las instrucciones que se indican en Paso 2: Configurar File Transfer para agregar una.

  3. Si hay una configuración remota, asegúrese de haber escrito bien su nombre.

  4. Si está todo bien escrito, compruebe la parte del error «Configuraciones remotas válidas:» para ver si aparece alguna configuración remota específica.

  5. Si sigue sin ver su configuración remota, asegúrese de que el formato de YAML es el adecuado y de que está editando el archivo YAML correcto. El archivo YAML está vinculado al usuario que ha iniciado sesión.

    importante

    En Windows, no ejecute CMD.exe ni PowerShell como administrador. Si lo hace, el ordenador intentará leer de un archivo de configuración que no está en el archivo local del usuario.

E/S de TCP

Error: FATAL [202X-XX-XX XX:XX:XX] Unrecoverable error: retryable: retryable: RequestError:

Problema 1: el ordenador se desconectó de Internet y perdió la conexión con el bucket S3.

Solución 1: en tal caso, compruebe si hay una interrupción en la red o alguna restricción del firewall.

Problema 2: la unidad en la que se almacena el medio no puede soportar la carga que File Transfer le está imponiendo. Esto provoca una pérdida de conexión con el medio. Puede ser habitual entre las unidades de red.

Solución 2: reduzca el número máximo de transferencias activas y el número de subprocesos a 1 e intente realizar de nuevo la carga.

GUI
Para reducir el número máximo de transferencias activas y el número de subprocesos a 1 mediante la GUI

  1. Abra File Transfer.

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

    2. Seleccione Nimble Studio File Transfer en la lista.

  2. Elija el menú desplegable en la parte superior derecha de la pantalla y, a continuación, elija Configuración.

  3. En la sección de Configuración de S3, cambie el valor de Máximo de transferencias activas y Número de subprocesos a 1.

  4. Seleccione Guardar e intente realizar la carga de nuevo.

CLI
Para reducir el número máximo de transferencias activas y el número de subprocesos a 1 mediante la CLI

  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. Actualice los valores de max_active_transfers y threads a 1.

  3. Guarde el archivo de configuración.

Aumente paulatinamente los valores de número máximo de transferencias activas y número de subprocesos hasta alcanzar una configuración que no sobrecargue la unidad.

Ruta absoluta

Error: WARN [202X-XX-XX XX:XX:XX] Absolute paths are not supported, ignoring /me dia/drive

Problema: recibir esta advertencia significa que está utilizando una ruta absoluta que no es compatible. Una ruta absoluta contiene la letra de unidad. En Windows es C:\. En Linux h macOS, es la principal: /.

Solución: si se encuentra en el nivel raíz, elimine los caracteres iniciales C:\ (Windows) o / (Linux y macOS). Si no es así, sustituya la ruta relativa por la de su directorio de trabajo actual.

No se puede abrir la conexión

Error: Unable to open connection.

Problema 1: se está ejecutando otra aplicación File Transfer.

Solución 1: cierre cualquier otra aplicación File Transfer en ejecución. También puede cambiar api_server.enabled a false en el archivo de configuración.

Problema 2: File Transfer está intentando escuchar en un puerto en el que no puede escuchar. Esto puede ocurrir si su usuario no tiene permiso para escuchar el puerto, o si está utilizando el puerto 1023 o uno inferior. Estos puertos se consideran privilegiados. Para escuchar restos puertos, debe ejecutar la aplicación como administrador.

Solución 2: asegúrese de que quien esté ejecutando File Transfer tenga permiso para escuchar estos puertos. También puede cambiar el puerto a 1024 o uno superior.

Problema 3: otro programa está utilizando el mismo puerto.

Solución 3: detenga el otro programa que utiliza el mismo puerto.