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

Matériel nécessaire :

CD ou image ISO d’installation Ubuntu Server Edition LTS 12.04.x 64bits
Packages nécessaires :
o roverex-dserver_1.0_i386.deb
o webmin_1.620_all.deb(ouversionulté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 nécessaire : ID du futur serveur Temps nécessaire et connaissances nécessaires :

2-3h de travail nécessaire pour l’installation de l’ensemble des composants. Prévoir du temps supplémentaire pour la configuration du serveur Lotus Domino et du serveur Traveler.
Bonne connaissance des environnements Linux recommandée. Maî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 propriétaires et les distributions Linux migrent vers le système de démarrage UpStart en remplacement du Sysinit (Système V). Ce changement important ne permettra plus à l’avenir d’utiliser Sysinit pour l’arrêt, le démarrage ou le redémarrage des services via la commande /etc/init.d.

Depuis Ubuntu 10.04, les services systèmes et une grande partie des services serveurs ont été migré vers UpStart, mais cette distribution reste compatible avec Sysinit.

Par exemple, l’arrêt et le dé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 apportées par UpStart, les scripts utilisant encore Sysinit doivent dé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) Insérer le CD d’installation d’Ubuntu server 12.04.x dans le serveur et démarrer le serveur (vérifier que le CD est le premier périphérique de démarrage du BIOS) ou monter l’image ISO dans votre VM.
2) Le menu du CD doit apparaître. Choisir la langue d’installation (anglais recommandé) ainsi que la disposition du clavier (Swiss French) via la touche F3. Puis sélectionner « Install Ubuntu Server »
3) Démarrage de la procédure d’installation. Choisir la langue du serveur (anglais recommandé). Choisir le pays. Pour la Suisse, choisir l’option « other », puis « Europe » et enfin
« Switzerland».
4) Choisir le nom du serveur. Attention : Nom court ! (pas FQDN).
5) Choix du fuseau horaire. Le système propose automatiquement Europe/Zurich. Accepter.
6) Partitionnement du disque dur. Veuillez préférer la méthode manuelle.
7) Cré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 proportionnée aux donnée du futur serveur Lotus Domino (Notesdata). EXT4 et primaire.
4. 1x partition SWAP de 1,5 fois et 2 fois la RAM à disposition. Partition logique.

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

Nous procéderons à la configuration IP après l’installation.

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

a. OpenSSH est vivement recommandé pour simplifier l’administration du serveur.

13) Suite de l’installation.
14) Choix de l’endroit pour l’installation du secteur de démarrage. Répondre « Yes ».
15) Installation terminée. Retirer le CD et redémarrer (Reconfigurer le BIOS pour dé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) Configuration du réseau

Editer le fichier des interfaces (sudo vim /etc/network/interfaces)

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-réseau]
                  network [adresse du réseau : Exemple 192.168.1.0]
                  broadcast [adresse de broadcast : Exemple 192.168.1.255]
                  gateway [passerelle par défaut]
                  dns-nameservers [adresse IP du serveur DNS]
                  dns-search [domaine dns : Exemple : toto.ch]

2) redémarrer l’interface réseau : sudo /etc/init.d/networking restart
3) Appliquer les dernières mises à jour
1. Récupération des listes sur les dépôts publiques et appliquer les mises à jour
```
        sudo apt-get update && sudo apt-get upgrade
```
2. Répondre Y
3. Mise à jour du noyau Linux (kernel)
```
        sudo apt-get dist-upgrade
```
4. Répondre Y
5. Redé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)

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

Configurer les éléments suivants :
workgroup = [Votre domaine / groupe de travail]
server string = [DESCRIPTION NETBIOS DU SERVEUR]
security = user (décommenter si nécessaire)
usershare allow guest = no
Les sections [profiles] et [cdrom] doivent être mises en commentaires. Remplacer « yes » par « no » pour les options des sections [printers] et [print$].
Il est souvent pratique de pouvoir accéder aux fichiers data du serveur Domino via Windows. Dans ce cas, ajouter le partage [notesdata]. Si vous voulez disposer é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
```
Sauvegarder et quitter.
Redémarrer SAMBA : sudo service smbd restart

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

Page 6

Etape 4 : Création des répertoires et définition des droits

Créer le répertoire /srv/notesdata
```
        sudo mkdir /srv/notesdata
```
Créer le répertoire /home/software (optionnel –> voir configuration SAMBA) sudo mkdir /home/software

Changer le propriétaire du dossier « notesdata »

        sudo chown –R notes:notes /srv/notesdata

Changer le propriétaire du dossier « software » (optionnel –> voir configuration SAMBA)
```
        sudo chown –R notes:notes /home/software
```
Vérifier que les droits Unix sur le dossier /srv/notesdata sont 755
```
        sudo chmod –R 755 /srv/notesdata
