View a markdown version of this page

Solução de problemas de Nimble Studio File Transfer - Transferência de Arquivos do Nimble Studio
Gere um arquivo de suporteSolução de problemas da GUISolução de problemas da CLI

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas de Nimble Studio File Transfer

Se você tiver problemas ao usar o Nimble Studio File Transfer, use as informações a seguir para ajudar a solucionar seus problemas.

Recomendamos que você ative o log seguindo as instruções em Registro em log.

Gere um arquivo de suporte

Você pode gerar um arquivo de suporte para ajudá-lo a solucionar problemas. Um arquivo de suporte é um arquivo zip que você pode fornecer a um engenheiro de suporte.

GUI
Para gerar um arquivo de suporte usando a interface gráfica do usuário (GUI)

  1. Abra o File Transfer.

    1. Vá para o Menu iniciar e pesquise por File Transfer.

    2. Selecione Nimble Studio File Transfer na lista.

  2. Selecione o menu suspenso no canto superior direito da tela e escolha Suporte.

  3. Um menu do navegador de arquivos é aberto. Escolha onde deseja fazer o download do arquivo.

CLI
Para gerar um arquivo de suporte usando a CLI

  • Abra um terminal e execute o seguinte comando: filetransfer support-file

    1. Isso gerará um arquivo zip em C:\Users\username\.filetransfer\support-files\support-file-20230310-110834.zip (Windows) ou em /Users/username/.tiletransfer/support-files/supportfile-20230227-185212.zip (Linux & macOS).

    2. A CLI exibirá o caminho para o arquivo gerado.

Solução de problemas da GUI

Muitos erros com a GUI podem ser resolvidos com a seção de solução de problemas da interface de linha de comandos (CLI). Se você estiver recebendo erros na GUI, tente as seguintes etapas:

  1. Reinicie o File Transfer.

  2. Abra o terminal no macOS ou cmd.exe no Windows.

  3. Execute o comando a seguir para iniciar uma sessão ativa: filetransfer daemon

  4. Comece um upload como você costuma fazer. Depois de receber um erro no aplicativo, verifique a janela CLI. Um erro deve ser exibido aí.

Você poderá solucionar esse problema na seção Solução de problemas da CLI.

File Transfer não consegue se conectar após o upgrade da v1.x para a v2.0

Problema: você fez upgrade do File Transfer v1.x para v2.0 e a GUI do File Transfer não entra no status Conectado.

Solução: exclua o Daemon local do menu suspenso Sistema de arquivos local. Atualizamos a nomenclatura dos componentes e alguns clientes podem ser afetados, dependendo da configuração anterior.

O File Transfer não conseguiu se conectar

Problema: A GUI do File Transfer não entra no status Conectado.

Solução: atualize o arquivo YAML.

  1. Abra o arquivo de configuração usando seu editor de texto preferido.

    1. O arquivo de configuração está localizado em C:\Users\username\.filetransfer\configuration.yaml (Windows) ou ~/.filetransfer/configuration.yaml (Linux & macOS).

  2. Verifique se api_server.enabled existe no arquivo e se está definido como true.

    1. Se estiver definido como false, a GUI não conseguirá se comunicar com a CLI do File Transfer e todas as funcionalidades da GUI serão desativadas.

    2. Se api_server.enabled não estiver definido em configuration.yaml, o padrão é true.

Solução de problemas da CLI

Credenciais expiradas ou inválidas

Problema: se as credenciais que você forneceu para o File Transfer tiverem problemas, você receberá um dos seguintes erros. 

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*=*

Solução: atualize as credenciais do perfil do AWS seguindo as instruções na página Configurações de arquivos de configuração e credenciais no Guia do usuário do AWS Command Line Interface.

Perfil de transferência inválido

Erro: FATAL [202X-XX-XX XX:XX:XX] Perfil de transferência inválido. Perfis de transferência inválidos:

Problema: você está usando um nome de configuração remota que ainda não foi configurado.

