Restore : opération Stsadm (Windows SharePoint Services)
Mise à jour : 2009-09-24
Nom de l’opération : Restore
Si le paramètre url est utilisé, la collection de sites est restaurée. En revanche, lorsque le paramètre restoremethod est utilisé, il est possible de procéder à une restauration d’une base de données individuelle, d’une application Web ou de l’intégralité de la batterie de serveurs. Si vous souhaitez remplacer une collection de sites existante, utilisez le paramètre overwrite.
Syntaxe
Pour restaurer une collection de sites
stsadm -o restore
-url <nom d’URL>
-filename <nom du fichier>
[-hostheaderwebapplicationurl] <URL de l’application Web>
[-overwrite]
Pour réaliser une restauration d’urgence
stsadm -o restore
-directory <chemin UNC>
-restoremethod {overwrite | new}
[-backupid] <GUID de l’historique de sauvegarde, voir stsadm -help backuphistory>
[-item] <chemin créé à partir de l’arborescence>
[-percentage] <entier entre 1 et 100>
[-showtree]
[-suppressprompt]
[-username] <nom d’utilisateur>
[-password] <mot de passe>
[-newdatabaseserver] <nom du nouveau serveur de base de données>
[-preservechangelog]
[-quiet]
Paramètres
| Paramètre | Valeur | Obligatoire ? | Description |
|---|---|---|---|
url |
Une URL valide, telle que http://nom_serveur/sites/nom_site |
Oui |
Spécifie l’URL à laquelle la sauvegarde de la collection de sites doit être restaurée. |
filename |
Nom de fichier valide du fichier de restauration de la collection de sites, tel que « Nom_site.bak » |
Oui |
Spécifie le chemin d’accès et le nom du fichier qui contient la sauvegarde de la collection de sites. |
hostheaderwebapplicationurl |
URL valide associée à l’application Web par le biais d’un mappage des accès de substitution, tel que « http://*server_name* » |
Non |
Restaure une collection de sites sous forme de collection de sites nommée par l’hôte et non sous forme de collection reposant sur des chemins d’accès. Lorsque le paramètre hostheaderwebapplicationurl est spécifié, la valeur du paramètre url correspond à l’URL de la collection de sites nommée par l’hôte et la valeur du paramètre hostheaderwebapplicationurl correspond à l’URL de l’application Web qui contiendra la collection de sites nommée par l’hôte. |
overwrite |
<aucune> |
Non |
Remplace une collection de sites existante se trouvant actuellement à l’emplacement spécifié par le paramètre url par la collection de sites stockée dans le fichier de sauvegarde. |
directory |
L’un des chemins d’accès valides :
Notes Les dossiers spbr* sont créés automatiquement. |
Oui |
Chemin d’accès où Windows SharePoint Services 3.0 stocke le package de sauvegarde d’urgence généré pendant l’opération stsadm -o backup. Il s’agit du dossier parent des dossiers spbr*. Si vous disposez d’un ordinateur sur lequel sont installés Microsoft SQL Server 2005 et une instance de Windows SharePoint Services 3.0, vous pouvez utiliser des chemins d’accès de lecteurs locaux. Cela comprend une installation de base. Toutefois, si SQL Server 2005 et Windows SharePoint Services 3.0 sont installés sur plusieurs ordinateurs, vous devez utiliser les chemins de partage UNC (Universal Naming Convention) afin que les composants de recherche et la base de données SQL soient lus à partir du même emplacement (par exemple, \\*nom_ordinateur*\volume\Backup). Plusieurs packages de sauvegarde peuvent être stockés au même emplacement. Il s’agit du même chemin d’accès que celui que vous transmettez au paramètre -directory de l’opération stsadm -o restore. |
restoremethod |
L’une des valeurs suivantes :
|
Oui |
Spécifie le type de restauration de batterie de serveurs à effectuer (overwrite ou new). La valeur overwrite restaure le contenu et les paramètres à leur emplacement d’origine. Ce paramètre ne doit être utilisé que dans une restauration d’urgence au sein de la même batterie de serveurs. Si la valeur overwrite est utilisée, une invite de confirmation s’affiche. Pour supprimer l’invite, utilisez le paramètre suppressprompt. La valeur new spécifie que le contenu sera restauré à un nouvel emplacement et est conçue pour être utilisée lors d’une restauration sur une batterie de serveurs différente (par exemple, un nouveau serveur de bases de données). |
backupid |
GUID valide, tel que « 12345678-90ab-cdef-1234-567890abcdef » |
GUID du package de sauvegarde à restaurer. Chaque package de sauvegarde est associé à un GUID unique. Pour connaître le GUID, il est nécessaire d’examiner l’historique de sauvegarde par le biais de l’opération stsadm -o backuphistory. Si ce paramètre n’est pas spécifié, le package de la sauvegarde la plus récente sera utilisé. |
|
item |
Élément valide, tel que :
|
Non |
Indique quelle partie de la batterie doit être restaurée. Vous pouvez utiliser le libellé du chemin d’accès complet à la batterie de serveurs, tel qu’il est indiqué par le paramètre -showtree, ou le nom du composant cible dans le chemin d’accès, si ce nom est unique. Si l’élément ou le chemin contient une espace, placez des guillemets avant et après. Si ce paramètre n’est pas spécifié, tous les éléments du package de restauration sont restaurés. |
percentage |
Entier compris entre 1 et 100. La valeur par défaut est 5. |
Non |
Permet d’afficher les mises à jour de l’avancement de l’opération Restore selon un incrément défini par ce pourcentage (par exemple, une valeur de « 5 » permet d’afficher les mises à jour de l’avancement de la restauration par incréments d’achèvement de 5 %, tandis qu’une valeur de « 10 » permet de les afficher par incréments d’achèvement de 10 %). Notes Ce pourcentage n’est pas précis et l’avancement réel de l’opération peut être supérieur ou inférieur aux valeurs définies. Pour les bases de données très volumineuses, la valeur 1 est la plus adaptée pour surveiller l’avancement. La valeur par défaut est 5. |
showtree |
<aucune> |
Non |
Indique les éléments du package de sauvegarde qui seraient restaurés suivant tous les autres paramètres transmis à l’opération stsadm -o restore Les éléments qui seront exclus de la restauration en fonction des autres paramètres passés à l’opération Restore seront précédés d’un astérisque. Les éléments qui ne peuvent pas être sélectionnés pour la restauration seront placés entre crochets ([]). Une restauration ne sera pas effectuée si le paramètre showtree est présent. |
suppressprompt |
<aucune> |
Non |
Empêche l’affichage de l’invite de ligne de commande suivante : Avertissement : tous les composants sélectionnés seront remplacés. Souhaitez-vous qu'ils soient remplacés ? (O/N) Ce paramètre est valide uniquement lorsque la valeur du paramètre restoremethod est overwrite. |
username |
Nom d’utilisateur valide pour l’authentification SQL, au format *nom_utilisateur* |
Non |
Définit le même nom d’utilisateur pour tous les objets en cours de restauration qui nécessitent un nom d’utilisateur, y compris les pools d’applications Web. Si une batterie de serveurs entière est restaurée, ce paramètre ne doit être utilisé que par les batteries de serveurs qui utilisent l’authentification Windows pour se connecter à une base de données. Si seulement une base de données est restaurée, vous pouvez fournir un nom de connexion SQL Server 2005. |
password |
Non |
Définit le même mot de passe pour tous les objets en cours de restauration qui nécessitent un mot de passe, y compris les pools d’applications Web. Si une batterie de serveurs entière est restaurée, ce paramètre ne doit être utilisé que par les batteries de serveurs qui utilisent l’authentification Windows pour se connecter à une base de données. Si seulement une base de données est restaurée, vous pouvez fournir un mot de passe de connexion SQL Server 2005. |
|
newdatabaseserver |
Nom de serveur de base de données valide, tel que « SQLBE1 » |
Non |
Indique le nom d’instance de SQL Server 2005 à utiliser lors de la restauration de bases de données si la valeur du paramètre restoremethod est new. Ce paramètre n’est pas valide si la valeur du paramètre restoremethod est définie sur overwrite. Par défaut, le nom du nouveau serveur de base de données est demandé pour chaque base de données. |
preservechangelog |
<aucune> |
Non |
Conserve le journal des modifications de sorte que la prochaine analyse de cette base de données de contenu ne soit pas une analyse complète. Ce paramètre a été introduit pour la première fois dans la Mise à jour d’infrastructure pour Windows SharePoint Services 3.0. Pour plus d’informations, voir Remarques. |
quiet |
<aucune> |
Non |
Empêche l’affichage des informations d’avancement de la restauration dans la fenêtre. L’état final de la restauration (« Opération réussie») sera cependant affiché. Si le paramètre -quiet n’est pas spécifié, l’opération restore affiche les informations d’avancement de l’opération dans la fenêtre pendant la restauration. |
Remarques
Si vous exécutez la Mise à jour d’infrastructure pour Windows SharePoint Services 3.0, l’identificateur (ID) de chaque base de données de contenu est conservé lorsque vous restaurez ou rattachez la base de données à l’aide des outils intégrés. Le comportement de rétention par défaut du journal des modifications est le suivant lorsque vous utilisez les outils intégrés :
Les journaux des modifications de toutes les bases de données sont conservés lorsque vous restaurez une batterie de serveurs.
Le journal des modifications d’une base de données de contenu est conservé lorsque vous rattachez la base de données.
Le journal des modifications d’une base de données de contenu N’EST PAS CONSERVÉ lorsque vous restaurez uniquement la base de données de contenu. C’est dans ce cas que vous devez utiliser le paramètre preservechangelog.
Lorsqu’un ID de base de données et le journal des modifications sont conservés, le service Recherche continue l’analyse d’après la planification régulière définie par des règles d’analyse. Lorsqu’un journal des modifications n’est pas conservé, le service Recherche réalise une analyse complète pendant l’analyse planifiée suivante.
Pour plus d’informations, voir Déplacer des bases de données de contenu (Windows SharePoint Services 3.0) et Administration de la sauvegarde et de la récupération pour la technologie Windows SharePoint Services 3.0.
Lorsque vous restaurez une base de données existante et que vous ne spécifiez pas la valeur overwrite pour le paramètre restoremethod lorsque vous exécutez l’opération stsadm –o restore, un nouvel ID est attribué à la base de données restaurée et le journal des modifications de la base de données n’est pas conservé. L’analyse suivante de la base de données indexera intégralement la base de données de contenu.
Si une restauration est effectuée et que l’ID du package de sauvegarde est déjà en cours d’utilisation dans la batterie de serveurs (par exemple, lorsque vous essayez de diviser une base de données en deux parties), un nouvel ID est attribué à la base de données restaurée et un avertissement est ajouté au journal de restauration. Si l’ID de la base de données de contenu n’a pas changé et que le jeton de journal des modifications utilisé par le service Recherche est valide pour le journal des modifications actuel de la base de données de contenu, vous pouvez réaliser une analyse incrémentielle au lieu d’une analyse complète. Si le journal des modifications n’est pas conservé, le jeton ne sera pas valide et le service Recherche devra alors procéder à une analyse complète.