```

4) Redé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) Installation des librairies nécessaire au fonctionnement de Webmin 1.6 depuis les dépô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) Installer Webmin
1. Télécharger la dernière version de Webmin
  cd /home/software
  wget http://www.webmin.com/download/deb/webmin-current.deb
2. Installer la dernière version
  sudo dpkg –i webmin-current.deb
3. Redémarrer le serveur
4. Vé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 à jour proposées si besoin (noyau), puis redé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 :

Editer le fichier /etc/security/limits.conf
sudo vim /etc/security/limits.conf
En fin de fichier, ajouter les lignes suivants :

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

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

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

Ajouter la ligne suivante en fin de fichier :
session required pam_limits.so
Redémarrer le serveur

2) Installation de Roverex DServer (Prise en charge complète d’Ubuntu Serveur pour Lotus Domino).
1. Transfé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. Vérifier que Roverex a créé le fichier « .domino.pwd » dans le ré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 passés (Passed), continuer
3) Configuration de la session Root (l’utilisation de „sudo“ pose problème à 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 (différent de « notes » et compliqué)
4) Décompression de l’archive Lotus Domino 9
1. Transférer l’archive TAR « DOMINO_SERVER_9.0_LINUX_XS_64_EN.tar » sur le
  serveur.
2. Décompresser l’archive Lotus Domino à l’aide de la commande suivante :
  tar xvf DOMINO_SERVER_9.0_LINUX_XS_64_EN.tar
3. Un dossier ./linux64/domino est créé.
4. Fermer la session « notes » et ouvrir une session avec l’utilisateur « root »
5. Se placer dans le répertoire linux64/domino
  cd linux64/domino
6. Lancer l’installation à l’aide de la commande ./install
7. L’installeur démarre. Lorsqu’il demande s’ il doit continuer en mode console,
  ré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 à l’écran et répondre aux questions en fonction des besoins

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

6) Décompression des composants OpenSocial pour IBM Domino 9
1. Supprimer le dossier d’installation de IBM Domino 9 : rm -Rf linux64
2. Transférer l’archive TAR « DOMI_SE_EMEX_AO_9.0_LIN_XS_64_EN_FW.tar» sur le
  serveur.
3. Décompresser l’archive Lotus Domino à 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 créé.
5. Fermer la session « notes » et ouvrir une session avec l’utilisateur « root »
6. Se placer dans le répertoire linux64 : cd linux64
7. Ajouter le droit d’exécution sur le fichier « install » : chmod +x install
8. Lancer l’installation à l’aide la commande ./install
9. L’installeur démarre. Lorsqu’il demande si on doit continuer en mode console,
  répondre Yes et suivre les instructions à l’écran.
10. Supprimer le dossier d’installation de IBM Traveler 9 : rm -Rf linux64
7) Lorsque l’installation est terminée, il est nécessaire de configurer le script de démarrage de Lotus Domino.
1. Editer le fichier /etc/init.d/domino
```
        sudo vim /etc/init.d/domino
```
2. Modifier les premiè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″

Mettre en commentaire la ligne LANG=“es_ES@euro“
Décommenter si besoin la ligne #LANG=“fr_FR@euro“
Modifier la ligne 62 comme ceci :
if [ -d „/opt/ibm/domino/bin“ ]; then
Modifier la ligne 63 comme ceci :
bin_dir=“/opt/ibm/domino/bin“ # For Domino 6.5.x or older
Enregistrer et fermer
Démarrer le serveur pour la première configuration (via l’outil « Configuration du serveur à distance » depuis un PC Windows)
cd /srv/notesdata
/opt/ibm/lotus/bin/server -listen
Une fois la configuration terminée, redé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) Décompression d’ IBM Traveler 9

a) Transférer l’archive TAR « NOTES_TRAVELR_9.0_LINUX_XS_ML.tar.gz » sur le serveur.
b) Décompresser l’archive Lotus Domino à l’aide de la commande suivante :
tar xvf NOTES_TRAVELR_9.0_LINUX_XS_ML.tar.gz
c) L’installation d’ IBM Traveler 9 nécessite normalement une interface graphique. Dès lors, pour l’installation sur Ubuntu Server, il est nécessaire d’utiliser le mode d’installation silencieux.
d) Editez le fichier « installer.properties » extrait à l’étape b :
sudo vim installer.properties
e) Modifier les paramè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 (décommenter la ligne)
6. vi) LINUX_GROUP_NAME=notes (décommenter la ligne)
7. vii) NTS_WEBSITE_HOME=1(définiTravelercommeserveurWebpardéfaut)->Recommandé
8. viii) NTS_SET_EXTERNAL_URL=https://VOTRE_SERVEUR/traveler
f) L’installeur d’ IBM Traveler nécessite les librairies 32 bits pour pouvoir démarrer. Il est donc nécessaire de les installer :
sudo apt-get install ia32-libs
g) Répondre Y pour terminer l’installation des librairies 32 bits.
h) Se connecter avec l’utilisateur « root »
i) Arrêter le serveur IBM Domino 9 : /etc/init.d/domino stop
j) Dans le répertoire de décompression de l’archive IBM Traveler 9, lancer la commande
suivante pour lancer l’installation silencieuse :

./TravelerSetup -f installer.properties -i silent -l en
k) Suivre le processus à l’écran jusqu’à la confirmation du succès de l’installation.
l) Suite à l’installation d’ IBM Traveler, certains fichiers n’ont pas le bon propriétaire. Il faut
réinitialiser les droits :

sudo chown –R notes:notes /srv/notesdata

sudo chmod –R 755 /srv/notesdata
m) Redémarrer le serveur IBM Domino et configurer IBM Traveler selon votre convenance et en fonction de la documentation IBM