Domain

Eine Domain ist ein Adress-Bereich für Server wie etwa uni-koeln.de. Unterhalb dieser Domain werden die einzelnen Systeme über ihren Namen, den Hostname, konkret identifiziert.

Zum Beispiel finden Sie unter der Adresse www.uni-koeln.de den Webserver und unter imap.uni-koeln.de den Mailserver der Universität. Hierbei ist uni-koeln.de die Domain und die Hostnames sind “www” und “imap”.

Der Name einer Domain kann allerdings auch als Hostnames verwendet werden. Wenn Sie in Ihrem Browser http://uni-koeln.de statt http://www.uni-koeln.de eingeben, bekommen Sie ebenfalls die Webseite der Uni zu sehen, weil wir beide Namen als Hostnamen eingetragen wurden.

Das Eintragen beider Varianten (mit und ohne “www”) ist inzwischen üblich und wird am RRZK für TYPO3-Seiten automatisch so eingetragen. (Dies ist bei universitätsfremden Domains (siehe oben) zu beachten, da Sie für das Eintragen beider Varianten selbst verantwortlich sind)

Subdomain

So genannte Subdomains wie etwa subdomain.uni-koeln.de sind ebenfalls möglich. Unterhalb dieser können sich dann weitere Hostnames befinden wie hostname.subdomain.uni-koeln.de.

Adressen

Sie können anhand der Adresse nicht erkennen, ob es sich beim Adressbestandteil “name” innerhalb von “name.uni-koeln.de” um eine Subdomain oder einen Hostname handelt.

Das RRZK verwendet allerdings größtenteils keine “echten” Subdomains, sondern trägt Hostnames direkt in der Domain uni-koeln.de ein.

Im Beispiel www.anglistik.phil-fak.uni-koeln.de ist also “www.anglistik.phil-fak” der Hostname in der Domain “uni-koeln.de”.

fully qualified hostname

Wenn von einem “fully qualified hostname” gesprochen wird, ist damit der Hostname inklusive der Domain gemeint. Der allgemeine Sprachgebrauch ist hier oft unpräzise und nennt den “fully qualified hostname” einfach Domain - der Unterschied ist jedoch relevant.

URL

Eine URL ist hingegen die komplette Internetadresse einer Seite. Sie enthält neben dem fully qualified hostname noch das Protokoll (also “http”, oder “https”) und wird meist noch durch einen Pfad (zum Beispiel zu einem Dokument) ergänzt.

Sie hat also das Schema protokoll://hostname.domain/pfad/unterpfad/dokument.typ.

Zum Beispiel setzt sich die URL https://rrzk.uni-koeln.de/aktuelles.html aus der Angabe des Protokoll (“https://”), dem fully qualified hostname “rrzk.uni-koeln.de” (also Hostname und Domain) und dem Pfad “aktuelles.html” (die gewünschte Seite innerhalb des Webauftritts) zusammen.

Damit TYPO3 die URLs für die einzelnen Dokumente Ihrer Webseite generieren kann, muss das System wissen welcher fully qualified hostname (umgangssprachlich Domain) zu welchem Teil des Seitenbaums gehört.

Dafür müssen Sie vorab im Backend einen so genannten Domain-Record auf der Seite anlegen, welche die Startseite für die jeweilige Webadresse sein soll.

Wichtig: Eine Domain kann in einem TYPO3 nur einmal angelegt werden. Existiert bereits ein Domain-Record für eine Domain, dann wird (leider ohne direkte Fehlermeldung) eine “0” (Null) hinten angehängt. Ein solcher Eintrag ist wirkungslos und erzeugt bei den Webmastern Fehlermeldungen.

Derartige Dubletten werden auch dann erzeugt, wenn Sie ganze Webauftritte durch rekursives Kopieren verdoppeln. Daher raten wir Ihnen vom rekursiven Kopieren ab.

1. Wählen Sie das Modul “Liste”.
2. Klicken Sie im Seitenbaum auf die oberste Seite, für welche die anzulegende Domain gelten soll. Diese Seite wird häufig “Startseite” genannt. Wählen Sie nicht die root-Seite Ihrer TYPO3-Installation!
3. Klicken Sie auf das "Neu"-Icon oberhalb des Bearbeitungsbereichs. Es erscheint eine Auswahl möglicher anzulegender Datensatztypen. (Sollte diese Liste nicht erscheinen, sondern eine Seitenauswahl, haben Sie den falschen Neu-Knopf gedrückt.)
4. Wählen Sie den Datensatztyp "Domain".
5. Aktivieren Sie, wenn noch nicht geschehen, unten den Haken für "zweite Optionspalette".
6. Geben Sie den fully qualified Hostname (also den voll ausgeschriebenen Hostname inklusive Domain, aber ohne Pfad und ohne Protokoll) ein, unter welchem Ihre Webseite hauptsächlich zu erreichen sein soll. Ein Beispiel wäre institut.uni-koeln.de. (Keben Sie bitte NICHT www.institut.uni-koeln.de sondern lediglich institut.uni-koeln.de ein, das www. wird später automatisch hinzugefügt)
   Bitte beachten Sie: Wenn Sie meinen, hinter dem Hostname einen Pfad angeben zu müssen, wie beispielsweise “/meine-neue-seite.html”, kann es gut sein, dass Sie gar keine Domain, sondern stattdessen eine Weiterleitung benötigen. Kontaktieren Sie uns in diesem Falle bitte via typo3master@uni-koeln.de.
