자주 발생하는 문제

이 페이지에는 자주 보는 메시지와 문제를 모았습니다. 각 제목은 Frost가 표시하는 메시지이거나, 사용자가 겪는 증상입니다.

#"Frost isn't set up yet, run frost init"

Frost가 config.toml을 찾지 못했습니다. frost init을 실행하세요. --config-dir나 FROST_CONFIG_DIR을 쓴다면 올바른 폴더를 가리키는지 확인하세요.

#"no key on this machine"

키 파일이 없습니다. 이 컴퓨터에 스토리지가 이미 설정되어 있다면 frost key import를 실행하고 복구 문구를 입력하세요. 그렇지 않다면 frost init을 실행하세요.

#"a backup or restore operation is already in progress"

다른 Frost 프로세스가 백업을 사용하고 있습니다. 대개 예약된 백업입니다. 그런 경우 Frost는 "a scheduled backup is already running"이라고 표시하고 언제 시작했는지 알려 줍니다. 끝날 때까지 기다렸다가 다시 시도하세요. Frost의 잠금 파일을 지워도 그 프로세스는 멈추지 않습니다.

#"the local encryption key does not match"

스토리지에 다른 키로 만든 백업이 있습니다. frost key verify를 실행하고 적어 둔 복구 문구를 입력해 어떤 키인지 확인하세요. 올바른 키라면 그 문구로 frost key import를 실행하세요.

#Frost가 백업을 찾지 못함

"has no Frost repository" 같은 메시지는 Frost가 찾는 곳에 백업이 없다는 뜻입니다. 오류에는 백업을 마지막으로 연 위치와 되돌아가는 방법이 표시됩니다. 자세한 내용은 백업 옮기기를 참고하세요.

액세스 키가 아직 작동하는데 백업이 Permafrost에서 사라졌다면, 그 키로 삭제되었을 가능성이 큽니다. 바로 [email protected]로 이메일을 보내세요. 다른 사람이 키를 가지고 있을 수 있다면 getfro.st/perma/recover에서 새 키를 받으세요.

#설정 도우미가 연결하지 못함

설정 도우미는 문제를 설명하고, 원인일 가능성이 가장 큰 답으로 돌아갑니다.

#"This storage provider does not support conditional writes"

컴퓨터끼리 서로의 백업 기록을 덮어쓰지 않도록 Frost에 필요한 기능을 스토리지가 지원하지 않습니다. 키나 설정을 바꿔도 해결되지 않습니다. 다른 스토리지를 고르세요. 자세한 내용은 스토리지 선택을 참고하세요.

셀프 호스팅 서버나 드라이브에서는 다르게 표시됩니다. 서버가 "cannot create hard links"라고 하거나, 폴더가 "on an unsupported filesystem"라고 표시됩니다. ext4, Btrfs, XFS, ZFS, APFS, NTFS 같은 파일 시스템에 있는 폴더를 쓰세요.

#"the server didn't accept Frost's SSH key"

셀프 호스팅 서버가 Frost의 키를 거부했습니다. 예를 들어 키가 authorized_keys에서 지워진 경우입니다. frost init을 실행하고 키를 다시 추가하세요. 자세한 내용은 셀프 호스팅을 참고하세요.

#"the server's SSH host key has changed"

서버의 신원이 바뀌면 Frost는 ssh와 마찬가지로 연결을 거부합니다. 서버를 다시 설치했거나 서버 주소가 바뀌었다면 ssh-keygen -R <host>로 이전 키를 지운 뒤 frost init을 다시 실행하세요. 그런 경우가 아니라면 연결하기 전에 키가 바뀐 이유를 확인하세요.

#"... not found. Connect the required drive and try again"

백업이 있는 드라이브가 연결되어 있지 않거나, 폴더 경로가 바뀌었습니다. 드라이브를 연결하세요. Windows가 다른 드라이브 문자를 지정했다면 로컬 드라이브를 참고하세요.

#"the Permafrost access key was rejected"

메시지 뒤에 Permafrost가 알려 주는 이유가 이어집니다. 키가 잘못되었거나, 더 새 키로 바뀌었거나, 계정이 닫혔습니다. 가장 최근 키를 쓰거나 새 키를 받으세요. 자세한 내용은 Permafrost를 참고하세요.

#"uploads are paused"

Permafrost가 지금은 이 계정의 새 백업을 받지 않습니다. 이유와 기한은 메시지에 나오며, 복원은 계속 됩니다. 자세한 내용은 Permafrost를 참고하세요.

