Depuis la ligne de commande, tu vois en une commande si ton site est sauvegardé. Tu récupères les journaux et le rapport de support, tu actives le débogage, tu vérifies les notifications et tu observes ou termines la tâche en cours.
WP-CLI manque encore ? Le guide se trouve dans Installer WP-CLI. Toutes les commandes de l’extension sont présentées dans Les commandes en un coup d’œil.
Les sorties des commandes sont en anglais. Certaines actions vérifient d’abord l’utilisateur : la commande doit s’exécuter en tant que l’utilisateur à qui appartiennent les dossiers de l’extension. --force passe outre la vérification. Les sections ci-dessous mentionnent le paramètre là où il existe.
Afficher l’état du site : status
status affiche le même résultat que la tuile d’état de la page Vue d'ensemble. La commande n’a ni actions ni paramètres et ne change rien.
# Afficher l’état du site wp cloneworx-backup status
La première ligne indique l’état. Si plusieurs s’appliquent, l’ordre du tableau prévaut :
| État | Couleur de la tuile d’état | Signification |
|---|---|---|
error |
rouge | La dernière sauvegarde a échoué. |
overdue |
rouge | Un plan de sauvegarde actif n’a pas fait de bonne sauvegarde à temps. |
disconnected |
jaune | Une destination est déconnectée. |
warn |
jaune | Le site est sauvegardé ; la dernière sauvegarde s’est terminée avec des avertissements. |
ok |
vert | Le site est sauvegardé. |
none |
gris | Il n’y a pas encore de sauvegarde. |
En dessous figurent les détails. Les lignes plans et operation sont toujours présentes, les autres seulement s’il y a quelque chose à indiquer :
| Ligne | Signification |
|---|---|
last backup |
La dernière sauvegarde : nom de la tâche, statut, fin, taille et, par destination, l’état. |
last good backup |
La dernière bonne sauvegarde, si elle est différente de la dernière. |
overdue |
Le plan en retard et depuis combien de temps il est dû ou n’a pas fait de bonne sauvegarde. |
disconnected |
La destination déconnectée avec la raison. S’il y en a plusieurs, la ligne indique le nombre. |
warnings |
Les avertissements de la dernière sauvegarde, comptés par type. |
plans |
Combien de plans sont actifs, combien il y en a et le nombre de destinations. |
alarm |
Les plans pour lesquels un avertissement de sauvegarde en retard est en cours. |
operation |
Le fonctionnement : le résultat, le dernier cycle automatique avec son planificateur, WP-Cron et l’auto-requête. |
Le résultat dans la ligne operation est ok, late ou missing. late signifie : il y a un plan actif, mais aucun planificateur automatique n’est arrivé depuis deux heures. missing signifie : il manque au serveur un prérequis de l’extension.
Récupérer les journaux : logs
logs liste les fichiers journaux de l’extension ou les écrit tous dans un fichier tar. Il y a le journal général avec son fichier précédent et, par tâche, un journal propre.
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--to |
Écrit tous les journaux dans ce fichier tar. Le fichier ne doit pas encore exister, et son dossier doit être accessible en écriture. Sans ce paramètre, la commande n’affiche que la liste. | Chemin d’un fichier |
# Lister les fichiers journaux wp cloneworx-backup logs # Écrire tous les journaux dans un fichier tar wp cloneworx-backup logs --to=/tmp/cloneworx-logs.tar
La liste indique par fichier le nom, la taille et la dernière modification, à la fin le nombre de fichiers et leur taille totale. Le fichier tar n’est pas compressé et contient le dossier cloneworx-backup-logs. C’est le même fichier que pour Télécharger tous les journaux sur la page Réglages.
Comment lire un journal, c’est expliqué dans Lire le journal.
Créer le rapport de support : support
support affiche le rapport de support sous forme de texte ou l’écrit dans un fichier. C’est le même rapport que pour Copier le rapport de support sur la page Réglages.
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--to |
Écrit le rapport dans ce fichier. Le fichier ne doit pas encore exister. Sans ce paramètre, le rapport apparaît dans la sortie. | Chemin d’un fichier |
# Afficher le rapport dans la sortie wp cloneworx-backup support # Écrire le rapport dans un fichier wp cloneworx-backup support --to=/tmp/cloneworx-bericht.txt
Le rapport comporte les sections site, serveur, extension, réglages, fonctionnement, destinations, plans, les dix dernières tâches, périmètre, diagnostic et les 40 dernières lignes du journal général. Le rapport est en anglais.
Ne figurent pas dans le rapport : les noms de tâche et autres identifiants de 32 caractères, les noms des destinations et des plans, les emplacements et les identifiants des destinations, les adresses e-mail et les chemins du serveur. Les destinations et les plans apparaissent avec leur identifiant, les adresses e-mail seulement sous forme de nombre, les chemins comme <wp>, <wp-content> et <uploads>. Le rapport contient l’adresse du site, par destination le type de destination et l’état, et par plan le rythme, les racines, les destinations et le nombre pour Sauvegardes max..
Rien n’est envoyé
La commande n’envoie le rapport nulle part. Lis-le avant de le transmettre.
Activer le débogage : debug
Avec le débogage, l’extension écrit des lignes détaillées dans le journal. Après 24 heures, il se désactive de lui-même. Dans l’interface, l’interrupteur s’appelle Débogage pendant 24 heures.
| Action | Objectif |
|---|---|
debug on |
Active le débogage et indique le moment jusqu’auquel il reste actif. |
debug off |
Désactive le débogage. |
debug status |
Affiche si le débogage est actif et jusqu’à quand. Sans action, wp cloneworx-backup debug fait la même chose. |
on et off connaissent le paramètre --force.
# Activer le débogage wp cloneworx-backup debug on # Afficher l’état wp cloneworx-backup debug status # Désactiver le débogage wp cloneworx-backup debug off
Si l’extension ne peut pas écrire son journal, chacune des trois actions avertit et indique la raison.
Vérifier les notifications : notify
| Action | Objectif |
|---|---|
notify status |
Affiche les destinataires, les trois interrupteurs des notifications, les avertissements en cours pour sauvegardes en retard, la dernière vérification, le dernier e-mail envoyé et le dernier échec d’envoi. Sans action, wp cloneworx-backup notify fait la même chose. |
notify check |
Vérifie maintenant si un plan est en retard. Si un avertissement commence ou qu’un rappel est dû, l’extension envoie l’e-mail, si cette notification est activée. |
notify test |
Envoie un e-mail de test aux destinataires saisis. Si personne n’est saisi, il va à l’adresse d’administration du site. |
check et test connaissent le paramètre --force.
# Afficher l’état des notifications wp cloneworx-backup notify status # Vérifier maintenant les sauvegardes en retard wp cloneworx-backup notify check # Envoyer un e-mail de test wp cloneworx-backup notify test
Un plan est en retard si sa dernière bonne sauvegarde est plus ancienne que son rythme plus une tolérance. La tolérance est la moitié du rythme, au moins 6 heures : un plan quotidien est en retard après 36 heures. Cette vérification s’exécute d’elle-même à chaque planificateur, au plus toutes les 15 minutes.
notify check nomme les plans en retard et compte combien d’avertissements ont commencé, ont été rappelés et sont terminés, et combien d’e-mails ont été envoyés. notify test indique les adresses auxquelles l’e-mail de test est parti. Si WordPress refuse l’envoi, la commande se termine par une erreur et indique la raison.
Les destinataires et les interrupteurs se modifient avec wp cloneworx-backup settings ; voir Réglages et périmètre avec WP-CLI.
S’abonner et se désabonner des nouveautés : news
news affiche, commence ou termine l’abonnement aux nouveautés de cloneworx Backup. Dans l’interface, c’est l’interrupteur M’informer des nouveautés et mises à jour importantes de cloneworx Backup.
| Action | Objectif |
|---|---|
news status |
Affiche l’état : off, pending (la confirmation est en attente) ou subscribed. L’adresse n’apparaît qu’abrégée. Sans action, wp cloneworx-backup news fait la même chose. |
news subscribe |
Abonne l’adresse de --email. |
news unsubscribe |
Désabonne. Dans l’extension, c’est immédiat. |
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--email |
Seulement subscribe : l’adresse qui est abonnée. Obligatoire. |
une adresse e-mail |
--force |
Seulement subscribe et unsubscribe : s’exécute aussi en tant qu’un autre utilisateur. |
sans valeur |
# Afficher l’état wp cloneworx-backup news status # Abonner une adresse wp cloneworx-backup news subscribe --email=admin@example.com # Se désabonner wp cloneworx-backup news unsubscribe
Si l’extension n’atteint pas le serveur des nouveautés ou si le serveur refuse, news subscribe se termine par une erreur et indique la raison. Rien n’est alors abonné. Si le serveur ne confirme pas un désabonnement, news unsubscribe avertit ; dans l’extension, l’abonnement est malgré tout terminé.
L’appel vaut consentement
news subscribe envoie l’adresse, le domaine, la langue du site, la version de l’extension et le moment du consentement au serveur des nouveautés de cloneworx. Qui exécute la commande y consent. Le serveur confirme l’abonnement par e-mail.
Observer, mener, interrompre la tâche en cours : job
Une sauvegarde, une restauration, une vérification : tout ce qui dure plus longtemps s’exécute comme une tâche en de nombreuses étapes courtes. Une seule tâche s’exécute à la fois par site. job travaille avec la tâche en cours d’exécution.
| Action | Objectif |
|---|---|
job status |
Affiche la tâche en cours. Sans action, wp cloneworx-backup job fait la même chose. |
job run |
Mène la tâche en cours jusqu’au bout dans ce processus, sans pauses entre les étapes. |
job abort |
Programme l’interruption. La tâche s’arrête à son prochain point d’arrêt, nettoie et se termine comme interrompue. |
job probe |
Lance un test de charge : une tâche sans données qui mesure le serveur. |
# Afficher la tâche en cours wp cloneworx-backup job status # Faire avancer ici la tâche en cours jusqu’à la fin wp cloneworx-backup job run # Annuler la tâche en cours wp cloneworx-backup job abort
job status indique le nom de la tâche, le type de tâche, qui l’a lancée et si une étape travaille actuellement. En dessous figurent la progression avec phase, entrées, octets et temps restant, et les compteurs : étapes, étapes terminées brutalement, tentatives sans progression, avertissements. Si aucune tâche n’est en cours, la commande le dit.
job run écrit une ligne par étape et, à la fin, le résultat de la tâche. Si un autre processus mène déjà la tâche, la commande attend brièvement puis abandonne. La tâche continue sans elle.
Le test de charge : job probe
Le test de charge mesure combien de temps une étape survit réellement sur ton serveur, quels planificateurs arrivent, à quelle vitesse le dossier de travail écrit et combien de mémoire est disponible. Il ne sauvegarde rien et ne touche aucune destination.
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--units |
Le nombre d’unités de travail. | nombre entier, par défaut 200 |
--unit-ms |
Le travail simulé par unité en millisecondes. | nombre entier, par défaut 50 |
--background |
La commande lance le test de charge et envoie la première auto-requête. Ensuite, la tâche se mène d’elle-même via le serveur web. Le résultat montre alors les limites du serveur web, pas celles de la ligne de commande. | sans valeur |
--force |
S’exécute aussi en tant qu’un autre utilisateur. | sans valeur |
# Un test de charge sur plusieurs étapes : environ 100 secondes wp cloneworx-backup job probe --units=2000 --unit-ms=50 # Le même test de charge, mené par le serveur web wp cloneworx-backup job probe --units=2000 --unit-ms=50 --background
Le résultat figure ensuite aussi sur la page Réglages dans la tuile Système et support, dans le bloc Diagnostic de la vue Étendu.
Autres tâches de diagnostic
Trois autres actions lancent des tâches de diagnostic. Aucune ne fait de sauvegarde ; ce qu’elles écrivent, elles le suppriment à la fin.
| Action | Objectif | Paramètres propres |
|---|---|---|
job filelist |
Construit la liste des fichiers : ce qu’une sauvegarde contiendrait, ce qui est omis et si l’espace libre suffit. |
--roots, --targets
|
job dbexport |
Exporte la base de données dans le dossier de travail, relit l’export et compare les lignes par table. |
--tables, --no-snapshot
|
job files |
Écrit la partie fichiers d’une sauvegarde dans le dossier de travail et vérifie chaque partie. Avec --targets, la tâche transfère les parties vers ces destinations, les y vérifie et les supprime à nouveau. |
--roots, --targets, --part-limit (taille d’une partie en Mo, par défaut 256) |
Les trois connaissent en outre --max-per-step, --background et --force.
# Afficher ce que contiendrait une sauvegarde des téléversements et des plugins wp cloneworx-backup job filelist --roots=wp-uploads,wp-plugins # Vérifier l’export de la base de données wp cloneworx-backup job dbexport