Pour répondre à des besoins d'installation et de mise à jour de Dynacase sur diverses plateforme, de manière simple via une interface WEB, Dynacase-control est né.

Dynacase-control rend l'installation et la mise à jour de Dynacase indépendant de la distribution Linux présente sur le serveur.

Dynacase-control en quelques lignes :

contrôle de la présences des services (postgresl, php, etc…), modules php et autres logiciels attendus sur le serveur
possibilité d'utiliser plusieurs dépôts Dynacase (stable, test, dev)
gestion des modules Dynacase : modules installés, mise à jours possibles, modules disponibles, suppressions de modules
gestion des dépendances entre modules lors de l'installation
paramétrage et modification des paramétrages des modules

Dynacase-control permet donc de réaliser simplement une première installation de Dynacase-platform.

Pré-requis

Pré-Requis logiciels

Les informations fournies ci-dessous, le sont à titre indicatif et peuvent varier en fonction de la distribution linux cible (nom des extensions par exemple).

Ces informations sont fournies pour la version stable de dynacase.

Pour les composants requis (apache, postgresql, php, …) la version validée est la version avec laquelle les tests de dynacase sont joués.

La version utilisable est éventuellement indiquée : elle est sensée fonctionner avec dynacase. Toutefois, l'ensemble des fonctionnalités dynacase n'ont pas été validé avec cette version.

Les informations relatives aux composants sont exhaustives (utilisée par certain modules) et nécessaires pour une installation standard faite par défaut.

	stable 3.0	3.1
PHP	> 3.0.12 version 5.3 >= 3.0.4 version 5.3 (fonctionne avec une version 5.2 si les composants extui ne sont pas utilisés) < 3.0.4 : version 5.2	5.3
PostgreSQL	8.3 ou 8.4¹⁾	8.4
ExtJS	3.1	3.2

Pour voir le détail des paquets aptitude à installer sous Debian, reportez-vous à la page Résolution des principales dépendances.

Navigateurs supportés

La version Dynacase 3.0 est fonctionnelle avec les navigateurs suivants :

Internet Explorer 8
Firefox 3 (>3.5)
Chrome branche stable

Apache

version validée : 2.2

Modules

php5_module
env_module
expires_module
dir_module
auth_basic_module
authn_file_module
authz_host_module
setenvif_module
rewrite_module

PHP

Modules PHP utilisé

Les modules notés (core) sont normalement inclus de manière statique dans PHP.

Core (core)
SimpleXML
calendar
ctype
date (core)
fileinfo
gd
gettext
iconv
imap
json
ldap
mbstring
pcntl
pcre
pgsql
posix
pspell
session (core)
sockets
standard (core)
xml
zip

PEAR

XML/RSS.php
Net/SMTP.php
Mail/mime.php
Crypt/CHAP.php (optionnel)

Commande *nix

rm
file
mkdir
tar
zip >= 3.0
unzip >= 6.0
dot
convert
recode
html2ps
ps2pdf
php
ldapdelete (optional)
psql
pg_dump
msgcat

01/02/2010 13:46 · Claverie Marc

Installation

Installation de Dynacase-control

A cette étape, l'installation de Dynacase Control doit être réalisée par l'administrateur de votre serveur

Pré-requis
- Dynacase-control nécessite un serveur HTTP Apache 2.x avec PHP 5 (mod_php) et les modules : php xml, php zip, php json
Il est nécessaire que le répertoire dans lequel sera installé Dynacase ait une directive ”AllowOverride All” positionné au niveau de la configuration Apache.
- Si le paramètre ”max_execution_time” de votre installation PHP est trop bas (inférieur à 5 minutes), il sera peut être nécessaire d'augmenter celui-ci dans votre `php.ini'.
Installation
Se connecter 'root'. Déplacer vous dans un répertoire accessible via apache (dans votre DocumentRoot décrit dans vos fichiers de configuration apache - par exemple). Dans ce répertoire sera installé Dynacase-control.
```
# cd /var/www/html
```
Télécharger l'installer ici http://eec.anakeen.com/public/control/dynacase-control-current.tar.gz :
```
# wget http://eec.anakeen.com/public/control/dynacase-control-current.tar.gz
```
Extraire l'archive :
```
# tar xfz dynacase-control-current.tar.gz
```
Modifier le propriétaire de l'arborescence crée :
```
# chown -R apache: dynacase-control-x.y-z/
```
Remarque : Le user apache dépend de votre distribution (www-data sous Debian)

Créer un raccourci
```
# ln -s dynacase-control-x.y-z dynacase-control
```
Se connecter à l'URL Dynacase Control (dépend de son dossier d'installation et de la configuration apache) :
- http://localhost/dynacase-control/
Troubleshooting/FAQ

