Skip to content
Marko Schulz 01. December 2024 - 18:50 01. December 2024 - 18:50

ViMbAdmin V2 installieren

Das ViMbAdmin Projekt (vim-be-admin) bietet eine Web-basierte virtuelles Mailbox Verwaltungssystem, welches Mail-Administratoren ermöglicht, Domains, Mailboxen und Aliase zu verwalten.

Wenn noch nicht vorhanden, installieren wir erst git und laden und die aktuelle Version von VimBAdmin herunter und installieren es nach /usr/local/vimbadmin.

root:~# apt-get install git subversion
root:~# cd /usr/local
root:/usr/local# git clone -b v2 git://github.com/opensolutions/ViMbAdmin.git vimbadmin
root:/usr/local# cd /usr/local/vimbadmin
root:/usr/local/vimbadmin# ./bin/library-init.sh
root:/usr/local/vimbadmin# cp application/configs/application.ini.dist application/configs/application.ini

In der Konfiguratiosdatei müssen die SQL Verbindungsdaten connection_string, sowie das homdir der Mailboxen eingerichtet werden. Ausserdem muss ein sycuritysalt erstellt werden.

root:/usr/local/vimbadmin# vi application/configs/application.ini
....
securitysalt = "<RANDOM ALPHANUMERIC SIGNS>"
defaults.mailbox.uid = 5000
defaults.mailbox.gid = 5000
defaults.mailbox.homedir = "/var/vmail/"
resources.doctrine.connection_string = "mysql://vimbadmin:********@127.0.0.1/vimbadmin"

Nun können wir das Skript bin/doctrine-cli.php ausführen, um die SQL Tabellen der vimbadmin Datenbank zu erstellen.

root:/usr/local/vimbadmin# bin/doctrine-cli.php create-tables
root:/usr/local/vimbadmin# chown -R www-data:www-data /usr/local/vimbadmin/var
root:/usr/local/vimbadmin# mkdir etc

Als nächstes erstellen wir eine Apache Konfiguration für vimbadmin, welche in der Vhost Datei eingebunden werden kann.

root:/usr/local/vimbadmin# vi etc/apache2.conf
<IfModule mod_alias.c>
    Alias /vimbadmin /usr/local/vimbadmin/public
</IfModule>
<Directory /usr/local/vimbadmin/public>
    Options FollowSymLinks
    AllowOverride None
    Order allow,deny
    Allow from all
    <IfModule mod_rewrite.c>
        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} -s [OR]
        RewriteCond %{REQUEST_FILENAME} -l [OR]
        RewriteCond %{REQUEST_FILENAME} -d
        RewriteRule ^.*$ - [NC,L]
        RewriteRule ^.*$ /index.php [NC,L]
        #RewriteRule ^.*$ /vimbadmin/index.php [NC,L]
    </IfModule>
</Directory>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet

So könnte eine mögliche vhost Datei aussehen. In diesem Fall ist vimbadmin unter http://vimbadmin.example.com/ zu erreichen.

<VirtualHost *:80>
        ServerAdmin root@localhost
        ServerName vimbadmin.example.com

        DocumentRoot /usr/local/vimbadmin/public

        Include /usr/local/vimbadmin/etc/apache2.conf

    # Disable the /vimbadmin alias
    <IfModule mod_rewrite.c>
        RewriteEngine On
        RewriteCond %{REQUEST_URI} ^/vimbadmin/
        RewriteRule ^/vimbadmin - [F]
    </IfModule>

    <Directory /usr/local/vimbadmin/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride None
        DirectoryIndex index.php index.htm index.html
        Order allow,deny
        allow from all
    </Directory>

        CustomLog /var/log/apache2/vimbadmin.example.com_acc.log combined
        ErrorLog /var/log/apache2/vimbadmin.example.com_err.log
        LogLevel warn

</VirtualHost>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet

Nach diesen Änderungen muss der Apache neu gestartet werden.

root:/usr/local/vimbadmin# service apache2 restart

Dokumentation