View a markdown version of this page

Nimble Studio File Transfer 문제 해결 - Nimble Studio File Transfer
지원 파일 생성GUI 문제 해결CLI 문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Nimble Studio File Transfer 문제 해결

Nimble Studio File Transfer를 사용하는 데 문제가 있는 경우 다음 정보를 사용하여 문제를 해결합니다.

로깅의 지침에 따라 로깅을 활성화하는 것이 좋습니다.

지원 파일 생성

문제 해결에 도움이 되는 지원 파일을 생성할 수 있습니다. 지원 파일은 지원 엔지니어에게 제공할 수 있는 zip 파일입니다.

GUI
그래픽 사용자 인터페이스(GUI)를 사용하여 지원 파일을 생성하려면

  1. File Transfer를 엽니다.

    1. 시작 메뉴로 이동하여 File Transfer를 검색합니다.

    2. 목록에서 Nimble Studio File Transfer를 선택합니다.

  2. 화면 오른쪽 상단의 드롭다운 메뉴를 선택하고 지원을 선택합니다.

  3. 파일 브라우저 메뉴가 열립니다. 파일을 다운로드할 위치를 선택합니다.

CLI
CLI를 사용하여 지원 파일을 생성하려면

  • 터미널을 열고 다음 명령을 실행합니다. filetransfer support-file

    1. 그러면 C:\Users\username\.filetransfer\support-files\support-file-20230310-110834.zip(Windows) 또는 /Users/username/.tiletransfer/support-files/supportfile-20230227-185212.zip(Linux 및 macOS)에 zip 파일이 생성됩니다.

    2. CLI는 생성된 파일의 경로를 출력합니다.

GUI 문제 해결

GUI와 관련된 많은 오류는 명령줄 인터페이스(CLI) 문제 해결 섹션을 참고하여 해결할 수 있습니다. GUI에서 오류가 발생하는 경우 다음 단계를 시도합니다.

  1. File Transfer을 다시 시작합니다.

  2. macOS 또는 Windows의 경우 cmd.exe에서 터미널을 엽니다.

  3. 다음 명령을 실행하여 활성 세션을 시작합니다. filetransfer daemon

  4. 평소와 같이 업로드를 시작합니다. 애플리케이션에서 오류가 발생하면 CLI 창을 확인합니다. 해당 창에 오류가 표시됩니다.

CLI 문제 해결 섹션을 참고하여 이 오류를 해결할 수 있습니다.

v1.x에서 v2.0으로 업그레이드한 후 File Transfer를 연결할 수 없음

문제: File Transfer v1.x에서 v2.0으로 업그레이드하고 나서 File Transfer GUI가 연결됨 상태로 전환되지 않습니다.

해결 방법: 로컬 파일 시스템 드롭다운 메뉴에서 로컬 대몬(daemon)을 삭제합니다. 구성 요소 이름이 업데이트되었으며 일부 고객은 이전 구성에 따라 영향을 받을 수 있습니다.

File Transfer에 연결할 수 없습니다.

문제: File Transfer GUI가 연결됨 상태로 들어가지 않습니다.

해결 방법: YAML 파일을 업데이트합니다.

  1. 원하는 텍스트 편집기에서 구성 파일을 엽니다.

    1. 구성 파일은 C:\Users\username\.filetransfer\configuration.yaml(Windows) 또는 ~/.filetransfer/configuration.yaml(Linux 및 macOS)에 있습니다.

  2. 파일에 api_server.enabled이 존재하고 값이 true로 설정되어 있는지 확인합니다.

    1. false로 설정되면 GUI가 File Transfer CLI와 통신할 수 없으며 모든 GUI 기능이 비활성화됩니다.

    2. configuration.yaml에 api_server.enabled이 정의되지 않은 경우 기본값은 true입니다.

CLI 문제 해결

만료되었거나 유효하지 않은 보안 인증

문제: File Transfer에 제공한 보안 인증에 문제가 있는 경우 다음 오류 중 하나가 표시됩니다.

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

해결 방법: AWS Command Line Interface 사용 설명서의 구성 및 보안 인증 파일 설정 페이지에 있는 지침에 따라 AWS 프로필의 보안 인증을 새로 고칩니다.

무효한 전송 프로필

오류: : 치명적 [202X-XX-XX XX:XX:XX] 무효한 전송 프로필. 유효한 전송 프로필:

문제: 아직 설정되지 않은 원격 구성 이름을 사용하고 있습니다.

