Roundcube webmail telepítése Debian 9-Apache-MySQL környezetben forrásának megtekintése

==Összefoglalás==
A leírás Debian 9.11 operációs rendszeren készült.

A példák a szöveges fájlok szerkesztéséhez mcedit szövegszerkesztőt feltéteznek (Telepítés: apt-get install mc)

A parancsok root jogot feltételeznek. (állandó root jog: sudo bash)

A szükséges Apache webszerver, MySQL adatbázis szerver és Php futtatókörnyezet az operációs rendszer tárolójából telepítjük.

A pédában Apache-Debian alapértelmezések lesznek használatban: A /var/www/ könyvtár és a www-data user lesz használva.

A Roundcube webmail 1.4.2 Stable kiadása lesz telepítve. 

A példában a webszerver, adatbázis szerver és a levelezési szolgáltatások egy hoston futnak. Ezek igény szerint különválaszthatóak.

==Webszerver, adatbáziszerver, PHP futtatókörnyezet és szükséges csomagok telepítése==
<syntaxhighlight lang="bash">
apt-get install -y apache2 mysql-server php php-mysql php-mbstring php-pear php-gd php-imagick php-intl php-zip curl unzip
</syntaxhighlight>

==Roundcube motor telepítése==
<syntaxhighlight lang="bash">
wget -qO- https://github.com/roundcube/roundcubemail/releases/download/1.4.2/roundcubemail-1.4.2.tar.gz | tar -xzf - -C /var/www/
chown -R www-data:www-data /var/www/roundcubemail-1.4.2
</syntaxhighlight>

==PHP függőségek telepítése==

===Composer telepítése===
[https://getcomposer.org/ Információ]

A Debian tárolójában nem a legfrissebb verzió van, ezért manuálisan javasolt telepíteni.

Installer letöltése:<syntaxhighlight lang="bash">
curl -sS https://getcomposer.org/installer -o /tmp/composer-setup.php
</syntaxhighlight>Ha szeretnénk, ellenőrizhetjük a telepítőt. [https://getcomposer.org/download/ A verziók hash -jei.]A példában az 1.9.1 verzió hash-je található.<syntaxhighlight lang="php">
php -r "if (hash_file('sha384', '/tmp/composer-setup.php') === 'baf1608c33254d00611ac1705c1d9958c817a1a33bce370c0595974b342601bd80b92a3f46067da89e3b06bff421f182') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
</syntaxhighlight>Composer telepítése: a példában globálisan elérhető lesz a composer, de telepíthetjük a webhost könyvtárába is igény szerint.<syntaxhighlight lang="bash">
php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm /tmp/composer-setup.php
</syntaxhighlight>Sikereres telepítés után, ha a composer parancsot attribútum nélkül kiadva megjeleni annak helpje, sikeres a telepítés.<syntaxhighlight lang="bash">
composer

   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.9.1 2019-11-01 17:20:17

Usage:
  command [options] [arguments]

</syntaxhighlight>

===Composer futtatása===
Konfigurációs file átnevezése és futtatás:<syntaxhighlight lang="bash">
cd /var/www/roundcubemail-1.4.2/
mv composer.json-dist composer.json
composer install --no-dev
</syntaxhighlight>

==Javascript függőségek telepítése==
<syntaxhighlight lang="bash">
cd /var/www/roundcubemail-1.4.2/
bin/install-jsdeps.sh
</syntaxhighlight>

==Adatbázis létrehozása==
Feltételezve, hogy a mysql root felhasználónak konzolból nincs jelszava (telepítés alapértelmezett)

SQL futtatása:

*roundcubemail: adatbázis neve
*roundcube: adatbázis felhasználó neve
*password: adatbázis felhasználó jelszava
<syntaxhighlight lang="bash">
mysql -uroot -e "CREATE DATABASE roundcubemail CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'roundcube'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON roundcubemail .* TO 'roundcube'@'%';"
mysql -uroot roundcubemail < /var/www/roundcubemail-1.4.2/SQL/mysql.initial.sql
</syntaxhighlight>

==Webszerver konfigurálása==
PHP konfigurálása<syntaxhighlight lang="bash">
mcedit /etc/php/7.0/apache2/php.ini
</syntaxhighlight>Az alábbi értéket adjuk meg a konfigurációban: [https://www.php.net/manual/en/timezones.php Lehetséges értékek]<syntaxhighlight lang="ini">
date.timezone = 
</syntaxhighlight><span> </span>Apache konfiguráció létrehozása:<syntaxhighlight lang="bash">
mcedit /etc/apache2/sites-available/roundcube.conf
</syntaxhighlight>

*ServerName: domain név, ami alatt a wiki elérhető lesz. (A domaint konfigurálni kell a kiszolgáló IP címéhez)
*ServerAlias: további domain nevek.
*ServerAdmin: webmester e-mail címe.
*DocumentRoot: A könyvtár, ahová a Roundcube telepítve van.
*VirtualHost: a *:443 a https, a *:80 a http konfiguráció, ha csak az egyik kell, a másik elhagyható
*https konfiguráció
**SSLCertificateFile: tanúsítvány fájl
**SSLCertificateKeyFile: privát kulcs file
**Include (opcionális): tanúsítvány lánc fájl
<syntaxhighlight lang="apacheconf">
<IfModule mod_ssl.c>
    <VirtualHost *:443>
            ServerName mydomain.com
            ServerAlias www.mydomain.com
            ServerAdmin webmaster@onlinesoft.org
            DocumentRoot /var/www/roundcubemail-1.4.2/
    
            ErrorLog ${APACHE_LOG_DIR}/error.log
            CustomLog ${APACHE_LOG_DIR}/access.log combined
    
            SSLEngine on
            SSLCertificateFile  /etc/ssl/certs/ssl-cert-snakeoil.pem
            SSLCertificateKeyFile       /etc/ssl/private/ssl-cert-snakeoil.key
            #Include       /etc/ssl/certs/ssl-chain.conf
    </VirtualHost>
</IfModule>

<VirtualHost *:80>
        ServerName mydomain.com
        ServerAlias www.mydomain.com
        ServerAdmin webmaster@onlinesoft.org
        DocumentRoot /var/www/roundcubemail-1.4.2/

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

</syntaxhighlight>Apache konfiguráció<syntaxhighlight lang="bash">
ln -s /etc/apache2/sites-available/roundcube.conf /etc/apache2/sites-enabled/roundcube.conf
service apache2 restart
</syntaxhighlight>

== Roundcube configurálása ==
A Roundube telepítése böngészőben, a beállított domainon az installer könyvtár használatával folytatható. 

http(s)://mydomain.com'''/installer/'''
<br />