Domino 9 on Ubuntu – The most complete how-to I have seen …

… lately.The how-to is from a friend of mine, who runs the whole Domino setup including Traveler on Ubuntu boxes. It’s in french, but since the yellow bubble is made of a bunch of extremely clever girls and boys, that should not be a problem, right?

Christophe Boss, who gets all the credit for that work, is way ahead of me, regarding anything from Linux to Domino administration and he has done the Ubuntu thing for years. It works. No support from IBM, but who needs them anyway.

Here it is:

Installation Lotus Domino 9.0 64 bits (avec composants OpenSocial) et IBM Traveler 9 (optionnel)
sur Ubuntu Server 12.04 64 bits LTS

Matériel nécessaire :

  • CD ou image ISO d’installation Ubuntu Server Edition LTS 12.04.x 64bits
  • Packages nécessaires :

    o roverex-dserver_1.0_i386.deb
    o webmin_1.620_all.deb(ouversionultérieur-optionnel)
    o DOMINO_SERVER_9.0_LINUX_XS_64_EN.tar(ServeurDomino)
    o DOMI_SE_EMEX_AO_9.0_LIN_XS_64_EN_FW.tar(ComposantOpenSocial) o SiserveurIBMTraveler9:NOTES_TRAVELR_9.0_LINUX_XS_ML.tar.gz

  • Autre composant nécessaire : ID du futur serveur Temps nécessaire et connaissances nécessaires :
  • 2-3h de travail nécessaire pour l’installation de l’ensemble des composants. Prévoir du temps supplémentaire pour la configuration du serveur Lotus Domino et du serveur Traveler.
  • Bonne connaissance des environnements Linux recommandée. Maîtrise de la ligne de commande indispensable, Ubuntu Server ne disposant pas d’interface graphique.
  • Connaissances en configuration des serveurs, IBM Domino et IBM Traveler requises.

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3 Page 1

INFORMATION CONCERNANT UBUNTU SERVER 2012

Depuis 2010, les Unix propriétaires et les distributions Linux migrent vers le système de démarrage UpStart en remplacement du Sysinit (Système V). Ce changement important ne permettra plus à l’avenir d’utiliser Sysinit pour l’arrêt, le démarrage ou le redémarrage des services via la commande /etc/init.d.

Depuis Ubuntu 10.04, les services systèmes et une grande partie des services serveurs ont été migré vers UpStart, mais cette distribution reste compatible avec Sysinit.

Par exemple, l’arrêt et le démarrage de Samba doivent utiliser UpStart par les commandes suivantes :

sudo stop smbd
sudo start smbd
sudo restart smbd

Pour l’instant, UpStart n’est pas compatible avec la commande „reload“.

LSBInitScripts

Avec les modifications apportées par UpStart, les scripts utilisant encore Sysinit doivent désormais utiliser une description LSBInitScripts. Voici un exemple :

### BEGIN INIT INFO
# Provides: scriptname #Required-Start:$remote_fs $syslog

# Required-Stop:
# Default-Start:
# Default-Stop:
# Short-Description:
# Description:
### END INIT INFO
$remote_fs  $syslog
2 3 4 5
0 1 6
Start daemon at boot time
Enable service provided by daemon

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 2

Etape 1 : Installation Ubuntu Server Edition LTS 12.04.x

  1. 1)  Insérer le CD d’installation d’Ubuntu server 12.04.x dans le serveur et démarrer le serveur (vérifier que le CD est le premier périphérique de démarrage du BIOS) ou monter l’image ISO dans votre VM.
  2. 2)  Le menu du CD doit apparaître. Choisir la langue d’installation (anglais recommandé) ainsi que la disposition du clavier (Swiss French) via la touche F3. Puis sélectionner « Install Ubuntu Server »
  3. 3)  Démarrage de la procédure d’installation. Choisir la langue du serveur (anglais recommandé). Choisir le pays. Pour la Suisse, choisir l’option « other », puis « Europe » et enfin
    « Switzerland».
  4. 4)  Choisir le nom du serveur. Attention : Nom court ! (pas FQDN).
  5. 5)  Choix du fuseau horaire. Le système propose automatiquement Europe/Zurich. Accepter.
  6. 6)  Partitionnement du disque dur. Veuillez préférer la méthode manuelle.
  7. 7)  Créer 4 partitions (il est possible d’utiliser LVM si besoin) :
    1. 1x partition racine (/) de minimum 25Go en EXT4 et primaire
    2. 1x partition home (/home) de minimum 10Go en EXT4 et primaire
    3. 1x partition SRV (/srv) d’une taille proportionnée aux donnée du futur serveur Lotus Domino (Notesdata). EXT4 et primaire.
    4. 1x partition SWAP de 1,5 fois et 2 fois la RAM à disposition. Partition logique.

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3 Page 3

