Serverhosting návody

Postup, jak aktualizovat webmail klienta Roundcube na Debian Squeeze (VPS - virtuální server WEDOS). Níže popsanou aktualizace jsme prováděli z verze Roundcube 0.5.1 na verzi 1.0.1 na již zmiňovaném operačním systému. Postup bude pro jiné distribuce Linuxu obdobný ne-li stejný.

Pro úspěšnou aktualizaci postupujte podle níže uvedených pokynů. Pokud provádíte aktualizaci (upgrade z předchozí verze Roundcube Webmail, doporučujeme pečlivě zálohovat jak složku stávajícího klienta, tak i databázi roundcube.

1. Zálohovat!, zálohovat!, zálohovat!

Než se pustíme do akce je důležité nejprve vše odzálohovat obvzláště ti, kteří provádějí aktualizaci na již zaběhlém systému a mohou ovlivnit své klienty, kteří přes emailového klienta poštu vybírají.

1. Provedeme zálohu obsahu adresáře roundcube a to tak, že se přesuneme do jeho umístění:

cd /usr/share/roundcube

a spustíme příkaz:

tar cvf rouncube_zal_RRRRMMDD.tar *

R - rok
M - měsíc
D - den
Soubor si označíme názvem a časovým razítkem, abychom případně věděli co je to zač a kdy byl vytvořen.

Tímto krokem dojde k záloze obsahu celého adresáře roundcube v /usr/share/rouncube. Pokud máme klienta umístěného v jiném adresáři je nutno se před spuštěním zálohy přesunout tam. Teď je nutno ještě zálohovat databázi, abychom měli zálohu kompletní.

2. Záloha databáze pomocí nástroje phpMyAdmin

Příhlásíme se do phpMyAdmin a přepneme se na kartu "Export" a klikneme na tlačítko "Proveď".

Potom zvolíme "Uložit soubor" a klikneme na "OK"

Nakonec vybereme umístění, kde chceme zálohu uložit a klikneme na "Uložit".

Tímto krokem dojde k exportu databáze a máme vytvořenou kompletní zálohu (FTP, MySQL) klienta Rouncube.

2. Stažení aktuální verze Roundcube

Z oficiálních stránek Roundcube http://roundcube.net/download/ si stáhneme aktuální balíček webmail klienta. V našem případě je to roundcubemail-1.0.1.tar. Stažený balíček si rozbalením připravíme k náhrání ne server.

3. Nahrání souborů na server

Pro nahrání souborů na server použijte svůj oblíbený program FTP, SFTP, SCP, TotalCommander nebo WinSCP.

Nahraďte soubor index.php a všechny soubory ve složkách
/bin/
/SQL/
/program/
/installer/
/skins/default/
/plugins/

v umístění /usr/share/rouncube

Nakopírujte také výchozí konfigurační soubor a mapování MIME typ:

config/defaults.inc.php
config/mimetypes.php

4. Spuštění aktualizace

1. Spusťte z příkazové řádky příkaz:

./bin/update.sh 

nebo zadejte do webového prohlížeče http://url-to-roundcube/installer/installer a zvolte "3 Test config".
Chcete li použít aktualizaci přes URL je nutné upravit hodnotu "enable_installer" z false na "true" v konfiguračním souboru config/main.inc.php.

2. Zadejte aktuální verzi vašeho Roundcube. Verzi zjistíte na začátku souboru index.php. V našem případě je to verze "0.5.1" viz. níže a pro pokračování stiskněte "enter". Nechte aktualizační script zkontrolovat konfiguraci a aktualizaci konfiguračních souborů, tak jak navrhuje. Zadejte "y" a pokračujte dále "enter".

Výpis z průběhu spuštění scriptu update.sh:

root@vm12345/usr/share/roundcube# ./bin/update.sh
What version are you upgrading from? Type '?' if you don't know.
0.5.1
NOTICE: Obsolete config options:
(You still have some obsolete or inexistent properties set. This isn't a problem but should be noticed)
- 'mime_magic'
Do you want me to fix your local configuration? (y/N)
y
. backing up the current config file(s)...
. writing /usr/share/roundcube/config/config.inc.php...
Done.
Your configuration files are now up-to-date!
WARNING: File type detection doesn't work properly!
Please check the 'mime_magic' config option or the finfo functions of PHP and run this script again.
Executing database schema update.
Updating database schema (2011011200)... [OK]
Updating database schema (2011092800)... [OK]
Updating database schema (2011111600)... [OK]
Updating database schema (2011121400)... [OK]
Updating database schema (2012080700)... [OK]
Updating database schema (2013011000)... [OK]
Updating database schema (2013042700)... [OK]
Updating database schema (2013052500)... [OK]
Updating database schema (2013061000)... [OK]
Updating database schema (2014042900)... [OK]
Indexing contacts for user 1...done.
This instance of Roundcube is up-to-date.
Have fun!

Poznámka: Když nebudete vědět verzi rouncube, podívejte se do souboru index.php a zadejte ji do instalačního scriptu. Volby "?" se raději vyhněte. Díky zadání verze bude script přesně vědět, které .sql má použít pro aktualizaci databáze.

5. Aktualizace úspěšně dokončena

Po úspěšném dokončení aktualizace by se Vám měl na obrazovce zobrazit text:
This instance of Roundcube is up-to-date.
Have fun!

Náhled po aktualizaci:

Pokud jste prováděli aktualizaci přes URL nastavte hodnotu "enable_installer" zpět na "false".

6. Informace

S verzí 1.0 Roundcube, se mění struktura konfiguračních souborů.Dříve používané soubory main.inc.php a db.inc.php jsou nyní nahrazeny jedním souborem config.inc.php, který obsahuje pouze nastavení, které se liší od nastavení výchozího. To do budoucna umožní ještě jednodušší aktualizaci.
Vemte na vědomí, že od této chvíle, je config.inc.php jediný konfigurační soubor pro Roundcube. Defaultní hodnoty jsou v souboru defaults.inc.php.