Solução: atualize as configurações remotas.

  1. Escolha o menu suspenso ( The menu icon. ). Em seguida, escolha Configurações.

  2. Se não houver nenhuma configuração remota listada na seção Configurações remotas válidas, adicione uma configuração remota seguindo as instruções em Etapa 2: Configurar o File Transfer.

  3. Se houver uma configuração remota, verifique se você não digitou incorretamente o nome dela.

  4. Se você não digitou nada errado, verifique a parte “Configurações remotas válidas:” do erro para ver se uma configuração remota específica está listada.

  5. Se você ainda não vê a configuração remota, verifique se o YAML está formatado corretamente e se você está editando o arquivo YAML correto. O arquivo YAML está vinculado ao usuário conectado.

    Importante

    No Windows, não execute o CMD.exe nem o PowerShell como administrador. Se você fizer isso, seu computador tentará ler um arquivo de configuração que não esteja no arquivo do usuário local.

E/S TCP

Erro: FATAL [202X-XX-XX XX:XX:XX] Erro irrecuperável: repetitivo: retentável: RequestError:

Problema 1: seu computador se desconectou da Internet e perdeu a conexão com o bucket do S3.

Solução 1: nesse caso, verifique se há uma interrupção na rede ou alguma restrição de firewall.

Problema 2: a unidade em que a mídia está armazenada não consegue lidar com a carga que o File Transfer está exigindo dela. Isso causa uma perda na conexão com a mídia. Isso pode ser comum entre unidades de rede.

Solução 2: reduza o número máximo de transferências ativas e o número de threads para 1 e tente fazer o upload novamente.

GUI
Para reduzir o máximo de transferências ativas e o número de threads para 1 usando a GUI

  1. Abra o File Transfer.

    1. Vá para o Menu iniciar e pesquise por File Transfer.

    2. Selecione Nimble Studio File Transfer na lista.

  2. Escolha o menu suspenso no canto superior direito da tela e selecione Configurações.

  3. Na seção de Configurações do S3, altere Máximo de transferências ativas e Número de threads para 1.

  4. Escolha Salvar e tente fazer o upload novamente.

CLI
Para reduzir o máximo de transferências ativas e o número de threads para 1 usando a GUI

  1. Abra o arquivo de configuração com qualquer software de edição de texto em seu computador.

    1. Windows: navegue até a pasta User/<your username> do seu computador. Abra a pasta .filetransfer e abra o arquivo filetransfer.yaml com um editor de texto.

    2. macOS: insira Cmd+Shift+G. Em seguida, insira ~/.filetransfer. Abra o arquivo filetransfer.yaml em um editor de texto.

    3. Linux: abra o arquivo filetransfer.yaml usando qualquer editor de texto. O arquivo está localizado em ~/.filetransfer/configuration.yaml.

  2. Atualize os valores de max_active_transfers e threads para 1.

  3. Salve o arquivo de configuração.

Aumente lentamente os valores do máximo de transferências ativas e do número de threads até chegar a uma configuração que não sobrecarregue sua unidade.

Caminho absoluto

Erro: WARN [202X-XX-XX XX:XX:XX] Caminhos absolutos não são suportados, ignorando /me dia/drive

Problema: receber esse aviso significa que você está usando um caminho absoluto que não é suportado. Um caminho absoluto contém a letra da unidade. No Windows, é C:\. No Linux e no macOS, este é o padrão: /.

Solução: se você estiver no nível raiz, remova o padrão C:\ (Windows) ou / (Linux & macOS). Caso contrário, substitua o caminho relativo ao seu diretório de trabalho atual.

Não é possível abrir a conexão

Erro: Não é possível abrir a conexão.

Problema 1: outro aplicativo File Transfer está em execução.

Solução 1: feche todos os outros aplicativos File Transfer em execução. Como alternativa, você pode alterar api_server.enabled para falso no arquivo de configuração.

Problema 2: File Transfer está tentando receber de uma porta da qual você não pode receber. Isso pode acontecer se o usuário não tiver permissão para receber da porta ou se você estiver usando a porta 1023 ou inferior. Elas são consideradas portas privilegiadas. Essas portas exigem que você as execute como administrador para ouvi-las.

Solução 2: certifique-se de que quem está executando o File Transfer tenha permissão para receber dessas portas. Também é possível alterar a porta para 1024 ou superior.

Problema 3: outro programa está usando a mesma porta.

Solução 3: interrompa o outro programa que está usando a mesma porta.