Installation

Du musst kein Webentwickler oder Programmierer sein, um Tiki zu installieren. Tiki beinhaltet einen einfach zu bedienenden Installationswizard (den Tiki Installer), der Dir die meiste Arbeit abnimmt. Die restlichen Einstellungen können bei Deinem Webhoster vorgenommen werden.

Wenn Du ein Anfänger bist (oder nicht gerne selbst herumtüftelst) solltest Du ggf. einen Tiki-freundlichen Hoster in Betracht ziehen. Viele von diesen erledigen die Tiki Installation ohne weitere Kosten.

Übersicht

Dieses Video bietet eine erste Übersicht über die Tiki Installation. Siehe Tiki TV und Tiki Filme für weitere Videos.

Aus Tiki für Dummies Smarties

Aus Tiki für Dummies Smarties

Basisübersicht in Tiki 3: Installation und Profile

Dieser neue Installer und die Anwendung von Profilen ist neu in Tiki3. Werfe in dem 12 Minuten-Film einen kurzen Blick hierauf:

Schritt-für-Schritt Installation

Bevor Du anfängst

Bevor Du Tiki installierst lies die Anforderungen und Setup-Informationen. Vernünftige Vorplanung erleichert Dir die spätere Installation. Wenn Du einen Webhoster benötigst, verwende die Liste der Tiki-freundlichen Hoster.

Diese Anweisungen sind bewusst allgemein gehalten und sollten dadurch für die meisten shared host Installationen geeignet sein. Weitere Informationen für bestimmte Kombinationen von Betriebssystemen und Webservern findest Du in diesen Installationsanleitungen.

Voraussetzungen

Diese Anleitung geht davon aus, dass Du:

• FTP oder SSH (shell) Zugriff auf einem Webserver hast (z.B. Apache) mit PHP5
  • Normalerweise lädst Du die Dateinen mit einem FTP Client (z.B. WinSCP oder FileZilla) hoch.
• Zugriff zu einer MySQL Datenbank hast (sollte von Deinem Webhoster bereitgestellt werden)

1.1. Datenbank erstellen

Tiki erfordert eine MySQL Datenbank.

Viele Hoster bieten eine Benutzeroberfläche mit der man die Datenbank und deren Benutzer anlegen kann. Wenn Dein Webhoster z.B. cPanel verwendet, dann kannst Du möglicherweise phpMyAdmin im Hauptmenü oder im Abschnitt mit der Bezeichnung Databases/Datenbanken sehen.

Die MySQL und phpMyAdmin Anwendungen in cPanel 11.

Das Erstellen einer Datenbank und eines Datenbankbenutzers ist sehr einfach. Im Wesentlichen erstellst Du eine leere Datenbank, die später vom Tiki Installer mit den richtigen Tabellen und Daten gefüllt wird.

Die drei Schritte der Datenbankeinrichtung

1. Erstelle eine Datenbank.
   • Du kannst der Datenbank einen bliebigen Namen geben - aber übertreibe es nicht unnötig. Du kannst z.B. einfach tiki verwenden. Abhängig von Deinem Hoster lautet der Datenbankname in phpMyAdmin dann z.B. accountname_tiki.
     Hinweis: standardmäßig verwendet Tiki UTF-8 Kodierung für die Datenbank. Wir empfehlen dringend "utf8" unter "collation"/"Kollation" bei phpMyAdmin (oder ähnlichem) auszuwählen. Siehe hierzu folgendes Bild:
     
     Wenn Du eine andere Kodierung wählst, musst Du ggf. manuell Deine ../db/local.php Datei anpassen.
     Tip: Wenn Du planst, multiple Tikis aufzusetzen, dann wähle nicht tiki als Datenbanknamen.
   • Merke Dir den Datenbanknamen, da Du ihn später noch brauchen wirst.
2. Erstelle einen Datenbankbenutzer (mit Passwort).
   • Nochmals: übertreibe es nicht mit dem Benutzernamen. Du kannst hier den gleichen Namen wie für die Datenbank wählen (siehe Schritt 1).
   • Wähle ein sicheres Passwort. Du kannst Dein Passwort und den Benutzernamen jederzeit in Deiner ../db/local.php Datei in Deinem Tiki-Verzeichnis einsehen, wenn Du diese Daten vergessen hast.
   • Merke Dir den Benutzernamen und das Passwort, da Du sie später noch brauchen wirst.
3. Weise dem unter Schritt 2 erstellten Datenbankbenutzer alle Datenbankberechtigungen zu.

Gratulation. Du hast nun eine benutzbare Datenbank und einen Datenbankbenutzer mit Passwort und den notwendigen Berechtigungen.

1.1.1. Herunterladen und Entpacken

