3,054
edits
Changes
From SME Server
Jump to navigationJump to search→Installation d'Affa v.3
{{Languages|Affa}}
{{Languages|Affa}}
{{Level|type=Niveau de compétence : Avancé|Advanced|Les instructions dans cette page requièrent un niveau avancé. Une bonne compréhension de Linux et de SME est recommandée.}}
{{Level|type=Niveau de compétence : Avancé|Advanced|Les instructions dans cette page requièrent un niveau avancé. Une bonne compréhension de Linux et du serveur KOOZALI SME est recommandée.}}
{{usefulnote/fr}}
{{usefulnote/fr}}
==== Un coup d’œil aux caractéristiques d'Affa ====
==== Un coup d’œil aux caractéristiques d'Affa ====
* Affa est sûr : tous les transferts et connexions sont faits en utilisant le protocole ssh avec une authentification par clés publique/privée.
* Affa est sûr : tous les transferts et connexions sont faits en utilisant le protocole ssh avec une authentification par clés publique/privée (mais DSA, cf. « Attention » ci-dessous).
* Lance périodiquement des sauvegardes complètes sans intervention.
* Lance périodiquement des sauvegardes complètes sans intervention.
* Seules les différences avec la sauvegarde complète précédente sont transférées par le réseau.
* Seules les différences avec la sauvegarde complète précédente sont transférées par le réseau.
* Des répertoires et fichiers peuvent être exclus de la sauvegarde.
* Des répertoires et fichiers peuvent être exclus de la sauvegarde.
* Les serveurs Linux non SME peuvent être sauvegardés en mettant la propriété SMEServer à 'no' et en utilisant une liste d'inclusion.
* Les serveurs Linux non SME peuvent être sauvegardés en mettant la propriété SMEServer à 'no' et en utilisant une liste d'inclusion.
{{Warning box|type=Attention :| si vous souhaitez sauvegarder un serveur Linux assez récent (Debian 9 et supérieur, ...), Affa qui utilise des clés DSA ne pourra pas se connecter à votre serveur qui voudra des clés RSA. Cf. [[https://bugs.contribs.org/show_bug.cgi?id=10783 bogue 10783]]. Un patch est disponible mais lisez bien le commentaire 8, tout n'est pas réglé.}}
* En mode ESXi, les machines virtuelles actives peuvent être sauvegardées. Voir [[Backup_of_ESXi_Virtual_Machines_using_Affa|Sauvegarde de machines virtuelles ESXi avec Affa]] en anglais.
* En mode ESXi, les machines virtuelles actives peuvent être sauvegardées. Voir [[Backup_of_ESXi_Virtual_Machines_using_Affa|Sauvegarde de machines virtuelles ESXi avec Affa]] en anglais.
* Priorité configurable (nice level) pour les process rsync sur les serveurs backup et source.
* Priorité configurable (nice level) pour les process rsync sur les serveurs backup et source.
Pour installer Affa v.3, saisir la commande suivante :
Pour installer Affa v.3, saisir la commande suivante :
- pour SME 10
yum install smeserver-affa --enablerepo=smecontribs,openfusion
- pour SME9
yum install smeserver-affa --enablerepo=smecontribs
yum install smeserver-affa --enablerepo=smecontribs
Le serveur a, de nouveau, besoin d'être mis à jour.
Le serveur a, de nouveau, besoin d'être mis à jour.
affa --configcheck
affa --configcheck
Cela ne devrait révéler aucune erreur.
Cela ne devrait révéler aucune erreur.
</li><li>Maintenant créez / envoyez vos fichiers de clés à votre serveur SME de production :
</li><li>Maintenant créez vos clés dsa et envoyez votre clé publique à votre serveur SME de production :
affa --send-key backup-smeserver
affa --send-key backup-smeserver
{{Note box|type=Note :|initialement, lorsque vous faites cette étape, vous devez temporairement mettre «oui» à "Autoriser l'authentification par SSH à l'aide de mots de passe standards" dans l'accès à distance sur le serveur de production. [[https://wiki.contribs.org/SME_Server:Documentation:Administration_Manual:Chapter11/fr#11.1._Acc.C3.A9s_.C3.A0_distance]]}}
{{Note box|type=Note :|initialement, lorsque vous faites cette étape, vous devez temporairement mettre «oui» à "Autoriser l'authentification par SSH à l'aide de mots de passe standards" dans l'accès à distance sur le serveur de production. [[https://wiki.contribs.org/SME_Server:Documentation:Administration_Manual:Chapter11/fr#11.1._Acc.C3.A9s_.C3.A0_distance]]}}
{{Warning box|type=Attention :| il est possible que certaines machines sauvegardées (non SME-KOOZALI) renvoient une erreur si elles n'acceptent plus les clés dsa ; voir le bogue [[http://bugs.contribs.org/show_bug.cgi?id=10783]]}}
Les sorties suivantes doivent apparaître sur la console :
Les sorties suivantes doivent apparaître sur la console :
| oui
| oui
| 2230
| 2230
| L'horaire à laquelle la tâche s'exécutera. Utiliser exactement 4 chiffres, pas de virgule, pas de point. '''Important :''' l'utilisation du format correct HHMM est essentielle. Des horaires mal formatés causeront d’étranges erreurs Perl. Pour plusieurs sauvegardes par jour, répéter la ligne pour chaque horaire.
| L'horaire à laquelle la tâche s'exécutera. Utiliser exactement 4 chiffres, pas de virgule, pas de point. '''Important :''' l'utilisation du format correct HHMM est essentielle. Des horaires mal formatés causeront d’étranges erreurs Perl. Pour obtenir plusieurs sauvegardes par jour, répéter la ligne : une ligne pour chaque horaire désiré.
|-
|-
| status
| status
=== Utilisation et options de ligne de commande ===
=== Utilisation et options de ligne de commande ===
{{Note box|Les options peuvent être abrégées tant qu'elles restent uniques, ex. --mak est identique à --make-cronjobs}}
{{Note box|type=Note :|les options peuvent être abrégées tant qu'elles restent uniques, ex. --mak est identique à --make-cronjobs.}}
'''affa --run JOB'''
'''affa --run JOB'''
'''affa --make-cronjobs'''
'''affa --make-cronjobs'''
Configure les tâches cron comme programmées dans les enregistrements de tâches. Exécutez cette commande pour que les changements de configuration liés au temps soient efficaces, c'est-à-dire les propriétés de TimeSchedule, killAt et resumeKilledAt. Toutes les 15 minutes, Affa vérifie si un fichier de configuration est plus récent que le fichier cronjob et exécute la commande make-cronjobs si tel est le cas. Donc, vous n'avez pas besoin d'exécuter cette commande manuellement, vous pouvez également attendre au maximum 15 minutes avant l'entrée en vigueur de vos mises à jour.
Configure les tâches cron comme programmées dans les enregistrements de tâches. Exécutez cette commande pour appliquer les modifications des propriétés liées au temps, c’est-à-dire TimeSchedule, killAt et resumeKilledAt. Exécutez cette commande pour que les changements de configuration liés au temps, c'est-à-dire les propriétés de TimeSchedule, killAt et resumeKilledAt, soient efficients. Toutes les 15 minutes, Affa vérifie si un fichier de configuration est plus récent que le fichier cronjob et exécute la commande make-cronjobs si tel est le cas. Donc, vous n'avez pas besoin d'exécuter cette commande manuellement, vous pouvez également attendre au maximum 15 minutes avant l'entrée en vigueur de vos mises à jour.
'''affa --configcheck'''
'''affa --configcheck'''
Génère d'abord la clé DSA pour le serveur Affa, si cela n'a pas déjà été fait. Envoie ensuite la clé publique à l'hôte 'remoteHostName' comme configuré dans l'enregistrement de la tâche et génère l'entrée ssh known host (hôte connu) spécifique à la tâche.
Génère d'abord la clé DSA pour le serveur Affa, si cela n'a pas déjà été fait. Envoie ensuite la clé publique à l'hôte 'remoteHostName' comme configuré dans l'enregistrement de la tâche et génère l'entrée ssh known host (hôte connu) spécifique à la tâche.
{{Note box|Initialement, lorsque vous faites cette étape, vous aurez besoin d'activer '''temporairement''' «Autoriser l'authentification par SSH à l'aide de mots de passe standards» sur le serveur de production.}}
{{Note box|type=Note :|initialement, lorsque vous faites cette étape, vous aurez besoin d'activer '''temporairement''' «Autoriser l'authentification par SSH à l'aide de mots de passe standards» sur le serveur de production.}}
{{Note box|<nowiki>l'option --send-key fonctionne pour SME Server comme serveur distant et pour les systèmes sur lesquels les clés publiques sont stockées dans /root/.ssh/authorized_keys2 et sur lesquels les commandes /bin/cat, /bin/touch, /bin/grep et /bin/mv sont disponibles. Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}
{{Note box|type=Note :|<nowiki>l'option --send-key fonctionne pour SME Server comme serveur distant et pour les systèmes sur lesquels les clés publiques sont stockées dans /root/.ssh/authorized_keys2 et sur lesquels les commandes /bin/cat, /bin/touch, /bin/grep et /bin/mv sont disponibles. Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}
'''affa --check-connections [JOB JOB ...]'''
'''affa --check-connections [JOB JOB ...]'''
Vérifie la connexion ssh et, si nécessaire, rsyncd auth, pour toutes les tâches données en arguments. Sans aucun argument, toutes les tâches sont vérifiées.
Vérifie la connexion ssh et, si nécessaire, rsyncd auth, pour toutes les tâches données en arguments. Sans aucun argument, toutes les tâches sont vérifiées. Pour les tâches pour lesquelles la clé publique n'avait pas encore été envoyée, il vous sera demandé le mot de passe et la clé sera envoyée ensuite.
'''affa --full-restore JOB [ARCHIVE]'''
'''affa --full-restore JOB [ARCHIVE]'''
'''affa --cleanup JOB'''
'''affa --cleanup JOB'''
Après avoir abaissé une valeur de conservation, par ex. par ScheduleKeep, les archives avec des indices plus élevés ne seront plus déplacées et seront définitivement supprimées. Cette option trouve ces archives et les supprime après confirmation.
Après avoir abaissé une valeur de conservation, par ex. par ScheduleKeep, les archives avec un indice plus élevé que configuré, ne seront plus supprimées automatiquement et existeront toujours. Cette option trouve ces archives et les supprime définitivement après confirmation. Lors de l'exécution de la commande de nettoyage sur un disque USB connecté localement, montez manuellement le disque USB AVANT d'exécuter cette commande. Lorsque vous avez terminé, démontez manuellement le disque USB. Cette exigence peut s’appliquer à certaines des autres commandes répertoriées ici.
'''affa --rename-job JOB NouveauNom'''
'''affa --rename-job JOB NouveauNom'''
'''affa --move-archive JOB NouveauRepertoireRacine'''
'''affa --move-archive JOB NouveauRepertoireRacine'''
Déplace le répertoire d'archivage de la tâche JOB vers les répertoire racine NouveauRepertoireRacine et ajuste la valeur de la propriété RootDir. NouveauRepertoireRacine doit être un chemin complet commençant par une barre oblique. Comme le déplacement à travers le système de fichiers (par ex. d'un disque USB externe vers un disque local) n'est pas possible, Affa utilise une commande «copie» dans ce cas et efface le répertoire source après. En fonction de la taille de l'archive, la copie à travers les systèmes de fichiers peut durer longtemps.
Déplace le répertoire d'archivage de la tâche JOB vers le répertoire racine NouveauRepertoireRacine et ajuste la valeur de la propriété RootDir. NouveauRepertoireRacine doit être un chemin complet commençant par une barre oblique. Comme le déplacement à travers le système de fichiers (par ex. d'un disque USB externe vers un disque local) n'est pas possible, Affa utilise une commande «copie» dans ce cas et efface le répertoire source après. En fonction de la taille de l'archive, la copie à travers les systèmes de fichiers peut durer longtemps.
{{Tip box|type=Astuce :|voir également le paragraphe 8.2, plus bas.}}
'''affa --delete-job [--revoke-key] JOB'''
'''affa --delete-job [--revoke-key] JOB'''
Efface irréversiblement une tâche, y compris toutes les archives, la configuration et les bases de données attachées. En passant l'option '--revoke-key', la clé publique sur le serveur distant sera détruite.
'''affa --revoke-key JOB'''
'''affa --revoke-key JOB'''
'''affa --revoke-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''
Détruit la clé DSA publique sur le serveur distant.
{{Note box|type=Note :|<nowiki>l'option --revoke-key seule fonctionne sur SME Server comme serveur distant et pour les systèmes où les clés sont stockées dans /root/.ssh/authorized_keys2 Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}
'''affa --kill JOB'''
'''affa --kill JOB'''
Termine la tâche en cours JOB et tous les processus fils (les processus rsync).
'''affa --killall'''
'''affa --killall'''
Terminates all running jobs.
Terminates all running jobs.
affa --mailtest JOB
'''affa --mailtest JOB'''
Envoie un courriel de test aux adresses électroniques configurées dans l'enregistrement de la tâche. Avec la propriété 'Watchdog' à 'yes', un courriel de test est aussi envoyé depuis le serveur distant. Utilisez cette fonctionnalité pour vérifier que l'envoi des courriels fonctionne.<br>
{{Note box|type=Note :|par défaut, Affa n'envoie des messages qu'en cas d'erreur, jamais en cas de succès (voir la propriété 'chattyOnSuccess').}}
{{Note box|By default Affa only sends messages on errors, never on success (see property chattyOnSuccess).}}
'''affa --nrpe [JOB JOB ...]'''
'''affa --nrpe [JOB JOB ...]'''
'''affa --debug'''
'''affa --debug'''
Active un journal verbeux. Remplace la tâche et les configurations globales.
====Options d'utilisation et de lignes de commande spécifiques à SME====
====Options d'utilisation et de lignes de commande spécifiques à SME====
Lance une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur Affa <b>(!)</b> comme défini dans l'enregistrement JOB. Autrement dit, une fois terminée, le serveur de sauvegarde reboote comme un clone du serveur source. Assurez-vous d'avoir arrêté le serveur source avant de rebooter le serveur de sauvegardes, sinon l'interface réseau ne sera pas activée. Cela est important, lorsque vous lancez --rise à distance. La fonction --rise ne fonctionne qu'avec les serveurs SME et ne devrait être utilisée que sur les serveurs de sauvegardes dédiés.
Lance une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur Affa <b>(!)</b> comme défini dans l'enregistrement JOB. Autrement dit, une fois terminée, le serveur de sauvegarde reboote comme un clone du serveur source. Assurez-vous d'avoir arrêté le serveur source avant de rebooter le serveur de sauvegardes, sinon l'interface réseau ne sera pas activée. Cela est important, lorsque vous lancez --rise à distance. La fonction --rise ne fonctionne qu'avec les serveurs SME et ne devrait être utilisée que sur les serveurs de sauvegardes dédiés.
Avec l'option --all, tous les fichiers et répertoires de l'archive tels que définis par les propriétés include[] sont restaurés. Les fichiers et répertoires avec le même nom sur le serveur Affa seront écrasés et ne peuvent pas être restaurés par un undoris. Cela ne devrait pas poser de problème sur un serveur Affa dédié qui ne contient aucune autre donnée. Après un éventuel undorise ces données aditionnelles restaurées doivent être supprimées manuellement.
Avec l'option --all, tous les fichiers et répertoires de l'archive tels que définis par les propriétés include[] sont restaurés. Les fichiers et répertoires avec le même nom sur le serveur Affa seront écrasés et ne peuvent pas être restaurés par un undo-rise. Cela ne devrait pas poser de problème sur un serveur Affa dédié qui ne contient aucune autre donnée. Après un éventuel undo-rise, ces données additionnelles restaurées doivent être supprimées manuellement.
Remarquez que le processus rise sauvegarde le serveur Affa lui-même avant d'effectuer la restauration de l'archive. Cette sauvegarde est utilisée par un éventuel undorise pour restaurer le serveur Affa. Seulement les fichiers et répertoires standards sont sauvegardés. Les données dans des endroits non normalisés (comme /opt) ne sont pas touchées et existeront encore après le rise '''si elles n'ont pas été écrasées par les données de la sauvegarde''' (c-a-dire si la sauvegarde contient aussi le répertoire /opt, par exemple). Voir aussi : [[Backup_server_config#Standard_backup_.26_restore_inclusions]]
Remarquez que le processus rise sauvegarde le serveur Affa lui-même avant d'effectuer la restauration de l'archive. Cette sauvegarde est utilisée par un éventuel undo-rise pour restaurer le serveur Affa. Seulement les fichiers et répertoires standards sont sauvegardés. Les données dans des endroits non normalisés (comme /opt) ne sont pas touchées et existeront encore après le rise '''si elles n'ont pas été écrasées par les données de la sauvegarde''' (c-a-dire si la sauvegarde contient aussi le répertoire /opt, par exemple). Voir aussi : [[Backup_server_config#Standard_backup_.26_restore_inclusions]]
Un fichier smeserver.tgz stocké sur un disque USB peut être utilisé pour restauration lors d'une nouvelle installation de SME Server.
Un fichier smeserver.tgz stocké sur un disque USB peut être utilisé pour restauration lors d'une nouvelle installation de SME Server.
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.
==== Copier une archive Affa d'un disque dur USB sur un nouveau disque ====
Affa utilise un grand nombre de liens matériels (hard links) pour compresser et préserver de la place sur le disque pour les sauvegardes. Dans la situation où l'on voudrait copier un disque contenant une archive Affa sur un autre disque (de taille plus importante), il est nécessaire de s'assurer que les liens matériels ont été copiés correctement au risque que la copie devienne considérablement plus volumineuse que l'archive source.
Affa utilise un grand nombre de liens matériels (hard links) pour compresser et préserver de la place sur le disque pour les sauvegardes. Dans la situation où l'on voudrait copier un disque contenant une archive Affa sur un autre disque (de taille plus importante), il est nécessaire de s'assurer que les liens matériels ont été copiés correctement au risque que la copie devienne considérablement plus volumineuse que l'archive source.
Une méthode pour copier à travers des systèmes de fichiers distincts (par ex. entre 2 disques usb différents) et préserver les liens matériels est la suivante:
Une méthode pour copier à travers des systèmes de fichiers distincts (par ex. entre 2 disques usb différents) et préserver les liens matériels est la suivante:
* monter les deux disques usb avec des points de montage différents, par exemple /media/backup1 et /media/backup2 et effectuer alors:
* monter les deux disques usb avec des points de montage différents, par exemple /media/backup1 et /media/backup2 et effectuer alors :
mkdir /media/backup2/archive cd /media/backup1/archive tar cpf - . | ( cd /media/backup2/archive && tar xpf - )
mkdir /media/backup2/archive
cd /media/backup1/archive
tar cpf - . | ( cd /media/backup2/archive && tar xpf - )
en remplaçant '''archive''' par le véritable nom de l'archive (job) Affa que l'on souhaite placer sur l'autre disque.
en remplaçant '''archive''' par le véritable nom de l'archive (job) Affa que l'on souhaite placer sur l'autre disque.
