Dies ist eine alte Version des Dokuments!


HowTo / Migration von Zarafa 7.0.x auf Ubuntu 10.04 LTS -> Zarafa 7.1.x auf Ubuntu 12.04 LTS

Dieses HowTo erklärt in einzelnen Schritten die Migration von Zarafa 7.0.x auf einen neuen Host mit Ubuntu 12.04 LTS und Zarafa 7.1.x.
Ein installiertes Grundsystem mit SSH oder Konsolenzugang wird vorausgesetzt.

Vorbereitungen

Bevor Zarafa installiert werden kann müssen noch ein Datenbanksystem (MySQL), ein Webserver (Apache) und PHP installiert werden.

MySQL

sudo aptitude install mysql-server

Apache inkl. PHP

sudo aptitude install apache2-mpm-prefork libapache2-mod-php5

Weitere Software

Zarafa benötigt noch weitere Bibliotheken und Tools

sudo aptitude install catdoc gawk libboost-filesystem1.46.1 libboost-system1.46.1 libcurl3 libicu48 mktemp php-gettext poppler-utils python-mysqldb python-support ttf-dejavu-core unzip w3m wget xsltproc


Installation und Konfiguration von Zarafa 7.0.x

Installation

Die aktuelle Final Version von Zarafa 7.1.x kann hier: http://download.zarafa.com/community/final/7.1/ heruntergeladen werden.
Der richtige Download für ein 32bit Ubuntu System ist zcp-7.1.x-xxxxx-ubuntu-10.04-i386-free.tar.gz

Wechsel ins Temp-Verzeichnis.

cd /tmp

Installationspaket runterladen.

wget http://download.zarafa.com/community/final/7.1/7.1.x-xxxxx/zcp-7.1.x-xxxxx-ubuntu-12.04-i386-free.tar.gz

Am einfachsten ist es die Linkadresse zu kopieren…


…und mit einem klick auf die rechte Maustaste in Putty einzufügen.


Archiv entpacken:

tar xfz zcp-7.1.x-xxxxx-ubuntu-12.04-i386-free.tar.gz

In das Verzeichnis des entpackten Archivs wechseln:

cd zcp-7.1.x-xxxxx-ubuntu-12.04-i386

Installation von Zarafa starten:

sudo ./install.sh

Nun sollte diese Meldung erscheinen:

Mit ENTER bestätigen.

Eingabe der Seriennummer (wenn vorhanden):


MySQL-Server Daten eingeben:

Bis auf das Passwort können alle Felder leer gelassen werden.

SMTP-Konfiguration:

Hier können alle Felder leer gelassen werden.

Problem: Zarafa-Server startet vor MySQL
Unter Ubuntu 12.04 startet MySQL beim Booten ab und an zu langsam. Damit Zarafa-Server erst nach MySQL startet muss das Startscript angepasst werden. Durch die Anpassung wird vor dem Start von Zarafa-Server überprüft ob MySQL läuft. Ist MySQL noch nicht gestartet wird kurz pausiert und erneut geprüft.

Startscript anpassen:

sudo vim /etc/init.d/zarafa-server

Folgender Code muss vor Zeile 54 eingefügt werden:

while [ "`/sbin/initctl list | grep -c 'mysql start/running'`" != '1' ]; do
sleep 1
done

vorher:

export LC_ALL=$ZARAFA_LOCALE
export LANG=$ZARAFA_LOCALE
start-stop-daemon --start $QUIETDAEMON --pidfile $PIDFILE --exec $SERVER -- $SERVER_OPTS
log_end_msg $?
unset LC_ALL LANG

nachher:

export LC_ALL=$ZARAFA_LOCALE
export LANG=$ZARAFA_LOCALE
while [ "`/sbin/initctl list | grep -c 'mysql start/running'`" != '1' ]; do
sleep 1
done
start-stop-daemon --start $QUIETDAEMON --pidfile $PIDFILE --exec $SERVER -- $SERVER_OPTS
log_end_msg $?
unset LC_ALL LANG


Zarafa „eindeutschen“

Damit später der Login-Screen und die Ordner im Postfach in deutscher Sprache erscheinen müssen einige Dateien angepasst werden.

Bearbeiten der Datei config.php in /etc/zarafa/webaccess-ajax/

sudo vim /etc/zarafa/webaccess-ajax/config.php


Zeile 177 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)
vorher:

define('LANG', 'en_EN'); // default fallback language

nachher:

define('LANG', 'de_DE.UTF-8'); // default fallback language




Bearbeiten der Datei config.php in /etc/zarafa/webapp/

sudo vim /etc/zarafa/webapp/config.php


Zeile 124 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)
vorher:

define('LANG', 'en_EN'); // default fallback language

nachher:

define('LANG', 'de_DE.UTF-8'); // default fallback language




Anpassen der Datei 00createstore /etc/zarafa/userscripts/createuser.d/

sudo vim /etc/zarafa/userscripts/createuser.d/00createstore


Zeile 11 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)
vorher:

zarafa-admin --utf8 --create-store "${ZARAFA_USER}" --lang "${ZARAFA_LANG}"

nachher:

zarafa-admin --utf8 --create-store "${ZARAFA_USER}" --lang "de_DE.UTF-8"




Anpassen der Datei zarafa in /etc/default/

sudo vim /etc/default/zarafa


Zeile 6 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)
vorher:

ZARAFA_LOCALE="C"

nachher:

ZARAFA_LOCALE="de_DE.UTF-8"


Zeile 38 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)
vorher:

ZARAFA_USERSCRIPT_LOCALE="C"

nachher:

ZARAFA_USERSCRIPT_LOCALE="de_DE.UTF-8"




Zarafa neu starten:

sudo /etc/init.d/zarafa-server restart

Apache neu starten:

sudo /etc/init.d/apache2 restart


Installation und Konfiguration von Postfix

Installation

Postfix installieren:

sudo apt-get install postfix


Die Erklärung mit OK bestätigen:


Internet-Site auswählen:


Domain-Namen eintragen:

Konfiguration

Die Konfiguration von /etc/postfic/main.cf, /etc/postfix/virtual und /etc/aliases aus der Konfiguration des alten Servers übernehmen bzw. anpassen.

sudo postmap /etc/postfiv/virtual
sudo service postfix restart



Migration

Daten auf altem Server sichern

Dienste stoppen

sudo /etc/init.d/postfix stop
sudo /etc/init.d/zarafa-spooler stop
sudo /etc/init.d/zarafa-server stop
sudo /etc/init.d/zarafa-licensed stop
sudo /etc/init.d/zarafa-dagent stop
sudo /etc/init.d/zarafa-gateway stop
sudo /etc/init.d/zarafa-ical stop
sudo /etc/init.d/zarafa-indexer stop
sudo /etc/init.d/zarafa-search stop
sudo /etc/init.d/zarafa-monitor stop

MySQL Datenbank sichern

mysqldump --single-transaction -p zarafa > /tmp/zarafa.sql

Stores (E-Mail Anhänge usw) sichern

cd /var/lib
tar cfvz /tmp/zarafa_store.tar.gz zarafa/

Daten per scp auf den neuen Server kopieren

scp benutzer@hostalt:/tmp/zarafa.sql /tmp/
scp benutzer@hostalt:/tmp/zarafa_store.tar.gz /tmp/

Rücksicherung

cd /tmp/ 
tar xfz zarafa_store.tar.gz
cd zarafa
sudo mkdir attachments
sudo mv 0/ 1/ 2/ 3/ 4/ 5/ 6/ 7/ 8/ 9/ attachments/
sudo cp -r /tmp/zarafa /var/lib/