Procédure de déploiement du système SOGo

Côté serveur

Les prérequis serveur

• Un serveur virtuel avec :
  • Intel, AMD or PowerPC CPU 3 GHz (côté HN)
  • minimum 2048 MB of RAM
  • minimum 3 GB d'espace disque
• un serveur imap
• un serveur smtp

Installation et configuration du serveur

• créez et configurez un serveur virtuel de base à votre sauce
• exemple de partitionnement recommandé :
  • 2 Go pour / (obligatoire)
  • 1 Go pour /var (optionnel)
  • 1 Go pour /var/log (recommandé)
  • 1 Go pour /var/lib/mysql (obligatoire)
  • 3 Go pour /opt (dans le cas d'une installation de Funambol)

• une idée des haricots (beancounters) sur le SOGo de Montréal : Projet/SOGo/BeanCounterServeurDeMontreal

• reconfigurer les locales :

  • # les locales
    # sélectionner fr_FR.UTF-8 + la langue locale
    # et choisir celle qu'on veut par défaut, à condition que ce soit en .UTF-8
    
    dpkg-reconfigure locales
    
    . /etc/environment
    . /etc/default/locale
    export LANG

• reconfigurer le fuseau horaire :

  • dpkg-reconfigure tzdata

mise en place d'Apache

dans un objectif SSL et PHP5 (installe le mpm-prefork au lieu du mpm-worker par défaut)

• # installer apache2 + config Unicode + SSL + activation modules
  aptitude install apache2 libapache2-mod-php5
  
  sed -i '/^#AddDefaultCharset/c AddDefaultCharset UTF-8' /etc/apache2/conf.d/charset
  
  a2enmod mime
  
  # Configuration Apache2 en mode ssl
  # cf http://wiki.auf.org/wikiteki/PKI/CréationCertificatServeurSSL pour la création du certif dans IGC (http://igc.auf.org)
  # installé la racine AUF sur tous les postes clients (dans thunderbird et dans firefox) : cf 
  #    http://wiki.auf.org/wikiteki/PKI#Pr.2BAOk-liminaire_:_installation_de_l.27AC_racine_dans_Firefox_et_Thunderbird
  
  a2enmod ssl
  
  cat > /etc/apache2/sites-available/sogo.xx.auf.org << __EOF__
  <VirtualHost *:80>
          ServerName sogo.xx.auf.org
          ServerAdmin rtr+sogo@xx.auf.org
          DocumentRoot /var/www
          ErrorLog \${APACHE_LOG_DIR}/sogo.xx.auf.org-error.log
          CustomLog \${APACHE_LOG_DIR}/sogo.xx.auf.org-access.log combined
          RedirectMatch ^/$ https://sogo.xx.auf.org/SOGo
  </VirtualHost>
  __EOF__
  
  cat > /etc/apache2/sites-available/sogo.xx.auf.org-ssl << __EOF__
  <IfModule mod_ssl.c>
  <VirtualHost _default_:443>
          ServerName sogo.xx.auf.org
          ServerAdmin rtr+sogo@xx.auf.org
          DocumentRoot /var/www
          RedirectMatch ^/$ https://sogo.xx.auf.org/SOGo
          ErrorLog \${APACHE_LOG_DIR}/sogo.xx.auf.org-ssl-error.log
          CustomLog \${APACHE_LOG_DIR}/sogo.xx.auf.org-ssl-access.log combined
  
          SSLEngine on
          SSLCertificateFile    /etc/ssl/certs/sogo.xx.auf.org-cert.pem
          SSLCertificateKeyFile /etc/ssl/private/sogo.xx.auf.org-key.pem
          SSLCACertificateFile  /etc/ssl/certs/AC-AUF-RACINE+BA.pem       # changer la région
          SSLVerifyClient None
  </VirtualHost>
  </IfModule>
  __EOF__
  
  a2ensite sogo.xx.auf.org
  a2ensite sogo.xx.auf.org-ssl
  
  a2dissite default
  
  # Activer les modules proxy requis par SOGo
  
  a2enmod headers
  a2enmod rewrite
  a2enmod proxy_http

• redémarrer apache : service apache2 restart

mise en place de mysql

• # installer MySQL + config Unicode
  aptitude install mysql-server
  
  cat > /root/.my.cnf  << __EOF__
  [client]
  password = "mot-de-passe-super-complique"   #idem que celui tapé lors de l'installation du paquet mysql-server-5.1 précédemment
  __EOF__
  chmod 0600 /root/.my.cnf
  
  cat > /etc/mysql/conf.d/local.cnf << __EOF__
  [mysqld]
  # par défaut du côté serveur
  default-character-set = utf8
  #character-set-server = utf8
  
  # à exécuter pour tous les clients (indispensable pour PHP 4, au moins)
  init-connect = 'SET NAMES utf8'
  
  language = /usr/share/mysql/french
  
  bind-address = 0.0.0.0
  
  # log_slow_queries = /var/log/mysql/mysql-slow.log
  # log_bin = /var/log/mysql/mysql-bin.log
  log        = /var/log/mysql/mysql.log
  
  # max_connections = 500
  
  [mysqldump]
  default-character-set = utf8
  
  [mysql]
  # par défaut du côté client (pour root, qui ne subit pas le init-connect)
  default-character-set = utf8
  __EOF__
  
  # relancer mysql
  /etc/init.d/mysql restart

installation de SOGo

• # ajout du dépôt inverse
  echo "deb http://inverse.ca/debian squeeze squeeze" >> /etc/apt/sources.list
  
  # ajouter la clé inverse.ca
  apt-key adv --keyserver subkeys.pgp.net --recv 19CDA6A9810273C4
  
  aptitude update
  
  aptitude install --without-recommends sogo memcached
  
  # corriger memcached pour sogo
  sed -i -e "s/127.0.0.1/localhost/" /etc/memcached.conf
  
  service memcached restart
  
  # On met le nom du serveur SOGo dans apache en gardant le HTTPS
  sed -i -e "s/yourhostname/sogo.ca.auf.org/g" /etc/apache2/conf.d/SOGo.conf
  
  # au passage, suite à l'alerte lors de l'installation
  sed -i -e "s/^SHOWWARNING/#SHOWWARNING=true/g" /etc/tmpreaper.conf
  
  
  # base de données
  cat > /root/sogo-bdd.sql << __EOF__
  CREATE DATABASE sogo DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
  GRANT ALL PRIVILEGES ON sogo.* TO 'sogo'@'localhost' IDENTIFIED BY 'xxxxxxxxxxxxxxxx';
  GRANT ALL PRIVILEGES ON sogo.* TO 'sogo'@'sogo.xx.auf.org'  IDENTIFIED BY 'xxxxxxxxxxxxxxx';
  GRANT select ON sogo.* TO 'sogo'@'sogo.%.auf.org'  IDENTIFIED BY 'xxxxxxxxxxxxxxx';                # autoriser les autres SOGo à se connecter sur notre sogo
  
  # mettre un enregistrement reverse dans son dns pour son sogo.xx.auf.org
  
  USE sogo;
  
  CREATE TABLE auf_users (
    c_uid varchar(255) NOT NULL,
    c_name varchar(255) DEFAULT NULL,
    c_password varchar(255) DEFAULT NULL,
    c_cn varchar(255) DEFAULT NULL,
    mail varchar(255) DEFAULT NULL,
    mail_pays varchar(255) DEFAULT NULL,
    givenname varchar(64) DEFAULT NULL,
    sn varchar(64) DEFAULT NULL,
    department varchar(255) DEFAULT NULL,
    title varchar(255) DEFAULT NULL,
    telephonenumber varchar(16) DEFAULT NULL,
    source varchar(64) DEFAULT 'LOCAL',
    PRIMARY KEY (c_uid)
  ) ENGINE=MyISAM DEFAULT CHARSET=utf8;
  
  __EOF__
  
  # le reste des tables sera créé par SOGo lui-même.
  
  mysql < /root/sogo-bdd.sql
  
  # configuration SOGo
  # Il faut lancer le service sogo avant la configuration, sinon au lancement, après configuration, il créera un fichier "vide" en écrasant nos config
  
  service sogo stop ; sleep 10 ; service sogo start
  
  cat > /root/config_sogo.sh << __EOF__
  defaults -u sogo write sogod SOGoMailDomain xx.auf.org
  defaults -u sogo write sogod SOGoMailingMechanism smtp
  defaults -u sogo write sogod SOGoSMTPServer smtp.xx.auf.org
  defaults -u sogo write sogod SOGoLanguage French
  defaults -u sogo write sogod SOGoTimeZone xxxxxxxxxxxxx/xxxxxxxxxxxxx # America/Montreal
  defaults -u sogo write sogod SOGoEnableEMailAlarms YES
  defaults -u sogo write sogod OCSSessionsFolderURL mysql://sogo:xxxxxxxxxxxx@sogo.xx.auf.org:3306/sogo/sogo_sessions_folder
  defaults -u sogo write sogod OCSFolderInfoURL mysql://sogo:xxxxxxxxxxxx@sogo.xx.auf.org:3306/sogo/sogo_folder_info
  defaults -u sogo write sogod SOGoProfileURL mysql://sogo:xxxxxxxxxxxx@sogo.xx.auf.org:3306/sogo/sogo_user_profile
  defaults -u sogo write sogod OCSEMailAlarmsFolderURL mysql://sogo:xxxxxxxxxxxxx@sogo.xx.auf.org:3306/sogo/sogo_alarms_folder
  defaults -u sogo write sogod SOGoIMAPServer imaps://imap.xx.auf.org:993
  # pour un serveur en imap
  # defaults -u sogo write sogod SOGoIMAPServer imap.xx.auf.org
  defaults -u sogo write sogod SOGoCalendarDefaultRoles '("PublicViewer","ConfidentialDAndTViewer")'
  defaults -u sogo write sogod SOGoDayStartTime 9
  defaults -u sogo write sogod SOGoDayEndTime 17
  defaults -u sogo write sogod SOGoFirstDayOfWeek 1
  defaults -u sogo write sogod SOGoBusyOffHours YES
  defaults -u sogo write sogod SOGoDefaultCalendar personal
  defaults -u sogo write sogod SOGoMailAuxiliaryUserAccountsEnabled YES
  defaults -u sogo write sogod SOGoPageTitle 'SOGo - AUF xxxxxNOM_BUREAUxxxxxx'
  defaults -u sogo write sogod SOGoEnablePublicAccess YES
  defaults -u sogo write sogod SOGoForceIMAPLoginWithEmail YES
  defaults -u sogo write sogod SOGoFaviconRelativeURL http://www.auf.org/favicon.ico
  defaults -u sogo write sogod SOGoSuperUsernames '('username_de_l_admin')'
  defaults -u sogo write sogod SOGoAppointmentSendEMailNotifications YES
  
  defaults -u sogo write sogod SOGoUserSources '(
      {
          canAuthenticate = YES;
          displayName = ANNUAIRE-AUF;
          id = users;
          isAddressBook = YES;
          type = sql;
          LoginFieldNames = (c_uid, mail_pays);
          userPasswordAlgorithm = crypt;
          viewURL = "mysql://sogo:xxxxxxxxxxxxxxx@sogo.xx.auf.org:3306/sogo/auf_users";
          IMAPLoginFieldName = mail_pays;
          authenticationFilter = "source='\''LOCAL'\''";
      }
  )'
  __EOF__
  
  # NB : adpater les champs suivants :
  #  - code pays (deux caractères, ex. ca)
  #  - serveur smtp
  #  - serveur imap
  #  - mot de passe du compte d'accès à la base de données sogo
  #  - le mot de passe mysql de sogo est celui définit lors de la configuration de la base de données sogo, plus haut
  
  service sogo stop
  
  sh /root/config_sogo.sh
  
  # augmenter le nombre d'instances de sogo
  sed -i '/^# PREFORK/c PREFORK=5' /etc/default/sogo
  
  
  # corriger l'ordre de démarrage pour que SOGo soit lancé après mysql et non avant
  if ! grep -q 'Required-Start:.* mysql' /etc/init.d/sogo ; then
    sed -i -e '/^# Required-Start:/s/$/ mysql/' /etc/init.d/sogo
  fi
  
  insserv sogo
  
  service sogo start
  
  # Relancer Apache
  /etc/init.d/apache2 restart