7. Speichern Sie den Domain-Record
8. Erstellen Sie eine Site-Configruation. Das hierfür notwendige Tool ist derzeit noch in Erstellung, und es ist noch nicht ausreichend dokumentiert. Wenn Sie nicht wissen wie eine Site-Config mit dem Uzk-Tool erstellt wird, wenden Sie sich bitte an typo3master@uni-koeln.de. Verwenden Sie hierfür bitte nicht das in TYPO3 eingebaute Site-Tool.

Sobald das TYPO3-Team des RRZK die Domain freigegeben hat, wird dieser Eintrag aktiv. 

Achtung: Sobald Sie speichern können Sie die Seiten zwar noch im Backend bearbeiten, sie aber noch nicht im Frontend betrachten. Das ist erst möglich, wenn die Domain im Proxy freigeschaltet und im DNS eingetragen wurde.

Diese Vorgänge können einige Tage dauern. Sollte das Eintragen der Domain zeitkritisch sein, informieren Sie uns VORAB. Wir können die Prozesse zwar nicht grundsätzlich beschleunigen, aber unter Umständen einige Vorgänge (wie etwa das Beantragen des DNS-Eintrags) vorziehen. 

Eine Site-Config ist eine Konfiguration, die TYPO3 mitteilt, welche Domains als Haupt-Domains erfasst werden sollen, und welche Sprachen dort zur Verfügung stehen. Jede Webseite muss sich einer Hauptdomain zuorten lassen können, damit sie aufrufbar ist. Die Site-config ist somit ein wesentlicher Bestandteil jedes Webauftritts.

Seit TYPO3 v9 stellen wir den Admins der TYPO3 Installationen das Modul "Uzk Sites" zur Verfügung. Nur mittels dieses Moduls können Sie die Konfigurationen für Webseiten vollständig und im Sinne des Workflows der uni Köln anfertigen.
Achtung: Verwenden Sie an der Uni Köln bitte nicht das in TYPO3 eingebaute Sites-Modul, sondern nur das der Uni, welches Sie am Uni-Siegel erkennen.

Nachdem Sie über das Listenmodul einen Domain-Record Datensatz für eine neuen Webauftritt auf dessen Startseite angelegt haben (s.o.), 

Site Config über das neue Sites Modul anlegen

• Öffnen Sie die Seiteneigenschaften der Starsite, und setzen Sie unter "Verhalten" den Haken bei "Als Anfang der Website" und speichern Sie.
  Achtung: Setzen Sie diesen Haken Ausschließlich bei den Startseiten von Webauftritten und nirgends sonst.

• Öffnen Sie nun das UzK Sites Tool.

• Haben Sie bishier hin alles richtig gemacht wird Ihnen im oberen Bereich bereits ein Fehler angezeigt, dass es Eine Domain ohne Site-Config gibt. Je nach größe Ihrer TYPO3 Installation folgt eine u.U. sehr lange Liste von Sites. Entweder ganz oben in der liste oder ganz am Ende finden Sie die neuen Domains, Sie sind mit einem Grünen Button mit Plus-Zeichen versehen. Betätigen Sie diesen Button.

• Im folgenden Bildschirm klicken Sie bitte auf den Link "zurück zur Übersicht"

• Da die allermeisten Webseiten der uni köln sowohl in Deutsch als auch in Englisch erstellt werden sollen, werden diese beiden Sprachen per Default hinzugefügt. Mit den Blauen Sprach-Buttons können Sie weitere Sprachen hinzufügen, mit den rosanen Sprach-Buttons mit mülleimer-Symbol können Sie bestehende Sprachen entfernen.

• Leeren Sie anschließend bitte alle Caches (roter Blitz) , um die Änderungen Wirksam zu machen.

Damit ist die neue Site Config erstellt. Nach der Freischaltung des Domain durch die Hostmaster ist die Website öffentlich erreichbar.

Die eben vorgenommenen Einstellungen sind lediglich dem TYPO3 System bekannt. Um zu funktionieren, müssen sie in den Systemen der Webmaster (Proxy) eingetragen und im Internet als solches (DNS) bekannt gemacht werden.

Verfahren:

Nachts werden die TYPO3-Installationen durch das RRZK gescannt. Dabei werden neue Domain-Einträge gefunden und die Webmaster darüber informiert. 

Die Webmaster entscheiden final, ob ein Hostname so vergeben werden kann oder nicht. Zu allgemein gehaltene Domains oder solche mit Personennamen sind nicht zulässig. Beispiele für unzulässige Domains:

homepage.uni-koeln.de

studium.uni-koeln.de

s.uni-koeln.de

meyer.uni-koeln.de

Weitere Informationen dazu unter https://rrzk.uni-koeln.de/webadresse.html

Schließlich geben die Webmaster des RRZK den Hostname für den HA-Proxy frei und reichen die Anfrage an die Hostmaster des RRZK weiter, sofern es sich um eine uni-koeln.de-Domain handelt.

Die Änderungen im Proxy werden binnen 60 Minuten wirksam. Im DNS werden die Hostnamen zügig eingetragen. Bitte beachten Sie, dass Ihre Webseite ab dem Eintragen des Domain-Records bis zum vollständigen Eintragen aller Daten in DNS und Proxy möglicherweise nicht aufrufbar ist oder auf die Startseite der Uni verweist.

Wenn es wichtig ist, dass die neue Adresse rasch freigeschaltet wird, kontaktieren Sie uns bitte.

Sollten Sie Domains benötigen, die nur für Teile Ihres Webauftritts verwendet werden sollen, oder sollten Sie mehrere Webauftritte in einem TYPO3 administrieren wollen, beachten Sie dazu unsere zusätzlichen Informationen unter "Umgang mit mehreren Domains"