PHP class 'DOMDocument' not found.

Installer `php-dom' et/ou `php-xml'.

PHP class 'ZipArchive' not found.

Installer `php-zip'.

PHP function 'json_encode' not found.

Installer `php-json'.

PHP function 'json_decode' not found.

Voir Message ”PHP function 'json_encode' not found.”.

02/04/2010 12:08
Création d'un contexte
Un contexte regroupe tout ce qui est nécessaire au fonctionnement de Dynacase-platform : bases, modules Dynacase (logiciel), paramètres de configuration, etc…

Un même serveur peut fournir plusieurs contextes Dynacase-platform, chacun des contextes étant totalement autonome en terme de logiciel et de source, vous pouvez donc avoir 2 versions de Dynacase-platform installées simultanément sur votre serveur.

Les différents éléments nécessaires à l'initialisation d'un contexte sont :
- le répertoire racine du contexte : ce répertoire contient l'ensemble des modules et autres données installées
- la base de données Dynacase (demandée par le module obligatoire dynacase-platform)
Ces éléments sont à préparer par un administrateur système ayant les accès super-utilisateur (root) sur le serveur.
Préparation du répertoire racine

C'est le répertoire dans lequel sera installé l'instance de Dynacase-platform.

Ce répertoire doit être sous le ”DocumentRoot” de votre serveur Apache, et accessible en lecture/écriture par Apache.

Vous pouvez rentrer un chemin absolu ou un chemin relatif. Dans le cas d'un chemin relatif, celui-ci sera relatif au répertoire dans lequel vous aurez installé Dynacase-control.

Si le répertoire renseigné n'existe pas, Dynacase-control essayera de le créer. Pour cela, il faut que l'utilisateur Apache ait le droit d'écriture dans le répertoire parent du répertoire que vous voulez créer.

Si le répertoire existe déjà, Dynacase-control vérifiera qu'il ne contient pas d'installation existante. Dans le cas contraire, une erreur sera retourné et vous devrez sélectionner un autre répertoire.

Création de la base de données
La base de donnée dédiée à votre contexte Dynacase doit être propriété d'un rôle (au sens postgresql) SUPERUSER sur la base du contexte Dynacase.

Exemple :
```
[root@server ~]# su postgres
[postgres@server ~]# psql
postgres=# CREATE ROLE dynacaseowner WITH LOGIN ENCRYPTED PASSWORD 'password' SUPERUSER;
postgres=# CREATE DATABASE dynacase OWNER dynacaseowner;
```
Note:
- Pour une utilisation optimale de PostgreSQL il peut être nécessaire de modifier la configuration par défaut de celui-ci. Pour cela, vous pouvez consulter ce guide qui vous donnera un aperçu des paramètres principaux : http://www.dynacase.org/dynacase/install/tuning_postgresql
Création du service Postgresql pour accèder à la base de données
La configuration de Dynacase est par la suite basée sur le service (au sens postgresql). Exemple :
```
[root@server ~]# more $PGSYSCONFDIR/pg_service.conf 
[dynacase]
host=localhost
port=5432
user=dynacaseowner
password=password
dbname=dynacase
```
Le répertoire $PGSYSCONFDIR dans lequel est stocké le fichier pg_service.conf est dépendant de votre distribution et sa valeur peut être trouvée à l'aide de la commande pg_config. Exemple :
```
[root@server ~]# pg_config --sysconfdir
/etc/sysconfig/pgsql/pg_service.conf
```
Sous Debian (Lenny), la commande 'pg_config' est fournie par le paquet 'postgresql-server-dev-8.3' ; sous Ubuntu server 8.10 LTS, le package 'libpq-dev' est suffisant.

# pg_config --sysconfdir /etc/postgresql-common
Pour vérifier que les paramètres associés au service sont correct on pourra essayer de se connecter à la base avec la commande `psql' :
```
[root@server ~]# PGSERVICE=dynacase psql
dynacase=# 
```
Création du contexte
Pour créer un contexte, il faut cliquer sur le lien “Create Context” et renseigner les champs indiqués.
- Name : Nom du contexte
- Root : Chemin relatif ou absolue ou seront installés les fichiers
- Description : Commentaire sur le contexte
- Repositories : Sélectionner la version de Dynacase à installer
- Url : Url de l'installation de Dynacase
02/04/2010 12:08

Première installation de Dynacase-platform avec Dynacase-control

Installation du module de base

Pour installer Dynacase-platform, il faut juste cliquer sur le bouton `Install Selection'. En effet tous les composants de base de Dynacase-platform sont déjà automatiquement sélectionnés. Ceci entrainera l'installation des modules de base de Dynacase-platform et toutes leur dépendances.

