Table des matières

, , , ,

OBM-UI

OBM est une solution logicielle Open Source de travail collaboratif, intégrant les meilleurs composants libres pour gérer et partager les informations au sein d’une organisation. OBM-UI est l'interface web de base de cette solution.

OBM-UI fournit :

Cette documentation explique comment installer manuellement OBM-UI à partir des sources et sans interférer avec vos autres applications web.

Pré-requis

Voici quelques éléments en cas de problème :

''sudo a2enmod rewrite ssl''

Installation

Télécharger les sources sur le site communautaire obm.org. Les extraire dans un répertoire accessible par apache (nous utiliserons /var/www/obm pour ce tutoriel). Modifier le propriétaire et le groupe pour les fichiers d'obm.

wget http://download.obm.org/obm-2.2.x.tar.gz
sudo mv obm-2.2.x.tar.gz /var/www
cd /var/www
sudo tar xzf obm-2.2.x.tar.gz
sudo mv obm-2.2.x obm
sudo chown www-data.www-data obm/ -R

Configuration

Configuer Apache

Le mieux est d'utiliser un virtualhost. Pour cela, créer un fichier obm dans /etc/apache2/sites-available/ avec les informations suivantes (le serveur sera accessible via le nom obm.mondomaine.tld) :

<VirtualHost *:80>
        ServerName obm.mondomaine.tld
        DocumentRoot "/var/www/obm/php"
        ErrorLog /var/log/apache2/obm-error.log
        CustomLog /var/log/apache2/obm-access.log combined
        RewriteEngine on
        RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [L,R]
</VirtualHost>
 
NameVirtualHost *:443
<VirtualHost *:443>
        ServerName obm.mondomaine.tld
        DocumentRoot "/var/www/obm/php"
 
        SSLVerifyClient none
        SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown downgrade-1.0 force-response-1.0
 
        ErrorLog /var/log/apache2/obm-error.log
        CustomLog /var/log/apache2/obm-access.log combined
 
        SetEnv OBM_INCLUDE_VAR obminclude
        Alias /images /var/www/obm/resources
        #OBM 2.2.x use utf8
        #AddDefaultCharset ISO-8859-15
        DirectoryIndex obm.php
        Options -Indexes
 
        php_value include_path  ".:/var/www/obm/"
        php_value session.bug_compat_42  0
        php_value session.bug_compat_warn  0
        #php_value session.gc_maxlifetime 2880
        php_value magic_quotes_gpc  On
        #les options suivantes sont recommandées ma facultative
        #php_value memory_limit 128M
        #php_value post_max_size 10M
        #php_value upload_max_filesize 10M
 
        # section nécessaire uniquement pour le synchro PDA
        #<Location /funambol>
        #ProxyPass ajp://_TOMCAT_SERVER_:8009/funambol
        #</Location>
 
        # section nécessaire uniquement pour le module obm-sync
        #<Location /obm-sync>
        #ProxyPass ajp://_TOMCAT_SERVER_:8009/obm-sync
        #</Location>
 
        # section nécessaire uniquement pour le webmail minig
        #<Location /minig>
        #ProxyPass ajp://_TOMCAT_SERVER_:8009/minig
        #</Location>
        # alias /webmail/images /usr/lib/minig/images
        #If you install minig on an other server,
        #comment alias /webmail/images, and use
        #proxyPass ajp:
        #<Location /webmail/images>
        #ProxyPass ajp://_TOMCAT_SERVER_Minig:8009/minig/images
        #</Location>
</VirtualHost>

Activer le virtualhost et relancer apache :

sudo a2ensite obm
sudo /etc/init.d/apache2 reload

Configurer la base de données

Créer une base de données ('obm'), un utilisateur ('obm') qui aura tous les droits sur la base. Utiliser pour cela phpmyadmin ou saisir dans une console :

mysql -u root -p
mysql> CREATE USER 'obm'@'localhost' IDENTIFIED BY 'password';
mysql> CREATE DATABASE IF NOT EXISTS `obm` ;
mysql> GRANT ALL PRIVILEGES ON `obm` . * TO 'obm'@'localhost';
mysql> exit

Créer les tables et importer les données par défaut :

cd /var/www/obm/scripts/2.2/
./install_obmdb_mysql_2.2.sh obm obm password fr 
( ajouter full en fin de ligne si cette commande ne fonctionne pas )