Nous procéderons à la configuration IP après l’installation.

  1. 8)  Démarrage du formatage et de l’installation de base du serveur Ubuntu.
  2. 9)  Configuration de l’utilisateur de base et du mot de passe :
    1. Utilisateur : notes
    2. Mot de passe : A votre convenance
  3. 10)  Configuration du proxy (Si aucun proxy, laisser vide)
  4. 11)  Configuration des mises à jour du système. Choisir « Install security updates automatically »
  5. 12)  Choix des applications serveur. Si besoin, cochez « SAMBA Server » et « OpenSSH Server »

a. OpenSSH est vivement recommandé pour simplifier l’administration du serveur.

  1. 13)  Suite de l’installation.
  2. 14)  Choix de l’endroit pour l’installation du secteur de démarrage. Répondre « Yes ».
  3. 15)  Installation terminée. Retirer le CD et redémarrer (Reconfigurer le BIOS pour démarrer sur le disque dur en premier).

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3 Page 4

Etape 2 : Configuration du serveur

Ouvrir une session avec l’utilisateur « notes ».

  1. 1)  Configuration du réseau
    1. Editer le fichier des interfaces (sudo vim /etc/network/interfaces)
    2. Modifier le fichier comme suite :
                # This file describes the network interfaces available on your system
                # and how to activate them. For more information, see interfaces(5).
                # The loopback network interface
                auto lo
                iface lo inet loopback

      # The primary network interface auto eth0
      iface eth0 inet static

                        address [adresse IP du serveur]
                        netmask [Masque de sous-réseau]
                        network [adresse du réseau : Exemple 192.168.1.0]
                        broadcast [adresse de broadcast : Exemple 192.168.1.255]
                        gateway [passerelle par défaut]
                        dns-nameservers [adresse IP du serveur DNS]
                        dns-search [domaine dns : Exemple : toto.ch]
  2. 2)  redémarrer l’interface réseau : sudo /etc/init.d/networking restart
  3. 3)  Appliquer les dernières mises à jour
    1. Récupération des listes sur les dépôts publiques et appliquer les mises à jour
              sudo apt-get update && sudo apt-get upgrade
    2. Répondre Y
    3. Mise à jour du noyau Linux (kernel)
              sudo apt-get dist-upgrade
    4. Répondre Y
    5. Redémarrer le serveur

      sudo reboot

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 5

Etape 3 : Configuration de SAMBA (optionnel)

1)

Editer le fichier de configuration de SAMBA (sudo vim /etc/samba/smb.comf)

  1. Configurer les éléments suivants :

    workgroup = [Votre domaine / groupe de travail]
    server string = [DESCRIPTION NETBIOS DU SERVEUR]
    security = user (décommenter si nécessaire)
    usershare allow guest = no
    Les sections [profiles] et [cdrom] doivent être mises en commentaires. Remplacer « yes » par « no » pour les options des sections [printers] et [print$].

  2. Il est souvent pratique de pouvoir accéder aux fichiers data du serveur Domino via Windows. Dans ce cas, ajouter le partage [notesdata]. Si vous voulez disposer également d’un endroit de stockage pour les binaires par exemple, utilisez le partage [Software].

    Ajouter les lignes suivantes en fin de fichier :

    #—— DOMINO SAMBA GENERAL CONFIGURATION FOR CBSA —–

       [notesdata]
            comment = Lotus Domino data
            read only = no
            browseable = yes
            guest ok = no
            path = /srv/notesdata
       [Software]
            comment = Software repository
            read only = no
            browseable = yes
            guest ok = no
            path = /home/software
  3. Sauvegarder et quitter.
  4. Redémarrer SAMBA : sudo service smbd restart

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 6

Etape 4 : Création des répertoires et définition des droits

  1. Créer le répertoire /srv/notesdata
            sudo mkdir /srv/notesdata
  2. Créer le répertoire /home/software (optionnel –> voir configuration SAMBA) sudo mkdir /home/software
  3. Changer le propriétaire du dossier « notesdata »
            sudo chown –R notes:notes /srv/notesdata
  4. Changer le propriétaire du dossier « software » (optionnel –> voir configuration SAMBA)
            sudo chown –R notes:notes /home/software
  5. Vérifier que les droits Unix sur le dossier /srv/notesdata sont 755
            sudo chmod –R 755 /srv/notesdata

4) Redémarrer le serveur et tester SAMBA et OpenSSH.

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 7

