Line 574: |
Line 574: |
| globalStatus=enabled | | globalStatus=enabled |
| qui assure l'exécution de la tâche au travers de «cronjobs» et écrase les valeurs spécifiques dans la section spécifique de la tâche. | | qui assure l'exécution de la tâche au travers de «cronjobs» et écrase les valeurs spécifiques dans la section spécifique de la tâche. |
| + | |
| + | === 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}} |
| + | '''affa --run JOB''' |
| + | Lance une tâche. Normalement effectué par cronjob. |
| + | |
| + | |
| + | '''affa --make-cronjobs''' |
| + | Configure les tâches cron comme programmées dans les enregistrements de tâches. |
| + | |
| + | |
| + | '''affa --send-key JOB''' |
| + | '''affa --send-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]''' |
| + | 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|<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 --full-restore JOB [ARCHIVE]''' |
| + | Effectue une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur source distant comme défini dans l'enregistrement JOB. Si [ARCHIVE] n'est pas donnée, l'archive 'scheduled.0' est utilisée comme défaut. La restauration totale reconstruit le serveur comme il était au moment de la sauvegarde. Après la restauration l'hôte source est redémarré. |
| + | |
| + | |
| + | '''affa --rise [--all] JOB [ARCHIVE]''' |
| + | 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 7et 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. |
| + | |
| + | 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 standard (comme /opt) ne sont pas touchées et existeront encore après le rise. Voir aussi : [[Backup_server_config#Standard_backup_.26_restore_inclusions]] |
| + | |
| + | |
| + | '''affa --undo-rise''' |
| + | Cette fonction reconvertit en serveur de sauvegarde un serveur Affa préalablement converti en serveur de production. Après un redémarrage, toutes les tâches configurées fonctionneront à nouveau. |
| + | |
| + | |
| + | '''affa --unchunk-archive JOB ARCHIVE''' |
| + | Concatène et décompresse tous les fichiers découpés dans l'archive ARCHIVE de la tâche JOB pour rendre l'archive prête pour une restauration. Notez que l'archives la plus récente scheduled.0 n'est jamais découpée et donc qu'elle peut être restaurée telle quelle sans re-concaténation préalable. |
| + | |
| + | |
| + | '''affa --chunk-archive JOB ARCHIVE''' |
| + | Découpe et compresse tous les fichiers dont les noms correspondent à la propriété chunkFiles pour économiser l'espace disque. Cela ne devrait être utilisé que comme l'inverse de --unchunk-archive. Les découpages sont stockés en fichiers bzip2 dans un répertoire nommé FILENAME.affa-chunks avec 8 niveaux de profondeur. |
| + | |
| + | |
| + | |
| + | '''affa --create-backup-file JOB [ARCHIVE] [--outfile=FILE]''' |
| + | Crée une archive tar gzippée FILE depuis l'ARCHIVE de la tâche JOB. Pendant la création la somme MD5 est calculée puis le fichier tar enregistré lui est comparé. L'archive par défaut est schedule.0 et le fichier FILE par défaut est./smeserver.tg. La somme de contrôle est écrite dans FILE.md5sum. |
| + | |
| + | Un fichier smeserver.tgz stocké sur un disque USB peut être utilisé pour restauration lors d'une nouvelle installation de SME Server. |
| + | |
| + | |
| + | '''affa --list-archives [--csv] JOB''' |
| + | Affiche un tableau de toutes les archives de la tâche JOB existantes, avec la date, le nombre de fichiers, la taille et l'espace disque utilisé. |
| + | <small><pre> |
| + | Affa version 2.0.0-rc4 on affa1.mydomain.de (10.204.48.2) |
| + | +------------------------------------------------------------------------------+ |
| + | | Job: primmail | |
| + | | Description: Mailserver Albstadt | |
| + | | Directory: /var/affa/primmail/ | |
| + | | Hostname: 10.204.144.2 | |
| + | | Email: admin@mydomain.de | |
| + | +-------+-----------------------+-----------+----------------+--------+--------+ |
| + | | Run | Completion date | Exec Time | Files | Size | Recvd | |
| + | +-------+-----------------------+-----------+----------------+--------+--------+ |
| + | | M 9 | Sun 2008 Mar 02 06:11 | 0h29m47s | 679010 | 80GB | 60MB | |
| + | | M 8 | Sun 2008 Mar 30 06:12 | 0h26m59s | 701683 | 83GB | 48MB | |
| + | | M 7 | Sun 2008 Apr 27 06:16 | 0h28m01s | 731332 | 87GB | 47MB | |
| + | | M 6 | Sun 2008 Jun 01 06:20 | 0h27m37s | 755529 | 90GB | 50MB | |
| + | | M 5 | Sun 2008 Jun 29 06:24 | 0h28m39s | 800200 | 94GB | 52MB | |
| + | | M 4 | Sun 2008 Jul 27 06:28 | 0h29m10s | 835398 | 99GB | 59MB | |
| + | | M 3 | Sun 2008 Aug 31 06:34 | 0h34m53s | 869409 | 101GB | 65MB | |
| + | | M 2 | Sun 2008 Sep 28 06:38 | 0h33m19s | 910889 | 106GB | 59MB | |
| + | | M 1 | Sun 2008 Oct 26 06:42 | 0h38m41s | 932627 | 110GB | 61MB | |
| + | | M 0 | Sun 2008 Nov 30 06:48 | 0h51m44s | 954090 | 116GB | 75MB | |
| + | +-------+-----------------------+-----------+----------------+--------+--------+ |
| + | | W 3 | Sun 2008 Dec 14 06:50 | 0h53m34s | 962267 | 118GB | 68MB | |
| + | | W 2 | Sun 2008 Dec 21 06:52 | 0h53m11s | 974914 | 120GB | 69MB | |
| + | | W 1 | Wed 2008 Dec 24 06:52 | 0h48m58s | 974536 | 120GB | 64MB | |
| + | | W 0 | Sun 2008 Dec 28 06:58 | 0h39m01s | 977003 | 120GB | 61MB | |
| + | +-------+-----------------------+-----------+----------------+--------+--------+ |
| + | | D 6 | Tue 2008 Dec 30 06:52 | 0h54m45s | 976872 | 120GB | 77MB | |
| + | | D 5 | Wed 2008 Dec 31 06:52 | 0h49m10s | 977764 | 120GB | 63MB | |
| + | | D 4 | Thu 2009 Jan 01 06:28 | 0h28m09s | 977879 | 120GB | 60MB | |
| + | | D 3 | Fri 2009 Jan 02 06:53 | 0h53m21s | 978144 | 120GB | 68MB | |
| + | | D 2 | Sat 2009 Jan 03 06:53 | 0h53m15s | 978072 | 120GB | 60MB | |
| + | | D 1 | Sun 2009 Jan 04 06:53 | 0h53m16s | 976478 | 120GB | 70MB | |
| + | | D 0 | Mon 2009 Jan 05 06:52 | 0h52m42s | 977062 | 120GB | 61MB | |
| + | +-------+-----------------------+-----------+----------------+--------+--------+ |
| + | | S 1 | Mon 2009 Jan 05 17:57 | 0h27m48s | 976353 | 120GB | 98MB | |
| + | | S 0 | Tue 2009 Jan 06 06:52 | 0h52m55s | 976539 | 120GB | 70MB | |
| + | +-------+-----------------------+-----------+----------------+--------+--------+ |
| + | </pre></small> |
| + | Avec --csv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes. |
| + | |
| + | |
| + | '''affa --status [--csv]''' |
| + | Affiche un tableau de toutes les tâches actives (status enabled), avec l'heure de dernier et prochain lancement, la taille, l'espace disque utilisé par la plus récente archive, la date d'exécution du dernier lancement, et le nombre d'archives programmées (S), quotidiennes (D), hebdomadaires (W), mensuelles (M) et annuelles (Y). Le dernier lancement (colonne 'Last') affiche 'failed' si une tâche n'a pas été lancée dans les dernières 24h. Pour les tâches désactivées, 'Last' affiche toujours 'failed' au bout de 24 h. Pour voir la date et l'heure du dernier lancement de ces tâches, utilisez l'option --list-archives. La colonne 'Next' montre l'heure à laquelle le prochain lancement aura lieu, si 'Enabled' est à 'yes'. |
| + | <small><pre> |
| + | Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2) |
| + | +----------------+-----+-------+-----------+-------+-------+----------------+ |
| + | | Job | ENA | Last | Exec Time | Next | Size | N of S,D,W,M,Y | |
| + | +----------------+-----+-------+-----------+-------+-------+----------------+ |
| + | | erp-alb-rsyncd | yes | 00:20 | 0h00m14s | 00:20 | 46MB | 1, 7, 4,10, 0 | |
| + | | erp-fra-rsyncd | yes | 02:46 | 0h01m03s | 02:45 | 712MB | 1, 7, 4,10, 0 | |
| + | | esxi-TS-W2K | yes | 00:37 | 4h22m08s | 20:15 | 60GB | 1, 7, 1, 0, 0 | |
| + | | esxi-W2KR2 | yes | 02:22 | 3h52m09s | 22:30 | 40GB | 1, 7, 1, 0, 0 | |
| + | | helpdesk | yes | 00:25 | 0h00m47s | 00:25 | 117MB | 1, 7, 4,10, 0 | |
| + | | imageserv | yes | running (pid 16477) | 1, 7, 4,10, 0 | |
| + | | intraweb | yes | 06:34 | 0h04m50s | 18:00 | 2.1GB | 2, 7, 4,10, 0 | |
| + | | pdcalb | yes | 21:19 | 0h14m27s | 21:05 | 89GB | 1, 7, 4,10, 0 | |
| + | | pdcfra | yes | 04:18 | 0h03m33s | 04:15 | 33GB | 1, 7, 4,10, 0 | |
| + | | primmail | yes | 06:52 | 0h52m55s | 17:30 | 120GB | 2, 7, 4,10, 0 | |
| + | | rayofhope | yes | 21:52 | 0h07m40s | 21:45 | 26GB | 1, 7, 4,10, 0 | |
| + | | smecrmpg | yes | 22:35 | 0h00m21s | 22:35 | 70MB | 1, 7, 4,10, 0 | |
| + | | sozserv | yes | 02:09 | 0h04m03s | 02:05 | 5.9GB | 1, 7, 4,10, 0 | |
| + | | wiki | yes | 03:45 | 0h00m27s | 03:45 | 278MB | 1, 7, 4, 8, 0 | |
| + | +----------------+-----+-------+-----------+-------+-------+----------------+ |
| + | | az32share | no | - | 0h00m22s | 03:05 | 1.3GB | 1, 7, 4, 8, 0 | |
| + | +----------------+-----+-------+-----------+-------+-------+----------------+ |
| + | </pre></small> |
| + | Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes. |
| + | |
| + | |
| + | '''affa --disk-usage''' |
| + | Affiche l'utilisation actuelle du disque pour les répertoires racine de tous les systèmes de fichiers. |
| + | <small><pre> |
| + | Affa version 2.0.0-rc4 on backup2.mydomain.de (10.204.0.52) |
| + | +------+--------+--------+----------------------------------------------------+ |
| + | | Use% | Used | Avail | Root Dir | |
| + | +------+--------+--------+----------------------------------------------------+ |
| + | | 71% | 938GB | 365GB | /var/affa | |
| + | | 20% | 194GB | 759GB | /mnt/affadev | |
| + | +------+--------+--------+----------------------------------------------------+ |
| + | </pre></small> |
| + | Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes. |
| + | |
| + | |
| + | '''affa --show-schedule [--all]''' |
| + | Affiche un calendrier 'graphique' de toutes les tâches actives. La résolution est de 30 minutes. Un 'X' indique les heures de lancement programmés. La durée de la dernière exécution est marquée avec des '='. |
| + | <small><pre> |
| + | Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2) |
| + | TIME 0:00 4:00 8:00 12:00 16:00 20:00 |
| + | erp-alb-rsyncd X------- -------- -------- -------- -------- -------- |
| + | helpdesk X------- -------- -------- -------- -------- -------- |
| + | esxi-W2KR2 =====--- -------- -------- -------- -------- -----X== |
| + | esxi-TS-W2K ==------ -------- -------- -------- -------- X======= |
| + | imageserv ---X---- -------- -------- -------- -------- -------- |
| + | sozserv ----X--- -------- -------- -------- -------- -------- |
| + | erp-fra-rsyncd -----X-- -------- -------- -------- -------- -------- |
| + | wiki -------X -------- -------- -------- -------- -------- |
| + | pdcfra -------- X------- -------- -------- -------- -------- |
| + | primmail -------- ----X=-- -------- -------- ---X---- -------- |
| + | intraweb -------- -----X-- -------- -------- ----X--- -------- |
| + | pdcalb -------- -------- -------- -------- -------- --X----- |
| + | rayofhope -------- -------- -------- -------- -------- ---X---- |
| + | smecrmpg -------- -------- -------- -------- -------- -----X-- |
| + | 1 disabled jobs not listed. Use --all to display. |
| + | </pre></small> |
| + | |
| + | |
| + | '''affa --send-status''' |
| + | Envoie le tableau d'état, l'espace disque utilisé et la liste des archives de toutes les tâches à l'adresse email configurée dans l'enregistrement 'DefaultAffaConfig'. Cette commande est utilisée par la tâche cron 'affa status'. |
| + | |
| + | |
| + | '''affa --mailtest JOB''' |
| + | Envoie un email de test aux adresses email configurées dans l'enregistrement de la tâche. Avec la propriété 'Watchdog' à 'yes', un email de test est envoyé depuis le serveur distant aussi. Utilisez cela pour vérifier que l'envoi des mails fonctionne.<br> |
| + | '''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'). |
| + | |
| + | |
| + | '''affa --cleanup JOB''' |
| + | Après que vous ayez diminué le temps de conservation (scheduledKeep), les archives avec un indice plus élevé ne seront plus supprimées automatiquement et existeront toujours. Cette option trouve ces archives et les supprime. |
| + | |
| + | |
| + | '''affa --rename-job JOB NEWNAME''' |
| + | Renomme la tâche JOB en NEWNAME, y compris tous les enregistrements de la base de données et les répertoires d'archive. |
| + | |
| + | |
| + | '''affa --move-archive JOB NEWROOTDIR''' |
| + | Déplace le répertoire d'archive de JOB vers NEWROOTDIR et ajuste la propriété RootDir. NEWROOTDIR doit être un chemin complet (full path) commençant par un slash. Comme le déplacement d'un système de fichiers à un autre (par exemple d'un disque USB à un disque local) n'est pas possible, Affa se sert dans ce cas d'une commande de copie et efface ensuite le répertoire source. Selon la taille de l'archive, la copie d'un système de fichiers à l'autre peut prendre longtemps. |
| + | |
| + | |
| + | '''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 --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]''' |
| + | Détruit la clé DSA publique sur le serveur distant. |
| + | {{Note box|<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 --check-connections''' |
| + | Contrôle le login ssh pour toutes les tâches configuré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 --kill JOB''' |
| + | Termine la tâche en cours JOB et tous les processus fils (les processus rsync).. |
| + | |
| + | '''affa --debug''' |
| + | Active un journal verbeux. Remplace la tâche et les configurations globales. |
| | | |
| ===Installation d'Affa v.2 === | | ===Installation d'Affa v.2 === |