Documentation technique : Debian
Documentation basée sur la distribution Debian

> > Palabre : serveur XMLSocket

Palabre : serveur XMLSocket

Palabre est un script écrit en Python mettant en place un serveur XMLSocket. Ce type de service est particulièrement utile dans le cadre du déploiement d’applications développées en Flash de manière distribué (système de chat notamment).

Installation du serveur

L’installation du serveur est assez simple et se passe de cette manière :

  1. cd ~
  2. wget http://palabre.gavroche.net/download/palabre-server-0.6b/palabre-src-0.6b.tar
  3. tar -xvf palabre-src-0.6b.tar
  4. # On vérifie que Python est déjà installe
  5. sudo apt-get install python python-xml
  6. # On installe le serveur proprement
  7. cd palabre-src-0.6b
  8. sudo python setup.py install

Télécharger

Dorénavant on peut lancer le serveur avec la commande :

  1. sudo palabre start

Et l’arrêter avec :

  1. sudo palabre stop

Configuration

Le serveur est dorénavant installé correctement, reste à le configurer correctement pour un usage simple. On ouvre donc son fichier de configuration :

  1. sudo nano /etc/palabre.conf

et on change les lignes suivantes :

  1. # On active le serveur en démon
  2. #startdaemon = false
  3. startdaemon = true
  4. # On change les ips autorisées pour que tous les clients puissent y avoir accès
  5. # ip = 127.0.0.1
  6. ip = all
  7. # On log les connexions dans un fichier
  8. # logfile =
  9. logfile = /var/log/palabre.log
  10. # On modifie les domaines autorisés (mettez vos noms de domaine ici)
  11. # alloweddomains = domainthatdoesnotexist.bar otherinexistantdomain.foo
  12. alloweddomains = mondomaine.com
  13. # On désactive le fait de vérifier les mots de passe
  14. # checkpassword = true
  15. checkpassword = false
  16. # On désactive les plugins inutiles
  17. # list = dbQueries,helloworld,simpleLogin
  18. list =

Télécharger

Démarrer le serveur au démarrage de la machine

Pour une utilisation serveur, il est nécessaire de pouvoir démarrer le programme au démarrage de la machine et l’arrêter à son extinction afin d’éviter au maximum les interventions manuelles en cas de reboot ou autre.

Palabre ne fournit pas de script de démarrage, donc en voici un fonctionnel sous Debian.

  1. #!/bin/bash
  2. #
  3. # Init file for the Palabre server
  4. #
  5. # description: Starts a XMLSocket server called Palabre
  6. #
  7. # processname: palabre.py
  8.  
  9. ### BEGIN INIT INFO
  10. # Provides:             palabre
  11. # Required-Start:       $syslog
  12. # Required-Stop:        $syslog
  13. # Should-Start:         $network
  14. # Should-Stop:          $network
  15. # Default-Start:        2 3 4 5
  16. # Default-Stop:         0 1 6
  17. # Short-Description:    Palabre -  XMLSocket server
  18. # Description:          Palabre provide a XMLSocket server.
  19. ### END INIT INFO
  20.  
  21. # Source function library.
  22. . /lib/lsb/init-functions
  23.  
  24. NAME=palabre
  25. DESC="Palabre server"
  26.  
  27. # Pid file
  28. PIDFILE="/var/run/$NAME.pid"
  29.  
  30. [ "$NETWORKING" = "no" ] && exit 0
  31. [ -f "$DAEMON" ] || exit 1
  32.  
  33. RETVAL=0
  34.  
  35. start() {
  36.     echo -n "Starting $DESC: "
  37.     palabre start
  38.     echo "$NAME."
  39. }
  40.  
  41. stop() {
  42.     echo -n "Stopping $DESC : "
  43.     palabre stop
  44.     echo "$NAME."
  45. }
  46.  
  47. restart() {
  48.     palabre restart
  49. }
  50.  
  51. status() {
  52.     PID=$(cat $PIDFILE)
  53.     if [ -n "$PID" ]; then
  54.         log_success_msg "$DESC is running (pid $PID)."
  55.             exit 0
  56.     else
  57.         log_failure_msg "$DESC is not running."
  58.             exit 1
  59.     fi
  60. }
  61.  
  62. case "$1" in
  63.   start)
  64.         start
  65.     ;;
  66.   stop)
  67.         stop
  68.     ;;
  69.   status)
  70.         status
  71.     ;;
  72.   restart|reload)
  73.         restart
  74.     ;;
  75.   *)
  76.     echo "Usage: palabre {start|stop|status|restart}"
  77.     RETVAL=1
  78. esac
  79.  
  80. exit $RETVAL

Télécharger

Pour l’installer proprement, il suffit de copier le contenu dans un fichier :

  1. nano ~/palabre.init
  2. # Puis coller le contenu du fichier d'init

Télécharger

Puis d’installer proprement le script d’initialisation :

  1. sudo cp ~/palabre.init /etc/init.d/palabre
  2. sudo chmod +x /etc/init.d/palabre
  3. sudo update-rc.d palabre defaults

Télécharger

Les actions suivantes sont alors disponibles :

  1. # Lancement du serveur
  2. sudo /etc/init.d/palabre start
  3. # Extinction du serveur
  4. sudo /etc/init.d/palabre stop
  5. # Redémarrage du server (stop/start)
  6. sudo /etc/init.d/palabre restart
  7. # Obtenir le statut du serveur
  8. sudo /etc/init.d/palabre status

Télécharger

Le serveur Palabre sera également lancé au démarrage de la machine et éteint proprement à son extinction.

Ressources :

  • Auteur :
  • Publié le :
  • Mis à jour : 15/11/15

2 commentaires

Commentez la documentation

Qui êtes-vous ?
[Se connecter]
Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.