Installation de opush3 pour obm 3.0

Obm 3 utilise opush 3 pour le service activesync. Depuis cette version on doit installer cassandra nous même.

La raison est simple : du faite du multi node de cassandra, vous pouvez avoir cassandra sur un serveur différent que l’opush . Je vais donc vous décrire la procédure pour installer cassandra et opush sur un même serveur.

Pré-requis :

Une vm ou un serveur avec au minimum 2Go de RAM. Nous en mettrons donc 4Go.
Une Debian 7 64bit
La machine est en lan et son ip défini : son ip sera donc 192.168.4.125

Installation :

On commence par modifier notre source.list pour avoir les paquets pour cassandra et obm

# Stable repository with current version 3.0.X:
deb http://deb.obm.org/30/stable obm obm
deb http://deb.obm.org/30/contrib wheezy obm

deb http://deb.obm.org/opush/stable opush opush

deb http://ftp.fr.debian.org/debian/ wheezy main contrib non-free
deb-src http://ftp.fr.debian.org/debian/ wheezy main contrib non-free

deb http://security.debian.org/ wheezy/updates main contrib non-free
deb-src http://security.debian.org/ wheezy/updates main contrib non-free

# wheezy-updates, previously known as 'volatile'
deb http://ftp.fr.debian.org/debian/ wheezy-updates main contrib non-free
deb-src http://ftp.fr.debian.org/debian/ wheezy-updates main contrib non-free

# Cassandra 2.0
deb http://debian.datastax.com/community stable main

On récupère les clés

Si vous êtes from scratch, n’oubliez pas d’installer le paquet curl pour la suite.

wget -q http://deb.obm.org/obmgpg.pub -O - | apt-key add -
curl -L http://debian.datastax.com/debian/repo_key | apt-key add -

On met à jour notre liste de dépôts

apt-get update

Installation d’Oracle JRE

il faut au minium un JRE 1.7.0_25.  A l’heure ou j’écris ce tutorial la version est en 1.8

Allez sur la page :
http://www.oracle.com/technetwork/java/javase/downloads/index.html
et rendez vous sur JRE
Téléchargez la dernière version du JRE et installez la (attention modifiez le lien du Wget, mon AuthParam ne sera pas toujours valable, l’archive fait dans les 60Mo)

Lors de update-alternative, modifiez bien vos chemins en fonction de votre version.

cd /root
wget http://download.oracle.com/otn-pub/java/jdk/8u20-b26/jre-8u20-linux-x64.tar.gz?AuthParam=1410429997_ff1b83c9124dc16140191719bafa747c
mv jre-8u20-linux-x64.tar.gz?AuthParam=1410429997_ff1b83c9124dc16140191719bafa747c jre-8u20-linux-x64.tar.gz
mkdir -p /usr/lib/jvm
tar xvfz jre-8u20-linux-x64.tar.gz -C /usr/lib/jvm
update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/jre1.8.0_20/bin/java" 1
update-alternatives --set java /usr/lib/jvm/jre1.8.0_20/bin/java

Il nous reste plus qu’à définir la variable JAVA_HOME

export JAVA_HOME=/usr/lib/jvm/jre1.8.0_20

puis vérifier le tout

java -version

résultat :

java version "1.8.0_20"
Java(TM) SE Runtime Environment (build 1.8.0_20-b26)
Java HotSpot(TM) 64-Bit Server VM (build 25.20-b23, mixed mode)

Afin de le rendre permanent modifier le fichier /etc/profile et coller le export vu au-dessus

Installation de JNA

on installe le paquet

apt-get install libjna-java

Installation de cassandra 2.0

apt-get install dsc20

Configuration de cassandra

Il faut commencer avant tout par supprimer la configuration de base installée avec le paquet debian.