Etape 3 : Installation de Webmin (optionnel)

  1. 1)  Installation des librairies nécessaire au fonctionnement de Webmin 1.6 depuis les dépôts

    sudo apt-get install apt-get install perl libnet-ssleay-perl openssl libauthen-pam-perl libpam-runtime libio-pty-perl apt-show-versions python

  2. 2)  Installer Webmin
    1. Télécharger la dernière version de Webmin

      cd /home/software
      wget http://www.webmin.com/download/deb/webmin-current.deb

    2. Installer la dernière version

      sudo dpkg –i webmin-current.deb

    3. Redémarrer le serveur
    4. Vérifier le fonctionnement de Webmin depuis un PC en tapant l’adresse :

      https://IP_DU_SERVEUR:10000

    5. Utiliser l’utilisateur et le mot de passe « notes » pour ouvrir Webmin
    6. Effectuer les mises à jour proposées si besoin (noyau), puis redémarrer le

      serveur.

    7. Dans une console, taper les commandes suivantes

      sudo apt-get autoremove sudo apt-get autoclean sudo apt-get clean

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 8

Etape 4 : Installation du serveur Lotus Domino 9.0

1) Modification des limites de fichiers :

  1. Editer le fichier /etc/security/limits.conf

    sudo vim /etc/security/limits.conf

  2. En fin de fichier, ajouter les lignes suivants :

root soft nofile Root hard nofile Notes soft nofile Notes hard nofile

20000
65535
20000
65535

c. Editer le fichier /etc/pam.d/common-session

sudo vim /etc/pam.d/common-session

  1. Ajouter la ligne suivante en fin de fichier :

    session required pam_limits.so

  2. Redémarrer le serveur
  1. 2)  Installation de Roverex DServer (Prise en charge complète d’Ubuntu Serveur pour Lotus Domino).
    1. Transférer le paquet « roverex-dserver_1.0_i386.deb » sur le serveur.
    2. Installer le paquet (sudo dpkg –i roverex-dserver_1.0_i386.deb)
    3. Taper le mot de passe de l’utilisateur « notes » 2x
    4. Vérifier que Roverex a créé le fichier « .domino.pwd » dans le répertoire

      /srv/notesdata avec les droits Unix 400

      ll /srv/notesdata

    5. Effectuer un test du serveur Ubuntu : roverex-dserver-test
    6. Si tous les tests sont passés (Passed), continuer
  2. 3)  Configuration de la session Root (l’utilisation de „sudo“ pose problème à l’installeur IBM !)
    1. En ligne de commande avec l’utilisateur « notes », tapez :

      sudo passwd root

    2. Entrer un mot de passe pour root 2x (différent de « notes » et compliqué)
  3. 4)  Décompression de l’archive Lotus Domino 9
    1. Transférer l’archive TAR « DOMINO_SERVER_9.0_LINUX_XS_64_EN.tar » sur le

      serveur.

    2. Décompresser l’archive Lotus Domino à l’aide de la commande suivante :

      tar xvf DOMINO_SERVER_9.0_LINUX_XS_64_EN.tar

    3. Un dossier ./linux64/domino est créé.
    4. Fermer la session « notes » et ouvrir une session avec l’utilisateur « root »
    5. Se placer dans le répertoire linux64/domino

      cd linux64/domino

    6. Lancer l’installation à l’aide de la commande ./install
    7. L’installeur démarre. Lorsqu’il demande s’ il doit continuer en mode console,

      répondre Yes.

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 9

5) Installation du serveur Lotus Domino 9
a. Suivre les instructions à l’écran et répondre aux questions en fonction des besoins

nécessaires pour le futur serveur Domino.
Configuration proposée :
– Laisser /opt pour les binaires IBM Domino
– Modifier le chemin des données du serveur en /srv/notesdata (par défaut : /local/notesdata)
L’utilisation de /opt et /srv pour les données domino respecte le standard FSH. – Choisir le mode « manual » pour le paramétrage de Domino

  1. 6)  Décompression des composants OpenSocial pour IBM Domino 9
    1. Supprimer le dossier d’installation de IBM Domino 9 : rm -Rf linux64
    2. Transférer l’archive TAR « DOMI_SE_EMEX_AO_9.0_LIN_XS_64_EN_FW.tar» sur le

      serveur.

    3. Décompresser l’archive Lotus Domino à l’aide de la commande suivante :

      tar xvf DOMI_SE_EMEX_AO_9.0_LIN_XS_64_EN_FW.tar

    4. Un dossier ./linux64 est créé.
    5. Fermer la session « notes » et ouvrir une session avec l’utilisateur « root »
    6. Se placer dans le répertoire linux64 : cd linux64
    7. Ajouter le droit d’exécution sur le fichier « install » : chmod +x install
    8. Lancer l’installation à l’aide la commande ./install
    9. L’installeur démarre. Lorsqu’il demande si on doit continuer en mode console,

      répondre Yes et suivre les instructions à l’écran.

    10. Supprimer le dossier d’installation de IBM Traveler 9 : rm -Rf linux64
  2. 7)  Lorsque l’installation est terminée, il est nécessaire de configurer le script de démarrage de Lotus Domino.
    1. Editer le fichier /etc/init.d/domino
              sudo vim /etc/init.d/domino
    2. Modifier les premières lignes du fichier comme ceci :
