de en

Quick Install Guide

Diese Seite stellt lediglich eine Kurzanleitung zum Installieren eines Systems dar.
Diese Seite kann auch als PDF heruntergeladen und ausgedruckt werden.
Eine ausführliche Beschreibung gibt es im Handbuch.

Download

Wenn noch nicht bereits geschehen, so beginnt die Installation von Kajona mit dem Download des Systems von www.kajona.de. Hierfür gibt es zwei Möglichkeiten.

Zum einen wäre da der Download es „all-in-one.zip“-Package. Hier sind alle benötigten Module und Elemente enthalten. Wählt man diesen Weg, so muss nach dem Download das Archiv entpackt werden. Weiter geht es mit dem Schritt „Upload“, das ZIP-File wird nun nicht mehr benötigt und kann gelöscht werden.

Zum anderen bleibt die Möglichkeit, bewusst einzelne Module herunterzuladen. In diesem Fall sollten nun die gewünschten Module und gegebenenfalls zusätzliche Seitenelemente heruntergeladen werden. Nach dem alle Dateien in einen Ordner kopiert und in diesem entpackt wurden folgt der nächste Schritt: „Dateien in korrekte Struktur kopieren“. Die ZIP-Files werden nun nicht mehr benötigt und können gelöscht werden.

Dateien in korrekte Struktur kopieren

Dieser Schritt wird nur benötigt, wenn die Module als einzelne Pakete heruntergeladen wurden. Wenn das „all-in-one“-Package heruntergeladen wurde, dann geht es direkt mit dem Schritt „Upload“ weiter.

Nachdem nun alle Module entpackt wurden, sollten sich im zuvor angelegten Ordner nun weitere Unterordner befinden, beispielsweise „modul_system“, „modul_pages“ oder auch „element_formular“. In jedem dieser Ordner befindet sich die Dateistruktur eines späteren Kajona-Systems. Diese Unterordner müssen nun alle in einen gemeinsamen Ordner kopiert werden. Hierfür wechselt man in einen der Modul- bzw. Elementordner und kopiert alle beinhalteten Dateien in die Zwischenablage. Diese fügt man dann in einen zuvor neu angelegten Ordner ein, der außerhalb der Modul- bzw. Elementordner liegt. Diesen Vorgang wiederholt man für alle vorhandenen Modul- und Elementordner. Beim Kopieren kann eventuell eine Sicherheitsmeldung erscheinen, welche davor warnt, dass Dateien überschrieben werden. Diese kann gefahrlos ignoriert werden, da hier nur Ordner, aber keine Dateien überschrieben werden (in jedem der Modul- und Elementordner befindet sich eine vollständige Ordnerstruktur des späteren Systems).

Wurden alle Modul- und Elementdateien kopiert, so sollte sich im Zielordner eine Struktur nach dem Schema

/
admin (Ordner)
installer (Ordner)
lang (Ordner)
portal (Ordner)
system (Ordner)
templates (Ordner)
.htaccess
download.php
favicon.ico
image.php
index.php
xml.php

befinden. Je nach gewählten Modulen können jedoch auch einzelne Dateien fehlen.
Nun kann es mit dem Schritt „Upload“ weitergehen.

Upload

Das System kann nun auf den Webserver kopiert werden. Dies erfolgt in der Regel per FTP oder SSH, bei lokalen Testumgebungen meistens ganz einfach per Dateimanager. Befindet sich das System auf dem Webserver, so kann nun mit dem Schritt „Verzeichnisrechte anpassen“ fortgefahren werden.

Verzeichnisrechte anpassen

Damit das System erfolgreich installiert und betrieben werden kann, müssen ein paar Datei- und Verzeichnisrechte vorgenommen werden. Konkret benötigt der Webserver Schreibrechte auf die folgenden Dateien/Verzeichnisse:

  • /system/config/config.php
  • /portal/pics/cache
  • /portal/pics/upload
  • /portal/downloads
  • /system/debug
  • /system/dbdumps


Die Rechte können mit allen gängigen FTP-Programmen abgeändert werden (Stichwort: chmod 0777). Sind alle Rechte angepasst, geht es mit dem Punkt „Datenbank erstellen“ weiter.

Datenbank erstellen

Die Datenbank, in welcher Kajona später installiert werden soll, muss im Vorfeld angelegt werden. Kajona benötigt hierfür nicht zwingend eine eigene Datenbank sondern kann auch in bestehende Datenbanken parallel zu anderen Systemen installiert werden. Notiert werden sollten der Name der Datenbank, der Name des Datenbankbenutzers sowie dessen Passwort.

Das Anlegen einer Datenbank erfolgt in der Regel über die Administrationsoberfläche des Webhosters oder per phpMyAdmin.

Nun kann der „Installer aufgerufen“ werden.

Installer aufrufen

Wurde die Datenbank angelegt, so erfolgt nun das Aufrufen des Installers. Dieser befindet sich im Verzeichnis /installer/.

Es sollte nun eine URL nach dem Schema www.meine-domain.xy/ aufgerufen werden. Wurde das System in einem Unterordner angelegt, so muss der Pfad natürlich um diese erweitert werden: www.meine-domain.xy/meine_unterordner/.

Als erster Schritt überprüft der Installer ob alle Rechte zuvor korrekt konfiguriert wurden. Zusätzlich werden ein paar benötigte PHP-Module auf Vorhandensein überprüft.

Wurde dieser Schritt abgeschlossen, erfolgt das Erfassen der Datenbank-Zugangsdaten. Hier sollten nun die zuvor notierten Daten eingetragen werden.

Nach dem Klick auf „write to configs“ erscheint ein weiteres Formular. In diesem können die gewünschten Zugangsdaten zur Administration erfasst werden. Konkret ist das der Benutzername und das Passwort für den späteren Admin-Zugang.

Ist auch dieser Schritt erledigt, geht es an die Installation des Systems an sich. Des Anfang machen hierbei die Module. Im nachfolgen Schritt könne dann auch die zugehörigen Seitenelemente installiert werden.

Als letzter Schritt erfolgt die Installation der Beispielinhalte. Die Installation erfolgt hier analog zur Installation der vorherigen Module.
Wurden alle Elemente und Module installiert ist die Installation abgeschlossen.

Aus Sicherheitsgründen sollte nun (per FTP) das „/installer“-Verzeichnis samt allen beinhalteten Dateien gelöscht werden. Und dann kann es weiter gehen: „Das Portal lebt“.

Das Portal lebt

Nach der Installation erfolgt der erste Test: Das Portal kann aufgerufen werden. Hierfür wird einfach der oberste Ordner des Systems aufgerufen, also, je nach dem,

www.meine-domain.xy/

oder
www.meine-domain.xy/meine_installation/.

Wurde das Modul „Samplecontent“ installiert, so erscheint nun eine vorgefertigte Beispielseite, wenn das Modul nicht installiert wurde, sollte nun eine Fehlermeldung erscheinen, welche sich über eine fehlende Startseite beschwert. Herzlichen Glückwunsch – Kajona wurde installiert. Um nun Inhalte abzuändern, erfolgt das „Anmelden an der Administration“.

Anmelden an der Administration

Um sich an der Administration anzumelden, wird der Pfad des Portals einfach um den Ordner admin/ ergänzt, also zu
www.meine-domain.xy/admin/

oder

www.meine-domain.xy/meine_installation/admin/.

Nun erscheint die Login-Oberfläche der Administration, an der man sich mit dem während der Installation angegebenen Benutzernamen samt Passwort anmelden kann.


Viel Spaß mit Kajona!

09.09.10 19:46