[[Category:Installation und Updates]]

==Installation von Contao in einer Subdomain bei 1&1 WebHosting==

Das folgende Beispiel beschreibt Schritt für Schritt die Einrichtung von Contao auf einem Shared Webspace von [http://www.1und1.de/ 1&1 WebHosting]. Um Contao im Rahmen eines Hosting-Pakets von 1&1 betreiben zu können, muss ein Paket bestellt werden, das zumindest eine MySQL 5-Datenbank enthält. Zur Zeit ist "1&1 Homepage Perfect" das kleinste Paket, welches diese Mindestanforderung erfüllt.

Aus Sicherheits- bzw. Datenschutzgründen wurden die in diesem Beispiel angegebenen Zugangsdaten und Domainnamen frei erfunden.

 

==Vorbereitung==
===Datenbank anlegen===
[[Datei:1u1_mysqlicon.jpg|Datenbank]]

Im [http://login.1und1.de 1&1 ControlCenter] legt man als erstes eine neue Datenbank an. In einigen der angebotenen Hosting-Pakete könnte es eventuell noch eine Auswahl zwischen verschiedenen MySQL-Versionen geben. Es ist unbedingt darauf zu achten, dass es sich bei der neu installierten Datenbank um eine MySQL 5-Datenbank handelt. Das für die Datenbank angelegte MySQL-Passwort sollte man sich gut merken bzw. notieren. Nachdem das Passwort angelegt wurde, kann man es nicht mehr sehen. Ändern lässt es sich nur, wenn man in der Datenbank eingeloggt ist.

 

Die Einrichtung der MySQL 5-Datenbank erfolgt über ein Eingabeformular:

[[Datei:1u1_mysql1.jpg|Datenbank anlegen]]

 

Es kann im Zuge der Datenbankinstallation ein Weile dauern, bis der Status '''Fertig''' angezeigt wird. Anschließend sollte das Resultat etwa so aussehen:

[[Datei:1u1_mysql2.jpg|Datenbank anlegen]]

 

Eine Übersicht über die Zugangsdaten (Datenbankname, Hostname, Benutzername) findet man unter dem Menüpunkt '''Bearbeiten''':

[[Datei:1u1_mysql3.jpg|Datenbank anlegen]]

 

Damit ist die Datenbank vorbereitet.

 

===FTP-Zugang kontrollieren===
[[Datei:1u1_ftpicon.jpg|FTP-Zugänge]]

Einen FTP-Zugang braucht man normalerweise nicht selbst anzulegen, da er von 1&1 WebHosting vorinstalliert wurde. Das Passwort hat man nach der Einrichtung des Webspace vom Provider per Mail zugesandt bekommen.

[[Datei:1u1_ftp1.jpg|FTP-Zugänge Übersicht]]

 

Der Zugang setzt direkt im Basisverzeichnis des Webspace auf (deshalb wird als Verzeichnis '''/.''' angezeigt). Hat man das Passwort vergessen, kann unter '''Bearbeiten''' ein neues vergeben werden.

 

===Subdomain anlegen und konfigurieren===
[[Datei:1u1_domainicon.jpg|Domains]]

Über dieses Icon gelangt man im [http://login.1und1.de 1&1 ControlCenter] in die Domainübersicht. Dort ist die bestellte Domain eingetragen. Bei einem bereits bestehenden Webspace kann es sein, dass auf der Domain eine alte Website läuft, die erst nach Fertigstellung der neuen Contao-Installation durch diese ersetzt werden soll.

Deshalb baut die neue Contao-Website zunächst '''unter einer Subdomain''' auf:

[[Datei:1u1_domain1.jpg|Domainübersicht]]

Um die bestehende Website zu ersetzen, genügt es, die Domainziele zu ändern, um die Subdomain zur Hauptdomain zu machen. Weitere Änderungen sind nicht erforderlich.

Unter '''Neu''' kann eine neue Subdomain eingerichtet werden. Für diese Beispiel-Anleitung erhält sie den Namen '''contao.meinedomain.de''':

[[Datei:1u1_domain2.jpg|Subdomain anlegen]]

 

Mit einem Haken in der Übersicht vor der neuen Subdomain und dem Button '''Verwendungsart''' kann die Subdomain konfiguriert werden. Da Contao in einem Unterverzeichnis installiert werden soll, um eine klare Trennung zu anderen Anwendungen zu haben, wird ein Verzeichnis '''cms1''' angelegt.

[[Datei:1u1_domain4.jpg|Domain konfigurieren]]

 

Nach dem '''OK''' gelangt man wieder in die Domainübersicht, wo jetzt die Subdomain auf das Verzeichnis '''/cms1''' verweist.

[[Datei:1u1_domain5.jpg|Domainübersicht mit Subdomain]]

 

==Installation==
===FTP-Programm einrichten===
Um Contao auf die richtige Stelle im Webspace zu kopieren, müssen die FTP-Zugangsdaten in das verwendete FTP-Programm eintragen werden. Bei Eingabe der richtigen Daten wird das Programm direkt das Verzeichnis '''/cms1''' öffnen. Jedes FTP-Programm ist etwas anders aufgebaut, deshalb hier nur ein Beispiel. In allen Programmen müssen aber die gleichen Zugangsdaten für den Webspace eingetragen werden.

{{Achtung|Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (z.B. ''.htaccess'') abgeschaltet. Für eine vollständige Installation von Contao ist es '''sehr wichtig''', diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit der neuen Contao-Website gegen ungewolltes Auslesen von Daten.

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

{|
|rowspan="6" | [[Datei:1u1_ftp2.jpg|FTP-Zugangsdaten eintragen]]
|valign="top" | Protokoll:
|valign="top" | Es soll eine '''FTP-Verbindung''' aufgebaut werden.
|-
|valign="top" | Server:
|valign="top" | Hier wird einfach die '''Hauptdomain''' eingetragen, welche automatisch auf die richtige IP aufgelöst wird.
|-
|valign="top" | Port:
|valign="top" | Hier trägt man den Standard-Port einer FTP-Verbindung, den '''Port 21''', ein.
|-
|valign="top" | Benutzername:
|valign="top" | Den Benutzernamen hat man in den [[1_und_1_Internet#FTP-Zugang_kontrollieren|FTP-Zugängen]] im [http://login.1und1.de 1&1 ControlCenter] abgelesen.
|-
|valign="top" | Passwort:
|valign="top" | Das FTP-Passwort wurde vom Provider mitgeteilt, oder man hat bei den [[1_und_1_Internet#FTP-Zugang_kontrollieren|FTP-Zugängen]] ein neues Passwort erstellt.
|-
|valign="top" | Anfangsverzeichnis:
|valign="top" | Hier muss das '''Basisverzeichnis''' für die Installation angegeben werden, welches bei der [[1_und_1_Internet#Subdomain_anlegen_und_konfigurieren|Subdomain-Einrichtung]] erstellt wurde.
|}
 
Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte es auf dem Server ein '''leeres Verzeichnis''' aufrufen.

 

===Upload Contao===
Nachdem Contao von der [http://www.contao.org/herunterladen.html offiziellen Homepage] herunter geladen wurde, entpacken man das ZIP-Archiv auf dem lokalen Rechner. In dem ZIP ist als unterstes noch ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.
 

[[Datei:1u1_zip1.jpg|Contao ZIP-Archiv]]

 
Als Besonderheit für 1&1 erstellt man in dem Basisverzeichnis eine '''.htaccess'''-Datei mit folgendem Inhalt:
 
<source lang="text">
AddType x-mapp-php5 .php
AddHandler x-mapp-php5 .php
</source>
 

Des Weiteren bereitet man die '''.htaccess.default''' für eine spätere Verwendung vor, indem man (speziell für 1&1) auch hier diese beiden Zeilen einträgt:
 
<source lang="text">
AddType x-mapp-php5 .php
AddHandler x-mapp-php5 .php
##
# Contao Open Source CMS
# Copyright (C) 2005-2010 Leo Feyer
#
# Formerly known as TYPOlight Open Source CMS.
#
</source>
 

Ich persönlich verwende für die Installation die einfache Variante der .htaccess und wechsle erst später, wenn alles läuft, auf die im Contao-Paket enthaltene Datei, die für die URL-Umschreibung zuständig ist. Dazu muss man dann .htaccess.default in .htaccess umbenennen.
 

'''Das ganze Paket (ab Basisverzeichnis) lädt man jetzt per FTP auf den Webspace hoch.'''

 

===Aufruf des Installtools===
So - inzwischen sollte auch die Subdomain '''contao.meinedomain.de''' verfügbar sein, so dass man mit der Installation von Contao beginnen kann.

Da die Installation aus der Sicht der Subdomain in der Root liegt (/cms1 ist die Root der Subdomain!), braucht man kein Unterverzeichnis beim Aufruf anzugeben oder die Rewrite-Base in der .htaccess zu verändern.

Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen natürlich mit dem Pfad typolight anstatt contao). Der Ablauf der Installation ist [[Installation|auf der Seite Installation]] beschrieben, hier also nur die speziellen Einstellungen, die bei 1&1 anzuwenden sind:

{|
|[[Datei:1u1_install1.jpg|Datenbankconnection]]
|valign="top" | Hier werden alle Daten eingetragen, die man zuvor [[1_und_1_Internet#Datenbank_anlegen|im ControlCenter unter Datenbanken]] notiert hat.
|}

 

===Das sollte es dann gewesen sein===

----

-- [[Benutzer:do_while|do_while]] - 2010-06-28