

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
<a name="troubleshooting"></a>

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](monitoring.md#monitoring-logging).

**Topics**
+ [Gere um arquivo de suporte](#troubleshooting-support-file)
+ [Solução de problemas da GUI](#troubleshooting-gui)
+ [Solução de problemas da CLI](#troubleshooting-cli)

## Gere um arquivo de suporte
<a name="troubleshooting-support-file"></a>

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

   1. Selecione **Nimble Studio File Transfer** na lista.

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

1. 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).

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

------

## Solução de problemas da GUI
<a name="troubleshooting-gui"></a>

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.

1. Abra o terminal no macOS ou `cmd.exe` no Windows. 

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

1. 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](#troubleshooting-cli).

### File Transfer não consegue se conectar após o upgrade da v1.x para a v2.0
<a name="troubleshooting-gui-session-v2-0"></a>

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

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/nimble-studio/latest/filetransfer-guide/images/nsft-troubleshooting.png)


### O File Transfer não conseguiu se conectar
<a name="troubleshooting-gui-session"></a>

**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). 

1. 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. 

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

## Solução de problemas da CLI
<a name="troubleshooting-cli"></a>

### Credenciais expiradas ou inválidas
<a name="troubleshooting-expired-credentials"></a>



**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](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) no Guia do usuário do AWS Command Line Interface. 

### Perfil de transferência inválido
<a name="troubleshooting-invalid-transfer-profile"></a>

**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.\]](http://docs.aws.amazon.com/pt_br/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png)). Em seguida, escolha **Configurações**. 

1. 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](getting-started.md#getting-started-configure). 

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

1. 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. 

1. 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
<a name="troubleshooting-tcp-io"></a>

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

   1. Selecione **Nimble Studio File Transfer** na lista.

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

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

1. 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. 

   1. macOS: insira **Cmd\$1Shift\$1G**. Em seguida, insira **\$1/.filetransfer**. Abra o arquivo `filetransfer.yaml` em um editor de texto.

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

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

1. 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
<a name="troubleshooting-absolute-path"></a>

**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
<a name="troubleshooting-connection"></a>

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