#!/bin/sh
### BEGIN INIT INFO
# Provides:
# Required-Start:
# Required-Stop:
# Default-Start:
# Default-Stop:
# Short-Description:
# Description:
### END INIT INFO

domino
$remote_fs $syslog
$remote_fs $syslog
2345
016
Start domino at boot time
Enable Lotus Domino server by daemon

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3 Page 10

c. Modifier la ligne output=“/dev/tty12″ en output=“/dev/tty6″

  1. Mettre en commentaire la ligne LANG=“es_ES@euro“
  2. Décommenter si besoin la ligne #LANG=“fr_FR@euro“
  3. Modifier la ligne 62 comme ceci :

    if [ -d „/opt/ibm/domino/bin“ ]; then

  4. Modifier la ligne 63 comme ceci :

    bin_dir=“/opt/ibm/domino/bin“ # For Domino 6.5.x or older

  5. Enregistrer et fermer
  6. Démarrer le serveur pour la première configuration (via l’outil « Configuration du serveur à distance » depuis un PC Windows)
    cd /srv/notesdata
    /opt/ibm/lotus/bin/server -listen
  7. Une fois la configuration terminée, redémarrer le serveur

    sudo reboot

Installation Lotus Domino 9 sur Ubuntu Server Edition LTS 12.04 – Version 1.3

Page 11

Etape 5 : Installation d’ IBM Traveler 9 (optionnel)

1) Décompression d’ IBM Traveler 9

  1. a)  Transférer l’archive TAR « NOTES_TRAVELR_9.0_LINUX_XS_ML.tar.gz » sur le serveur.
  2. b)  Décompresser l’archive Lotus Domino à l’aide de la commande suivante :

    tar xvf NOTES_TRAVELR_9.0_LINUX_XS_ML.tar.gz

  3. c)  L’installation d’ IBM Traveler 9 nécessite normalement une interface graphique. Dès lors, pour l’installation sur Ubuntu Server, il est nécessaire d’utiliser le mode d’installation silencieux.
  4. d)  Editez le fichier « installer.properties » extrait à l’étape b :

    sudo vim installer.properties

  5. e)  Modifier les paramètres suivants :
    1. i)  ACCEPT_LICENSE=true
    2. ii)  DOMINO_PROGRAM_DIRECTORY=/opt/ibm/domino/notes/latest/linux
    3. iii)  DOMINO_DATA_DIRECTORY_1=/srv/notesdata
    4. iv)  DOMINO_NOTESINI_DIRECTORY_1=/srv/notesdata
    5. v)  LINUX_USER_NAME=notes (décommenter la ligne)
    6. vi)  LINUX_GROUP_NAME=notes (décommenter la ligne)
    7. vii)  NTS_WEBSITE_HOME=1(définiTravelercommeserveurWebpardéfaut)->Recommandé
    8. viii)  NTS_SET_EXTERNAL_URL=https://VOTRE_SERVEUR/traveler
  6. f)  L’installeur d’ IBM Traveler nécessite les librairies 32 bits pour pouvoir démarrer. Il est donc nécessaire de les installer :
    sudo apt-get install ia32-libs
  7. g)  Répondre Y pour terminer l’installation des librairies 32 bits.
  8. h)  Se connecter avec l’utilisateur « root »
  9. i)  Arrêter le serveur IBM Domino 9 : /etc/init.d/domino stop
  10. j)  Dans le répertoire de décompression de l’archive IBM Traveler 9, lancer la commande

    suivante pour lancer l’installation silencieuse :

    ./TravelerSetup -f installer.properties -i silent -l en

  11. k)  Suivre le processus à l’écran jusqu’à la confirmation du succès de l’installation.
  12. l)  Suite à l’installation d’ IBM Traveler, certains fichiers n’ont pas le bon propriétaire. Il faut

    réinitialiser les droits :

    sudo chown –R notes:notes /srv/notesdata

    sudo chmod –R 755 /srv/notesdata

  13. m)  Redémarrer le serveur IBM Domino et configurer IBM Traveler selon votre convenance et en fonction de la documentation IBM