LES PARAMETRES – signification – placement - conditions d’utilisation
En Français, on désigne par "paramètre", ce que Stanford nomme "argument" ou "flag", "switch" ou encore, et c'est plus compréhensible pour nous, "parameter". C'est une mention que l'on inscrit, entre autres, dans la cible d'un raccourci, ou bien dans la fenêtre de configuration, sur la ligne "Additional client parameters". Cette mention permet d'accéder à des options de configuration dont nous verrons, ci-après, la signification précise.
Notons que ces "paramètres" viennent en complément des "options" de configuration déjà décrites dans les différents tutoriels.
On dit qu'un client peut parfaitement fonctionner sans que nous ayions rien à savoir des paramètres. Pourtant, le premier lancement d'un client version 6 en mode console nécessite toujours le paramètre -configonly. La modification d'un élément de la configuration peut nécessiter -config. Vous voulez terminer proprement le traitement d'une unité de travail (wu) et ne plus en télécharger une autre, en vue de partir en week-end, vous mettez -pause ou -oneunit. Et que dire du paramètre -smp obligatoire et permanent pour accéder au client haute performance SMP... et il y en a encore beaucoup d'autres à bien connaître.
Stanford nous permet d'obtenir la liste de tous les paramètres et leur signification sommaire. Pour un client en mode console (non configuré en tant que service), nous inscrivons la mention -help (c'est un paramètre) dans la cible de son raccourci :
En relançant le client, nous obtenons l'écran suivant :
Tiens, il manque le paramètre -gpu x ! L'inscription de la mention -help dans la cible du raccourci du client GPU donne la liste incluant ce paramètre :
Par contre le paramètre -forceasm a disparu, normal il concerne seulement les optimisations CPU. Ce qui ne signifie pas pour autant que chaque client affiche parfaitement les seuls paramètres qui lui sont propres, puisque dans cette liste, issue du client GPU, il y a le paramètre propre au client SMP (incohérence ou préparation vers un client vraiment unique ?).
Notons immédiatement que ces paramètres ne se mettent pas n'importe où et ne doivent pas être utilisés à la légère, sinon on va vers de gros déboires.
- Pour un client en mode console (non configuré en tant que service), tous les paramètres supportés par le client concerné peuvent être mis dans la cible du raccourci mais nous verrons qu'il est plus judicieux de n'utiliser ici que les paramètres ponctuels (par exemple -config, -pause, etc...).
Les paramètres permanents, lorsque c'est souhaité, devront être inscrits dans la fenêtre de configuration, sur la ligne "Additional client parameters". Cependant, l'inverse n'est pas vrai car seuls les paramètres permanents devront être mis sur la ligne "Additional client parameters" et cela quel que soient le client et le mode.
- Pour un client en mode "System tray", il n'y a rien de plus simple, puisque l'icône figurant dans la barre des tâches permet d'accéder, grâce au clic droit, directement à l'option "Configure". L'onglet "Avancé" permet d'accéder à la ligne "Additional client parameters" pour les paramètres permanents. Mais il ne faut surtout pas mettre un paramètre, même s'il s'agit d'un paramètre ponctuel, dans la cible de son raccourci (si on en a créé un pour éviter le lancement automatique), car on risque une erreur fatale. C'est l'interface (clic droit sur l'icône) qui fait fonction de paramètres ponctuels.
- En ce qui concerne une version console configurée en tant que service, il faut être un utilisateur averti pour affecter un paramètre et même pour arrêter proprement le client, un petit tuto en fin de page fournit les explications nécessaires.
LISTE DES PARAMETRES PONCTUELS
-configonly : c'est le premier paramètre à connaître car obligatoire pour démarrer proprement un client en mode console, à compter de la version 6. Il permet de configurer le client et d'accéder aux options avancées nécessitant une relance de la console. A la fin de la configuration, la fenêtre se ferme automatiquement.
-config : c'est un paramètre que nous allons utiliser pour accéder à une reconfiguration du client (changement ou correction du pseudo, de la team...) sans que nous ayons besoin de modifier les éléments de la ligne "Additional client parameters", nécessitant une relance de la console.
-help : permet d'afficher la liste des paramètres.
-queueinfo : affiche la file d'attente (queue) des 9 positions et leur état (Empty : vide - Ready : l'unité en cours de traitement - Finished : unité terminée en attente d'envoi sur les serveurs de Stanford).
-send X : X étant le numéro dans la queue, permet de forcer l'envoi immédiat de l'unité terminée. Après trois essais, même infructueux, la fenêtre se ferme automatiquement, sans reprendre le traitement d'une unité éventuellement en cours.
-send all : force l'envoi de toutes les unités terminées. Après trois essais, même infructueux, la fenêtre se ferme automatiquement, sans reprendre le traitement d'une unité éventuellement en cours.
-delete X : supprime l'unité concernée dans la position de la queue. Sauf cas très particulier (SMP linux avec qfix lorsque le traitement s'arrête avant l'envoi et selon une procédure très particulière), il est préférable et plus efficace, en cas d'un gros problème, de supprimer les fichiers "work" et "queue" qui se trouvent dans le répertoire du client concerné.
-pause : dès que le traitement de l'unité de travail est terminée, le programme tente d'envoyer les résultats pendant trois fois et aucune autre unité n'est téléchargée. On peut alors fermer la console par Ctrl-C.
-oneunit : identique au paramètre -pause mais la fermeture de la console est automatique. Le désavantage est qu’on ne peut pas voir si le programme a bien réussi à envoyer les résultats, sauf à passer par le fahlog présent dans le répertoire du client concerné.
LISTE DES PARAMETRES PERMANENTS
-smp : paramètre obligatoire pour fonctionner en mode SMP Windows et Linux, sinon le client fonctionnera comme un client classique avec des unités de travail classiques.
Clients SMP Windows : à mettre dans la fenêtre de configuration sur la ligne "Additional client parameters"
Client SMP Linux 6.02 : à mettre dans le terminal : ./fah6 -smp
Client SMP Linux 6.24 : à mettre dans le fenêtre de configuration sur la ligne "Additional client parameters"
-smp -deino : spécifique pour le client SMP Deino MPI
Client SMP Windows Deino MPI : à mettre dans la fenêtre de configuration sur la ligne "Additional client parameters"
-gpu X : ce paramètre concerne l'utilisation d'une ou plusieurs cartes graphiques pour plier. Si vous avez une seule carte graphique dans votre ordinateur et que vous vous en servez pour plier, il n'est pas nécessaire d'utiliser ce paramètre. Si vous avez deux cartes et que vous n'en utilisez qu'une seule pour plier, vous devez lui affecter un numéro. Et si vous pliez avec plusieurs cartes, il sera également obligatoire de leur affecter un numéro à chacune d'elles.
Les numéros commencent par 0, c'est-à-dire que la première carte aura le paramètre -gpu 0 et la deuxième le paramètre -gpu 1, etc...
Client GPU Windows : à mettre dans la fenêtre de configuration sur la ligne "Additional client parameters"
-verbosity X : permet de régler le niveau des informations qui seront mentionées dans le fahlog. Par défaut, le niveau est 3 mais vous pourvez le porter à son maximum qui est 9, afin d'avoir toutes les informations disponibles, en vue d'une meilleure compréhension lorsqu'un problème survient.
Client classique Windows 5.04 : à mettre dans la cible du raccourci pour un mode console (non configuré en tant que service)
Client Linux 6.02 : à mettre dans le terminal : ./fah6 -verbosity 9 (pour mode uniprocesseur) ou ./fah6 -smp -verbosity 9 (pour mode SMP)
Tous les autres clients Windows et Linux : à mettre dans la fenêtre de configuration sur la ligne "Additional client parameters"
-advmethods : permet d'avoir des unités expérimentales, afin d'aider Stanford dans la mise au point de certains projets ou fahcore (logiciel de calcul spécifique à certains types de projets). Les unités brutes obtenues ou le nouveau fahcore en test peuvent être instables, c'est pourquoi les unités sont mieux rétribuées.
A partir de la version 5.04 et a fortiori tous les clients version 6, une ligne particulière de la fenêtre de configuration invite à accepter ou refuser cette option. Il n'est donc plus nécessaire d'inscrire ce paramètre nulle part ailleurs.
-local : utile, afin d'éviter les sources de conflits, lorsqu'on a installé plusieurs clients sur le même ordinateur. Ce paramètre est vital jusqu'aux clients de la version 5 (dont 5.04) mais devenu obsolète pour les dernières révisions de la version 6.
Client classique Windows 5.04 : à mettre dans la cible du raccourci pour le mode console (non configuré en tant que service)
Tous les clients V6 : aucune utilité
-forceasm : force le client à utiliser toutes les optimisations du processeur, tels SSE ou 3DNow, si disponibles. Par défaut, le client utilise toutes les optimisations disponibles par le processeur, prévues dans son programme. Cependant, en cas d'instabilité constatée et un arrêt précoce du traitement de l'unité, le programme peut relancer le traitement sans les optimisations. Le contributeur qui est absolument certain que son ordinateur est parfaitement stable mais que ce sont les unités brutes qui sont corrompues peut utiliser le paramètre -forceasm.
Client classique Windows 5.04 : à mettre dans la cible du raccourci pour le mode console (non configuré en tant que service)
Tous les clients V6 : à mettre dans la fenêtre de configuration sur la ligne "Additional client parameters"
Client GPU : aucune utilité
VERSION CONSOLE CONFIGUREE EN TANT QUE SERVICE SOUS WINDOWS
Vous pouvez avoir besoin d'arrêter le client, pour une raison quelconque, ou pour lancer une exécution ponctuelle ou pour le reconfigurer. Jusqu'à un certain stade, la procédure est identique et ne présente aucun risque. Nous traiterons ici des clients version console configurée en tant que service à partir de la version 6, ne nécessitant alors plus l'ouverture de la base de registre, procédure dont le risque est grand de mettre en danger l'intégrité du système si utilisateur non initié.
Plusieurs méthodes peuvent être utilisées. En voici l'une d'elles :
1 - Sous XP, cliquez sur Démarrer/Exécuter et tapez "services.msc", puis cliquez sur OK
Sous Vista, pressez simultanément sur le logo Windows du clavier et la touche "r", puis tapez "services.msc", puis cliquez sur OK.
2 - Dans la fenêtre qui s’ouvre, recherchez et sélectionnez votre service FAH concerné et pressez sur "Arrêter le service" situé dans la colonne de gauche. Le service (et donc le client) est momentanément arrêté.
Si vous souhaitez faire exécuter à votre client une opération ponctuelle (-pause par exemple), le reconfigurer (pseudo, team, etc…), ou bien désactiver définitivement le mode service :
3 - Toujours dans la fenêtre des services, faites un clic droit sur votre service FAH concerné et sélectionnez "Propriétés"
4 - Dans "Type de démarrage", sélectionnez "Désactivé"
Votre client est maintenant en mode console simple.
5 - Créez un raccourci de l’exécutable et placez-le à portée de main, en vue de manipulation future toujours possible
6 - Inscrivez le paramètre ponctuel souhaité dans la cible du raccourci ou bien -configonly dans le but de procéder à une reconfiguration du client.
Vous pouvez alors relancer votre client en double-cliquant sur le raccourci. Dans le cas d'une reconfiguration, la fenêtre de configuration s'ouvre et vous pouvez y apporter vos modifications (pseudo, team, etc...) et vos paramètres permanents sur la ligne "Additional client parameters".
Si vous avez choisi de basculer définitivement le client en version console simple (non configurée en tant que service), en mettant "no" à l'invite adéquate, vous avez terminé la procédure.
Si vous avez choisi de conserver le mode service (vous avez gardé "yes" à l'invite adéquate), vous devez exécuter la procédure inverse, c'est-à-dire réactiver le service et le redémarrer.
7 - Dans la fenêtre des services, sélectionnez à nouveau le service FAH concerné et cliquez sur "Démarrer le service", puis clic droit sur le service, sélection de "Propriétés" et dans "Type de démarrage" sélection de "Automatique". Vous pouvez fermer la fenêtre des services. La procédure est terminée.