• A ce stade, SOGo est prêt et fonctionnel. Pour tester :

  • ouvrir un navigateur et aller à https:sogo.xx.auf.org

  • on ne peut pas encore se connecter, car les comptes utilisateurs ne sont pas encore créés.

synchronisations

• Inter-implantation et synchronisation des comptes utilisateurs (prenom.nom@auf.org + mot de passe associé)

• installation paquet debian développé par ProgFou : sogocentral-clients

  • echo "deb http://apt.auf.org squeeze auf" >> /etc/apt/sources.list
    aptitude install auf-keyring
    aptitude update
    aptitude install sogocentral-clients
    
    # se référer à la doc pour la suite
    cat /usr/share/doc/sogocentral-clients/mysql.sql
    
    # lancer une première synchro (un cron tourne à chaque heure pour le reste)
    sogocentral-sync

• génération des entrées dns pour /etc/hosts (régler les problèmes de DNS inverse pas toujours disponibles)

  • sogocentral-gen-hosts >> /etc/hosts
    # vérifier et supprimer le doublon sur votre serveur local

• génération des régles pour le parefeu (faciliter l'ouverture des filtrages pour les serveurs SOGo)

  • sogocentral-gen-iptables >> /etc/network/firewall-sogo
    # ajouter ce fichier dans votre fichier principal de règles iptables, quelque part au début
    # insérer la dernière régle générée (et en commentaire) dans votre fichier principal de règles iptables après le fichier.
    # relancer les règles iptables

personnalisation de la page d'accueil

• mkdir -p /home/sogo/GNUstep/Library/SOGo/Templates/MainUI
  
    # télécharger ces deux fichiers (template modifié et styles)
  wget --user-agent="Client-sogo-config" -O /home/sogo/GNUstep/Library/SOGo/Templates/MainUI/SOGoRootPage.wox "http://wiki.auf.org/wikiteki/Projet/SOGo/Proc%C3%A9dureD%C3%A9ploiement?action=AttachFile&do=get&target=SOGoRootPage.wox"
  wget --user-agent="Client-sogo-config" -O /home/sogo/GNUstep/Library/SOGo/Templates/MainUI/SOGoRootPage.css "http://wiki.auf.org/wikiteki/Projet/SOGo/Proc%C3%A9dureD%C3%A9ploiement?action=AttachFile&do=get&target=SOGoRootPage.css"
    # remplacer "Amériques et Caraïbes" par votre région dans le fichier SOGoRootPage.wox
  
    # télécharger les logos
  wget --user-agent="Client-sogo-config" -O /usr/lib/GNUstep/SOGo/WebServerResources/logo_auf.png "http://wiki.auf.org/wikiteki/Projet/SOGo/Proc%C3%A9dureD%C3%A9ploiement?action=AttachFile&do=get&target=logo_auf.png"
  wget --user-agent="Client-sogo-config" -O /usr/lib/GNUstep/SOGo/WebServerResources/sogo-logo-petit.png "http://wiki.auf.org/wikiteki/Projet/SOGo/Proc%C3%A9dureD%C3%A9ploiement?action=AttachFile&do=get&target=sogo-logo-petit.png"

création de comptes génériques pour les agendas publics

• création du compte (remplacer les variables ci-dessous par les bonnes valeurs)

  • INSERT INTO auf_users VALUES ('agenda.[ville_bureau]','agenda.[ville_bureau]',ENCRYPT('[mot_de_passe]',),'Agendas public [nom_bureau]','agenda.[ville_bureau]@xx.auf.org','agenda.[ville_bureau]@xx.auf.org','Agendas public','[nom_bureau]','AUF','[nom_bureau]','[num_tel]','LOCAL');

• contacter la personne qui a été désigné par l'administration pour gérer les agendas publics et lui donner les codes d'accès :
  • elle doit se connecter avec ces codes via sogo web (agenda.[ville_bureau] et son [mot_de_passe])

  • créer les agendas publics nécessaires en veillant à bien commencer par le nom de la ville : [ville_bureau]-Absences-Missions et [ville_bureau]-Evenements (exemples : Paris-Evenements et Paris-Absences-Missions).

    • NB : Commencer par ceux du bureau régional, les autres seront ajoutés au besoin
  • elle va ensuite dans l'option partage pour chacun de ces agendas et s'accorde les droits (tous les droits) à elle-même ou à une autre personne déléguée pour tel ou tel autre agenda ; cela pour pouvoir accéder aux agendas publics depuis son compte personnel sans être obligé de se connecter avec le compte générique.
    • NB : on peut très bien choisir/préférer utiliser directement le compte générique plutôt que de devoir s'abonner aux agendas publics.
  • règles importantes dans la création des évènements : préfixer les évènements par leur intitulé explicite. Exemple :
    • Mission - Moussa Nombré (Bucarest) # on indique le lieu de la mission entre parenthèses
    • Férié - (BAO) - Fête du travail
    • Absence - Christine Legris

gestion des extensions SOGo

• (extensions pour le client Thunderbird + script de mise à jour)

  mkdir /var/www/plugins
  cd /var/www/plugins
  
  # récupération du script de mise à jour
  wget --user-agent="Client-sogo-config" -O updates.php "http://wiki.auf.org/wikiteki/Projet/SOGo/MiseAJourDesExtensions?action=AttachFile&do=get&target=updates.php"
  
  # adaptation du script
  sed -i -e "s/inverse.ca\/downloads\/extensions/sogo.xx.auf.org\/plugins/" updates.php
  sed -i -e "s/102/106/" updates.php
  
  # récupération des extensions
  wget --user-agent="Client-sogo-config" -O sogo-connector-3.106.xpi http://www.sogo.nu/files/downloads/extensions/sogo-connector-3.106.xpi
  wget --user-agent="Client-sogo-config" -O lightning-1.0b2.106i.xpi http://www.sogo.nu/files/downloads/extensions/lightning-1.0b2.106i_linux-i686.xpi
  
  # adpatation du sogo-integrator
  
  # utilitaire pour manipuler les .xpi
  aptitude install fastjar
  cd /tmp
  wget --user-agent="Client-sogo-config" -O sogo-integrator-3.106.xpi http://www.sogo.nu/files/downloads/extensions/sogo-integrator-3.106-sogo-demo.xpi
  mkdir SOGo
  cd SOGo
  jar xf /tmp/sogo-integrator-3.106.xpi
  rm chrome/content/extensions.rdf
  cat > chrome/content/extensions.rdf << __EOF__
  <?xml version="1.0"?>
  <!DOCTYPE RDF>
  <RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:isi="http://inverse.ca/sogo-integrator/"
    xmlns:em="http://www.mozilla.org/2004/em-rdf#"
    xmlns:NC="http://home.netscape.com/NC-rdf#">
    <Seq about="http://inverse.ca/sogo-integrator/extensions"
      isi:updateURL="https://sogo.xx.auf.org/plugins/updates.php?plugin=%ITEM_ID%&amp;version=%ITEM_VERSION%&amp;platform=%PLATFORM%">
      <li>
        <Description
          em:id="sogo-integrator@inverse.ca"
          em:name="SOGo Integrator"/>
      </li>
      <li>
        <Description
          em:id="sogo-connector@inverse.ca"
          em:name="SOGo Connector"/>
      </li>
      <li>
        <Description
          em:id="{e2fda1a4-762b-4020-b5ad-a41df1933103}"
          em:name="Lightning"/>
      </li>
    </Seq>
  </RDF>
  __EOF__
  
  jar cf sogo-integrator-3.106.xpi *
  cp sogo-integrator-3.106.xpi /var/www/plugins
  
  # Vérification :
  # Il faut s'assurer que l'extension sogo-integrator a été bien configurée
  # 1. aller sur http://sogo.xx.auf.org/plugins, télécharger sogo-integrator (bouton droit - enregistrer sous) et
  #    désarchiver et vérifier que le fichier chrome/content/extensions.rdf pointe bien sur votre serveur
  # 2. voir la ligne : "isi:updateURL="http://sogo.xx.auf.org/plugins/updates.php?
  #    plugin=%ITEM_ID%&amp;version=%ITEM_VERSION%&amp;platform=%PLATFORM%">"
  # AVEZ-VOUS REMPLACE LE xx (sogo.xx.auf.org) PAR VOTRE CODE PAYS ???????????
  # si oui, tout est bon
  # sinon modifier le fichier /tmp/SOGo/chrome/content/extensions.rdf et 
  # "cd /tmp/SOGo ; jar cf sogo-integrator-3.106.xpi * ; cp sogo-integrator-3.106.xpi /var/www/plugins"

pour ceux qui ont des clients BlackBerry et/ou Androïd

cf Procédure d'installation de Funambol

pour ceux qui ont des clients Iphone

cf Procédure de configuration du CARDDAV pour les Iphones

Côté poste de travail

• Nous avons deux modes d'accès à SOGo :

• via le web : https://sogo.xx.auf.org. Il faut sur chaque poste :

  • ajouter un raccourci firefox vers ce lien
  • ajouter ce lien dans les favoris
  • ajouter ce lien dans le menu AUF de la région

• via thunderbird : pour ce faire il faut installer des extensions dans thunderbird. Mais, avec le script de mise à jour (update.php), il suffit d'installer un seul (le sogo-integrator) qui se chargera de mettre les deux autres (sogo-connector et lightning) :

  • Télécharger sogo-integrator depuis http://sogo.xx.auf.org/plugins

  • aller dans TB et installer cette extension. TB va redémarrer une fois tout seul ; après quoi toutes les 3 extensions sont installées et fonctionnelles.
• par défaut SOGo crée un agenda et un carnet d'adresses personnels pour chaque utilisateur. Renommer cet agenda et ce carnet en prenom.nom (clique droit-propriétés sur l'objet).