(syntaxe : […]/install_obmdb_mysql_2.2.sh db user password lang)

Configurer obm

Charger les configurations par défaut d'OBM :

sudo cp /var/www/obm/conf/obm_conf.inc.sample /var/www/obm/conf/obm_conf.inc
sudo cp /var/www/obm/conf/obm_conf.ini.sample /var/www/obm/conf/obm_conf.ini

Editez le fichier /var/www/obm/conf/obm_conf.ini et modifier les paramètres suivantes :

external-url = obm.mondomaine.tld
external-protocol = https
...
dbtype = MYSQL
db = obm
user = obm
password = "password"
...
; Enabled OBM module
obm-ldap = false
obm-mail = false
...
; backupRoot is the directory used to store backup data
backupRoot = "/var/backups/obm"

Il faut encore créer le répertoire pour les sauvegardes :

sudo mkdir /var/backups/obm
sudo chown www-data /var/backups/obm

Normalement, tout devrait fonctionner, vous pouvez passer à l'étape suivante.

Utilisation

Accéder à l'interface OBM : https://obm.mondomaine.tld/

Préliminaires

Créer un domaine

Il faut impérativement commencer par créer un premier domaine. Le domaine global n'est qu'un domaine à usage technique pour l'administrateur global d'OBM : il ne sert qu'à créer des domaines et ne devrait normalement pas contenir d'utilisateur (les utilisateurs du domaine global n'ont par exemple pas d'agenda).

Champs Explications
Label C'est le nom qui apparaît dans les formulaires (connexion par exemple) où le domaine doit être précisé (on peut mettre 'Domaine 1')
Description L'intitulé du champ est explicite (facultatif)
Nom de domaine C'est le nom de domaine au sens DNS (dans notre exemple, 'mondomaine.tld') - attention, cette valeur n'est plus modifiable une fois le domaine créé
Adresse1 … Ce sont les informations qui seront renseignées par défaut lors de la création des utilisateurs ; elles sont donc facultatives

Créer l'administrateur de ce domaine

Il doit maintenant créer l'administrateur de ce domaine, car, dans l'esprit d'OBM, admin0 ne sert qu'à la création des domaines et du premier administrateur. Il est plus prudent de tout faire par la suite avec le compte d'administration du domaine.

Champs Explications
Genre On y saisit normalement Mlle/Mme/M (facultatif)
Nom L'intitulé du champ parle de lui-même, il est obligatoire (dans notre exemple, on peut choisir 'admin1'
Prénom (facultatif)
Identifiant Champs obligatoire (dans notre exemple, 'admin1' également) - cette valeur est modifiable a posteriori
Mot de passe Champ obligatoire, 4 caractères mininum, 12 maxi, le message d'erreur est explicite si l'on saisit des caractères non autorisés
Domaine Choisir évidemment le domaine 1
Profil Laisser la valeur Admin
Titre, @M, Tel, Adresse1 … Ces informations (fonction, adresse courriel, téléphone…) concernent plutôt l'annuaire, elles sont facultatives

Créer les utilisateurs

On peut maintenant commencer à créer les utilisateurs à l'aide du compte administrateur du domaine 1.

Pour la connexion, il y a deux possibilités. Soit vous entrez l'identifiant, c'est-à-dire 'admin1' puis le mot de passe et enfin vous sélectionnez le domaine. Soit vous entrez comme identifiant, une pseudo adresse courriel (identifiant@mondomaine.tld) et dans ce cas, le domaine sélectionné n'a aucune importance : c'est ce qui est à droite du @ qui est pris en compte. L'adresse courrielle saisit lors de la création de l'utilisateur n'est par contre pas utilisable pour la connexion.

Voilà, votre serveur est normalement totalement opérationnel.

Désinstallation

mysql -u root -p
mysql> DROP USER 'obm'@'localhost';
mysql> DROP DATABASE `obm` ;
mysql> exit
sudo rm /etc/apache2/sites-available/obm /etc/apache2/sites-enabled/obm
sudo /etc/init.d/apache2 reload
sudo rm -rf /var/www/obm /var/backups/obm

Pour ceux qui avaient installés des paquets supplémentaires pour satisfaire aux pré-requis : les supprimer également.

Liens


Contributeurs : philoux99.