-
Notifications
You must be signed in to change notification settings - Fork 1
Grundinstallation und Systemvoraussetzungen
- Grundinstallation und Systemvoraussetzungen
- Installation der Erweiterungen: (eine Option wählen) 2a. Installation Kitodo.Presentation 2b. Installation Kitodo.Presentation mit DFG Viewer als Beispielanwendung 2c. Installation Kitodo.Presentation mit DFG Viewer und OCR On Demand als Beispielanwendung
Voraussetzung ist ein Server / PC mit Linux, Apache 2.4, MariaDB und PHP 7 (ab TYPO3 11 auch PHP 8), eine Konfiguration, die auch als LAMP bezeichnet wird. Empfohlen werden aktuelle Linux-Distributionen von Debian bullseye (für TYPO3 10) oder bookworm (für TYPO3 11), Ubuntu oder vergleichbare. WSL unter Windows ist ebenfalls möglich.
Debian bookworm kommt mit PHP 8.2 und erfordert daher TYPO3 11. Diese Konstellation wird seit Kitodo.Presentation 5.0.0-rc1 unterstützt, ist aber noch experimentell. Entsprechende Kommandos sind mit experimentell gekennzeichnet.
Superuser Rechte vorausgesetzt (sudo oder sudo su).
apt update
apt install apache2 mariadb-server
Apache Service: service apache2 status|start|stop|restart|reload
DB Service: service mariadb status|start|stop|restart
Zusätzlich sind die folgenden Pakete zu installieren:
apt install libapache2-mod-php php-curl php-gd php-intl php-mysql php-xml php-zip
Und folgende Apache2-Module zu aktivieren:
a2enmod expires headers rewrite
Anschließend muss noch die Lokalisierung definiert werden (TODO: Notwendigkeit prüfen):
apt install locales
sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen
locale-gen
Als nächstes wird die Datenbank erstellt und ein Nutzer für Typo3 angelegt:
# Erstelle eine neue datenbank "dfgviewer" mit dem user "TYPO3":
mariadb-admin create dfgviewer
mariadb --execute="GRANT ALL ON dfgviewer.* TO typo3@localhost IDENTIFIED BY 'password';"
Hinweis: ältere Linux-Distributionen erfordern mysql statt mariadb und mysqladmin statt mariadb-admin.
Nun wird TYPO3 Version 10.4.x installiert. Die Installation muss (!) mit Composer erfolgen.
# Installiere TYPO3 r10 im 'dfgviewer' Verzeichnis:
cd /var/www
apt install composer
composer create-project typo3/cms-base-distribution:^10 dfgviewer
chown -R www-data: dfgviewer
cd /var/www/html
ln -s ../dfgviewer/public/* .
ln -s ../dfgviewer/public/.htaccess
Nun müssen noch einige PHP-Einstellungen vorgenommen werden: (einige Befehle sind möglicherweise nicht auf allen Distributionen vorhanden, so dass die mods manuell kopiert/verschoben werden müssen)
# Füge eine apache2 Konfiguration hinzu:
cat <<eod >/etc/apache2/sites-available/dfgviewer.conf
<Directory /var/www/>
AllowOverride All
</Directory>
eod
# Aktiviere die config:
a2ensite dfgviewer
# Aktualisiere die Konfiguration für apache2:
service apache2 reload
experimentell: Für TYPO3 11 und PHP 8.2 muss in obigen Kommandos typo3/cms-base-distribution:^10 durch typo3/cms-base-distribution:^11 ersetzt werden.
Die folgenden Einstellungen sind für TYPO3 vorzunehmen (bzw. die auf der Seite angezeigten Werte wiki):
cat <<eod >/etc/php/7.4/mods-available/typo3.ini
;Settings for Typo3:
max_execution_time=240
max_input_vars=1500
eod
experimentell: Für TYPO3 11 und PHP 8.2 muss in obigen Kommandos /etc/php/7.4/mods-available/typo3.ini durch /etc/php/8.2/mods-available/typo3.ini ersetzt werden.
Dann werden die neuen Einstellungen aktiviert und apache2 neu gestartet:
phpenmod typo3
service apache2 restart
touch dfgviewer/public/FIRST_INSTALL
Nun ruft man http://localhost/ (oder http://localhost/typo3/install.php) im Webbrowser auf. Das TYPO3 Install Tool sollte angezeigt werden. Lesen und beheben Sie alle Probleme, die in der Umgebungsübersicht angezeigt werden.
Um das Problem zu beheben, bearbeiten Sie die xdebug-Konfiguration im apache2 conf-Verzeichnis:
nano /etc/php/7.4/apache2/conf.d/20-xdebug.ini
Und fügen Sie folgende Zeile hinzu:
xdebug.max_nesting_level = 500
Datei speichern (Ctrl+S) und apache2 service neu starten:
service apache2 restart
Laden Sie die Seite neu und befolgen Sie die folgenden Anweisungen. Übrigens: Der DB-Benutzer war zuvor auf typo3@localhost mit PW password ! Wenn Sie das Installationsprogramm eine Seite zu Testzwecken erstellen lassen, müssen Sie dessen Seitenkonfiguration zurücksetzen: Backend -> Site Management -> Sites -> [Created Site] -> Delete Site Configuration Sonst wird die Seite nicht richtig geladen! (TODO: Notwendigkeit prüfen)
apt install ghostscript graphicsmagick graphicsmagick-imagemagick-compat