よくある問題

このページでは、よく見かけるメッセージや問題をまとめています。各見出しは、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 から消えている場合は、そのキーを使って削除された可能性が高いです。すぐに care@getfro.st にメールしてください。ほかの人がキーを持っているかもしれない場合は、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 を一度実行してから新しいターミナルを開きます。