La page « Restauration »

Sur la page Restauration, tu remets une sauvegarde sur ce site : la base de données, les fichiers ou les deux. C’est ici que tu choisis la sauvegarde, lis la vérification préalable, lances la restauration et décides ensuite de la conserver ou de l’annuler.

Tout ce qui est lent se passe à côté du site en fonctionnement. Le basculement lui-même ne dure qu’un instant. Ensuite, l’état précédent est conservé 7 jours : pendant ce temps, un retour en arrière est possible.

La page en un coup d’œil

1. Restauration est l’entrée de menu de la page, dans le menu de WordPress sous cloneworx.
2. La tuile principale indique la dernière bonne sauvegarde. Pendant une restauration, elle montre la progression, ensuite le retour en arrière ouvert.
3. Restaurer la dernière sauvegarde ouvre la tuile Préparer la restauration avec la dernière bonne sauvegarde.
4. Importer depuis un fichier ouvre la tuile pour l’import d’un fichier de sauvegarde.
5. Sauvegardes est la liste des sauvegardes. Sur cette page, elle sert de sélection pour la restauration.
6. Plus … ouvre le menu d’une sauvegarde.
7. Afficher plus ajoute les 7 lignes suivantes à la liste.
8. Étendu passe à la vue avec toutes les informations. Le choix vaut pour toutes les pages de l’extension.

Sous la tuile principale apparaissent au besoin le message de la page et l’une des deux tuiles Préparer la restauration et Importer depuis un fichier. Une seule des deux est ouverte à la fois.

La tuile principale

La tuile principale connaît trois états :

État	Ce que la tuile montre	Boutons
prête	Titre Restauration, en dessous Dernière sauvegarde réussie avec la date, la taille, les destinations et le type.	Restaurer la dernière sauvegarde et Importer depuis un fichier
restauration en cours	Titre La restauration est en cours, l’étape, une barre et la progression de la phase en cours.	Annuler, jusqu’à ce que le basculement commence
jaune retour en arrière ouvert	Titre Restauration appliquée, quand la restauration a été appliquée et jusqu’à quand elle peut être annulée.	Conserver la restauration et Annuler la restauration

• Une bonne sauvegarde est une sauvegarde qui s’est terminée complète ou avec des avertissements. Comme dernière bonne sauvegarde, la tuile indique la bonne sauvegarde la plus récente qui se trouve encore complète sur au moins une destination.
• S’il n’existe aucune sauvegarde de ce genre, on lit dans la tuile Pas encore de bonne sauvegarde : rien à restaurer. Le bouton Restaurer la dernière sauvegarde manque alors.
• Si une autre tâche est en cours, par exemple une sauvegarde, Restaurer la dernière sauvegarde est bloqué. Une seule tâche s’exécute à la fois.
• Pour aujourd’hui, hier et demain, la tuile principale écrit le mot à la place de la date. Les listes indiquent toujours la date complète.
• Si la page ne peut pas charger l’état, le message du serveur figure en rouge dans la tuile principale. Si elle ne peut pas charger la liste, le message figure en rouge au-dessus de la liste.

La liste des sauvegardes

1. La ligne indique la dernière bonne sauvegarde avec la date, la taille, la destination et le type.
2. Restaurer la dernière sauvegarde
3. Importer depuis un fichier
4. La ligne d’en-tête trie la liste : un clic sur un mot de colonne trie selon cette colonne, un deuxième clic inverse le sens. Le triangle se trouve sur la colonne triée.
5. Le cadenas marque une sauvegarde verrouillée.
6. Le point montre le résultat de la sauvegarde : vert pour complète, jaune pour avec avertissements, rouge pour échouée.
7. La coche verte signifie : la dernière vérification a trouvé la sauvegarde lisible et complète. Une croix rouge signifie : endommagée ou incomplète.
8. Plus … ouvre le menu de cette ligne.
9. Afficher plus ajoute les 7 lignes suivantes.

Les colonnes s’appellent Date, Taille, Destinations et Type. Dans la colonne Type, on lit Complète si la sauvegarde s’est terminée complète ou avec des avertissements, sinon l’état : Échouée, Interrompue ou En cours. À l’ouverture, la sauvegarde la plus récente est en haut.

