Restore

restore コマンドは、ファイルのバックアップ・バージョンのコピーを IBM® Storage Protect サーバーから、またはバックアップ・セット内から取得します。

ファイルをリストアするには、ディレクトリーまたは選択したファイルを指定するか、あるいはリストからファイルを選択します。 ファイルをバックアップ元のディレクトリーまたは別のディレクトリーに戻します。 バックアップ/アーカイブ・クライアントは、ファイルをリストアするためのデフォルトとして、 subtree 値を指定した preservepath オプションを使用します。

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム注:
  1. UNIX および Linux® システムでは、シンボリック・リンクが作成されると、その変更時刻は現在のシステム時刻に設定され、変更できません。 シンボリック・リンクのリストア時には、その修正日付と時刻は、リンクがバックアップされた日付と時刻でなく、リストアの日付と時刻に設定されます。 結果として、その修正時刻は最後のバックアップ以後に変更されているので、クライアントは次の増分バックアップ時にシンボリック・リンクをバックアップします。
Windows オペレーティング・システム注:
  1. ディレクトリーをリストアすると、その変更日時は、ディレクトリーがバックアップされた日時ではなく、リストアの日時に設定されます。 これは、クライアントがまずディレクトリーをリストアしてから、ファイルをディレクトリーに追加するためです。
  2. 名前が既存ファイルの短縮名と同一になっているファイルをリストアしようとすると、エラーが起こります。 例えば、 ABCDEF~1.DOC という名前のファイルを、 abcdefghijk.doc という名前のファイルが存在する同じディレクトリーにリストアしようとすると、Windows オペレーティング・システムは abcdefghijk.doc という名前のファイルを ABCDEF~1.DOCという短縮名にするため、リストアは失敗します。 リストア機能は、これを重複ファイルとして取り扱います。
    このエラーが起こった場合には、エラーを訂正するために次のアクションのいずれかを実行してください。
    • 短いファイル名で別の位置にリストアします。
    • リストアを停止して、既存ファイルの名前を変更します。
    • Windows で短いファイル名のサポートを無効にします。
    • 短いファイル命名規則と矛盾するファイル名を使用しないでください。 例えば、ABCDEF~1.DOC を使用しないでください。

