Quelltext der Seite 1 und 1 Internet

[[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 ein Zugang von 1&1 WebHosting vorinstalliert wurde. Das Passwort hat man nach der Einrichtung des Webspace vom Provider mitgeteilt bekommen.

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

.

Der Zugang setzt direkt im Basisverzeichnis des Webspace auf (deshalb wird das 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 ControlCenter in die Domainübersicht. Dort steht die bestellte Domain. 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.''' Man kann, wenn die bestehende Website ersetzen soll, einfach die Domainziele ändern, um die Subdomain zur Hauptdomain zu machen, was keine weiteren Änderungen erfordert.

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

.

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 konfigurieren werden. Da Contao in einem Unterverzeichnis installieren 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 ein FTP-Programm eintragen werden. Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis /cms1 öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
{{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.}}

{|
|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,<br />welche automatisch auf die richtige IP aufgelöst wird.
|-
|valign="top" | Port:
|valign="top" | Hier trägt man den Standard-Port einer<br />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]]<br />im ControlCenter abgelesen.
|-
|valign="top" | Passwort:
|valign="top" | Das FTP-Passwort wurde vom Provider mitgeteilt,<br />oder man hat bei den [[1_und_1_Internet#FTP-Zugang_kontrollieren|FTP-Zugängen]] ein neues<br />Passwort erstellt.
|-
|valign="top" | Anfangsverzeichnis:
|valign="top" | Hier muss das Basisverzeichnis für die Installation<br />angegeben werden, welches bei der [[1_und_1_Internet#Subdomain_anlegen_und_konfigurieren|Subdomain-Einrichtung]]<br />erstellt wurde.
|}

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


.

===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" | <br />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