• La liste montre 7 lignes. S’il y en a plus de 7, Afficher moins ramène aux 7 premières.
• Une sauvegarde annulée a un point gris, une sauvegarde en cours un anneau qui tourne.
• Si la liste est vide, on y lit Aucune sauvegarde pour l’instant.
• Si la liste devient trop étroite, la colonne Plan disparaît en premier, puis la colonne Taille.
• Le cadenas et la coche ont une infobulle : elle indique leur signification quand tu les pointes avec la souris ou que tu les touches.

Le menu d’une sauvegarde

1. Restauration ouvre la tuile Préparer la restauration avec cette sauvegarde.
2. Verrouiller la sauvegarde protège la sauvegarde contre la suppression automatique. Pour une sauvegarde verrouillée, l’entrée s’appelle Déverrouiller la sauvegarde.
3. Journal ouvre le journal de la sauvegarde.

• Restauration et Verrouiller la sauvegarde n’apparaissent que pour une bonne sauvegarde qui se trouve complète sur au moins une destination. Toute autre sauvegarde n’a que Journal.
• Vérifier, télécharger et supprimer se trouvent dans le menu sur la page Sauvegarde : La page « Sauvegarde ».
• Tant qu’une restauration est en cours ou qu’un retour en arrière est ouvert, Restauration n’ouvre pas la préparation. Une nouvelle restauration ne commence que lorsque tu as conservé ou annulé celle qui est ouverte.

Préparer la restauration

Restaurer la dernière sauvegarde et l’entrée Restauration du menu ouvrent la même tuile. La préparation ne change encore rien au site.

1. Fermer ferme la tuile.
2. Sauvegarde sélectionnée indique la date, la taille, les destinations et le type de la sauvegarde.
3. Dans la vue Compact, l’étendue est toujours la sauvegarde entière. La ligne indique son contenu.
4. Vérification préalable est la liste des neuf points avec leur résultat. Lancer la vérification préalable à côté répète la vérification préalable à la main.
5. Lancer la restauration ouvre le dialogue de confirmation. Le bouton est bloqué tant que la vérification préalable est en cours ou qu’un point bloque le démarrage.
6. Annuler ferme la tuile sans rien changer.

Derrière l’étendue et sous les boutons figurent deux indications qui valent pour chaque restauration : wp-config.php n’est jamais restauré. et Tu devras ensuite te reconnecter.

Étendue et interrupteurs dans la vue Étendu

1. Les cases à cocher montrent les racines de la sauvegarde. Ce qui est coché est restauré.
2. wp-config.php n’est jamais restauré.
3. Ne pas restaurer le cœur de WordPress laisse de côté le cœur de WordPress.
4. Ne pas restaurer les drop-ins (object-cache.php, advanced-cache.php, db.php) laisse de côté ces trois fichiers.
5. Ne pas restaurer .htaccess, web.config, .user.ini laisse de côté ces trois fichiers.
6. Déplacer les téléversements absents de la sauvegarde vers l’état précédent déplace vers l’état précédent les fichiers des téléversements que la sauvegarde ne contient pas.
7. Omettre les entrées endommagées (sinon une entrée endommagée arrête la restauration) restaure la sauvegarde sans ses entrées endommagées.

Une racine est une zone nommée du site, par exemple les extensions ou les téléversements. La tuile ne montre que les racines contenues dans cette sauvegarde : Base de données, wp-content (tout le reste), Plugins, Thèmes, Extensions incontournables (mu-plugins), Téléversements (uploads), Cœur de WordPress et Fichiers du dossier racine (.htaccess, robots.txt, …). Si aucune case n’est cochée, c’est la sauvegarde entière qui compte. Ce qui est réellement restauré est indiqué par le dialogue de confirmation avant le démarrage.