特定のパスおよびファイルのリストア時に subdir オプションを yes に設定した場合には、クライアントは、そのパスの下にあるすべてのサブディレクトリー、および任意のサブディレクトリーに存在する指定されたファイルのインスタンスを再帰的にリストアします。

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムディレクトリーまたはディレクトリー・ツリー全体をリストアするときに、 restore コマンドに inactivelatestpicktodate、および fromdate の各オプションを指定しないと、クライアントはどのオブジェクトがリストアされるかを追跡します。 なんらかの理由でリストア・プロセスが中断された時は、restart restore コマンドを入力して、中断ポイントからリストアを再始動させることができます。 複数の再始動可能リストア・セッションを設定できます。 リストアは、ファイル指定が完全にワイルドカード指定されている場合にのみ再始動可能です。 再始動可能なリストアの場合、例えば次のように入力します。
  dsmc rest /home/* -sub=yes
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム再始動可能でないリストアの場合は、次のように入力します。
  dsmc rest "/Users/user1/file?.c" -sub=yes
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム query restore コマンドを使用して、サーバー・データベース内の再始動可能リストア・セッションのリストを表示します。 再始動可能リストアが restart restore コマンドを使用して完了するか、あるいは cancel restore コマンドを使用して取り消される場合を除き、ファイル・システムのバックアップはそれ以上実行できません。
  dsmc rest "/Users/user1/file?.c" -sub=yes

Windows オペレーティング・システム詳しくは、Microsoft サポート技術情報の記事「 Q121007」( 「NTFS パーティションでの 8.3 名前作成を無効にする方法」) を参照してください。

Windows オペレーティング・システム通信障害またはセッション損失が原因で restore コマンドが再試行された場合、転送統計には、クライアントがすべてのコマンド試行にわたって転送しようとしたバイト数が表示されます。 したがって、転送済みバイト数の統計がファイル・サイズの統計などのファイル統計と一致しない場合があります。

Windows オペレーティング・システムLinux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム

サポートされるクライアント

このコマンドは、すべてのクライアントに有効です。

構文

構文図を読むビジュアル構文図をスキップREStore FILE オプション ソース・ファイルスペース {ファイル・スペース名}ソース・ファイルスペース ソース・ファイルスペース 「sourcefilespec」 宛先ファイル・スペックBACKUPSETName=backupsetnamelocalfilenametapedeviceLOCation=serverfiletape

パラメーター

ファイル
このパラメーターは、ソース・ファイル指定が明示的ファイル名であると指定します。 このパラメーターは、現行パスからファイル名をリストアする時、相対または絶対パスを指定しない時、およびファイル名が予約された restore コマンド・キーワード (restore backupset など) と矛盾する時に必要です。
ソース・ファイル・スペース
リストアしたいストレージのパスおよびファイル名を指定します。 ファイルのグループまたはディレクトリー内のすべてのファイルを指定するには、ワイルドカード文字を使用してください。
Windows オペレーティング・システム注: filespacenameを組み込む場合には、ファイル指定にドライブ文字を組み込まないようにしてください。
{ファイル・スペース名}
サーバー上の、リストアしたいファイルが入っているファイル・スペースを (中括弧で囲んで) 指定します。 これは、ファイルのバックアップ元のワークステーション・ドライブ上の名前です。
ドライブ・ラベル名が変更された場合、または異なるドライブ・ラベルを持つ別のノードからバックアップされたファイルをリストアする場合は、ファイル・スペース名を使用してください。
Windows オペレーティング・システム注: NTFS または ReFS ファイル・スペース名は、引用符と中括弧で囲んで、大/小文字混合または小文字で指定する必要があります。 例えば、{"NTFSDrive"}。 ループ・モードでは、単一引用符または二重引用符が有効です。 例えば、{"NTFSDrive"} および {'NTFSDrive'} は、両方とも有効です。 バッチ・モードでは、単一引用符だけが有効です。 単一引用符が必要なのは、オペレーティング・システムの制限です。
「destinationfilespec」
リストア・ファイルを入れたいパスおよび ファイル名を指定します。 宛先の指定がないと、クライアントはファイルをオリジナル・ソース・パスにリストアします。

Windows オペレーティング・システム destinationfilespecを入力する際には、以下の点を考慮してください。

  • sourcefilespec 名が単一ファイルの場合には、destinationfilespec はファイルかディレクトリーとすることができます。 単一ファイルをリストアしようとしている場合には、リストア済みのファイルに新規名を付けたいならば、オプションで、指定をファイル名で終了できます。
  • sourcefilespec にワイルドカードが使用されているか、あるいは subdir=yes が指定されている場合には、destinationfilespec はディレクトリーであり、ディレクトリー区切り文字 (¥) で終了していなければなりません。
注: 宛先パスまたはその一部が存在しない場合は、クライアントが作成します。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム注: 宛先を指定しない場合、クライアントは、元のファイル・システムに到達できるかどうかを判別します。 元のファイル・システムに到達できない場合は、クライアントはファイルをリストアしません。 この場合、異なる宛先を指定して、コマンドを再試行できます。
BACKUPSETName=
バックアップ・セットの名前を指定します。 このパラメーターはオプションです。 restore コマンドで backupsetname パラメーターを指定する場合、 pick オプションは使用できません。

backupsetname の値は、バックアップ・セットのロケーションによって異なり、以下のオプションのいずれかに対応しています。

backupsetname
IBM Storage Protect サーバーからのバックアップ・セットの名前を指定します。 location パラメーターが指定されている場合、-location=server を設定する必要があります。 バックアップ・セットが IBM Storage Protect サーバー・ストレージにある場合、そのバックアップ・セットには TOC が必要です。
localfilename
最初のバックアップ・セット・ボリュームのファイル名を指定します。 -location=file を設定する必要があります。
tapedevice
バックアップ・セット・ボリュームを含むテープ装置の名前を指定します。 IBMによって提供されるデバイス・ドライバーではなく、Windows 提供のデバイス・ドライバーを使用する必要があります。 -location=tape を設定する必要があります。
LOCation=
クライアントがバックアップ・セットを検索する場所を指定します。 location パラメーターを指定しない場合、クライアントは IBM Storage Protect サーバー上でバックアップ・セットを検索します。
サーバー
クライアントがサーバーからバックアップ・セットを検索することを指定します。 これはデフォルトのロケーションです。
ファイル
クライアントがローカル・ファイルからバックアップ・セットを検索することを指定します。
テープ
クライアントがローカル・テープ装置からバックアップ・セットを検索することを指定します。
表 1. Restore コマンド: 関連オプション
オプション 使用先
Windows オペレーティング・システムアスモード Windows オペレーティング・システムコマンド・ラインのみ。
Windows オペレーティング・システム日付形式 Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム日付形式 Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
dirsonly コマンド・ラインのみ。
filelist コマンド・ラインのみ。
filesonly コマンド・ラインのみ。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムフォローシンボリック Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
fromdate コマンド・ラインのみ。
fromnode コマンド・ラインのみ。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムフロムオーナー Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムコマンド行のみ。
fromtime コマンド・ラインのみ。
ifnewer コマンド・ラインのみ。
非アクティブ コマンド・ラインのみ。
latest コマンド・ラインのみ。
Windows オペレーティング・システム数値形式 Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム数値形式 Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
pick
注: restore コマンドで backupsetname パラメーターを指定する場合、 pick オプションは使用できません。
コマンド・ラインのみ。
pitDate コマンド・ラインのみ。
pittime コマンド・ラインのみ。
preservepath コマンド・ラインのみ。
Windows オペレーティング・システム置換 Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム置換 Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Windows オペレーティング・システムスキップ許可 Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Windows オペレーティング・システムの skipntsecuritycrc Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Windows オペレーティング・システムサブディレクトリー Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムサブディレクトリー Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Windows オペレーティング・システムテープ・プロンプト Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムテープ・プロンプト Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Windows オペレーティング・システム時間形式 Windows オペレーティング・システムクライアント・オプション・ファイル (dsm.opt) またはコマンド・ライン。
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタイムフォーマット Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムクライアント・ユーザー・オプション・ファイル (dsm.opt) またはコマンド・ライン。
todate コマンド・ラインのみ。
totime コマンド・ラインのみ。

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム /Users/user1/Documents ディレクトリー内の budget という名前の単一ファイルをリストアします。

restore /home/devel/projecta/budget

Windows オペレーティング・システムタスク
Windows オペレーティング・システム budget.finという名前の単一ファイルをリストアします。

restore c:\devel\projecta\budget.fin

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム現行ディレクトリーに存在する budgetという名前の単一ファイルをリストアします。

restore file budget

Windows オペレーティング・システムタスク
Windows オペレーティング・システム現行ディレクトリーに存在する budget.finという名前の単一ファイルをリストアします。

restore file budget.fin

Windows オペレーティング・システムタスク
Windows オペレーティング・システム abc file space proj ディレクトリーからファイルをリストアします。

rest {"abc"}\proj\*.*

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムファイル拡張子が .c のすべてのファイルを /home/devel/projecta ディレクトリーからリストアします。

restore "/home/devel/projecta/*.c"

Windows オペレーティング・システムタスク
Windows オペレーティング・システムファイル拡張子が .c のすべてのファイルを c:\devel\projecta ディレクトリーからリストアします。

rest c:\devel\projecta\*.c

Windows オペレーティング・システムタスク
Windows オペレーティング・システム拡張子が .c のすべてのファイルを、 winnt ファイル・スペースにある ¥devel\projecta ディレクトリーからリストアします。

rest {winnt}\devel\projecta\*.c

Windows オペレーティング・システムタスク
Windows オペレーティング・システムファイル拡張子が .c のすべてのファイルを c:\devel\projecta ディレクトリーから c:\newdevel\projectn\projecta ディレクトリーにリストアします。 projectn ディレクトリーまたは projectn\projecta ディレクトリーが存在しない場合は、作成されます。

restore c:\devel\projecta\*.c c:\newdevel\projectn\

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム /user/project ディレクトリー内のファイルをリストアします。 活動および非活動のバックアップ・バージョンを選択するには pick および inactive オプションを使用してください。

restore "/user/project/*" -pick -inactive

Windows オペレーティング・システムタスク
Windows オペレーティング・システム c:\project ディレクトリー内のファイルをリストアします。 活動および非活動のバックアップ・バージョンを選択するには pick および inactive オプションを使用してください。

restore c:\project\* -pi -ina

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム /home/devel/projecta ディレクトリーから、文字 .c で終わるすべてのファイルを /home/newdevel/projectn/projecta ディレクトリーにリストアします。 projectn または projectn/projecta ディレクトリーが 存在しない場合には作成されます。

restore "/home/devel/projecta/*.c" /home/newdevel/projectn/

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム /home/mydir ディレクトリー内のすべてのファイルを、2002 年 8 月 17 日 1:00 PM 現在の状態にリストアします。

restore -pitd=8/17/2002 -pitt=13:00:00 /home/mydir/

Windows オペレーティング・システムタスク
Windows オペレーティング・システム c:\mydir ディレクトリー内のすべてのファイルを、2002 年 8 月 17 日 1:00 PM 現在の状態にリストアします。

restore -pitd=8/17/2002 -pitt=13:00:00 c:\mydir\

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム /home/myid/ ディレクトリー内のすべてのオブジェクトをリストアします。 このリストアは完全にワイルドカード化されているため、リストア処理が中断された場合は、再始動可能なリストア・セッションが作成されます。

res "/home/myid/*"

Windows オペレーティング・システムタスク
Windows オペレーティング・システム名前変更されたファイル・スペースからファイルを元の場所にリストアします \\your-node\h$_OLD 。 次のようにソースと宛先の両方を入力してください。

res \\your-node\h$_OLD\docs\myresume.doc h:\docs\

Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システムタスク
Linux オペレーティング・システムOracle Solaris オペレーティング・システムAIX オペレーティング・システムMac OS X オペレーティング・システム /home/mydir ディレクトリー内のすべてのファイルを、2002 年 8 月 17 日 1:00 PM 現在の状態にリストアします。

restore -pitd=8/17/2002 -pitt=13:00:00 /home/mydir/

Windows オペレーティング・システムタスク
Windows オペレーティング・システム c:\mydir ディレクトリー内のすべてのファイルを、2002 年 8 月 17 日 1:00 PM 現在の状態にリストアします。

restore -pitd=8/17/2002 -pitt=13:00:00 c:\mydir\

Windows オペレーティング・システムタスク
Windows オペレーティング・システムバックアップ・セット daily_backup_data.12345678に含まれている budget.fin という名前の単一ファイルをリストアします。

restore c:\projecta\budget.fin -backupsetname=daily_backup_data.12345678 -location=server