Installation: Unterschied zwischen den Versionen

Aus Contao Community Documentation

K (div. Korrekturen)
K (Ein Administratorkonto anlegen)
 
(14 dazwischenliegende Versionen von 7 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
{{stub}}
 
{{stub}}
 
[[Category:Installation und Updates]]
 
[[Category:Installation und Updates]]
 +
Die hier angeführte Anleitung beschreibt die Standard-Vorgehensweise zur Installation von Contao. Speziell benötigte Anpassungen zu den einzelnen Webhostern bzw Hoster-spezifische Installationsanleitungen ist auf der Seite [[Webhoster]] zu finden.
 +
=Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster=
  
=Installation von Contao=
+
# Download des Contao-Cores auf [http://www.contao.org contao.org] bzw. [http://sourceforge.net/projects/contao/ Sourceforge]
==Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster==
+
 
+
# Download des Contao-Cores auf www.contao.org
+
 
# Entpacken auf dem Heimrechner
 
# Entpacken auf dem Heimrechner
 
# Hochladen der Dateien mittles FTP auf Ihren Server
 
# Hochladen der Dateien mittles FTP auf Ihren Server
Zeile 14: Zeile 13:
 
# Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")
 
# Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")
  
==Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster==
+
=Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster=
  
===Download von Contao und entpacken auf dem Heimrechner===
+
==Download von Contao und entpacken auf dem Heimrechner==
  
 
Auf www.contao.org begibt man sich auf den Bereich [http://www.contao.org/herunterladen.html Herunterladen] und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
 
Auf www.contao.org begibt man sich auf den Bereich [http://www.contao.org/herunterladen.html Herunterladen] und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
Zeile 23: Zeile 22:
 
Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. [http://www.7-zip.org/ 7-zip], welches nahezu alle gängigen Archivformate beherrscht.
 
Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. [http://www.7-zip.org/ 7-zip], welches nahezu alle gängigen Archivformate beherrscht.
  
===FTP-Programm einrichten===
+
==FTP-Programm einrichten==
 
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden.  
 
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden.  
 
Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
 
Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
Zeile 52: Zeile 51:
 
Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.
 
Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.
  
===Upload Contao===
+
==Upload Contao==
 
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.
 
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.
  
Zeile 60: Zeile 59:
 
Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.
 
Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.
  
===Aufruf des Installtools===
+
==Aufruf des Installtools==
 
+
===Installtool-Passwort===
 
Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).
 
Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).
  
 +
{{AppliesTo
 +
| Version=Typolight, Contao bis 2.10.x
 +
}}
 
Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").
 
Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").
  
 
Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
 
Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
 +
 +
{{AppliesTo
 +
| Version= Contao ab 2.11.x
 +
}}
 +
 +
Beim ersten Aufruf erwartet das Installtool die Vergabe eines Passwortes für jeden weiteren Aufruf des Installation-Tools.
 +
 
{{Anmerkung|Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.}}
 
{{Anmerkung|Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.}}
  
 +
===Einen Verschlüsselungsschlüssel erstellen===
 
Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys.
 
Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys.
 
Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
 
Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
{{Anmerkung|Diese Eingabe ist nur notwendig, wenn ein [[Webseitentemplate]] importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.}}
+
{{Anmerkung|Diese Eingabe ist nur notwendig, wenn ein [[Webseitentemplate]] importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.}}{{Achtung|Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.}}
{{Achtung|Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.}}
+
  
 +
===Datenbankverbindung prüfen===
 
Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
 
Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
 
{|
 
{|
Zeile 80: Zeile 90:
 
|}
 
|}
  
 +
 +
===Tabellen aktualisieren===
 
Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.
 
Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.
  
Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der [http://demo.contao.org Demonstrationswebseite] bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein, so lässt man das Auswahlmenü leer.
+
===Ein Template importieren===
 +
Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der [http://demo.contao.org Demonstrationswebseite] bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein und eine komplett neue Webseite erstellt werden, so lässt man das Auswahlmenü leer.
  
Abschliessend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)
+
===Ein Administratorkonto anlegen===
 +
Abschließend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)
  
 
Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.<br />
 
Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.<br />
 
'''Gratulation, die Installation ist abgeschlossen.'''
 
'''Gratulation, die Installation ist abgeschlossen.'''
  
=Webhoster=
+
==Absichern des Install-Tools==
==Liste kompatibler Webhoster==
+
Nach erfolgreicher Installation ist es ratsam, das Install-Tool gegen fremden Zugriff abzusichern. Dies kann man mit 2 Möglichkeiten:
[[1 und 1 Internet]] (kompatibel mit ein paar Besonderheiten)
+
*Durch Umbenennen der Datei ''/contao/install.php''
 
+
*Durch Abbrechen des Install-Skrips. Dazu die Datei ''/contao/install.php'' bearbeiten und in Zeile 2 folgenden Code einfügen:<source lang="php">exit();</source>
Hetzner.de (ab dem entsprechenden "Tarif inkl. MySQL-Datenbank" voll kompatibel)
+
 
+
==Workarounds für bestimmte Webhoster==
+
Bei manchen Webhostern ist es leider notwendig von obigem Standard Installationsschema abzuweichen.
+
 
+
Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.
+
 
+
Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist.
+
Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]]).
+
 
+
{{Hinweis|In Zukunft wird hier eine Liste von Artikeln veröffentlicht, welche Anpassungen bei welchen Webhoster notwendig ist um Contao zum Laufen zu bekommen.}}
+
 
