Documentation Bnum

Pages de documentation du Bnum

Installation

Pré-requis

Le Bnum MCE est basé sur le produit open-source Roundcube. Pour fonctionner voici les besoins :

• serveur IMAP (Cyrus, Dovecot, ...), voir la partie cœur de messagerie de la MCE sur la forge MCE
• serveur SMTP (Postfix, ...), voir la partie cœur de messagerie de la MCE sur la forge MCE
• serveur d'annuaire LDAP (OpenLDAP, ...), voir la partie annuaire technique de la MCE sur la forge MCE
• une base de données Postgresql (voir l'initialisation des schémas ci-dessous)
• un serveur web (Apache, Nginx, ...), voir les recommandations de la MCE (voir Apache pour la configuration)
• un serveur PHP, version recommandée actuelle : 7.3 (voir php pour plus de détails)
• les modules php : json, ldap, pgsql, mbstring, curl, intl, xml, zip, soap, opcache
• un environnement haute disponibilité : load balancer, reverse proxy, stockage partagé (pour les fichiers, ça peut être du NAS sinon ce sera en base de données), stockage de session (Redis, Memcache, ...)

Mise en place

Récupérer la dernière release depuis le dépôt webmail. L'installation se fera en fonction de l'environnement, mais la release peut directement être utilisé sur le serveur web configuré. Une fois le Bnum en place sur le serveur, il faut passer à la Configuration.

Une documentation d'installation complète est fournie par Roundcube : documentation

Base de données

Initialisation

La première chose à faire est de créer une base de données "roundcube" ou "rcube" avec un utilisateur associé.

La base de données Roundcube (base uniquement dédiée au Bnum) s'initialise à partir du script *.initial.sql accessible dans le dossier SQL

Par exemple pour une base de données PostgreSQL l'initialisation doit se faire à partir du fichier postgres.initial.sql

Mise à jour

Le schéma de la base de données Roundcube peut évoluer au fil du temps, il faut alors appliquer des mises à jour à partir des fichiers d'update. Tous les fichiers d'update sont trouvables dans le dossier ayant le nom du type de base de données, par exemple pour PostgreSQL.

Pour identifier les mises a jour à appliquer il est possible de se référer à la valeur de roundcube-version dans la table system. Tous les updates après cette date doivent être appliquer.

Initialisation de la base de données de l'ORM

Pour un fonctionnement optimal du Bnum, une seconde base de données doit être initialisée. Il s'agit de la base de données de l'ORM permettant le stockage des agendas, contacts, tâches et espaces de travail des utilisateurs. Pour l'initialisation il faut suivre la documentation de l'orm.

Configuration

Plusieurs configurations sont nécessaires pour un fonctionnement optimal du Bnum : la configuration générale de Roundcube, la configuration des plugins, la configuration de l'ORM :

• Pour la configuration générale, voir configuration Bnum
• Pour la configuration de l'ORM, voir configuration orm
• Pour la configuration des plugins, voir plugins du Bnum
• Pour la configuration PHP, voir php

Liste des plugins

Voir plugins du Bnum

Développement

Une page de documentation dédiée au développement sur le Bnum est disponible ici : documentation

Pour développer un plugin dans le Bnum, il faut utiliser le framework Roundcube associé
Une documentation sur le développement et la mise en place d'un nouveau plugin est accessible ici : Documentation_Roundcube_-_Developper_un_plugin.pdf

Roundcube propose dans sa page wiki pas mal de documentation sur le développement autour du framework : documentation

Documentations utilisateur

Plusieurs documentations utilisateur existent :

• Documentation utilisateur par la communauté Roundcube (attention l'interface est assez différente de celle de la MCE) : documentation
• Documentation utilisateur par le MTE : documentation du Bnum
• L'aiguilleur du Bnum par le MTE : aiguilleur du Bnum
• Le MTE propose également une page d'aide générale avec un moteur de recherche : page d'aide