해결 방법: 원격 구성을 업데이트합니다.

  1. 드롭다운 메뉴( The menu icon. )를 선택합니다. 그런 다음 설정을 선택합니다.

  2. 유효한 원격 구성 섹션에 나열된 원격 구성이 없는 경우 2단계: File Transfer 구성의 지침에 따라 원격 구성을 추가합니다.

  3. 원격 구성이 있는 경우 해당 원격 구성의 이름을 잘못 입력하지 않았는지 확인합니다.

  4. 철자가 틀리지 않은 경우 오류의 “유효한 원격 구성: ” 부분을 확인하여 특정 원격 구성이 나열되어 있는지 확인합니다.

  5. 원격 구성이 여전히 보이지 않으면 YAML의 형식이 올바른지, 올바른 YAML 파일을 편집하고 있는지 확인합니다. YAML 파일은 로그인한 사용자와 연결됩니다.

    중요

    Windows에서는 관리자 권한으로 CMD.exe 또는 PowerShell를 실행하면 안 됩니다. 그렇지 않으면 컴퓨터가 로컬 사용자 파일에 없는 구성 파일에서 읽으려고 시도합니다.

TCP 입출력

오류: 치명적 [202X-XX-XX XX:XX:XX] 복구할 수 없는 오류: 재시도 가능: 재시도 가능: RequestError:

문제 1: 컴퓨터의 인터넷 연결이 끊기고 S3 버킷과의 연결이 끊겼습니다.

해결 방법 1: 이 경우 네트워크가 중단되었거나 방화벽에 제한 사항이 있는지 확인합니다.

문제 2: 미디어가 저장된 드라이브에서 File Transfer가 가하는 로드를 처리할 수 없습니다. 이로 인해 미디어 연결이 끊깁니다. 네트워크 드라이브 간에 흔히 발생할 수 있는 문제입니다.

해결 방법 2: 최대 활성 전송 수와 스레드 수를 1로 줄이고 업로드를 다시 시도합니다.

GUI
GUI를 사용하여 최대 활성 전송 수와 스레드 수를 1로 줄이려면

  1. File Transfer를 엽니다.

    1. 시작 메뉴로 이동하여 File Transfer를 검색합니다.

    2. 목록에서 Nimble Studio File Transfer를 선택합니다.

  2. 화면 오른쪽 상단의 드롭다운 메뉴를 선택하고 설정을 선택합니다.

  3. S3 설정 섹션에서 최대 활성 전송 및 스레드 수를 1로 변경합니다.

  4. 저장을 선택하고 업로드를 다시 시도합니다.

CLI
CLI를 사용하여 최대 활성 전송 및 스레드 수를 1로 줄이려면

  1. 컴퓨터에 있는 텍스트 편집 소프트웨어를 사용하여 구성 파일을 엽니다.

    1. Windows: 컴퓨터에서 User/<your username> 폴더로 이동합니다. .filetransfer 폴더를 열고 텍스트 편집기로 filetransfer.yaml 파일을 엽니다.

    2. macOS: Cmd+Shift+G를 입력합니다. 그런 다음 ~/.filetransfer를 입력합니다. 텍스트 편집기로 filetransfer.yaml 파일을 엽니다.

    3. Linux: 텍스트 편집기를 사용하여 filetransfer.yaml 파일을 엽니다. 파일은 ~/.filetransfer/configuration.yaml에 있습니다.

  2. max_active_transfers 및 threads의 값을 1로 업데이트합니다.

  3. 구성 파일을 저장합니다.

드라이브에 과부하가 걸리지 않는 구성에 도달할 때까지 최대 활성 전송 및 스레드 수 값을 천천히 올립니다.

절대 경로

오류: 경고 [202X-XX-XX XX:XX:XX] 절대 경로는 지원되지 않습니다. /me dia/drive를 무시합니다.

문제: 이 경고가 표시되면 지원되지 않는 절대 경로를 사용하고 있다는 의미입니다. 절대 경로에는 드라이브 문자가 포함됩니다. Windows의 경우 이는 C:\입니다. Linux 및 macOS의 경우 /로 시작합니다.

해결 방법: 루트 수준에 있는 경우 선행 C:\(Windows) 또는 /(Linux 및 macOS)를 제거하세요. 그렇지 않은 경우 현재 작업 디렉터리를 기준으로 경로를 바꿉니다.

연결을 열 수 없습니다.

오류: 연결을 열 수 없습니다.

문제 1: 다른 File Transfer 애플리케이션이 실행 중입니다.

해결 방법 1: 실행 중인 다른 File Transfer 애플리케이션을 모두 닫습니다. 또는 구성 파일에서 api_server.enabled 값을 false로 변경할 수 있습니다.

문제 2: File Transfer가 수신할 수 없는 포트에서 수신을 시도하는 중입니다. 사용자에게 포트 수신 권한이 없거나 포트 1023 이하를 사용하는 경우 이 문제가 발생할 수 있습니다. 이러한 포트는 권한이 있는 포트로 간주됩니다. 이러한 포트를 수신하려면 관리자 권한으로 실행해야 합니다.

해결 방법 2: File Transfer를 실행 중인 사용자가 이 포트를 수신할 수 있는 권한이 있는지 확인합니다. 포트를 1024 이상으로 변경할 수도 있습니다.

문제 3: 다른 프로그램이 동일한 포트를 사용하고 있습니다.

해결 방법 3: 같은 포트를 사용하는 다른 프로그램을 중지합니다.