+
==Liste inkompatibler Webhoster==
+
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann.
+
Bitte beim Hinzufügen von Webhostern darauf achten, dass man detailliert beschreibt woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung".
+

Aktuelle Version vom 21. Juli 2016, 01:37 Uhr

MsgError.png Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.

Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.

Die hier angeführte Anleitung beschreibt die Standard-Vorgehensweise zur Installation von Contao. Speziell benötigte Anpassungen zu den einzelnen Webhostern bzw Hoster-spezifische Installationsanleitungen ist auf der Seite Webhoster zu finden.

Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster

  1. Download des Contao-Cores auf contao.org bzw. Sourceforge
  2. Entpacken auf dem Heimrechner
  3. Hochladen der Dateien mittles FTP auf Ihren Server
  4. Hochladen des Systemdiagnosetools ins Verzeichnis der Contao-Installation (gewöhnlicherweise das Root-Verzeichnis Ihrer Webadresse)
  5. Aufrufen der Diagnosedatei in der Adresszeile Ihres Browsers und eventuelle Fehlermeldungen beseitigen
  6. Aufrufen der Installationsdatei: www.IhreDomain.com/contao/install.php (ersetzen Sie "www.IhreDomain.com" mit Ihrer tatsächlichen Webadresse; in diesem Fall ist Contao im Rootverzeichnis Ihres Webservers installiert; der Zugang zum BackEnd (BE) liegt im Unterverzeichnis "contao/")
  7. Das Installationsskript führt Sie durch die abschließenden Schritte (die erforderlichen Daten zur Datenbank erhalten Sie von Ihrem Webhoster)
  8. Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")

Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster

Download von Contao und entpacken auf dem Heimrechner

Auf www.contao.org begibt man sich auf den Bereich Herunterladen und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.

Anmerkung.png Anmerkung: Contao wird in zwei unterschiedlichen Archivformaten angeboten. pkzip (Zip-Archiv) und tar.gz (gzipped Tarball). Sollten man einen Windows PC verwenden, sollte die pkzip Version verwendet werden.


Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. 7-zip, welches nahezu alle gängigen Archivformate beherrscht.

FTP-Programm einrichten

Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden. Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.

Achtung.png Achtung: Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (wie .htaccess) abgeschaltet. Bei Contao ist es sehr wichtig, diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit gegen ungewolltes Auslesen von Daten.

Häufig ist es möglich Parameter für den LIST-Befehl anzugeben, dann bitte -la angeben. Hierzu sollte die Doku des verwendeten FTP-Programms weiter helfen.


FTP-Zugangsdaten eintragen Protokoll: Es soll eine FTP-Verbindung aufgebaut werden.
Server: Hier wird einfach die Hauptdomain eingetragen,
welche automatisch auf die richtige IP aufgelöst wird.
Port: Hier trägt man meist den Standard-Port einer
FTP-Verbindung, den Port 21 ein.
Benutzername: Der Benutzername wurde vom Provider mitgeteilt.
Passwort: Das FTP-Passwort wurde vom Provider mitgeteilt.
Anfangsverzeichnis: Hier muss das Basisverzeichnis für die Installation
angegeben werden.

Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.

Upload Contao

In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.

Contao ZIP-Archiv

Das ganze Paket (ab Basisverzeichnis) ladet man jetzt per FTP auf den Webspace hoch. Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.

Aufruf des Installtools

Installtool-Passwort

Den Installer ruft man einfach mit http://contao.meinedomain.de/contao/install.php auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).


betrifft
Contao Version Typolight, Contao bis 2.10.x

Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").

Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.


betrifft
Contao Version Contao ab 2.11.x


Beim ersten Aufruf erwartet das Installtool die Vergabe eines Passwortes für jeden weiteren Aufruf des Installation-Tools.


Anmerkung.png Anmerkung: Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.


Einen Verschlüsselungsschlüssel erstellen

Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys. Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.

Anmerkung.png Anmerkung: Diese Eingabe ist nur notwendig, wenn ein Webseitentemplate importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.
Achtung.png Achtung: Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.


Datenbankverbindung prüfen

Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.

Datenbankconnection
Hier werden alle Daten eingetragen, die man von seinem Provider erhalten hat. Wenn die eingegebenen Daten korrekt sind, wird nach dem Speichern die Meldung "Datenbankverbindung ok." ausgegeben


Tabellen aktualisieren

Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.

Ein Template importieren

Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der Demonstrationswebseite bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein und eine komplett neue Webseite erstellt werden, so lässt man das Auswahlmenü leer.

Ein Administratorkonto anlegen

Abschließend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)

Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.
Gratulation, die Installation ist abgeschlossen.

Absichern des Install-Tools

Nach erfolgreicher Installation ist es ratsam, das Install-Tool gegen fremden Zugriff abzusichern. Dies kann man mit 2 Möglichkeiten:

  • Durch Umbenennen der Datei /contao/install.php
  • Durch Abbrechen des Install-Skrips. Dazu die Datei /contao/install.php bearbeiten und in Zeile 2 folgenden Code einfügen:
    exit();
Ansichten
Meine Werkzeuge

Contao Community Documentation

God: "what is your job?"
me: "i am a software developer ... i develop websites with Contao 3"
God: "sounds cool, what are you working on today? Web sockets? Ajax? HTML5 video streaming?"
me: "no, i am trying to send an email ...."

Leo Unglaub
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge