Historique

Migration d'une application Envole vers la version EOLE 2.4 (ébauche)¶

Pour faciliter le travail de packaging, il est nécessaire de "skeletoriser" le dépot 2.3 pour le transformer en dépot 2.4.

Nouvelle organisation du dépot git¶

Une nouvelle organisation globale des dépots git pour Envole est mise en place et sera commune pour 2.3 et 2.4.

Description des branches¶

Sources originales	Sources modifiées pour Envole	Ajouts EOLE	Packaging
upstream	=> patch	=> master	=> packaging 2.3
upstream	=> patch	=> master	=> packaging 2.4

la branche upstream ne contient que les sources originales de l'application et sert de référence pour la branche patch
la branche patch contient les sources patchées pour envole (il y a ici possibilité de générer un paquet envole-<nom_appli>)
la branche master est commune en 2.3 et 2.4 (sous réserve de rester compatible) et comporte, en plus des sources, tous les ajouts EOLE (templates, dicos, scripts, sql, password...)
les branches de packaging, une par version
Les flèches "=>" représentent le sens de merge des branches. (uptream est mergée dans patch qui est mergée dans master qui est mergée dans packaging)
Il est important de bien respecter ce sens de merge au risque de perdre des fichiers et rendre le dépot git inutilisable.

Étapes de migration d'un dépot¶

Créer la branche "patch" à partir de "master" :

user:~/depot/monappli (master)$ git checkout -b patch

Supprimer tout le contenu autre que le dossier src :

