Note

Attention, cette documentation n'est pas officielle et n'est validée par aucun développeur du projet, en outre, il se peut que d'une version à l'autre, des points de ce tutoriel soient amenés à changer (nouvelles dépendances de produits Zope par exemple).

Logguez vous sur votre serveur et créez une instance, Debian propose Dzhandle, un outil que nous n'utilisons pas ici dans un soucis d'universalité (Dzhandle n'est pas présent sur toutes les distributions).

Sous Debian, il est usuellement admit qu'il est convenable d'installer les packages avec dpkg (méthode apt-get). En ce qui concerne Zope je doute qu'il s'agisse de la bonne méthode. Toutefois si  un

$ sudo apt-get install zope29

fonctionne, c'est que vous avez de l'instable dans le apt sourcelist, dans ce cas je recommanderai plutôt les backports ou la compilation manuelle  qui vous évitera peut être des catastrophes avec des mises à jours.

NOTE : l'utilisateur est "bluetouff" pour cet exemple, remplacez le par le votre :)

Versions de Python, Zope et Zwook

Versions des softs utilisées pour ce tutoriel

• Version de Python : Python 2.4.4
• Version de Zope : Zope2.9.5

Prérequis

• Une installation fonctionnelle de zope 2.9.x vierge de tous produits.
• Attention si vous utilisez Plone sachez que GRUF rentrera en conflit avec PAS le nouveau système d'athentification de Plone.
• Pour éviter les mauvaises surprises Créez une instance dédié pour Zwook.

Création de l'instance

Zope est considéré par Debian comme une grosse librairie, les scripts de création d'instance ainsi que d'autres non moins intéressants (comme le script de création d'instance ZEO permettant une dissociation du frontal et du traitement dans 2 zodb différentes, sont localisés dans /usr/lib
Sur une BSD il faudra aller chercher dans /usr/local/var/lib
$ cd /usr/lib/zope29
$ sudo ./mkzopeinstance.py 

Répondez aux questions posées

•  emplacement où vous souhaitez voir votre instance (nous avons choisi pour l'exemple /home/bluetouff/z9000,
•  choix de l'utilisateur zope
•  choix du password.

Attention cet utilisateur aura les pleins pouvoirs sur votre instance, choisissez votre mot de passe correctement.

Permissions de l'instance

Dans notre exemple, nous avons choisi de placer notre instances dans le répertoire home de l'utilisateur, à savoir /home/bluetouff
Vous n'avez pas manqué de noter que la création de l'instance nécessitait des droits d'utilisateurs root (commande sudo), or, on ne souhaite pas que notre instance soit lancée avec ces droits. Nous allons donc les modifier pour donner au user bluetouff le droit de démarrer son instance et d'installer des produits. Nous changeons donc les permissions de notre instance de cette manière :

$ sudo chown -R bluetouff:bluetouff z9000/

Configuration de l'instance Zope

$ vi /home/bluetouff/z9000/etc/zope.conf

Et changez la valeur du port par défaut par celle que vous souhaitez (dans notre exemple zope écoute sur le port 9000).
Sous Debian, Zope écoute par défaut sur le port 9673.

Changez donc la ligne
%define HTTPPORT 9673
par
%define HTTPPORT 9000
pour que Zope écoute sur le port 9000

Sauvegardez votre nouvelle configuration.

Il ne nous reste plus qu'à démarrer notre instance

$ cd /home/bluetouff/z9000/bin
$ ./zopectl start

Vérifiez que tout s'est bien passé en ouvrant un navigateur et en vous rendant sur  :

http://urldemonserveur:9000

Vous devriez y voir votre page d'accueil de Zope

Installation de Zwook

Nous allons maintenant pouvoir passer à l'installation de Zwook à proprement parler.
On commence par récupérer la dernière version de Zwook

$ cd /home/bluetouff
$ wget  http://cesierre.ch/zwook_active_kz1_0_rc1/zwook/zwooksmanager-1.0.5.tgz

Vous pouvez maintenant décompresser l'archive contenant le zwook manager

$ tar -xvzf  zwooksmanager-1.0.5.tgz

Nous pouvons maintenant copier les Extensions et les produits dans les répertoires idoines de votre instance :

$ cd  NeedProducts
$ cp -r * /home/bluetouff/z9000/Products/ 

$ cd  NeedExtenstions
$ cp -r * /home/bluetouff/z9000/Extensions/

 Redémarrez votre instance

$ cd /home/bluetouff/z9000/bin
$./zopectl restart

Nous allons maintenant voir si notre Zwook manager a fait son office en laçant un navigateur et en nous rendant en ZMI à l'url :

http://urldemonserveur:9000/manage

Cette erreur provient de  ExternalEditor, nous commençons donc par faire le ménage

$ cd /home/bluetouff/z9000/Products

$ rm -rf ExternalEditor/

Puis on downloade la version 0.9.2

$ wget  http://www.plope.com/software/ExternalEditor/ExternalEditor-0.9.2-src.tgz

On le décompresse

$ tar -xvzf  ExternalEditor-0.9.2-src.tgz

on refait un coup de ménage mais cette fois ci sur l'archive compressée

$ rm -rf ExternalEditor-0.9.2-src.tgz

$ cd /home/bluetouff
$  mv ZwooksManager/ /home/bluetouff/z9000/Products/

et on redémarre l'instance

$ cd /home/bluetouff/z9000/bin
$ ./zopectl restart

On relance maintenant son navigateur pour voir si tout refonctionne convenablement, notre message d'erreur devrait avoir disparu. En zmi, dans les types de contenus disponibles dans le menu déroulant, vous trouverez maintenant notre zwook manager, ajoutez en un à la racine de votre zope par exemple.

Cliquez maintenant sur l'objet ainsi créé, puis sur l'onglet "view", depuis lequel nous allons pouvoir créer notre Zwook ou mettre à jour une installation préalablement effectuée dans une ancienne version.

A la création, nommez votre Zwook en lui donnant par exemple le nom du projet sur lequel vous souhaitez travailler, appelons le "monprojet" pour l'exemple. Lancez la création, ceci prend un petit moment en fonction de  votre configuration.

Fermez complètement votre navigateur, ou ouvrez en un autre (pas une nouvelle fenêtre du même navigateur et encore moins un onglet : un AUTRE navigateur (Opera, Firefox, ou ce que vous voudrez..)

Vous pouvez maintenant vous logguer sur votre Zwook en passant par l'url :

http://urldemonserveur:9000/monprojet

---------

Attention incomplet

Utilisation d'Apache 2 en frontal

Zope propose en natif un outil permettant de mapper des domaines sur plusieurs Zwooks contenus dans la même instance, il s'agit du VHM (virtual host monster), or, tous nos sites ne se trouvent pas forcément sur la même instance, dans ces conditions, la bonne pratique est d'utiliser Apache. Apache permettra en outre de pouvoir utiliser ssl pour l'authentification sécurisée et de soulager le Zserver  (le serveur http de Zope) du traitement de requêtes, ce qui d'un point de vue performances ne peut lui faire que grand bien.
Créer des VitualHost avez Apache pour faire cohabiter plusieurs instances sur le même serveur

- Activer  mod_proxy  mod_rewrite

Voici exemple de configuration pour un vhost capable de rewriter automatiquement  les sous domaines sous forme http://monzwwok.mondomaine.com à la création d'un nouveau Zwook sur une instance donnée

• Placez ce fichier dans /etc/apache2/site-enabled
• Rechargez Apache pour que votre fichier soit pris en compte