Technical documentation : Debian

Home page > Web services > 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
Download

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 =
Download

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

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
Download

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
Download

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
Download

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

Ressources :

2 comments

Comment on the documentation

  • On 18 January at 10:14 Replying to: Palabre : serveur XMLSocket

    Bonjour
    SVP y a t’il une copie de la documentation collectée puisque le site de la docuementation ne marche plus

    Reply to this message


Any message or comment?

  • (To create paragraphs, you simply leave blank lines.)

Who are you? (optional)
  • [Sign In]

SPIP | | Register | Suggestions | Monitor | Site Map | Legal notices | Follow-up of the site's activity RSS 2.0