user:~/depot/monappli (patch)$ git rm -r dicos/* sso/* tmpl/* sql/* Makefile eole.mk apps.mk # etc...

Commiter

user:~/depot/monappli (patch)$ git commit -m "Suppression de la partie EOLE"

Créer la branche "upstream" à partir de "patch" :

user:~/depot/monappli (patch)$ git checkout -b upstream

Supprimer toutes les sources du dossier src :

user:~/depot/monappli (upstream)$ git rm -r src/monappli-1.0.0/* src/plugins-1.0.0/* # etc...

Télécharger les sources de l'application depuis le site d'origine (fichier tar.gz)

Décompresser les sources dans le dossier src et renommer le dossier selon la nomenclature skeletor :

user:~/depot/monappli (upstream)/src$ tar -xvzf ~/monappli-1.0.0.tar.gz 
user:~/depot/monappli (upstream)$ mv monappli monappli-1.0.0

Commiter

user:~/depot/monappli (upstream)$ git commit -m "Mise en place des sources 1.0.0"

Merge de la branche "upstream" dans "patch" (avec une option pour conserver les fichiers de "patch") :

user:~/depot/monappli (upstream)$ git checkout patch
user:~/depot/monappli (patch)$ git merge -s ours upstream

Merge de la branche "patch" dans "master" (avec une option pour conserver les fichiers de "master") :

user:~/depot/monappli (patch)$ git checkout master
user:~/depot/monappli (master)$ git merge -s ours patch

Les options de merge étant conservées, les prochains merge pourront se faire avec un simple "git merge ...".
Il est important de bien respecter le flux de merge des branches (représenté par "=>" dans le tableau au-dessus).

Pour simplifier ce travail, on pourra reporter la création de la branche "upstream" et l'effectuer à l'occasion d'une montée de version de l'application.

Modification des dicos¶

Normalement il n'y a rien à changer.

Modification des templates¶

Certaines variables souvent utilisées dans Envole ont changé de nom.

Nom en 2.3	Nouveau nom en 2.4
adresse_ip_annuaire	container_ip_annuaire
adresse_ip_fichier	container_ip_fichier
adresse_ip_mail	container_ip_mail
adresse_ip_mysql	container_ip_mysql
adresse_ip_web	container_ip_web

=> Ces variables peuvent être rajoutées en 2.4 pour une rétro-compatibilité (#5701)

Modification des scripts shell¶

CreoleGet¶

.ParseDico
echo $mavariable

est remplacé par :

echo $(CreoleGet mavariable)

ATTENTION : à ce jour, pour accéder à une variable esclave, il faut connaître la variable maître :

echo $(CreoleGet lamaster.lesclave)

Il est possible de tester la présence de ParseDico avant de le lancer et ainsi faire en sorte d'avoir des scripts communs en 2.3 et en 2.4

Code d'exemple tiré de grr :

#!/bin/bash
if [ -f /usr/bin/ParseDico ];then
    #EOLE 2.3
    . ParseDico
    . /etc/eole/containers.conf
else
    #EOLE 2.4
    activer_apache=$(CreoleGet activer_apache)
    activer_grr=$(CreoleGet activer_grr non)
    container_path_web=$(CreoleGet container_path_web)
fi

if [ "$activer_apache" = "oui" ] && [ "$activer_grr" = "oui" ];then
    /usr/share/envole/grr/InstallEnvoleGrr.php
    www_grr="$container_path_web/var/www/html/grr" 
    chmod 774 "$www_grr/images" 
fi

exit 0

CreoleRun¶

./usr/share/eole/FonctionsEoleNg
RunCmd "ma -commande" conteneur

est remplacé par :

CreoleRun "ma -commande" conteneur

Il est possible d'émuler la commande RunCmd en 2.4 ou bien émuler CreoleRun en 2.3.
Exemple de code :

#!/bin/bash
if [ -f /usr/bin/ParseDico ];then
    RunCmd=RunCmd
    . /usr/bin/ParseDico
    . /etc/eole/containers.conf
    . /usr/share/eole/FonctionsEoleNg
else
    RunCmd=CreoleRun
    activer_moodle=$(CreoleGet activer_moodle)
fi

CMD="cd ${INSTALL_DIR} ; ${BIN_PHP} ${UPGRADE_SCRIPT} --non-interactive" 

$RunCmd "${BIN_SU} - ${APACHE_USER} -s /bin/bash -c \"${CMD}\"" web

Problèmes spécifiques¶

Problème de connexion aux bases MySQL #5633 ¶

Pour y remédier temporairement, on peut mettre "localhost" à la place de "127.0.0.1" (penser à la fois aux fichiers sql et aux fichiers de config php).

État des lieux application par application¶

Ajaxplorer¶

OK => eole-ajaxplorer (4.2.3-eole3-1)

MAJ Envole 3.3.7 => eole-ajaxplorer 4.2.3-eole4-1

Problème au moment du test car piwik n'était pas installé (dans /var/www/html/ajaxplorer/plugins/gui.ajax/class.AJXP_ClientDriver.php +216 : include d'une lib piwik)

phpMyAdmin¶

OK => eole-phpmyadmin (2.4.0-6)

Piwik¶

paquet eole-piwik (1.12-eole1-1) à déboguer ...

Cdt¶

OK => eole-cdt (4.9.3.7-eole1-2)

MAJ Envole 3.3.7 => eole-cdt 4.9.4.4-eole2-1

Dokuwiki¶

OK => eole-dokuwiki (2012-01-25a-eole2-4)

MAJ Envole 3.3.7 => eole-dokuwiki_2012-01-25a-eole4-1

FluxBB¶

OK => eole-fluxbb (1.5.3.eole1-1)

MAJ Envole 3.3.7 => eole-fluxbb 1.5.3.eole3-1 (#7686 est prise en compte)

Gepi¶

OK => eole-gepi (1.6.3-eole2-1)

MAJ Envole 3.3.7 => eole-gepi 1.6.3-eole4-1

GRR¶

OK => eole-grr (1.9.7e-eole1-1)

MAJ Envole 3.3.7 => eole-grr 1.9.7e-eole2-1

Jappix¶

OK => eole-jappix (0.9.0-eole1-1)

MAJ Envole 3.3.7 => eole-jappix 0.9.0-eole1-2

Moodle¶

KO : script posttemplate/12-moodle non compatible 2.4 (#5964)

Moodle BigBlueButton¶

Non testé

Moodle Référentiel¶

Non testé

Piwigo¶

OK => eole-piwigo (2.3.5-eole2-1)

MAJ Envole 3.3.7 => eole-piwigo 2.3.5-eole3-1

Problème au moment du test car piwik n'était pas installé (dans /var/www/html/piwigo/include/page_header.php +76 : require_once sur une lib piwik)

Roundcube¶

OK => eole-roundcube (0.9.1-eole2-1)

MAJ Envole 3.3.7 => eole-roundcube 0.9.1-eole4-1

SAP¶

Non testé

SPIP Eva¶

OK => eole-spipeva (3.0.10-eole1-1)

MAJ Envole 3.3.7 => eole-spipeva 3.0.10-eole4-1

Taskfreak¶

OK => eole-taskfreak (0.6.4-eole1-1)

mais problème d'encodage sur 2.4 (#6723)

MAJ Envole 3.3.7 => eole-taskfreak 0.6.4-eole2-1

Webcalendar¶

OK => ?

WordPress¶

OK => eole-worpress (3.6.1-eole1-1)

MAJ Envole 3.3.7 => eole-wordpress 3.6.1-eole3-1

Zarafa¶

Non testé

CDC¶

Non testé

SquirrelMail¶

Ne sera pas supporté

Gibii¶

N'est déjà plus supporté en 2.3

Compilation en EOLE 2.4¶

Voir : http://dev-eole.ac-dijon.fr/projects/eole/wiki/PrepareEOLE24

La nouvelle procédure de compilation de paquet se base sur les noms de tag de la branche master.

Donc à chaque modification du paquet il faudra taguer cette version avec un numéro supérieur à la précédente.

Pour différencier les versions upstream et les versions modifiées par EOLE, on pourra taguer la branche upstream avec "upstream/x.y.z" (où x.y.z est son numéro de version) et les releases EOLE (branche master) avec "release/x.y.z-eoleX" (où X est le numéro de la version EOLE).

Pour connaitre le dernier tag utilisé afin de l'incrémenter, tapez la commande git describe.

Pour lancer la commande de compilation en dev :

git package -b -d eole-2.4/unstable dist/ubuntu/precise/master

La 2.4 permet de compiler un paquet en expérimental :

git package -b -d eole-2.4/experimental dist/ubuntu/precise/master

Pour récupérer un paquet expérimental, modifier le sources.list :

deb http://test-eole.ac-dijon.fr/eole eole-2.4-experimental main

Actualiser le cache :

apt-get update

Et installer le paquet avec :

apt-get -t eole-2.4-experimental install <paquet>

Projet

Général

Profil

Envole

Wiki

Migration d'une application Envole vers la version EOLE 2.4 (ébauche)¶

Nouvelle organisation du dépot git¶

Description des branches¶

Étapes de migration d'un dépot¶

Modification des dicos¶

Modification des templates¶

Modification des scripts shell¶

CreoleGet¶

CreoleRun¶

Problèmes spécifiques¶

Problème de connexion aux bases MySQL #5633¶

État des lieux application par application¶

Ajaxplorer¶

phpMyAdmin¶

Piwik¶

Cdt¶

Dokuwiki¶

FluxBB¶

Gepi¶

GRR¶

Jappix¶

Moodle¶

Moodle BigBlueButton¶

Moodle Référentiel¶

Piwigo¶

Roundcube¶

SAP¶

SPIP Eva¶

Taskfreak¶

Webcalendar¶

WordPress¶

Zarafa¶

CDC¶

SquirrelMail¶

Gibii¶

Compilation en EOLE 2.4¶

Problème de connexion aux bases MySQL #5633 ¶