Paramètres obligatoires

Certains modules (ex : Dynacase-platform) nécessite la saisie de paramètres obligatoires qui seront demandés avant l'installation :

Pour freedom-toolbox, il faut donc renseigner les paramètres suivants :

client name : Nom de l'organisme/la société qui apparaîtra dans le login général de dynacase
database postgresql service name: : Nom du service PostgreSQL créé pour accéder à la base de données
authenticate default mode : html par défaut pour une authentification basée sur un formulaire Web
apache system user : Utilisateur sous lequel tourne apache (ex : www-data sous Debian)
temporary folder : répertoire utiliser pour stocker des données temporaires

Vérifications de pré-installation

Avant l'installation de chaque module, Dynacase-control vérifie que tout les pré-requis sont installés sur le système.

Un écran apparait indiquant les contrôles effectués. Si un pré-requis est absent, l'installation s'interromp et peut-être ensuite relancée (bouton “retry”) une fois le problème résolu (en général installation d'un paquet) :

Résolution des principales dépendances

Le tableau ci-dessous indique comment résoudre les dépendances pour une installation de base sous Debian Lenny.

Message	Commandes pour résoudre les dépendances
Checking if the PHP function 'pg_connect' exists You might need to install a php-pg package from your distribution in order to have Postgresql support in PHP.	aptitude install php5-pgsql /etc/init.d/apache2 reload
Checking if the command 'zip' is in the PATH	aptitude install zip
Checking if the command 'dot' is in the PATH	aptitude install graphviz
Checking if the command 'dot' is in the PATH	aptitude install imagemagick
Checking if the command 'html2ps' is in the PATH	aptitude install html2ps
Checking if the command 'php' is in the PATH	aptitude install php5-cli
Warning : Checking if the command 'ldapdelete' is in the PATH
Checking if the command 'msgcat' is in the PATH	aptitude install gettext
Checking if the PHP function 'imagegd' exists You might need to install a php-gd package from your distribution in order to have GD support in PHP.	aptitude install php5-gd/etc/init.d/apache2 reload
Checking if the PHP function 'ldap_connect' exists You might need to install a php-ldap package from your distribution in order to have LDAP support in PHP.	aptitude install php5-ldap /etc/init.d/apache2 reload
Warning : Checking if the PHP function 'ncurses_init' exists You might need to install a php-ncurses package from your distribution in order to have ncurses support in PHP.	Rien à faire sous Debian
Checking if the PHP function 'pspell_new' exists You might need to install a php-pspell package from your distribution in order to have spelling support in PHP.	aptitude install php5-pspell /etc/init.d/apache2 reload
Checking if the class 'Crypt_CHAP' is available in include file 'Crypt/CHAP.php' You might need to run : pear install Crypt_CHAP	aptitude install php-pear pear install Crypt_CHAP /etc/init.d/apache2 reload
Checking if the class 'Net_SMTP' is available in include file 'Net/SMTP.php' You might need to run : pear install Net_SMTP	pear install Net_SMTP /etc/init.d/apache2 reload
Checking if the class 'Mail_mime' is available in include file 'Mail/mime.php' You might need to run : pear install Mail_Mime	pear install Mail_Mime /etc/init.d/apache2 reload
Checking if the Apache module 'mod_expires' is loaded You might need to install and/or activate the Apache mod_expires module.	a2enmod expires/etc/init.d/apache2 restart
Checking if the class 'XSLTProcessor' is available in include file '' You might need to install a php-xsl package form your distribution in order to have XSLT support in PHP.	aptitude install php5-xsl /etc/init.d/apache2 reload
Checking if the class 'XML_Parser' is available in include file 'XML/Parser.php' You might need to install a php-pear-XML_Parser package from your distribution, or run 'pear install XML_Parser', in roder to have XML_Parser support in PHP.	pear install XML_Parser/etc/init.d/apache2 reload
Checking if the class 'XML_RSS' is available in include file 'XML/RSS.php' You might need to install a php-pear-XML_RSS package form your distribution, or run 'pear install XML_RSS', in order to get RSS parsing support in PHP.	aptitude install php-xml-rss/etc/init.d/apache2 reload
Checking if the PHP function 'imap_open' exists You might need to install a php-imap package from your distribution in order to get IMAP support in PHP.	aptitude install php5-imap/etc/init.d/apache2 reload

Debian Lenny

En résumé et toujours sous Debian Lenny, il faut donc exécuter ces commandes :

# aptitude install zip unzip graphviz imagemagick html2ps php5-cli 
# aptitude install php-pear gettext php5-pgsql php5-gd php5-xsl 
# aptitude install php5-ldap php5-pspell
# pear install Crypt_CHAP
# aptitude install php-net-smtp php-mail-mime
# a2enmod expires
# /etc/init.d/apache2 restart

Ubuntu 8.04 LTS

  apt-get install zip unzip dot graphviz html2ps imagemagick ghostscript gettext php5-gd php5-ldap  php5-pspell php-pear php5-xsl php-xml php-xml-rss php5-imap php5-mcrypt
  /etc/init.d/apache2 restart
  pear install Crypt_CHAP
  pear install Net_SMTP
  pear install Mail_Mime
  a2enmod expires
  /etc/init.d/apache2 force-reload
 
 ## required by module freedom-dav
  a2enmod expires
  /etc/init.d/apache2 force-reload

Ubuntu 10.04 LTS

  apt-get install postgresql apache2 php5 zip unzip graphviz html2ps imagemagick ghostscript gettext php5-gd php5-ldap php5-pspell php-pear php5-xsl php-xml-rss php5-imap php5-mcrypt php5-pgsql recode
 
  pear install Crypt_CHAP Net_SMTP Mail_Mime XML_Parser
 
  a2enmod expires rewrite
 
  service apache2 force-reload

Fin de l'installation et connexion à Dynacase-platform

Votre installation de Dynacase-platform de base est alors pleinement opérationnelle.

Dynacase-platform sera ensuite disponible à l'adresse indiquée dans votre contexte. Exemple :

http://localhost/dynacase/

Le mot de passe par défaut pour se connecter est “admin / anakeen”

02/04/2010 12:08

Dépôts

Seul les dépôts stables de la version 3.0 sont configurés par défaut.

Si vous avez un compte entreprise EEC, vous pouvez supprimer les dépôts fournis par défaut et ajouter les dépôts correspondants à votre compte EEC.

Pour ajouter un dépot, il suffit de se rendre dans le setup de dynacase-control. Dans ce setup, vous pouvez paramétrer le mode d'accès à internet (utilisation d'un proxy avec ou sans authentification), ajouter autant de dépots que nécessaires : Control > Setup > Repositories