Lade die aktuelle Version von Tiki von http://tiki.org/download auf Deinen lokalen Computer herunter.

Download Schaltfläche auf tiki.org

Aus Tiki für Dummies Smarties

Die gesamte Tiki-Datei umfasst mehr als 20 MB und steht in verschiedenen Formaten zur Verfügung.

Nachdem Du die Datei heruntergladen hast, entpacke (unzip) sie auf Deinen PC.

1.1.2. Zu Deinem Webhoster hochladen

Benutze FTP (oder SCP, SFTP, Rsync, SSH, etc.) um Dich mit Deinem Webhoster zu verbinden.

Wenn Du verbunden bist, suche das Webverzeichnis. Oftmals wird es www oder public_html genannt.
Hinweis: Der Verzeichnisname kann - je nach Webhost - verschieden sein.

Lade alls Tikidateien von Deinem PC zu Deinem Webhoster hoch.

• Wenn Du alle Dateien direkt in das Hauptverzeichnis (root) hochlädst, dann wird Tiki direkt über die URL http://www.DeineSeite.de verfügbar sein.
• Wenn Du andere Anwendungen installiert hast (oder es planst), solltest Du Tiki ggf. in ein Unterverzeichnis installieren (z.B. http://www.DeineSeite.de/tiki/). Nicht vergessen, das kann bedeuten, dass Du manuell die .htaccess-Datei in Deinem Tiki-Verzeichnis editieren musst (Als Beispiel "RewriteRule ^(.+)$ /tiki-index_raw.php?page=$1 [QSA,L]" muss ggf. zu diesem Term werden: "RewriteRule ^(.+)$ /tiki/tiki-index_raw.php?page=$1 [QSA,L]")

Zeit für etwas mehr Kaffee?

1.2. Installiere Tiki direkt aus dem SVN Repository

This method requires a. a server with shell (command line) access and b. a running SVN instance on this server.

For the SVN part please have a look the page Get Code on dev.tiki.org. There, if necessary aswell on the related pages, you find notes about the SVN commands and the particular paths you need to use in the command line to automatically checkout or update the right Tiki version into the intended installation directory (= tikiroot folder).

Example for a fresh checkout (recommended also for major upgrades)

Method 1
Checking out to a new folder (that you will specify)

$: svn checkout https://svn.code.sf.net/p/tikiwiki/code/trunk mynewfolder

Method 2
Checking out to the current folder (when you created the intended tikiroot already and changed into this directory prior to the checkout):

$: svn checkout https://svn.code.sf.net/p/tikiwiki/code/trunk .

Example for a minor update:

Do not forget to switch into the tikiroot of the Tiki you want to update

$: svn up

After your SVN instance has downloaded the Tiki files, the Tiki is not yet complete. You now have to run the composer!
The composer automatically downloads and installs the so called 'vendor files' from external sources.
Vendor files are external scripts and libraries, which we pack to the Tiki code on release time but we do not manage in our own repository.
Examples of those vendor files are the Bootstrap code, the jQuery library, Tablesorter, Elfinder etc..
Usually (= on most servers) you additionally have to fix certain file permissions.
Both can be accomplished by simply answering a number of questions after starting the setup.sh script in the shell (= command line).
This procedure is quite self-explaining. Just follow the instructions of the script.

Start setup.sh, (in the tikiroot)::

$: sh setup.sh

For more information on using setup.sh see also the section 4.1 Troubleshooting below. In this section we treat only the composer part, which is only applicable when you use an installation from the repository.

To start the composer you have to confirm the option "c" after starting the setup.sh script:

$: sh setup.sh
Your choice [c]? c

or

$: sh setup.sh
Your choice [f]? c

FAQ: On my server the composer script is not starting. What can I do, when I get the following error message?

Wrong PHP version: phpABC < required PHP version.  A version >= phpXYZ is necessary.

The problem is, that many shared hosting providers keep the setting of the default local PHP version of the shell (command-line) to an outdated PHP version which does not match the PHP requirements of Tiki or of the composer. Alternativ PHP settings in the .htaccess or in the php.ini file or in the user.ini file have no effect to the PHP version in the shell (command line).

However most of these servers have newer PHP versions available in the shell (command line), which can be used alternatively.
For Tiki 16, likely soon backported to Tiki 15, we provide an option, which allows to run the composer with an alternative up-to-date PHP version, given any one is available on the particular server.

Another issue to be addressed is, that the providers have different naming conventions how to distinguish their available PHP versions. To address this issue we implemented the option "-p" for our setup.sh script to provide the option to manually change the PHP version used by the script:

$: sh setup.sh -p PHPVERSION

In a first step, the setup.sh script automatically guesses three typically used namings of up-to-date versions, commonly used on many servers and uses the first one that matches:

php55 php5.5 php5.5-cli

If the script finds one of these, you should get the following message prior to an autostarting composer:

Wrong PHP version: phpABC < required PHP version.  A version >= phpXYZ is necessary.
Searching for typically named alternative PHP version ...
... correct PHP version phpDEF detected and used
Local PHP version >= required PHP version XYZ - good

Loading composer repositories with package information
Installing dependencies from lock file
(...)

Now you are done. Problem solved.

But if none of these options work out, you will get the following error message:

Wrong PHP version: phpABC < required PHP version.  A version >= phpXYZ is necessary.
Searching for typically named alternative PHP version ...
... no alternative php version found.
Please provide an alternative PHP version with the -p option.
Example: sh setup.sh -p phpXYZ.
You can use the command-line command 'php[TAB][TAB]' to find out available versions.

This should be quite self explaining.
You simply have to use the php command in the shell, followed by twice typing the TAB key without any space or other key and enter. then the shell (command line) will provide you a list of the available PHP versions which you can use (obviously using the naming convention used on this particular server):

Example:

$: php[TAB][TAB]
php    php-53  php-54  php-55  php-56  php-70

How to use this information:
Given the required PHP version would be php 5.5, but your provider uses php 5.3 by default, you simply need to type the following command to start setup.sh with the right PHP version for the composer (in this particular case php-55) ...

$: sh setup.sh -p php-55
Your choice [c]? c

And swoooosh the setup.sh will start the composer with php 5.5 after the following message:

Wrong PHP version: phpABC < required PHP version.  A version >= php55 is necessary.
Searching for typically named alternative PHP version ...
... correct PHP version php55 detected and used
Local PHP version >= required PHP version 55 - good

Now you need only to follow the setup.sh dialog to fix directory permissions (option f is reasonably secure works on most average servers. If you need a more secure setting or if your server needed a less restrictive setting (better change the server then), you can use another option. To find out which permission option is best n your server, you can use Permission Check.

You are done now and can go to your website to run the installer.

1.3. Installiere eine Tiki Release Datei

1.3.1. Gehe zu Deiner Website.

Öffne Deinen Webbrowser und öffne das Webverzeichnis, in welches Du die Tiki-Dateien kopiert hast (z.B. http://www.DeineSeite.de/tiki/ oder einfach nur http://www.DeineSeite.de wenn Du alles in das Hauptverzeichnis kopiert hast.

Der Tiki Installer Willkommenbildschirm erscheint.

Von Tiki für Dummies Smarties

Der Tiki Installer Willkommenbildschirm erscheint.



Von Tiki für Dummies Smarties

Der Tiki Installer Willkommenbildschirm erscheint.



Von Tiki für Dummies Smarties

Du solltest eine Nachricht sehen, dass Tiki sich nicht mit der Datenbank verbinden konnte und Dich auffordert, den Tiki Installer (tiki-install.php) aufzurufen.

Diese Nachricht ist normal und zeigt an, dass alles für die Installation von Tiki bereit ist.

Der Tiki Installer beinhaltet wichtige Links zu den ReleaseNotes und zur Documentation. Schaue Dir diese Dokus sicherheitshalber vor der Installation an.

Fehlerbehebung

Wenn Dein Browser eine Fehlermeldung wie z.B. Parse error: syntax error, unexpected T_STRING ausgibt, dann hast Du möglicherweise eine falsche PHP Version.

Ab Tiki 3.0, erfordert Tiki PHP5. Überprüfe die _htaccess Datei in der Tiki-Archivdatei für weitere Anweisungen, wie PHP5 zu aktivieren ist.

In den Installations-FAQs erhälst Du weitere Hilfe.

Dateien- und Ordnerberechtigungen

Wenn Dein Server nicht mit den Berechtigungen von Tiki für Dateien und Ordner zurecht kommt (ist abhängig von der Serverkonfiguration), dann erhälst Du ggf. Fehlermeldungen oder leere Seiten. Diese fehgeschlagenen Versuche erscheinen typischerweise in den Fehlerlogs (frage bei Deinem Webhoster nach, wo diese gespeichert sind, da dies setup-abhängig unterschiedlich sein kann)

Zu wenige Berechtigungen
Erscheint eine Nachricht, dass ein Verzeichnis nicht beschrieben werden kann, müssen die Berechtigungen für dieses Verzeichnis geändert werden. Tiki wird versuchen zu prüfen, ob es alle erforderlichen Verzeichnis beschreiben (und lesen) kann. Die Fehlermeldung enthält Anweisungen, wie dieses Problem gelöst werden kann.

Zu viele Berechtigungen
Erscheint ein Interner Server Fehler 500, leere Seiten oder ähnliches kann es sein, dass die Berechtigungen für Deinen Webhoster nicht geeignet sind. Eventuell ist auch das Memory-Limit zu gering.

Wenn Deine Berechtigungen gegenwärtig "777" lauten, dann benutze Deinen FTP-Client um die Dateien auf "755" zu ändern. Wenn Tiki in einen Unterordner installiert wurde, dann muss auch dieser Ordner entsprechend geändert werden.

Wenn Du Kommandozeilenzugriff hast, kannst Du auch:

sh setup.sh

aufrufen und entsprechende Werte eintragen. Wenn Du nicht weist, was anzugeben ist, kannst Du auch einfach "enter" drücken um die Standardwerte zu behalten.

Wenn "sh setup.sh" für Dich nicht funktioniert kannst Du auch in Deinem ./tiki/ Verzeichnis

chmod -R 777 ./db ./dump ./img/wiki ./img/wiki_up ./img/trackers ./modules/cache ./temp ./temp/cache ./templates_c ./templates ./styles ./whelp/

eingeben.

Ein anderer Weg wäre zuerst die Berechtigungen für alle Verzeichnisse und dann für alle Dateien zu setzen. Um alle Verzeichnisse auf 777 und die Berechtigungen für alle Dateien auf 644, zu setzen, benutze folgende Befehle, getrennt nacheinander, in der Kommandozeile:

find [DEIN_VERZEICHNIS] -type d -exec chmod 777 {} \;

find [DEIN_VERZEICHNIS] -type f -exec chmod 644 {} \;

Nachdem Du alle Verzeichns- und Dateiberechtigungsprobleme behoben hast, rufe tiki-install.php auf um fortzufahren.

1.1. Starte nur den Tiki Installer (tiki-install.php)

Öffne Deinen Webbrowser mit: http://www.DeineSeite.de/tiki-install.php (oder http://www.DeineSeite.de/tiki/tiki-install.php wenn Du Tiki in das Unterverzeichnis tiki installiert hast.

Die erste Seite des Tiki Installer erscheint. Dieser Installer erlaubt Dir:

• Eine Sprache zu wählen
• Deine Servereinstellungen zu testen
  • Wenn der Installer feststellt, dass bestimmte Servereinstellungen unpassend sind, schlägt er entsprechende Änderungen vor, um die Anforderungen zu erfüllen.
• Den Datenbankserver, Datenbanknamen, Datenbankbenutzer mit seinem Passwort einzutragen.
  Dies sind die Informationen der Datenbank, die Du zuvor erstellt hast. Du hast Dir die Daten gut gemerkt, oder? Für einen anderen Port benutze die Syntax "example.com;port=3307"
• Eine Datenbank zu erstellen/aktualisieren
• Einige Einstellungen (wie die Emailadresse des Administrators) einzustellen
• Das Installer-Skript zu deaktivieren
• und weiteres

Vervollständige jede Seite des Tiki Installer.

Alternativer "Schritt 5" ohne tiki-install.php

Wenn Du nicht in der Lage bist, den Tiki Installer abzuschließen, musst Du mit einer manuellen Installation fortfahren.

1.2. Zum ersten Mal anmelden

Melde Dich in der Login Box in der rechten Spalte an.

1. Trage diese Informationen ein:
   1. Benutzer: Trage admin ein
   2. Passwort: Trage admin ein
2. Klicke auf Login.

1.3. Ändere das Standardpasswort.

Wähle ein sicheres Passwort. Ggf. solltest Du Dich gleich ausloggen und Dein neues Passwort verwenden, damit Dein Passwortmanager dieses aufzeichnen kann..

1.4. Gratulation!

Es ist zu empfehlen, einen neuen Benutzer zu erstellen und ihn Administratorrechte zu geben anstelle regelmäß das admin-Konto zu verwenden. Du kannst nun die Benutzeroberfläche erforschen, solltest aber noch ein paar zusätzliche Schritte durchführen, bevor Du loslegst.

1.5. Konfiguriere Deine Tiki

Unter Eingangskonfiguration werden die nächsten, empfohlenden Schritte erklärt. Unter Konfiguration findet sich eine Tabelle der Inhalte, die sich mit der Konfiguration beschäftigen.

Neue Funktionen durch Profile hinzufügen

Beginnend mit Tiki3 kannst Du nun in einem Schritt verschiedene Einstellungen/Berechtigungen/Inhalte vorgeben um Tiki auf verschiedene Benutzungsmöglichkeiten vorzubereiten (z.B. um Tiki multilingual zu machen, Freetags hinzuzufügen, es als Kollaborative Umgebungen zu konfigurieren ...). Hierfür benötigst Du nur wenige Klicks durch den Profilmanager unter "Verwalten > Profile".

Unter Profile kannst Du mehr hierüber erfahren.

Für weitere Informationen über die Tiki Installation...

Verwandte Seiten: