dmtcp_sshd - En ligne dans le Cloud

PROGRAMME:

Nom

dmtcp - Point de contrôle multithread distribué

SYNOPSIS

dmtcp_coordinateur [Port]

dmtcp_lancement commande [arguments...]

dmtcp_restart ckpt_FILE1.dmtcp [ckpt_FILE2.dmtcp...]

commande_dmtcp coordinateurCommande

DESCRIPTION

DMTCP est un outil pour vérifier de manière transparente l'état d'un groupe arbitraire de programmes
répartis sur de nombreuses machines et reliés par des sockets. Il ne modifie pas l'utilisateur
programme ni le système d'exploitation. PICM est un composant autonome de DMTCP disponible en tant que
bibliothèque de points de contrôle pour un seul processus.

OPTIONS

Pour chaque commande, l'indicateur --help ou -h affichera les options de la ligne de commande. La plupart des commandes
les options de ligne peuvent également être contrôlées via des variables d'environnement. Ceux-ci peuvent être mis en
bash avec "export NAME=value" ou en tcsh avec "setenv NAME value".

DMTCP_CHECKPOINT_INTERVAL=entier
Temps en secondes entre les points de contrôle automatiques. Des points de contrôle peuvent également être initiés
manuellement en tapant 'c' dans le coordinateur. (par défaut : 0, désactivé ;
dmtcp_coordinator uniquement)

DMTCP_HOST=chaîne
Nom d'hôte sur lequel le coordinateur à l'échelle du cluster s'exécute. (par défaut : localhost ;
dmtcp_launch, dmtcp_restart uniquement)

DMTCP_PORT=entier
Le port sur lequel le coordinateur à l'échelle du cluster écoute. (par défaut : 7779)

DMTCP_GZIP=(1|0)
Réglez sur « 0 » pour désactiver la compression des images de point de contrôle. (par défaut : 1, compression
activée; dmtcp_launch uniquement) ATTENTION : gzip ajoute des secondes. Sans gzip,
ckpt/restart est souvent inférieur à 1 s

DMTCP_CHECKPOINT_DIR=chemin
Répertoire dans lequel stocker les images des points de contrôle. (par défaut : ./)

DMTCP_SIGCKPT=entier
Numéro de signal interne à utiliser pour le point de contrôle. Ne doit pas être utilisé par l'utilisateur
programme. (par défaut : SIGUSR2 ; dmtcp_launch uniquement)

DMTCP_COORDINATEUR

Chaque calcul à contrôler doit inclure un processus de coordinateur DMTCP. On peut
démarrer explicitement un coordinateur via dmtcp_coordinator, ou autoriser le démarrage d'un
implicitement en arrière-plan par dmtcp_launch ou dmtcp_restart pour fonctionner. L'adresse
du coordinateur unique doit être spécifié par dmtcp_launch, dmtcp_restart et
dmtcp_command via les indicateurs de ligne de commande --host et --port ou via le
Variables d'environnement DMTCP_HOST et DMTCP_PORT. Si ni l'un ni l'autre n'est donné, la paire hôte-port
par défaut, localhost-7779. La paire hôte-port associée à un coordinateur particulier
est donné par les indicateurs de ligne de commande utilisés dans la commande dmtcp_coordinator, ou le
variables d'environnement alors en vigueur, ou la valeur par défaut de localhost-7779.

Le coordinateur est apatride et ne sauraient point de contrôle. Au redémarrage, on peut utiliser un
ou un nouveau coordinateur. Plusieurs calculs sous contrôle DMTCP peuvent coexister en fournissant
un coordinateur unique (avec une paire hôte-port unique) pour chacun de ces calculs.

Le coordinateur lance un point de contrôle pour tous les processus de son groupe de calcul.
Les points de contrôle peuvent être : effectués automatiquement sur un intervalle (voir DMTCP_CHECKPOINT_INTERVAL
dessus); ou initié manuellement sur l'entrée standard du coordinateur (voir
paragraphe); ou initié directement sous le contrôle du programme par le calcul à travers le
API dmtcpaware (voir ci-dessous).

Le coordinateur accepte les commandes suivantes sur son entrée standard. Chaque commande doit
être suivi par le clé. Les commandes sont :
l : Liste des nœuds connectés
s : Imprimer le message d'état
c : point de contrôle sur tous les nœuds
f : Forcer un redémarrage même s'il manque des nœuds (débogage)
k : Tuer tous les nœuds
q : Tuez tous les nœuds et quittez
? : Afficher ce message