Interrupteur	Valeur par défaut	Effet
Ne pas restaurer le cœur de WordPress	Même site : non coché. Autre site ou origine inconnue : coché.	Le cœur reste tel qu’il est sur ce site. Si la sauvegarde ne contient pas le cœur, l’interrupteur est bloqué.
Ne pas restaurer les drop-ins (object-cache.php, advanced-cache.php, db.php)	Comme pour le cœur.	Les trois fichiers de la sauvegarde restent de côté. Les drop-ins propres à ce site passent, lors de la restauration de wp-content (tout le reste), dans l’état précédent, comme les autres entrées de cet endroit qui ne viennent pas de la sauvegarde.
Ne pas restaurer .htaccess, web.config, .user.ini	Comme pour le cœur.	Les trois fichiers restent tels qu’ils sont sur ce site.
Déplacer les téléversements absents de la sauvegarde vers l’état précédent	non coché	Par défaut, les fichiers des téléversements qui ne sont pas dans la sauvegarde restent en place. Si l’interrupteur est coché, ils passent dans l’état précédent et reviennent avec Annuler la restauration. Les fichiers du dossier racine qui ne sont pas dans la sauvegarde restent toujours en place.
Omettre les entrées endommagées (sinon une entrée endommagée arrête la restauration)	non coché	Par défaut, une entrée endommagée met fin à la restauration avant le basculement. Si l’interrupteur est coché, la restauration continue sans ces entrées précises. Si elle a omis des entrées, elle se termine avec des avertissements.

La vérification préalable établit si la sauvegarde provient de ce site ou d’un autre. Les interrupteurs montrent donc toujours ce qui va se passer : ton choix, sinon la valeur par défaut de la vérification préalable. Jusqu’à ce que la première vérification préalable ait répondu, l’indication que la vérification préalable est en cours et fixe les valeurs par défaut figure à sa place.

Pour la sauvegarde d’un autre site, les trois premiers interrupteurs sont cochés après la vérification préalable :

1. Ne pas restaurer le cœur de WordPress est coché : le cœur reste celui de ce site.
2. Ne pas restaurer les drop-ins (object-cache.php, advanced-cache.php, db.php) est coché : les trois fichiers de la sauvegarde restent de côté.
3. Ne pas restaurer .htaccess, web.config, .user.ini est coché : les trois fichiers restent ceux de ce site.

Pour en savoir plus : Restaurer une sauvegarde sur un autre site.

La vérification préalable

La vérification préalable s’exécute d’elle-même dès que la tuile s’ouvre, et à nouveau après chaque modification de l’étendue ou des interrupteurs. Avant que la restauration n’écrive quoi que ce soit, neuf points sont ainsi vérifiés. Chaque point se termine par l’un de quatre états : OK, Avertissement, Bloqué ou Non vérifié.

• Un avertissement ne bloque pas le démarrage : tu juges le risque.
• Si un point bloque, on lit sous la liste La vérification préalable bloque le démarrage., et Lancer la restauration reste bloqué.
• Si l’espace ne suffit pas pour préparer les téléversements à côté du dossier actif, le bloc Pas de retour en arrière apparaît : Restaurer les uploads quand l’espace ne suffit pas.

Chaque point, avec ses constats, est expliqué dans La vérification préalable de la restauration : chaque point expliqué.

Le dialogue de confirmation

Lancer la restauration demande une fois confirmation avant que quelque chose ne se passe. La boîte de dialogue s’appelle Démarrer la restauration ?

1. Le texte indique la sauvegarde qui est restaurée et le délai : l’état précédent est conservé 7 jours.
2. La ligne indique ce qui est restauré : base de données, fichiers, cœur de WordPress.
3. Tu devras ensuite te reconnecter.
4. Annuler ferme le dialogue de confirmation. La préparation reste ouverte.
5. Lancer la restauration lance la restauration.

• Si au moins un point de la vérification préalable avertit, le dialogue de confirmation indique en plus … point(s) de la vérification préalable avertissent ; tu as jugé le risque.
• Si tu as coché Remplacer quand même les téléversements sur place (irréversible), le dialogue de confirmation répète ce choix en rouge, et le bouton Lancer la restauration est rouge.

La restauration est en cours

1. La ligne indique l’étape avec son numéro, le nombre d’étapes et son nom, par exemple « Étape 2 sur 5 : Préparation des fichiers ».
2. La ligne indique la phase en cours et sa progression : entrées, taille et temps restant.
3. Annuler la sauvegarde annule aussi une restauration. Le lien porte ici le même nom que pour la sauvegarde.
4. Annuler annule la restauration. Le bouton est présent jusqu’à ce que le basculement commence.

