1Ce fichier decrit noip2, un client Linux de seconde generation pour 2le service de DNS dynamique no-ip.com. 3 4Nouveau: Ce code devrait se creer et s'executer sur Solaris/Intel et aussi BSD. 5 Editer le MakeFile pour Solaris et les variantes de BSDs. 6 Pour les utilisateur de BSD cherchant a modifier l'interface, voir 7 plus bas. 8 Informer moi des differents changement necessaire pour utiliser 9 correctement noip2 sur votre OS non-Linux. 10 11Svp, lire ce court fichier avant d'utiliser noip2. 12 13########################################################################### 14COMMENT CREER UN EXECUTABLE POUR VOTRE SYSTEME 15 16La commande 17 make 18Fabrique un binaire du client noip2 qui s'executera sur votre systeme. 19 20Si vous n'avez pas 'make' installe et que vous avez une machine Linux i686 21avec libc6, un binaire pour les systemes i686 est situe dans le repertoire 22'binaries' appele noip2-Linux. Copier ce binaire dans le repertoire de 23construction 24 'cp binaries/noip2-Linux noip2' 25 26La commande 27 make install 28(Qui doit etre execute en tant que 'root') va installer les differentes 29parties du logiciel a leur places approprie. Il vous posera des questions et 30construira un fichier de configuration. 31Voir plus bas si vous ne pouvez pas devenir 'root' ou ne pouvez pas ecrire 32dans /usr/local/*. 33 34########################################################################### 35COMMENT UTILISER LE CLIENT SANS LIRE LE RESTE DU TEXTE 36 37Operation usuelle? 38/usr/local/bin/noip2 -C configure un client 39/usr/local/bin/noip2 Lance un client 40/usr/local/bin/noip2 -S affiche des infos sur les clients lances 41/usr/local/bin/noip2 -D pid change l'etat de debug pour le client pid 42/usr/local/bin/noip2 -K pid termine le client pid 43 44Vous avez plus d'un peripherique d'acces � internet? 45/usr/local/bin/noip2 -M -c fichier demarre une instance supplementaire 46 47########################################################################### 48COMMENT DEMARRER LE CLIENT 49 50L'executable noip2 peut etre lancer en tapant /usr/local/bin/noip2 51 52Si vous voulez l'executer automatiquement quand la machine demarre, alors 53il faut placer le script suivant dans votre repertoire de demarrage. 54(/etc/init.d/rcX.d, /sbin/init.d/rcX.d ou ???) 55 56####################################################### 57#! /bin/sh 58# . /etc/rc.d/init.d/functions # decommente/modifie pour votre killproc 59case "$1" in 60 start) 61 echo "Demarrage de noip2." 62 /usr/local/bin/noip2 63 ;; 64 stop) 65 echo -n "Arret de noip2." 66 killproc -TERM /usr/local/bin/noip2 67 ;; 68 *) 69 echo "Usage: $0 {start|stop}" 70 exit 1 71esac 72exit 0 73####################################################### 74 75Ou le 'X' dans rcX.d est la valeur obtenue en executant la 76commande suivante 77 grep initdefault /etc/inittab | awk -F: '{print $2}' 78 79Killproc peut etre telecharge depuis ftp://ftp.suse.com/pub/projects/init 80Autrement, vous pouvez enlever le commentaire de ligne apres #! /bin/sh 81 82Si vous avez une version recente de RedHat, vous pouriez vouloir utiliser 83le script de demarage fournit pas un autre utilisateur. C'est dans le paquetage 84appele redhat.noip.sh 85Il se peut qu'il y est des modifications a apporter pour votre systeme. 86 87Il y a un script de demarrage pour Debian appele debian.noip2.sh. 88Il a aussi ete fournit par un autre utilisateur mais il parait qu'il 89peut ne pas fonctionner dans quelques situations. 90 91Ici c'est un script qui va tuer tous les processus de noip2 92 #!/bin/sh 93 for i in `noip2 -S 2>&1 | grep Process | awk '{print $2}' | tr -d ','` 94 do 95 noip2 -K $i 96 done 97Ces quatre lignes peuvent remplacer 'killproc' et 'stop_daemon' dans d'autres 98scripts. 99 100Si vous etes derriere un parefeu, vous devrez avoir besoin d'autoriser le port 1018245 (TCP) dans les deux directions. 102 103####################################################################### 104 105IMPORTANT!! Svp regler les permissions correctement sur votre executable. 106Si vous demarrer noip2 en utilisant une des methodes ci-dessus, faite les 107choses suivantes: 108chmod 700 /usr/local/bin/noip2 109chown root:root /usr/local/bin/noip2 110Si vous demarrer noip2 manuellement depuis un compte non root, faite le chmod 111700 comme ci dessus mais chown (Changement de proprietaire) sur le 112owner:group du compte non root, et vous devrez subsituer votre nouveau 113chemin si l'executable n'est pas dans /usr/local/bin. 114 115########################################################################### 116ETAT SAUVEGARDE 117 118Noip2 sauvegardera la derniere adresse IP envoye a no-ip.com au moment ou il se 119termine. Ce parametre sera lu au prochain demarrage de noip2. Le fichier de 120configuration doit etre en ecriture pour que ca marche! Rien ne se fera si ce 121n'est pas le cas, l'adresse de depart 0.0.0.0 restera inchangee. 122 123########################################################################### 124BSD UTILISANT UN PERIPHERIQUE SPECIFIQUE 125 126Les systemes BSD recent utilisent getifaddrs() pour lister TOUTES leurs 127interfaces. Positionnez le define 'bsd_wth_getifaddrs' dans le Makefile si vous 128utilise une version de BSD avec le support de getifaddrs() et ignorer le reste 129du paragraphe. 130Autrement positionne le define 'bsd'. 131Le reglage 'bsd' ne listera pas vos peripheriques dans BSD. Donc un peripherique 132ne pourra pas etre selectionne depuis le menu. Si vous voulez utiliser un 133peripherique particulier vous devrez editer le Makefile et changer la ligne 134 ${BINDIR}/${TGT} -C -Y -c /tmp/no-ip2.conf 135en 136 ${BINDIR}/${TGT} -C -Y -c /tmp/no-ip2.conf -I 'Votre peripherique' 137 138########################################################################### 139ARGUMENTS DE LA LIGNE DE COMMANDE A PASSER AU CLIENT 140 141Le client va se mettre lui meme en tache de fond et s'executer comme un daemon. 142Ce qui signifie que si vous le lancer plusieurs fois, et leve le drapeau 143d'utilisation multiple, vous aller avoir plusieurs instances s'executer. 144 145Si vous voulez que le client s'execute une fois et s'arrete, fournissait 146l'argument '-i adresseIP'. Le client se comportera mieux si il est active tous 147le temps meme entre des demandes de connections; Il utilise tres peu de 148ressources. 149 150Les actions du client sont controler par un fichier de configuration. Il est 151habituellement situe dans /usr/local/etc/no-ip2.conf, mais peut etre place 152n'importe ou si le parametre '-c nouveau_repertoire' est passe au demarrage. 153 154Le fichier de configuration peut etre genere avec le parametre '-C'. 155 156Il y a quelques nouveaux arguments de ligne de commande fournit avec les 157valeurs par defaut du fichier de configuration. Ce sont -F, -Y et -U. 158 159L'interval entre des tests successifs pour un changement d'adresse IP est 160controle par le parametre '-U nn'. Le nombre represente les minutes, un minimum 161de 1 est force par le client lorsqu'il s'execute sur la machine parefeu, 5 162lorsqu'il s'execute derriere un routeur/parefeu. Une valeur usuelle pour un 163client derriere un parefeu est 30. Un jour c'est 1440, une semaine 10080, un 164mois 40320, 41760, 43200 ou 44640. Pour une heure la determination est laisse 165comme exercice au lecteur :-) 166 167La construction du code de configuration permet une selection parmi les 168hosts/groups enregistres a no-ip.com pour l'utilisateur selectionne. Le parametre 169'-Y' forcera tous les hosts/groups a etre selectionnes pour les mis a jour. 170 171Quelques sites ont de multiples connections a internet. Ces sites confondent la 172detection auto NAT. Le parametre '-F' forcera le reglage non-NAT ou "parefeu". 173 174Le client peut etre appele avec le parametre '-i adresseIP' qui forcera le 175reglage avec cette adresse a no-ip.com. 176Le client s'execute un fois est s'arrete. 177 178Le parametre -I peut etre utilise pour surcharger le nom du peripherique dans le 179fichier de configuration ou pour forcer le nom fournit dans le fichier de 180configuration pendant sa creation. Svp utilisez ca en dernier ressort! 181 182Le parametre '-S' est utilise pour afficher les donnees associees a chaque 183instances de noip2. Si rien n'est lance, il affichera le contenu du fichier de 184configuration qui est selectionne. Il le fait est s'arrete. 185 186Le parametre '-K process_ID' est utilise pour terminer une instance de noip2. 187La valeur du process_ID peut etre obtenue en executant noip2 -S. 188 189Le parametre '-M' permettra d'executer plusieurs instances du client noip2. 190Chaque instance doit avoir son propre fichier de configuration. Il est possibe 191d'executer jusqu'a 4 instances simultanement. 192 193Toutes les erreurs et les messages d'information sont stockes via le service 194syslog. Un ligne indiquant un changement d'adresse reussi a no-ip.com est 195toujours ecrite dans le syslog. Le syslog est habituellement /var/log/messages. 196 197Si le client a ete construit avec le deboggage active, l'etat habituel, le 198parametre '-d' activera les sorties de debug. Cela produira une trace du 199programme lance et devrait vous aider si vous avez des problemes pour etablir la 200connection avec no-ip.com. Toutes les erreurs, messages et E/S dans les deux 201sens seront affiches sur le stderr a la place de syslog. 202Le parametre additionnel '-D pid' changera l'etat de debug d'un processus noip2. 203Il n'y aura pas de changement sur la redirection des sorties; Si c'etait sur le 204syslog, ca continuera a etre dans le syslog. 205 206Le parametre d'invoquation final est '-h'. Il affichera l'ecran tel qu'il est 207decrit ci dessous et s'arretera. 208 209USAGE: noip2 [ -C [ -F][ -Y][ -U #min]][ -c file] 210 [ -d][ -D pid][ -i addr][ -S][ -M][ -h] 211 212Version Linux-2.x.x 213Options: -C create configuration data 214 -F force NAT off 215 -Y select all hosts/groups 216 -U minutes set update interval 217 -c config_file use alternate data path 218 -d increase debug verbosity 219 -D processID toggle debug flag for PID 220 -i IPaddress use supplied address 221 -I interface use supplied interface 222 -S show configuration data 223 -M permit multiple instances 224 -K processID terminate instance PID 225 -h help (this text) 226 227########################################################################### 228COMMENT CONFIGURER LE CLIENT 229 230La commande 231 noip2 -C 232Creera un fichier de configuration dans le repertoire /usr/local/etc. 233Il sera stocke dans un fichier appele no-ip2.conf. 234 235Si vous ne pouvez pas ecrire dans /usr/local/*, ou etes incapable de devenir 236root sur la machine sur laquelle vous souhaitez executer noip2, vous aurez 237besoin d'inclure '-c nom_du_fichier_config' sur tout les appels du client, 238incluant la creation du fichier de configuration. Aussi, vous aurez probablement 239besoin de mettre l'executable dans un endroit ou vous pouvez ecrire. Changez 240la ligne PREFIX= dans le Makefile vers votre nouveau chemin et re-executer la 241commande make install pour eviter ces problemes. 242 243Vous aurez besoin de re-creer le fichier de configuration a chaque fois que 244votre compte ou mot de passe changera, ou quand vous ajouterez ou supprimerez 245des hosts et/ou groups a no-ip.com 246Chaque invoquation de noip2 avec '-C' detruira le fichier de configuration 247precedant. 248 249D'autres options peuvent etre utilises ici '-F' '-Y' '-U' 250 251On vous demandera si vous voulez executer un program/script sur une mise a 252jour reussi a no-ip.com. Si vous specifiez un script, il devra debuter par 253#!/bin/sh ou le shell de votre choix. Si ce n'est pas fait vous obtiendrez 254l'erreur 'Exec format error'. L'adresse IP qui vient juste d'etre mis a jour 255avec succes sera le premier argument du script/program. Le nom de host/group 256sera le deuxieme argument. 257 258Quelques machine ont de multiple connections a internet. Dans ce cas, vous serez 259amene a choisir le peripherique de connection au monde exterieur. Le drapeau -I 260peut etre fournit pour selectionner une interface qui n'est pas vue. 261Typiquement, ce sera une des interfaces pppx qui n'existe pas tant qu'elle n'est 262pas active. 263 264Le programme vous demandera votre courriel/nom d'utilisateur utilise pour 265l'identifiant de compte chez no-ip.com. Il vous demandera aussi le mot de passe 266pour ce compte. 267 268Le fichier de configuration ne contient pas d'autres informations utiles. 269 270IMPORTANT!! Svp regler les permissions correctement sur le fichier de 271configuration. 272chmod 600 /usr/local/etc/no-ip2.conf. 273chown root:root /usr/local/etc/no-ip2.conf. 274Si vous demarrez noip2 manuellement depuis un compte non-root, faire le chmod 275comme ci dessus mais chown du fichier no-ip2.conf avec le owner:group du compte 276non-root. Assurez vous que le repertoire est lisible! 277 278Le programme baissera ces privileges root apres avoir lu le fichier de 279configuration. 280########################################################################### 281Je souhaiterai voir ce fihier texte LISEZMOI.ENPREMIER traduit dans d'autres 282langues. Si vous pouvez traduire ce fichier depuis le Francais ou l'Anglais vers 283n'importe quel autre langage, Svp envoyez moi le fichier traduit. Merci. 284 285########################################################################### 286 287Les bugs peuvent etre rapportes a johna@onevista.com 288 289Envoyez moi un courriel si vous avez besoin d'aide, mais attention j'ai un 290fitrage etendu des courriers non sollicites (SPAM). 291N'envoyer pas de mail en html; personne ne pourra les voir. 292 293Vous pouvez faire un fichier de trace et examiner les messages d'erreurs. 294Ci dessous une explication sur comment faire cela. 295Taper: script noip2.out 296Taper: 'votre ligne de commande noip avec le parametre -d ajoute' 297Taper: exit 298Examiner le fichier noip2.out. Envoyer le moi si vous etes encore embarrasse. 299 300 johna@onevista.com Janvier 2004 301 (traduit en francais par vertacomi@wanadoo.fr) 302