Les commandes du coordinateur peuvent également être émises à distance en utilisant commande_dmtcp.

EXEMPLE UTILISATION

1. Dans une fenêtre de terminal séparée, démarrez dmtcp_coodinator.
(Voir la section précédente.)

dmtcp_coordinateur

2. Dans des terminaux séparés, remplacez chaque commande par "dmtcp_launch
[commande]". Le programme à point de contrôle se connectera au coordinateur spécifié par
DMTCP_HOST et DMTCP_PORT. De nouveaux fils de discussion seront vérifiés dans le cadre de la
traiter. Les processus enfants seront automatiquement contrôlés. Processus à distance
commencé par ssh sera automatiquement contrôlé. (En interne, DMTCP modifie le
ssh ligne de commande pour appeler dmtcp_launch sur l'hôte distant.)

dmtcp_launch ./monprogramme

3. Pour lancer manuellement un point de contrôle, exécutez la commande ci-dessous
ou tapez "c" suivi de dans le coordinateur. Fichiers de point de contrôle pour chacun
processus sera écrit dans DMTCP_CHECKPOINT_DIR. Le dmtcp_coordinator écrira
"dmtcp_restart_script.sh" dans son répertoire de travail. Ce script contient le
appels nécessaires à dmtcp_restart pour redémarrer l'ensemble du calcul, y compris
processus distants créés via ssh.

commande_dmtcp -c
OU : dmtcp_command --checkpoint

4. Pour redémarrer, il faut exécuter dmtcp_restart_script.sh, qui est
créé par le dmtcp_coordinator dans son répertoire de travail au moment de
point de contrôle. On peut éventuellement éditer ce script pour migrer les processus vers différents
hôtes. Par défaut, un seul processus redémarré sera redémarré au premier plan
et recevoir l'entrée standard. Le script peut être modifié pour choisir le processus
sera redémarré au premier plan.

./dmtcp_restart_script.sh

DMTCPAWARE API

DMTCP fournit une interface de programmation pour permettre aux applications contrôlées d'interagir avec
dmtcp. Dans la distribution source, voir dmtcpaware/dmtcpaware.h pour les fonctions
disponible. Voir test/dmtcpaware[123].c pour trois exemples d'applications. Pour un exemple de
son utilisation, essayez :

essai de disque dur ; rm dmtcpaware1; faire dmtcpaware1; ./autotest -v dmtcpaware1

L'application utilisateur doit être liée à libdmtcpaware.so (-ldmtcpaware) et utiliser l'en-tête
fichier dmtcp/dmtcpaware.h.

DMTCP BRANCHER MODULES

La distribution source comprend un niveau supérieur plug-in répertoire, avec des exemples de
écrire un module d'extension pour DMTCP. D'autres exemples se trouvent dans le test/plug-in annuaire. le
La fonction de plug-in ajoute trois nouvelles capacités programmables par l'utilisateur. Un plugin peut : ajouter des wrappers
autour des appels système ; prendre des mesures spéciales lors de certains événements (par exemple, un point de contrôle préalable,
reprise/post-point de contrôle, redémarrage); et peut insérer des paires clé-valeur dans une base de données à
l'heure de redémarrage qui est alors disponible pour être interrogée par les processus redémarrés d'un
calcul. (Les événements disponibles pour la fonctionnalité de plug-in forment un sur-ensemble des événements
disponible avec l'interface dmtcpaware.) Un ou plusieurs plugins sont invoqués via une liste de
chemins absolus séparés par des deux-points.

dmtcp_launch --with-plugin PLUGIN1[:PLUGIN2]...

RETOUR CODE

Un programme cible sous contrôle DMTCP renvoie normalement le même code retour que s'il était exécuté
sans DMTCP. Cependant, si DMTCP échoue (par opposition à l'échec du programme cible), DMTCP
renvoie un code retour spécifique à DMTCP, rc (ou rc+1, rc+2 pour deux cas particuliers), où rc
est la valeur entière de la variable d'environnement DMTCP_FAIL_RC si elle est définie, ou bien la valeur par défaut
valeur, 99.

Utilisez dmtcp_sshd en ligne à l'aide des services onworks.net