#백업이 폴더를 읽지 못함

macOS에서는 대개 개인정보 보호 권한 문제입니다. 오류에 무엇을 허용해야 하는지 나옵니다. 자세한 내용은 macOS 권한을 참고하세요. 다른 시스템에서는 사용자가 그 폴더를 읽을 수 있는지 확인하세요.

#"couldn't be read"로 표시된 파일

Frost는 그 파일들을 건너뛰고 나머지를 저장했습니다. 흔한 원인은 읽기 권한이 없는 파일, 백업 중에 삭제된 파일, 그리고 macOS에서 iCloud가 온라인에만 보관하는 파일입니다.

#"continued changing while being read"로 표시된 파일

백업하는 동안 어떤 프로그램이 그 파일에 쓰고 있었기 때문에, 스냅샷에는 이전 사본이 남았습니다. 프로그램을 닫고 다시 백업하거나, 다음 백업에 맡기세요.

#폴더가 "not found"로 표시됨

목록에 있는 폴더가 없어서 Frost가 나머지만 백업했습니다. 드라이브를 다시 연결하거나, 폴더를 옮겼다면 frost init으로 목록을 고치세요.

#"config.toml changed, but updating the scheduled job failed"

config.toml을 편집했지만 Frost가 예약 작업을 그에 맞게 업데이트하지 못했습니다. 이유는 메시지 뒷부분에 나옵니다. 설정 이름이 나오면 config.toml에서 그 설정을 고치세요. Frost는 성공할 때까지 명령어를 실행할 때마다 다시 시도합니다.

#"config.toml changed where backups go"

config.toml에서 백업이 저장되는 곳을 바꿨는데, Frost가 새 위치를 처음 사용할 때 문제를 발견했습니다. 무엇이 문제인지는 메시지 뒷부분에 나옵니다. 백업 옮기기를 참고하세요.

#"scheduled job is missing"

예약 작업이 삭제되었거나 꺼졌습니다. frost config set schedule.enabled true로 되살리세요.

#예약된 백업이 실행되지 않음

• frost status의 "next backup" 줄을 확인하세요.
• macOS에서는 시스템 설정 > 일반 > 로그인 항목 및 확장 프로그램(System Settings > General > Login Items & Extensions)에서 Frost의 스위치를 확인하세요. Node.js Foundation이라는 이름으로 표시됩니다.
• Windows에서는 예약된 백업을 실행하려면 로그인한 상태여야 하며, 배터리로 동작하는 동안에는 실행되지 않습니다.
• schedule.catch_up이 false면 컴퓨터가 꺼져 있거나 잠자기 상태일 때 예정된 백업을 건너뜁니다.
• 로그를 확인하세요. 자세한 내용은 자동 백업을 참고하세요.

#"verification failed"

표본 검사에서 스토리지의 데이터가 빠졌거나 손상된 것을 발견했습니다. 자세한 내용은 백업 확인을 참고하세요.

#"cannot restore alongside original files"

원본 옆의 폴더를 쓸 수 없습니다. 스냅샷이 다른 컴퓨터에서 온 경우가 많습니다. 대신 --to <dir>를 쓰세요. 자세한 내용은 파일 복원을 참고하세요.

#"cannot overwrite original files"

스냅샷이 다른 종류의 컴퓨터에서 왔거나, 원본으로 가는 경로가 Frost가 신뢰하지 않는 링크를 거칩니다. 대신 --beside나 --to <dir>를 쓰세요.

#복원 중 파일에 "changed after it was checked" 또는 "has more than one link"가 표시됨

Frost가 이미 확인한 파일이 변경되었거나, 아직 복원이 끝나지 않은 파일에 다른 이름으로 연결된 하드 링크가 있음을 발견했습니다. 복원 폴더를 변경하는 프로그램을 닫고 다시 시도하세요. 복원이 끝나지 않은 파일에 하드 링크가 있다면 새 빈 폴더에 복원하세요.

#지정한 스냅샷을 찾지 못함

#Frost가 스스로 업데이트하지 못함

Frost 폴더에 쓸 수 없거나, Frost를 소스에서 빌드한 경우입니다. 자세한 내용은 Frost 업데이트를 참고하세요.

#설치 프로그램이 멈춤

#설치한 뒤 frost를 찾을 수 없음

새 터미널을 여세요. Frost를 설치하는 동안 열려 있던 터미널에는 새 PATH가 반영되지 않습니다. pnpm을 쓴다면 pnpm setup을 한 번 실행한 뒤 새 터미널을 여세요.