Installation auf Ubuntu/Debian

Die mitgelieferte SQLite-Datenbank ist für Testinstallationen geeignet. In dieser Datenbank befinden sich bereits vorkonfigurierte Demoanwendungen (sie liegt unter <mapbender>/var/db/demo.sqlite). Eine Anleitung für eine Testinstallation auf Basis des Symfony Webservers finden Sie unter Aufruf von Mapbender unter Verwendung des lokalen Symfony Webservers.

Hint

Für den Produktiveinsatz wird PostgreSQL dringend empfohlen. Wichtige Konfigurationshinweise dazu finden Sie im Kapitel Optional > Mapbender Einrichtung auf PostgreSQL.

Voraussetzungen

  • PHP >= 8.1

  • Apache Installation mit folgenden aktivierten Modulen:

    • mod_rewrite

    • libapache2-mod-php

  • PostgreSQL Installation

    • Es wird empfohlen, eine PostgreSQL Datenbank für Mapbender zu verwenden.

    • Es wird empfohlen, einen eigenen Datenbankbenutzer für den Zugriff auf die Mapbender Datenbank anzulegen.

Als Webserver kann auch nginx verwendet werden. In dieser Anleitung wird darauf nicht weiter eingegangen.

Vorbereitung

Installation der benötigten PHP-Extensions:

sudo apt install php-gd php-curl php-cli php-xml php-sqlite3 sqlite3 php-apcu php-intl openssl php-zip php-mbstring php-bz2

Entpacken und im Webserver registrieren

Download der aktuellen Mapbender Version und entpacken nach /var/www/mapbender oder ein anderes Verzeichnis:

wget https://mapbender.org/builds/mapbender-starter-current.tar.gz -O /var/www/mapbender-starter-current.tar.gz
tar -zxf /var/www/mapbender-starter-current.tar.gz -C /var/www
mv $(ls -d /var/www/*/ | grep mapbender) /var/www/mapbender/

Konfiguration Apache 2.4

Datei /etc/apache2/sites-available/mapbender.conf mit dem folgenden Inhalt anlegen:

Alias /mapbender /var/www/mapbender/public/
<Directory /var/www/mapbender/public/>
 Options MultiViews FollowSymLinks
 Require all granted

 RewriteEngine On
 RewriteBase /mapbender/
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteRule ^(.*)$ index.php [QSA,L]
</Directory>

Aktivieren der Seite und Apache neu starten:

a2ensite mapbender.conf
service apache2 reload

Verzeichnisrechte

sudo chown -R :www-data /var/www/mapbender

sudo chmod -R ug+w /var/www/mapbender/var/log
sudo chmod -R ug+w /var/www/mapbender/var/cache
sudo chmod -R ug+w /var/www/mapbender/public/uploads

sudo chmod -R ug+w /var/www/mapbender/var/db/demo.sqlite

Nächste Schritte

Es kann nun auf die Mapbender Installation unter http://[hostname]/mapbender/ zugegriffen werden.

Per Voreinstellung lauten die Anmeldedaten

  • Benutzername: root

  • Passwort: root

Zur Überprüfung der Konfiguration dient der folgende Befehl:

bin/console mapbender:config:check

Hint

Bitte beachten Sie, dass der Befehl mapbender:config:check die PHP-CLI Version nutzt. Die Einstellungen der CLI-Version können sich von denen der Webserver PHP-Version unterscheiden. Nutzen Sie beispielsweise php -r 'phpinfo();' zur Ausgabe der PHP-Webserver Einstellungen.

Glückwunsch! Mapbender wurde erfolgreich installiert. Informationen zu den ersten Schritten mit Mapbender finden sich im Mapbender Schnellstart.

Optional

LDAP

Zur Nutzung der optionalen LDAP-Anbindung wird zunächst die PHP-LDAP-Extension benötigt:

sudo apt install php-ldap

Note

Zur Verwendung von LDAP muss im Anschluss außerdem das LDAP-Bundle in Mapbender integriert werden. Weitere Anweisungen zur Einrichtung finden Sie in der README.md.

Mapbender Einrichtung auf PostgreSQL

Für den Einsatz in einer Produktivumgebung wird nachfolgend die Konfiguration einer PostgreSQL Datenbank beschrieben.

Voraussetzungen:

  • Installation von PostgreSQL

  • vorhandene Datenbank zur Mapbender-Konfiguration

  • ggf. eigenen Benutzer für den Zugriff

Installation PHP-PostgreSQL Treiber:

sudo apt install php-pgsql php_pdo_pgsql

Die Konfiguration der Datenbankverbindung erfolgt über eine Variable, die den gesamten Verbindungsstring enthält. Konfigurieren Sie sie, indem Sie sie in Ihrer .env.local-Datei hinzufügen.

MAPBENDER_DATABASE_URL="postgresql://dbuser:dbpassword@localhost:5432/dbname?serverVersion=17&charset=utf8"

Anlegen der Mapbender Datenbank, sofern diese noch nicht vorliegt:

cd /var/www/mapbender
bin/console doctrine:database:create

Einrichtung der Mapbender Tabellenstruktur und laden der Demo-Anwendungen:

cd /var/www/mapbender
bin/console doctrine:schema:create
bin/console mapbender:database:init -v
bin/composer run reimport-example-apps

Root-Benutzer für Zugriff anlegen:

bin/console fom:user:resetroot

Weitere Informationen zur Konfiguration im Kapitel Details zur Konfiguration von Mapbender.