Installation und Update

// $Id: INSTALL.txt,v 1.20 2005/04/23 05:07:08 unconed Exp $
Übersetzt von "Landi":http://www.drupalcenter.de/user/55 12.08.2005

h3. Inhalt dieser Datei

* Anforderungen
* Optionale Anforderungen
* Installation
* Drupal Administration
* Theme(s) anpassen
* Upgrading
* Mehr Information

h3. Anforderungen

Drupal benötigt einen Web-Server, PHP4 (4.3.3 oder höher) oder PHP5 (http://www.php.net/) und MySQL (http://www.mysql.de/) oder PostgreSQL (http://www.postgresql.org/) Datenbank.

bq. NOTE: Es wird ausdrücklich empfohlen Apache als Web-Server und MySQL als Datenbank zu benutzen;
Andere Web-Server und Datenbankenkombbinationen wie IIS und PostgreSQL sind möglich aber weniger getestet.

h3. Optionale Anfoderungen

* Um XML-basierte Dienste wie die Blogger API, Jabber, RSS-Syndication zu benutzen, wird PHP's XML Erweiterung benötigt. Diese Erweiterung ist "enabled"(eingeschaltet), bei einer Standard PHP4 Installation.

* Wenn Sie Unterstützung für saubere URLs brauchen, benötigen Sie "mod_rewrite" und die Möglichkeit die lokalen .htaccess Dateien zu bearbeiten.

h3. Installation

1. DRUPAL HERUNTERLADEN

Sie können die aktuellste Version von Drupal von http://drupal.org/ herunterladen. Die Dateien sind im .tar.gz Format und können mit den mesiten Packprogrammen entpackt werden. Eine typische Befehlszeile für ein Unixsystem wäre:

Das erstellt ein neues Verzeichnis @drupal-x.x.x/@ was alle Drupaldateien und Verzeichnisse beinhaltet. Bewegen Sie den Inhalt dieses Verzeichnisses in das "root" Verzeichnis Ihres Webservers, oder in Ihr Verzeichnis welches die HTML Seiten beinhaltet (public_html), (var/www/html).

Befehlszeile hierfür:

2. DIE DRUPAL DATENBANK ERSTELLEN

Dieser Schritt ist nur nötig wenn Sie noch keine Datenbank installiert haben.
(Evtl. den Provider nach Zugangsdaten kontaktieren).
Wenn Sie Ihre Datenbank über ein Webinterface bearbeiten....

|||| -----PHPMYADMIN----BESCHREIBUNG FOLGT---------

Hier die Befehlszeilen Version:

Diese Anleitung ist für MySQL, wenn Sie eine andere Datenbank benutzen nehmen
Sie bitte die Dokumentation zu rate.
Im folgendem Beispiel 'dba_user' ist ein Beispiel MySQL-Benutzer welcher
"CREATE" und "GRANT" Privilegien hat.

Benutzen Sie Ihren entsprechenden Benutzernamen dür Ihr System.

Als erstes müssen wir eine neue Datenbank für unsere Drupalseite
erstellen, wir nennen Sie hier mal unverfänglich 'drupal':

MySQL fragt nach einem Passwort für die Datenbank und erstellt dann die Datenbankdateien
Nun müssen Sie sich einloggen und die Datenbankrechte setzen.

Wieder wird MySQL nach dem Passwort für die 'dba_user' Datenbank fragen
An der MySQL Eingabeaufforderung geben Sie ein:

Bedeutung:

'drupal' is der Name der Datenbank
'nobody@localhost' ist der Benutzername von Ihrem Webserver MySQL account
'password' ist das Passwort was benötigt wird um sich als MySQL User anzumelden

Bei Erfolg antwortet MySQL mit:

Um die neuen Berechtigungen zu aktivieren geben Sie folgendes ein:

und dann "Enter" drücken danach '\q' um MySQL zu verlassen.

3. DIE DRUPAL DATENBANK STRUKTUR LADEN.

Wenn Sie die Datenbank erstellt haben müssen Sie die benötigten Tabellen
in die Datenbank laden.
Wenn Sie Ihre Datenbank über ein Webinterface bearbeiten

|||| -----PHPMYADMIN----BESCHREIBUNG FOLGT---------

Auf der Befehlszeile geben Sie ein (wieder ersetzen Sie bitte 'nobody und 'drupal'
mit Ihrem MySQL Beutzernamen und den Namen Ihrer Datenbank:

4. VERBINDEN ZU DRUPAL

Die Standardkonfiguration finden Sie in der Datei im Verzeichnis /sites/default/settings.php
von Ihrer Drupal Installation.
Bevor Sie Drupal laufen lassen, müssen Sie die Datenbank-URL und die
Basisurl zu Ihrer Webseite eintragen.
Öffnen Sie die settings.php und editieren Sie die $db_url Zeile passend zu den
Datenbankeinstellungen die in den vorherigen Schritten gemacht worden sind.

Bedeutung:

'username', 'password', 'localhost' und 'database' sind:
Benutzername, passwort, host und Datenbankname für Ihre Einstellungen

$base_url Zeigt auf Ihre Drupalseite:

Eine einzige Drupal Installation kann mehrere verschiedene Dupalseiten
verwalten natürlich mit unterscheidlichem Inhalt.
Wenn Sie das nicht benötigen überspringen Sie einfach diese Sektion.

//////////Ich überspringe das hier auch mal fix :)
--Additional site configurations are created in subdirectories within
the 'sites' directory. Each subdirectory must have a 'settings.php'
file which specifies the configuration settings. The easiest way to
create additional sites is to copy the 'default' directory and modify
the 'settings.php' file as appropriate. The new directory name is
constructed from the site's URL. The configuration for www.example.com
could be in 'sites/example.com/settings.php' (note that 'www.' should
be omitted if users can access your site at http://example.com/).

Sites do not each have to have a different domain. You can use
subdomains and subdirectories for Drupal sites also. For example,

example.com, sub.example.com, and sub.example.com/site3 can all be
defined as independent Drupal sites. The setup for a configuration
such as this would look like the following:

sites/default/settings.php
sites/example.com/settings.php
sites/sub.example.com/settings.php
sites/sub.example.com.site3/settings.php

When searching for a site configuration (for example
www.sub.example.com/site3), Drupal will search for configuration
files in the following order, using the first configuration it finds:

sites/www.sub.example.com.site3/settings.php
sites/sub.example.com.site3/settings.php
sites/example.com.site3/settings.php
sites/www.sub.example.com/settings.php
sites/sub.example.com/settings.php
sites/example.com/settings.php
sites/default/settings.php

Each site configuration can have its own site-specific modules and
themes that will be made available in addition to those installed
in the standard 'modules' and 'themes' directories. To use
site-specific modules or themes, simply create a 'modules' or
'themes' directory within the site configuration directory. For
example, if sub.example.dom has a custom theme and a custom module
that should not be accessible to other sites, the setup would look
like this:

sites/sub.example.com/:
settings.php
themes/custom_theme
modules/custom_module

NOTE: for more information about multiple virtual hosts or the
configuration settings, consult the Drupal handbook at drupal.org.
////////////////////

5. DRUPAL Konfigurieren

Sie sollten in Ihrem Drupal Verzeichniss einen Ordner "files" Anlegen.
Für zum Beispiel: Logos; Avatare und oder Mediendateien für Ihre
neue Seite. Der Ordner "files" muss "lese und schreibrechte" für
das Drupalsystem haben. Sie können den Namen des Verzeichnisses
später über den Menuepunkt "Administer" ->> "settings" ->> "File system settings" ändern.

Sie können dann Ihren Browser(Vieleicht mit Firefox) starten
und zu Ihrer Drupalseite surfen.

Legen Sie den ersten Benutzer an und melden Sie sich an.
Der erste Benutzer hat automatisch Administrator-Rechte
Mit voller Kontrolle.

6. CRON TASKS

Viele Drupal Module (Wie die Suchfunktion) haben periodische
tasks die von einem Cron Job abgearbeitet werden müssen.
Um diese Tasks zu aktivieren rufen Sie Ihre Seite folgendermaßen auf:
http://www.example.com/cron.php -- das wars. Die Module
entscheiden nun selber was und wann Sie etwas tun.

Die meisten System unterstützen "crontabs" für zeitabhängige
Tasks wie dieses Bespiel, das jede "Stunde" einen Cron Task
automatisch startet:

Mehr Informationen über die Cronskripte finden Sie auf den Admin
Hilfe Seiten und im Drupal Handbuch auf drupal.org (ENGLISCH).
Beispiel-Skripte sind in dem "scripts/" Verzeichnis

DRUPAL ADMINISTRATION
---------------------

Auf einer neuen Installation ihrer Drupal Webseite sind
nur einige Module Aktiv und nur ein Theme und keine Benutzer-Rechte.

Benutzen Sie das Administrationspanel (Administer) um Dienste zu aktivieren.
Zum Beispiel ein paar generelle Einstellung Ihrer Seite:
"Administer > Users > Configure > Permissions" für Benutzer-Rechte

Für mehr Informationen für die Konfiguration der verschiedenen
Einstellungen benutzen Sie die Hilfe Seiten in dem Administraionpanel
Community-erstellte Module und Themes sind auf www.drupal.org verfügbar.

Personalisieren ihrer THEME(S)
-------------------------

Jetzt wo Ihr Server rennt, wollen Sie sicherlich das aussehen der Seite anpassen.
Einige Beispiel Themes sind schon in der Drupalinstallation enthalten.
Neue Themes bekommen Sie auf drupal.org.

Jedes Theme enthält einen PHP file ThemeName.theme was eine function header()
was bearbeitet werden kann um eigene Logos anzulegen
Jedes Theme ist also abhängig von der Engine.

Die meisten Themes enthalten "Stylesheets" um Farben und Layouts
zu verändern. Suchen Sie diese in dem themes/ verzeichnis meistens
liegt alternativen Themes eine "Readme" bei.

UPGRADING
---------

1. Machen Sue eine Sicherung Ihrer Daten besonders die Konfigurationsdatei
ist sehr wichtig 'sites/default/settings.php'.

2. Einloggen als Benutzer mit der ID 1. (Der erste Benutzer der angelegt wurde).

3. Entfernen Sie alle alten Drupaldateien und entpacken Sie die neuen
in dem Verzeichnis wo Ihre Drupalinstallation läuft.

4. Modifizieren Sie die neue Konfigurationsdatei und stellen sie sicher
das sie die aktuelltsten und richtigen Informationen eingetragen haben.

5. Starten Sie die update.php mit dem Aufruf der Seite: "http://www.example.com/update.php".

MEHR INFORMATION
----------------
Für Plattfom spezielle Konfigurationen und Probleme und Administrationsbeistand,
nehmen Sie bitte immer erst das Drupal Handbuch auf Drupal.org zur Hand.
Hilfe bekommen Sie natürlich auch im Forum und in der Mailingliste.