Restore : Stsadm 操作 (Office SharePoint Server)
操作名 : Restore
説明
url パラメータを使用すると、サイト コレクションの復元が実行されます。ただし、restoremethod パラメータを使用すると、個々のデータベース、Web アプリケーション、またはファーム全体の復元を実行できます。既存のサイト コレクションを上書きするには、overwrite パラメータを使用します。
構文
サイト コレクションを復元する場合
stsadm -o restore
-url <URL 名>
-filename <ファイル名>
[-hostheaderwebapplicationurl] <Web アプリケーションの URL>
[-overwrite]
致命的な障害の復元の場合
stsadm -o restore
-directory <UNC パス>
-restoremethod {overwrite | new}
[-backupid] <backuphistory の GUID、stsadm -help backuphistory 参照>
[-item] <ツリーから作成されたパス>
[-percentage] <1 から 100 までの整数>
[-showtree]
[-suppressprompt]
[-username] <ユーザー名>
[-password] <パスワード>
[-newdatabaseserver] <新しいデータベースの名前>
[-preservechangelog]
[-quiet]
パラメータ
| パラメータ | 値 | 必須/省略可能 | 説明 |
|---|---|---|---|
url |
有効な URL ("http://server_name/sites/site_name" など) |
必須 |
サイト コレクションのバックアップの復元先の URL を指定します。 |
filename |
サイト コレクションのバックアップ ファイルの有効なファイル名 ("サイト名.bak" など) です。 |
必須 |
サイト コレクションのバックアップを含むファイルのパスと名前を指定します。 |
hostheaderwebapplicationurl |
代替アクセスマッピング (AAM) を使用した Web アプリケーションに割り当てられた有効な URL ("http://*server_name*" など) |
省略可能 |
サイト コレクションをパス ベースのサイト コレクションではなく、ホスト名が付いたサイト コレクションとして復元します。-hostheaderwebapplicationurl パラメータを指定する場合、-url パラメータはホスト名が付いたサイト コレクション、-hostheaderwebapplicationurl パラメータはホスト名が付いたサイト コレクションを保持する Web アプリケーションの URL です。 |
overwrite |
<なし> |
省略可能 |
url パラメータで指定した場所に現在配置している既存のサイト コレクションを、バックアップ ファイルに格納されているサイト コレクションで上書きします。 |
directory |
次のいずれかの有効なパス :
.gif "Note") メモ
spbr* フォルダは自動的に作成されます。
|
必須 |
Microsoft Office SharePoint Server 2007 において、stsadm -o backup 操作で生成された致命的な状況に対応するためのバックアップ パッケージが保存されているパスです。このディレクトリは、spbr* フォルダの親フォルダです。 Microsoft SQL Server 2005 および Office SharePoint Server 2007 のインスタンスがインストールされているコンピュータがある場合は、ローカル ドライブのパスを使用できます。これには基本インストールが含まれます。ただし、SQL Server 2005 および Office SharePoint Server 2007 が複数のコンピュータにインストールされている場合は、汎用名前付け規則 (UNC) の共有パスを使用して、SQL データベースと検索コンポーネントが同じ場所に書き込まれるようにする必要があります (\\*computer_name*\volume\Backup など)。複数のバックアップ パッケージを同じ場所に格納できます。これは、stsadm -o restore 操作で -directory パラメータに渡すのと同じパスです。 |
restoremethod |
次のいずれかの値 :
|
必須 |
実行するファームの復元の種類を指定します。overwrite または new を指定します。 overwrite では、内容および設定は元の場所に復元されます。このパラメータは同じファーム内での致命的な状況に対応するための復元の場合にのみ使用されます。overwrite を使用すると、確認のプロンプトが表示されます。プロンプトが表示されないようにするには、suppressprompt パラメータを使用します。 new は内容が新しい場所に復元されることを示し、異なるファーム (例 : 新しいデータベース サーバー) に復元する場合に使用されます。 |
backupid |
有効な GUID (例 : "12345678-90ab-cdef-1234-567890abcdef") |
復元するバックアップ パッケージの GUID。各バックアップ パッケージには関連付けられた一意の GUID があり、stsadm -o backuphistory 操作でバックアップ履歴を表示して確認できます。このパラメータを指定しないと、最後に行ったバックアップ パッケージが使用されます。 |
|
item |
次のような有効なアイテム : Web Application\SharePoint-80 |
省略可能 |
ファームのどの部分を復元するかを示します。-showtree パラメータにより表示されたとおりの完全なファーム パスの表記、または一意の名前が付いている場合はターゲット コンポーネントの名前を使用できます。アイテムまたはパスにスペースが含まれる場合は、二重引用符で囲みます。このパラメータが見つからない場合は、バックアップ パッケージのすべてのアイテムが復元されます。このパラメータを指定しないと、バックアップ パッケージ内のすべての項目が復元されます。 |
percentage |
1 から 100 までの整数値。 既定値は 5 です。 |
省略可能 |
復元操作の進行状況を、指定したパーセンテージごとに更新表示するように要求します (例 : "5"を指定した場合は 5% 進行したときに復元の進行状況が更新表示され、"10" を指定した場合は 10% 進行したときに復元の進行状況が更新表示されます)。 メモ
このパーセント値は厳密ではないため、実際の進行状況の更新は要求した値よりも前後することがあります。
データベースが非常に大きい場合に状況を確認するには、"1" が最適値です。 既定値は 5 です。 |
showtree |
<なし> |
省略可能 |
stsadm -o restore 操作に渡された他のすべてのパラメータに基づいて、バックアップ パッケージ内のどのアイテムが復元されるかを表示します。 復元操作に渡される他のパラメータに基づいて復元から除外されるアイテムの前にはアスタリスク文字が付きます。復元できないアイテムは大かっこ ([ ]) で囲まれます。showtree パラメータが存在する場合、復元は実行されません。 |
suppressprompt |
<なし> |
省略可能 |
次のコマンド ライン プロンプトが表示されなくなります。 "警告 : 選択したすべてのアイテムが上書きされます。上書きしますか (Y/N)?" このパラメータは restoremethod パラメータが "overwrite" に設定されている場合にのみ有効です。 |
username |
*username* 形式で指定する有効な SQL 認証のユーザー名。 |
省略可能 |
Web アプリケーション プールを含む復元中のすべてのオブジェクトの内、ユーザー名を必要とするオブジェクトに対して同じユーザー名を設定します。ファーム全体が復元される場合は、このパラメータは、Windows の認証を使用してデータベースに接続するファームでのみ使用されます。データベースのみ復元される場合は、SQL Server 2005 ログイン名を指定します。 |
password |
省略可能 |
Web アプリケーション プールなど、パスワードが必要なすべての復元オブジェクトに同じパスワードを設定します。ファーム全体が復元される場合は、このパラメータは、SQL Server 2005 を使用するデータベースに Windows の認証を使用して接続するファームでのみ使用されます。データベースのみ復元される場合は、SQL Server 2005 のログイン パスワードを指定します。 |
|
newdatabaseserver |
有効なデータベース サーバー名 (例 :"SQLBE1") |
省略可能 |
restoremethod パラメータの値が new の場合に任意のデータベースの復元に使用する SQL Server 2005 のインスタンス名を指定します。このパラメータは、restoremethod パラメータの値が overwrite に設定されていると、無効になります。 既定では、各データベースに対して新しいデータベース サーバー名が求められます。 |
preservechangelog |
<なし> |
省略可能 |
変更ログを保持して、このコンテンツ データベースの次のクロールがフル クロールにならないようにします。このパラメータは、Microsoft Office Servers インフラストラクチャ更新プログラムで初めて導入されました。詳細については、「備考」を参照してください。 |
quiet |
<なし> |
省略可能 |
復元進捗情報が表示ウィンドウに出力されないようにします。最終的な復元状況 ("操作は正常に完了しました") は表示されます。-quiet パラメータを指定しなかった場合、restore 操作ではパッケージを復元すると、表示ウィンドウに進捗情報が表示されます。 |
備考
Microsoft Office Servers インフラストラクチャ更新プログラム を実行している場合は、ビルトイン ツールを使用してデータベースを復元または再接続する際に、各コンテンツ データベースの識別子 (ID) が保持されます。ビルトイン ツールを使用した場合の既定の変更ログ保持動作は、以下のとおりです。
ファームを復元する際、すべてのデータベースの変更ログが保持されます。
データベースを再接続する際、コンテンツ データベースの変更ログが保持されます。
コンテンツ データベースだけを復元する際は、コンテンツ データベースの変更ログが保持されません。これは、preservechangelog パラメータを使用する場合に当てはまります。
データベース ID と変更ログが保持される場合、クロール ルールにより定義された定期スケジュールに基づいて検索によりクロールが継続されます。変更ログが保持されない場合、スケジュールされた次のクロール時にフル クロールが検索により実行されます。
詳細については、「コンテンツ データベースを移動する (Office SharePoint Server 2007)」と「ファーム全体のバックアップおよび復元 (SharePoint Server 2007)」を参照してください。
既存のデータベースを復元する場合に、overwrite オプションを指定した restoremethod パラメータを使用しないで stsadm –o restore 操作を行うと、復元するデータベースに新しい ID が割り当てられ、データベースの変更ログは保存されません。データベースの次回のクロールで、コンテンツ データベースに完全にインデックスが付けられます。
復元が実行され、バックアップ パッケージ内の ID がファームで既に使用されている場合 (たとえば、データベースを 2 つに分割する場合)、復元されたデータベースに新しい ID が割り当てられ、復元ログに警告が追加されます。フル クロールではなく増分クロールを実行できるかどうかは、コンテンツ データベース ID が以前と同じかどうかと、検索で使用される変更ログ トークンがコンテンツ データベース内の現在の変更ログで有効かどうかにより決まります。変更ログが保持されない場合、トークンは有効にならないため、検索でフル クロールを実行する必要があります。