Pour la recherche des mises à jour de dynacase-control, vous pouvez renseigner votre dépôt EEC avec les paramètres “wiff-update-host” et “wiff-update-path” : Control > Setup > Parameters

02/04/2010 12:08
La mise à jour automatique est en cours de réalisation. Une très prochaine version de Dynacase-control intègrera cette fonctionnalité.

Mise à jour de l'installeur Dynacase-control

Lorsque Dynacase-control détecte qu'une nouvelle version de l'installeur est disponible, une demande de mise-à-jour apparait :

Cliquer sur le bouton [Yes] pour télécharger et mettre à jour l'installeur, et cliquer sur [No] pour ne pas effectuer la mise-à-jour. La mise-à-jour sera proposée de nouveau au prochain chargement de l'installeur.

Mise à jour des modules Dynacase

Pour les mises à jour en mode console, se reporter à la documentation du CLI DYNACASE-CONTROL.

Lors de la consultation d'un contexte Dynacase, Dynacase-control présente les modules installés et ceux qui disposent d'une version supérieure sur le repository sont précédés de l'icône :

Dans l'exemple ci-dessus, le modules `dynacase-platform' a une mises-à-jour disponible.

Pour installer les mises-à-jour, il suffit de cocher les modules que vous souhaitez mettre à jour (case à cocher au début de la ligne), et valider ensuite en cliquant sur le bouton [Upgrade Selection]. En cliquant sur la case de la barre de titre, toute les mises à jour faisables seront sélectionnées (comme dans l'exemple).

02/04/2010 12:08

Ligne de commande

Mode CLI

Le CLI permet d'administrer le Dynacase-control en ligne de commande.

Utilisation

La commande `wiff' permet de manipuler et administrer les contextes Dynacase-platform.

A terme, les opérations actuellement accessibles à travers l'UI Web, seront accessibles en ligne de commande à l'aide de cette commande `wiff'.

La commande `wiff' doit être lancé sous `root'. Pour cela, vous pouvez soit vous logger sous le compte `root' pour exécuter la commande, soit utiliser `sudo pour exécuter celle-ci.

Si vous n'êtes pas `root' sur le serveur, et que les opérations d'administrations s'effectuent avec `sudo' :

$ sudo /var/www/dynacase-control/wiff help
Password: ******
[message d'aide]

Si vous avez accès au compte `root' sur le serveur :

# /var/www/dynacase-control/wiff help
[message d'aide]

Par la suite, nous utiliserons la notation de ce dernier cas (`# /var/www/dynacase-control/wiff').

Commandes

Lister les contextes existants

Syntaxe

list context [--pretty]