• TRES IMPORTANT : faire un inventaire avec l'utilisateur pour savoir s'il a ou non des carnets d'adresses (surtout avec des alias) et/ou agendas locaux déjà existants (avant la mise en place de SOGo).

  • convenir avec l’intéressé de quoi en faire :
    • migrer ces données dans l'agenda/carnet personnel SOGo ?
    • les archiver dans des objets distincts de l'agenda/carnet personnel SOGo (deuxième agenda/carnet) ?
    • les laisser en local (non accessible dans SOGo) ?
    • les virer ?
  • les migrations vers SOGo se font à coups d'export/import via des fichiers .ics pour l'agenda et .ldiff pour le carnet.

NB : la mise à jour des extensions étant centralisée et automatique, il vous faut, vous l'admin, suivre les évolutions, et mettre les nouvelles versions dans le dossier /var/www/plugins du serveur et modifier le script update.php (cf plus haut gestion des extensions SOGo)

• ajouter un lien vers le site des agendas publics : http://agendas.auf.org

Configuration des téléphones intelligents

• IPHONE (réglages "Mail, Contacts, Calendriers", Autres)
  • agenda : ajouter un compte CalDAV
  • carnet d'adresses : ajouter un compte CardDAV (en passant par l'url carddav.sogo.xx.auf.org créer plus haut)

    NB

    • iOS 4.1 et +
      pas de 3.x car non géré

• BLACKBERRY : passer par le client FUNAMBOL pour BB

• ANDROID : passer par le client FUNAMBOL pour Androïd

Vérifications

Remplir le tableau suivant : http://wiki.auf.org/wikiteki/Projet/SOGo/ProcédureDéploiement/ListeDeVérification