Les étapes d’une restauration dépendent de l’étendue :

Étape	Ce qui se passe
Vérification préalable	Les neuf points s’exécutent à nouveau. Si un point bloque, la restauration se termine avant que quelque chose ne soit écrit.
Préparation des fichiers	Dans chaque dossier racine, l’extension crée son propre dossier et y écrit les fichiers de la sauvegarde. Elle lit une destination locale sur place. Depuis une destination distante, elle récupère les parties une à une dans son dossier de travail, les vérifie et les y supprime ensuite. Si tu ne restaures que la base de données, l’étape s’appelle Récupération des parties.
Importation de la base de données	Seulement avec la base de données. Chaque table de la sauvegarde est créée sous un nom provisoire à côté des tables actives et remplie. Si le serveur de base de données signale une erreur, l’extension répète l’étape après 5 puis après 15 secondes. Le troisième échec consécutif met fin à la restauration avant que quelque chose ne soit basculé.
Basculement	L’extension compte les fichiers des téléversements et du dossier racine qui ne sont pas dans la sauvegarde, et bascule les téléversements et les fichiers du dossier racine fichier par fichier. Suit ensuite le basculement en mode maintenance de WordPress : d’abord toutes les tables de la base de données d’un coup, puis le cœur, les extensions incontournables, les extensions, les thèmes et le reste de wp-content. Ensuite, le nouveau site se confirme.
Confirmation	La conclusion. Avec la base de données, une étape s’exécute dans le nouveau WordPress : le cache d’objets est vidé, les permaliens sont réécrits, la planification de l’extension est redéfinie. Puis l’extension définit les droits des dossiers.

• Au début, on lit à la place du temps calcul du temps restant …
• Après un clic sur Annuler, on lit dans la tuile Annulation demandée ; la sauvegarde s’arrête à la prochaine étape. La restauration s’arrête à la prochaine étape, et la page signale Restauration interrompue ; rien n’a été basculé.
• La page continue de montrer la progression, même si ta connexion devient invalide après le basculement de la base de données. Si tu recharges la page, elle retrouve la restauration en cours.

La confirmation après le basculement

1. La ligne indique l’étape « Basculement ». Le bouton Annuler a disparu : à partir du basculement, la restauration ne peut plus être annulée. Le lien Annuler la sauvegarde est encore là, mais n’a plus d’effet à partir d’ici. Ensuite, la restauration peut être annulée par un retour en arrière.
2. Le nouveau site se confirme ; cette page aide si le serveur ne peut pas s’appeler lui-même.

Après le basculement, le nouveau site doit se confirmer. Pour cela, l’extension appelle sa propre adresse. Une réponse n’arrive que si WordPress, les extensions et le thème du nouvel état se chargent. La page Restauration ouverte appelle la même adresse, pour les serveurs qui bloquent les requêtes vers eux-mêmes.

• Si la confirmation n’arrive pas dans les 60 secondes, la même étape rebascule tout. Le site fonctionne alors de nouveau dans l’état précédent après quelques secondes, et la restauration se termine comme échouée.
• Après la confirmation, l’extension appelle une fois la page d’accueil. Si elle signale une erreur grave, cela figure comme avertissement dans le journal. La restauration reste, c’est toi qui décides.

Le résultat

Le résultat apparaît sous forme de message sous la tuile principale.

Message	Signification
vert Restauration appliquée · Tu devras ensuite te reconnecter.	La restauration est appliquée. Le message se ferme de lui-même après 8 secondes ; la tuile principale montre le retour en arrière ouvert.
jaune Restauration appliquée · Tu devras ensuite te reconnecter.	La restauration est appliquée avec des avertissements. Le message reste jusqu’à ce que tu le fermes. Les avertissements figurent dans le journal de la restauration : dans la vue Étendu, dans la tuile Dernières restaurations.
jaune Restauration interrompue ; rien n’a été basculé.	Tu as annulé la restauration avant le basculement. Le site est inchangé.
rouge La restauration a échoué : …	Le message indique la raison. Journal qui suit ouvre le journal de la restauration. Si le serveur refuse déjà le démarrage, c’est Afficher le journal qui suit ; le lien ouvre le journal général.

