Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
howto:zarafa:migration [2014/05/25 08:02] h.roddewig |
— (aktuell) | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== 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 === | ||
- | <code>sudo aptitude install mysql-server</code> | ||
- | |||
- | === Apache inkl. PHP === | ||
- | <code>sudo aptitude install apache2-mpm-prefork libapache2-mod-php5</code> | ||
- | |||
- | === Weitere Software === | ||
- | Zarafa benötigt noch weitere Bibliotheken und Tools | ||
- | <code>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</code> | ||
- | \\ | ||
- | ===== Installation und Konfiguration von Zarafa 7.1.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. | ||
- | <code>cd /tmp</code> | ||
- | |||
- | Installationspaket runterladen. | ||
- | <code>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</code> | ||
- | |||
- | Am einfachsten ist es die Linkadresse zu kopieren...\\ | ||
- | {{::download.jpg?nolink|}}\\ \\ | ||
- | ...und mit einem klick auf die rechte Maustaste in Putty einzufügen.\\ | ||
- | {{:link.jpg?nolink|}}\\ \\ | ||
- | |||
- | Archiv entpacken:\\ | ||
- | <code>tar xfz zcp-7.1.x-xxxxx-ubuntu-12.04-i386-free.tar.gz</code> | ||
- | |||
- | In das Verzeichnis des entpackten Archivs wechseln: | ||
- | <code>cd zcp-7.1.x-xxxxx-ubuntu-12.04-i386</code> | ||
- | |||
- | Installation von Zarafa starten: | ||
- | <code>sudo ./install.sh</code> | ||
- | |||
- | Nun sollte diese Meldung erscheinen:\\ | ||
- | {{::installation.jpg?nolink|}}\\ | ||
- | Mit ENTER bestätigen.\\ \\ | ||
- | |||
- | Eingabe der Seriennummer (wenn vorhanden):\\ | ||
- | {{:serial.jpg?nolink|}}\\ \\ | ||
- | |||
- | MySQL-Server Daten eingeben:\\ | ||
- | {{::sql_config.jpg?nolink|}}\\ | ||
- | Bis auf das Passwort können alle Felder leer gelassen werden.\\ \\ | ||
- | |||
- | SMTP-Konfiguration:\\ | ||
- | {{::smtp_config.jpg?nolink|}}\\ | ||
- | 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:\\ | ||
- | <code>sudo vim /etc/init.d/zarafa-server</code> | ||
- | |||
- | Folgender Code muss vor Zeile 54 eingefügt werden: | ||
- | <code>while [ "`/sbin/initctl list | grep -c 'mysql start/running'`" != '1' ]; do | ||
- | sleep 1 | ||
- | done</code> | ||
- | |||
- | vorher: | ||
- | <code>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</code> | ||
- | |||
- | nachher: | ||
- | <code>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</code> | ||
- | \\ | ||
- | ==== 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/ | ||
- | <code>sudo vim /etc/zarafa/webaccess-ajax/config.php</code>\\ | ||
- | Zeile 177 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)\\ | ||
- | vorher: | ||
- | <code>define('LANG', 'en_EN'); // default fallback language</code> | ||
- | nachher: | ||
- | <code>define('LANG', 'de_DE.UTF-8'); // default fallback language</code> | ||
- | \\ | ||
- | ---- | ||
- | \\ | ||
- | Bearbeiten der Datei config.php in /etc/zarafa/webapp/ | ||
- | <code>sudo vim /etc/zarafa/webapp/config.php</code>\\ | ||
- | Zeile 124 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)\\ | ||
- | vorher: | ||
- | <code>define('LANG', 'en_EN'); // default fallback language</code> | ||
- | nachher: | ||
- | <code>define('LANG', 'de_DE.UTF-8'); // default fallback language</code> | ||
- | \\ | ||
- | ---- | ||
- | \\ | ||
- | Anpassen der Datei 00createstore /etc/zarafa/userscripts/createuser.d/ | ||
- | <code>sudo vim /etc/zarafa/userscripts/createuser.d/00createstore</code>\\ | ||
- | Zeile 11 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)\\ | ||
- | vorher:\\ | ||
- | <code>zarafa-admin --utf8 --create-store "${ZARAFA_USER}" --lang "${ZARAFA_LANG}"</code> | ||
- | nachher:\\ | ||
- | <code>zarafa-admin --utf8 --create-store "${ZARAFA_USER}" --lang "de_DE.UTF-8"</code> | ||
- | \\ | ||
- | ---- | ||
- | \\ | ||
- | Anpassen der Datei zarafa in /etc/default/ | ||
- | <code>sudo vim /etc/default/zarafa</code>\\ | ||
- | Zeile 6 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)\\ | ||
- | vorher:\\ | ||
- | <code>ZARAFA_LOCALE="C"</code> | ||
- | nachher:\\ | ||
- | <code>ZARAFA_LOCALE="de_DE.UTF-8"</code>\\ | ||
- | |||
- | Zeile 38 anpassen (ja nach Version kann die Zeile etwas höher oder tiefer sein)\\ | ||
- | vorher:\\ | ||
- | <code>ZARAFA_USERSCRIPT_LOCALE="C"</code> | ||
- | nachher:\\ | ||
- | <code>ZARAFA_USERSCRIPT_LOCALE="de_DE.UTF-8"</code> | ||
- | \\ | ||
- | ---- | ||
- | \\ | ||
- | Zarafa neu starten: | ||
- | <code>sudo /etc/init.d/zarafa-server restart</code> | ||
- | |||
- | Apache neu starten: | ||
- | <code>sudo /etc/init.d/apache2 restart</code> | ||
- | \\ | ||
- | ===== Installation und Konfiguration von Postfix ===== | ||
- | ==== Installation ==== | ||
- | Postfix installieren: | ||
- | <code>sudo apt-get install postfix</code>\\ | ||
- | Die Erklärung mit OK bestätigen:\\ | ||
- | {{::postfix_config_1.jpg?nolink|}}\\ | ||
- | \\ | ||
- | Internet-Site auswählen:\\ | ||
- | {{::postfix_config_2.jpg?nolink|}}\\ | ||
- | \\ | ||
- | Domain-Namen eintragen:\\ | ||
- | {{::postfix_config_3.jpg?nolink|}}\\ | ||
- | |||
- | ==== Konfiguration ==== | ||
- | |||
- | Die Konfiguration von **/etc/postfic/main.cf, /etc/postfix/virtual und /etc/aliases** aus der Konfiguration des alten Servers übernehmen bzw. anpassen. | ||
- | |||
- | <code>sudo postmap /etc/postfiv/virtual</code> | ||
- | <code>sudo service postfix restart</code> | ||
- | \\ \\ | ||
- | ===== Migration ===== | ||
- | ==== Daten auf altem Server sichern ==== | ||
- | === Dienste stoppen === | ||
- | |||
- | <code>sudo /etc/init.d/postfix stop</code> | ||
- | |||
- | <code>sudo /etc/init.d/zarafa-spooler stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-server stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-licensed stop</code> | ||
- | |||
- | <code>sudo /etc/init.d/zarafa-dagent stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-gateway stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-ical stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-indexer stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-search stop</code> | ||
- | <code>sudo /etc/init.d/zarafa-monitor stop</code> | ||
- | === MySQL Datenbank sichern === | ||
- | <code>mysqldump --single-transaction -p zarafa > /tmp/zarafa.sql</code> | ||
- | === Stores (E-Mail Anhänge usw) sichern === | ||
- | <code>cd /var/lib</code> | ||
- | <code>tar cfvz /tmp/zarafa_store.tar.gz zarafa/</code> | ||
- | === Daten per scp auf den neuen Server kopieren === | ||
- | <code>scp benutzer@hostalt:/tmp/zarafa.sql /tmp/</code> | ||
- | <code>scp benutzer@hostalt:/tmp/zarafa_store.tar.gz /tmp/</code> | ||
- | === Rücksicherung der Stores === | ||
- | <code>cd /tmp/ </code> | ||
- | <code>tar xfz zarafa_store.tar.gz</code> | ||
- | <code>cd zarafa</code> | ||
- | <code>sudo mkdir attachments</code> | ||
- | <code>sudo mv 0/ 1/ 2/ 3/ 4/ 5/ 6/ 7/ 8/ 9/ attachments/</code> | ||
- | <code>sudo cp -r /tmp/zarafa /var/lib/</code> | ||
- | === Rücksicherung der Datenbank === | ||
- | <code>mysql -u root -p zarafa < zarafa.sql</code> | ||
- | === Abschluss === | ||
- | <code>sudo service zarafa-server restart</code> | ||