/etc/init.d/cassandra stop
rm -rf /var/lib/cassandra/data/system/*

On peut configurer cassandra en single node ou en multi-node.
Dans ce tutorial, je traiterai que le cas du single node.
Éditez le fichier /etc/cassandra/cassandra.yaml et modifiez les valeurs dans le fichier comme ci-dessous

...
cluster_name: 'MyOpushCluster'
...
seed_provider:
    - class_name: org.apache.cassandra.locator.SimpleSeedProvider
      parameters:
          - seeds: "127.0.0.1"
...
rpc_address: 192.168.4.125
....
authenticator: PasswordAuthenticator

redémarrer cassandra

/etc/init.d/cassandra start

On se connecte maintenant à cassandra.

cqlsh -u cassandra -p cassandra 192.168.4.125

et on créé le keyspace et l’utilisateur  ayant accès pour opush.

CREATE KEYSPACE opush WITH REPLICATION = {'class' : 'SimpleStrategy', 'replication_factor': 1}; USE opush; CREATE USER opush_user WITH PASSWORD 'opush_password' SUPERUSER;

Installation de Opush

Notez que pour répondre aux questions de l’installeur :
Pour les seed étant en single node: votre ip
Pour le keyspace : opush comme créé si dessus
Utilisateur opush : opush_user
Mot de passe de l’utilisateur : opush_password

apt-get install opush obm-munin-node

Configuration de Opush

C’est là que j’ai eu ma grosse surprise… Je ne peux l’expliquer, mais les fichiers de conf de opush étaient tout simplement incomplets ou inexistants. Donc nous allons vérifier chaque fichier et leur contenu.

Voilà les fichiers et les explications pour les remplir.
/etc/opush/opush.ini

#
# Locator & Database URL
#
host= **** ip du serveur ou se situe la base de donnée *****

#
# Database section
#

# DB type MYSQL, PGSQL
dbtype= *** Quel type de base de donnée utilisé MYSQL ou PGSQL *****

# Database name
db= **** nom de la base de donnée ****

# DB user
user= **** utilisateur de la base de donnée ****

# DB user password
password= *** mot de passe de l utilisateur ****

# OBM external URL
external-url= *** url d acces a votre interface d administration Obm *****

#
# Transaction timeout section
#

# Transaction timeout
transaction-timeout=1

# Transaction timeout unit (milliseconds, seconds, minutes, hours)
transaction-timeout-unit=minutes

/etc/opush/ldap_conf.ini

search.ldap.filter=(&(objectClass=inetOrgPerson) (|(mail=%q*)(sn=%q*)(givenName=%q*)))
search.ldap.url=*** ip du serveur ldap exemple : search.ldap.url=ldap://127.0.0.1 ****
search.ldap.basedn=dc=%d,dc=local

/etc/opush/cassandra.ini

cassandra.seeds=*** ip de votre serveur opush ****
cassandra.keyspace=opush
cassandra.user=*** utilisateur creer pour cassandra pour le keyspace opush
cassandra.password=*** mot de pase de l utilisateur cassandra***

Initialisation du schéma de cassandra

Si vous regardez le fichier de log de opush /var/log/opush/opush.log vous verrez ce message d’erreur :

[ERROR] {CONTAINER} [t/c/r/] Cassandra schema not installed, starting administration services only

Pour faire cela on doit utiliser CRaSH

Présentation de CRaSH

CRaSH est un shell permettant d’administrer le serveur Opush.

Configuration de CRaSH

La configuration de CRaSH se fait dans le fichier /etc/opush/remote_console.ini

# Default parameters
# uncomment lines and modify values to change default settings
#
console.enable = true
console.ssh.port = 5665
console.authentication.domain = global.virt

console.ssh.port permet de définir le port de connexion en ssh pour accéder à la console
console.authentication.domain permet de définir le domaine dans opush dont l’administrateur aura le droit de se connecter à CRaSH

Configuration de l’utilisateur ayant le droit d’administration de CRaSH dans OBM

Connectez vous sur votre interface Obm sur le global.virt avec l’utilisateur admin0.
Rendez vous dans Administration>Profil utilisateur
Recherchez admin et modifiez le profil

Dans Réglages Spécifiques cochez Administration et validez les modifications.

Connexion a CRaSH

Sur le serveur opush connectez vous comme suit à crash :

ssh -p 5665 admin0@127.0.0.1

Le mot de passe étant celui de votre utilisateur admin0 dans Obm

Installation du schema

Dans la console CRaSH :

schema install

Voila c est fait!

Autres commandes :

schema status # pour l etat
schema update # pour la mise a jour
dashbord # un equivalent de htop

il ne reste plus qu’à redémarrer opush

/etc/init.d/opush restart