Le message rouge indique ces raisons :

Raison	Ce que cela signifie
La vérification préalable a bloqué le démarrage.	Un point de la vérification préalable a bloqué à la première étape. Rien n’a été écrit. Ouvre à nouveau la préparation et lis la vérification préalable.
La sauvegarde a des entrées endommagées ; rien n’a été basculé.	Le journal indique le nombre d’entrées endommagées et les cinq premières. Prends une autre sauvegarde, ou choisis dans la vue Étendu Omettre les entrées endommagées (sinon une entrée endommagée arrête la restauration).
Le nouveau site ne s’est pas confirmé à temps ; l’état précédent est de retour.	Le nouvel état n’a pas pu se charger, ou la confirmation n’est pas arrivée. Le site fonctionne dans l’état précédent.
Le basculement a échoué ; l’état précédent est de retour.	L’extension a annulé le basculement. Le site fonctionne dans l’état précédent.
Le basculement des tables de la base de données a échoué ; rien n’a été basculé.	Le serveur de base de données n’a pas exécuté le renommage des tables. Si d’autres connexions occupent les tables, l’extension réessaie après 5 puis après 15 secondes ; seul le troisième échec met fin à la restauration. Le journal indique l’erreur du serveur de base de données.
L’import de la base de données a échoué trois fois ; rien n’a été basculé.	Une étape de l’import a échoué trois fois de suite à cause d’une erreur du serveur de base de données, par exemple parce que la connexion s’est rompue. Les tables provisoires ont été supprimées.
Une partie a échoué deux fois à la vérification.	Pour la restauration, cela signifie : une partie récupérée depuis la destination ne correspond pas à sa somme de contrôle. Rien n’a été basculé. Vérifie la sauvegarde : Vérifier une sauvegarde.
Rien à restaurer.	Des racines choisies, il n’en reste aucune à restaurer. Vérifie l’étendue et les interrupteurs.
Une tâche est déjà en cours.	Le serveur a refusé le démarrage : une seule tâche s’exécute à la fois. Attends qu’elle soit terminée, puis relance la restauration.

Si la page ne connaît pas de phrase pour une raison, on y lit Cause : … avec un code en anglais ; les détails figurent dans le journal. Si la lecture depuis la destination échoue, le message indique en plus la destination et le message inchangé de la destination. Une restauration échouée et une restauration annulée envoient un e-mail comme une sauvegarde échouée, si En cas d’erreurs et d’avertissements est activé dans les notifications.

Le retour en arrière ouvert

1. La ligne indique quand la restauration a été appliquée et jusqu’à quand elle peut être annulée.
2. Les tables et dossiers précédents sont conservés 7 jours. Conserve la restauration ou annule-la ; après 7 jours, elle est conservée automatiquement.
3. Conserver la restauration supprime l’état précédent : les tables et dossiers précédents. Ensuite, il n’y a plus de retour en arrière.
4. Annuler la restauration ramène l’état précédent.

Les deux boutons démarrent aussitôt, sans demande de confirmation. Le travail s’exécute comme tâche ; la tuile principale montre la progression, et les deux boutons sont bloqués pendant ce temps.

Message	Signification
vert Restauration conservée. Les tables et dossiers précédents ont été supprimés.	Le retour en arrière est fermé. La tuile principale est de nouveau prête.
vert Restauration annulée. Le site fonctionne de nouveau dans l’état précédent.	L’état précédent est de retour. La tuile principale est de nouveau prête.
rouge Cela n’a pas fonctionné : …	Le message indique la raison.

• S’il y a eu des avertissements lors de la conservation ou de l’annulation, la même phrase figure dans un message jaune.
• Les deux boutons fonctionnent aussi après la reconnexion, tant que le retour en arrière est ouvert.
• Après 7 jours, l’extension conserve la restauration d’elle-même.
• Les téléversements qui ont été remplacés sur place n’ont pas de retour en arrière. Annuler la restauration ramène alors tout le reste ; les téléversements restent tels que la restauration les a écrits.
• La page Vue d'ensemble montre également le retour en arrière ouvert, avec le lien Conserver ou annuler.

Pas à pas : Conserver ou annuler une restauration.

