Outils pour utilisateurs

Outils du site


braveo:docinstallpunjab

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

braveo:docinstallpunjab [2016/07/19 15:36] (Version actuelle)
Ligne 1: Ligne 1:
 +====== Installation de Punjab ======
 +Punjab est un composant serveur qui permet aux clients de se connecter au serveur via HTTP (en utilisant BOSH). ​ \\
 +BOSH (Bidirectional-streams Over Synchronous HTTP) désigne une méthode permettant d'​encapsuler un flux de données dans une connexion HTTP. 
  
 +**Pourquoi utiliser un serveur Bosh ?** \\
 +Tout simplement pour utiliser des clients Web comme **Jappix** ou **Muckl** qui utilisent le port 80 ou 443. Avec ejabberd, par défaut la connexion entre le client et ce serveur se fait par le port 5222.
 +
 +===== Démarrons l'​installation =====
 +
 +On installe les librairies nécessaires :
 +  apt-get install python python-twisted
 + 
 +Téléchargeons les sources de Punjab
 +  wget https://​github.com/​twonds/​punjab/​archive/​master.zip
 +
 +On se met dans le dossier /etc :
 +  cd /​etc  ​
 +
 +On dézippe :
 +  unzip master.zip
 +Le dossier punjab-master est créé. ​
 +
 +  cd punjab-master
 +  ​
 +On exécute le script d'​installation :
 +   ​python setup.py install  ​
 +   
 +Démarrons le serveur :
 +  twistd -y punjab.tac
 +  ​
 +punjab.tac est le ficher de configuration. Par défaut, le serveur écoute sur le port 5280. Si vous souhaitez changer de port, éditez le fichier et changer le port ici : \\
 +**internet.TCPServer(5280,​ site).setServiceParent(application)**
 +
 +On teste le serveur, en se connectant sur :  \\
 +http://​127.0.0.1:​5280/​http-bind/​
 +
 +Si tout est ok, on doit avoir : XEP-0124 - BOSH \\
 +Si le serveur ne démarre pas correctement,​ regardez dans le fichier twistd.log.
 +
 +=====  Configurer un proxy apache =====
 +Vous aurez besoin de configurer un proxy pour permettre la connexion à ejabberd sur le même domaine. Ici le domaine sera mdl29.net \\
 +
 +On active les modules :
 +  a2enmod rewrite
 +  a2enmod proxy
 +  a2enmod proxy_http
 +  ​
 +Le vhost bosh.mdl29.net :
 +<​code>​
 +<​VirtualHost *:80>
 +     ​ServerName bosh.mdl29.net
 +     ​DocumentRoot /​var/​www/​bosh
 +     ​Redirect / https://​bosh.mdl29.net/​
 +</​VirtualHost>​
 +
 +
 +<​VirtualHost *:443>
 +
 +ServerName bosh.mdl29.net
 +DocumentRoot /​var/​www/​bosh
 +ProxyPass / http://​localhost:​5280/​http-bind/​
 +ProxyPassReverse / http://​localhost:​5280/​http-bind/​
 +
 +Header set Access-Control-Allow-Origin "​*"​
 +
 +   # SSL
 +    SSLEngine on
 +    SSLCertificateFile ​    ​mdl29.net.crt
 +    SSLCertificateKeyFile ​ mdl29.net.key
 +    SSLCACertificateFile ​  ​GandiStandardSSLCA.pem
 +    SSLVerifyClient None
 +
 +</​VirtualHost>​
 +
 +</​code>​
 +
 +On active le vhost :
 +  aensite bosh.mdl29.net
 +
 +On relance apache :
 +  /​etc/​init.d/​apache2 restart
 +  ​
 +Et voilà, notre serveur bosh est opérationnel :-P.
 +  ​
 +
 +
 +
 +
 +
 + 
braveo/docinstallpunjab.txt · Dernière modification: 2016/07/19 15:36 (modification externe)