evoadmin-web/README-CLUSTER.md

73 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

INSTALLATION & CONFIGURATION EVOADMIN EN MODE CLUSTER
=====================================================
1. Infra type à mettre en place
-------------------------------
.---.
| | adm
'-.-'
.------------+------------.
v v v
.---. .---. .---.
| | www00 | | www01 | | wwwnn
'---' '---' '---'
* adm : machine hébergeant evoadmin-cluster. Doit pouvoir se connecter en
root sur tous les frontaux ;
* wwwXX : frontaux configurés en tant que pack-web/pack-mail.
2. Configuration sur la machine d'admin
---------------------------------------
* Récupérer le code ;
* Créer le virtual host pointant dans htdocs/ ;
* Initialiser la base de données SQLite :
* copier le contenu de scripts/ du dépôt dans /usr/share/scripts/evoadmin/.
3. Configuration des frontaux
-----------------------------
* Configurer un pack-web et pack-mail+evoadmin-mail classique ;
* ouvrir l'accès SSH entre tous les frontaux (nécessaire pour les
réplications) ;
* Ouvrir l'accès SSH en root depuis la machine d'admin vers chaque frontal ;
* Copier les scripts scripts/sync-master-to-slave* du dépôt dans
/opt/evocluster/, puis `chmod -R 755 /opt/evocluster/`.
Cas de la réplication MySQL :
* Configurer la réplication MySQL de manière standard (comme décrit ici [1]) ;
* Rajouter sur la machine slave dans le my.cnf la directive replicate-do-db,
qui contiendra la liste des bases des comptes à répliquer.
[1] http://trac.evolix.net/infogerance/wiki/HowtoMySQL#R%C3%A9plicationMySQL
4. Configuration d'Evoadmin
---------------------------
Afin d'activer Evoadmin en mode Cluster, remplir les variables suivantes dans
/home/evoadmin/www/conf/config.local.php :
$localconf['cluster'] = TRUE;
$localconf['cache'] = '/home/evoadmin/www/cache.sqlite'; // cache sqlite
$localconf['servers'] = array('www00', 'www01', ..., 'wwwnn');
Créer le cache après avoir renseigner le fichier de conf :
# cd /home/evoadmin/www/bin && php init_cache.php
www00 added in cache
[...]
Cache initialisé
# chown www-evoadmin:evoadmin /home/evoadmin/www/cache.sqlite
# chmod ug+rx /home/evoadmin/www/cache.sqlite
S'assurer que /home/evoadmin/www appartient bien à www-evoadmin:evoadmin.
Il est possible de dumper le cache grâce à au script list_domain.php et de
rajouter des serveurs dans le cache grâce au script add_server.php :
# php add_server.php www42