Importer depuis un fichier

Importer depuis un fichier ouvre une tuile avec une zone de téléversement, le bouton Choisir un fichier, le menu déroulant Importer vers la destination et le bouton Importer. Tu choisis le fichier de sauvegarde (.tar) que cette extension a téléchargé, et la destination sur laquelle la sauvegarde est stockée.

Le téléversement se fait en parties. Ensuite, l’extension vérifie la sauvegarde, la stocke sur la destination choisie et l’inscrit dans la liste. De là, tu la restaures comme toute autre sauvegarde. Pas à pas : Importer une sauvegarde depuis un fichier.

La vue Étendu

Dans la vue Étendu s’ajoutent :

• la colonne Plan dans la liste des sauvegardes,
• les racines et les interrupteurs dans la tuile Préparer la restauration,
• la tuile Dernières restaurations sous la liste.

1. La colonne indique ce qui s’est exécuté : Sauvegarde du … pour la restauration de cette sauvegarde, sinon Conserver la restauration ou Annuler la restauration.
2. La colonne indique l’état, par exemple Annulation possible, conservée ou annulée.
3. Durée indique combien de temps la tâche a duré.
4. La flèche déplie et replie la tuile. Un clic sur la ligne de titre fait la même chose.
5. Le point montre le résultat : vert pour réussi, jaune pour avec avertissements, rouge pour échoué ou interrompu.
6. Journal ouvre le journal de cette tâche.

État	Signification
En cours	La tâche est encore en cours.
confirmée	La restauration est appliquée. Le mot figure là quand rien n’est consigné à propos du retour en arrière.
Annulation possible	La restauration est appliquée, l’état précédent est encore là.
conservée	La restauration a été conservée, l’état précédent est supprimé.
annulée	La restauration a été annulée. Le même mot figure pour une restauration qui a échoué et dont l’extension a annulé le basculement.
Échouée	La tâche a échoué.
Interrompue	La tâche a été interrompue.

Pour une restauration en cours et pour une restauration interrompue, on lit dans la colonne précédente Annuler la restauration à la place de la sauvegarde.

La tuile est repliée quand tu ouvres la page. Dépliée, elle montre 7 lignes, la plus récente en premier. Afficher plus en ajoute 7 à la fois, jusqu’à 100 au plus ; Afficher moins revient en arrière. Tant qu’aucune restauration n’a encore eu lieu, on y lit Pas encore de restauration.

Le journal

Journal dans le menu d’une sauvegarde, dans la tuile Dernières restaurations et derrière un message rouge ouvre la même boîte de dialogue. Elle montre les 500 dernières lignes du journal, avec pour chaque ligne l’heure, le niveau et le message. Les journaux sont en anglais. Pour en savoir plus : Progression, messages et journal.

Voir aussi

• Restaurer le site à partir d’une sauvegarde
• La vérification préalable de la restauration : chaque point expliqué
• Ne restaurer que des parties
• Restaurer une sauvegarde sur un autre site
• Restaurer et importer avec WP-CLI

En ligne de commande

WP-CLI n’est pas encore installé ? Voici comment installer WP-CLI.

La vérification préalable, la restauration, la conservation, l’annulation et l’import fonctionnent aussi avec WP-CLI. Tu désignes une sauvegarde par son nom de tâche ; backup list montre les noms de tâche. La commande confie le basculement lui-même au serveur web, parce que c’est là que le nouveau site se confirme.

# Afficher les sauvegardes avec leur nom de tâche
wp cloneworx-backup backup list

# Exécuter la vérification préalable pour une sauvegarde
wp cloneworx-backup restore precheck <Job>

# Restaurer la sauvegarde entière
wp cloneworx-backup restore run <Job>

# Restaurer seulement la base de données
wp cloneworx-backup restore run <Job> --roots=db

# Afficher la restauration en cours ou le retour en arrière ouvert
wp cloneworx-backup restore status

# Conserver la restauration : l’état précédent est supprimé
wp cloneworx-backup restore keep

# Annuler la restauration : l’état précédent revient
wp cloneworx-backup restore undo

# Importer une sauvegarde depuis un fichier vers une destination
wp cloneworx-backup import /tmp/backup.tar --target=local-1