#########################################################
#  vBulletin 4 (Deutsch) Installation / Aktualisierung  #
#########################################################

Inhaltsverzeichnis

* Inhalt des vBulletin 4 Pakets
* Anleitung fr die Installation
* Anleitung fr die Aktualisierung von vBulletin 3.5.4 - 3.8.x auf vBulletin 4
* Anleitung fr die Aktualisierung einer lteren vBulletin 4 Version auf die aktuelle vBulletin 4 Version
* Anleitung fr die Aktualisierung von lteren Versionen (lter als vBulletin 3.5.4)
* Upgrade in der Kommandozeile (Shell) ausfhren
* Anhang: Weitere Informationen


Inhalt des vBulletin 4 Pakets
=============================

- upload/ (Dieses Verzeichnis enthlt alle Dateien von vBulletin, die Sie fr die
  Installation bzw. Aktualisierung auf Ihren Server hochladen mssen.)
  Bitte lesen Sie die Anweisungen weiter unten, um zu erfahren, welche Dateien Sie
  anpassen und welche Sie nach der Installation/der Aktualisierung lschen mssen.

- do_not_upload/ (Dieses Verzeichnis enthlt Dateien, die Sie im Normalfall nicht
  bentigen. Verwenden Sie diese Dateien nur, wenn Sie vom vBulletin-Support dazu
  aufgefordert wurden oder wenn Sie genau wissen, was Sie damit machen knnen.)
  - indexscript.php (Mit diesem Skript knnen Sie festlegen, ob die index.php
    standardmig das vBulletin-CMS oder das vBulletin-Forum anzeigen soll.)
  - Datei: tools.php (Mit diesem Skript knnen Sie u.a. Anmelde-Probleme beheben,
    die XML-Dateien erneut importieren, einem Benutzer Administrator-Rechte geben,
    den Cache aktualisieren, etc.)
  - Datei: searchindex.php (Mit diesem Skript knnen Sie den Suchindex via Telnet-/
    SSH-Zugang direkt ber die Shell-Konsole aufbauen.)
  - Datei: vb_backup.sh (Mit diesem Skript knnen Sie die Datenbank via Telnet-/
    SSH-Zugang direkt ber die Shell-Konsole sichern, ideal fr nchtliche Backups
    via Cron Jobs.)

- lizenzvereinbarung.html (Alle Kunden mssen der Lizenzvereinbarung beim Herunterladen
  von vBulletin und vor der Installation zustimmen.

- vb4_liesmich.html (HTML-Version der Informationen zur Installation / Aktualisierung
  von vBulletin)

- vb4_liesmich.txt (Text-Version der Informationen zur Installation / Aktualisierung
  von vBulletin)

- vb4_template-syntax.html (bersicht der neuen vBulletin 4 Template-Syntax)

___________________________________________________________________________________

Anleitung fr die Installation
==============================

Entpacken Sie das aus dem Kundenbereich heruntergeladene vBulletin-Paket auf Ihrer
Festplatte

ffnen Sie das Verzeichnis /upload/includes/. Darin finden Sie die Datei
config.php.new. Benennen Sie diese Datei in config.php um und ffnen Sie sie mit
einem Standard-Texteditor.

Die config.php ist durchgehend kommentiert, d.h. es sollte kein Problem sein, die
Werte fr die Variablen entsprechend einzutragen. Dazu gehren u.a.: Name der
Datenbank, Benutzername und Kennwort fr die Datenbank, Datenbank-Server, usw.

Suchen Sie z.B. diese Zeile:

$config['Database']['dbname'] = 'forum';

Die Angabe forum mssen Sie mit dem korrekten Namen Ihrer MySQL-Datenbank ersetzen.

Wenn Sie fertig sind, speichern Sie die Datei und laden Sie den gesamten Inhalt des
upload-Verzeichnisses auf Ihren Server.

Wenn Sie mit dem Hochladen fertig sind, ffnen Sie im Browser die URL
http://www.ihredomain.de/forum/install/install.php, wobei www.ihredomain.de/forum/
die URL Ihrer vBulletin 4 Dateien ist.

Geben Sie Ihre Kundennummer ein und klicken Sie auf Installation starten.

Nach einiger Zeit werden Sie vom Skript aufgefordert, einige Angaben zu Ihrem
Forum zu machen. 

Nachdem Sie die Eingaben gemacht haben, werden Sie nach einigen Benutzerdaten
gefragt, um Sie als Administrator fr das neue vBulletin einzurichten. Ein paar
Klicks spter ist das Skript fertig.

Bevor Sie sich in das Administrator-Kontrollzentrum begeben, lschen Sie bitte aus
Sicherheitsgrnden das komplette install Verzeichnis von Ihrem Server. Danach knnen
Sie das Kontrollzentrum betreten und die Arbeit mit Ihrem neuen vBulletin beginnen. 

___________________________________________________________________________________

Anleitung fr die Aktualisierung von vBulletin 3.5.4 - 3.8.x auf vBulletin 4
============================================================================


*****************************************************************************
Wichtige Hinweise VOR der Aktualisierung von vBulletin 3.x auf vBulletin 4.x:
*****************************************************************************

- berprfen Sie unbedingt die Kollation Ihrer Datenbank mit phpMyAdmin.
  Lesen Sie dazu bitte dieses Thema:
  http://www.vbulletin-germany.com/forum/showthread.php?t=45959

- Falls mglich, sollten Sie die Aktualisierung zuerst mit einem Testforum durchfhren:

  1. Erstellen Sie dazu eine Sicherung der vBulletin-Datenbank (z.B. mit der Software
     MySQLDumper - http://www.mysqldumper.de/) und importieren Sie diese in eine neue
     Datenbank. 
  2. Kopieren Sie alle Dateien der alten vBulletin-Version in ein neues Verzeichnis.
     Dazu gehren auch die Anhnge, Albumbilder, etc., falls diese im Dateisystem
     gespeichert werden. 
  3. Bearbeiten Sie die Datei /includes/config.php (in der Kopie des Forums!) und
     ndern Sie den Namen der Datenbank auf die neu erstellte Datenbank. 
  4. Testen Sie, ob die Kopie Ihres Forums problemlos funktioniert. Falls Sie sich
     nicht anmelden knnen, haben Sie vermutlich einen Cookie-Pfad festgelegt, der
     mit der Kopie nicht funktioniert. Fr vBulletin 4 ist es auch wichtig, dass die
     "URL des Forums" richtig ist. Laden Sie bitte die Datei "/do_no_upload/tools.php"
     aus dem vBulletin-Paket in das Verzeichnis "admincp" auf Ihren Server hoch und
     fhren Sie diese Datei im Browser aus. Setzen Sie damit alle Cookie-Einstellungen
     zurck und korrigieren Sie die "URL des Forums". 
  5. Wenn die Kopie Ihres Forums funktioniert, fhren Sie die Aktualisierung auf
     vBulletin 4 mit der untenstehenden Anleitung durch. 
  6. Testen Sie nach der Aktualisierung, ob alle Bereiche von vBulletin 4 funktionieren.
     Danach knnen Sie Ihr "Live"-Forum aktualisieren. 


- Die alten CSS-Einstellungen der Styles sind in vBulletin 4 nicht mehr gltig.
  Da darber hinaus auch so gut wie alle Templates in vBulletin 4 gendert wurden,
  werden bei der Aktualisierung alle alten Styles automatisch deaktiviert. Es wird
  ein neuer Standard-Style angelegt, der die Standard-Templates und Standard-
  Stylevariablen von vBulletin 4 verwendet.
- Die CSS-Klassen (Farben, Schriftarten, etc.) knnen Sie in vBulletin 4 ber
  die Stylevariablen ndern.
- Um Fehler bei der Aktualisierung zu vermeiden, werden bei der Aktualisierung
  auf vBulletin 4.x alle Add-ons und Plug-ins automatisch deaktiviert. Bitte
  berprfen Sie nach der Aktualisierung, ob die Add-ons/Plug-ins mit vBulletin 4
  kompatibel sind und fhren Sie gegebenenfalls ein Update durch, bevor Sie sie
  wieder aktivieren. 
- Nach der Aktualisierung mssen Sie einige Wartungsfunktionen ausfhren, dazu
  gehren: 
  - Themen-Informationen neu erstellen
  - Forum-Informationen neu erstellen
  - Fehlende Stichworte hinzufgen
  - Suchindex neu erstellen

  Hinweis: Bei greren Foren knnen einige der Wartungsfunktionen sehr lange dauern
  und den Server stark belasten. Sie sollten das Forum whrenddessen noch geschlossen
  lassen. 

  Die Wartungsfunktionen finden Sie hier:
  Administrator-Kontrollzentrum -> Wartung -> Wartungsfunktionen


Anleitung: 
----------

Schlieen Sie Ihr Forum ber das Administrator-Kontrollzentrum:
vBulletin-Einstellungen -> vBulletin ein- und ausschalten -> Ist das Forum aktiv? -> Nein

Alternativ knnen Sie das Forum-Verzeichnis auch mit einem .htaccess-Passwortschutz
schtzen (falls mglich). Mit diesem Passwortschutz verhindern Sie, dass Ihre Benutzer
whrend des Upgrades Fehlermeldungen sehen und dadurch verunsichert werden.

Erstellen Sie bitte eine komplette Sicherung Ihrer Datenbank. Dies knnen Sie mit
dem folgenden Befehl von der System-Befehlszeile (z.B. in der Shell via SSH/Telnet)
erledigen: 

mysqldump --add-drop-table -u benutzername -p datenbankname > datenbankname.sql

Sie knnen die Datenbank auch mit der Software MySQLDumper sichern:
http://www.mysqldumper.de/

Sichern Sie alle Dateien der alten vBulletin-Version. Dazu gehren auch die Anhnge,
Albumbilder, etc., falls diese im Dateisystem gespeichert werden. 

Vergewissern Sie sich bitte unbedingt, dass alle gesicherten Dateien und die
Datenbank-Sicherung vollstndig und fehlerfrei sind. . Die beste Mglichkeit dafr
ist, die Sicherung in einer neuen Datenbank einzuspielen und zu testen, ob die alte
vBulletin-Version problemlos mit der Sicherung funktioniert.

Laden Sie danach alle Dateien aus dem upload-Verzeichnis des vBulletin-Pakets auf
Ihren Server, mit Ausnahme der /install/install.php und /includes/config.php.new 

ffnen Sie im Browser die URL http://www.ihredomain.de/forum/install/upgrade.php
wobei www.ihredomain.de/forum/ die URL Ihrer vBulletin 4 Dateien ist. Sie sollten
nun automatisch zum passenden Upgrade-Skript weitergeleitet werden.

Alternativ knnen Sie das Upgrade in der Kommandozeile (Shell) ausfhren,
was bei greren Foren Timeout-Fehler vermeiden kann.
Informationen dazu finden Sie weiter unten.

Geben Sie Ihre Kundennummer ein, klicken Sie auf Upgrade starten und folgen Sie den
weiteren Anweisungen.

Sobald das Skript fertig ist, knnen Sie das Administrator-Kontrollzentrum betreten und
Ihr Forum wieder ffnen:
vBulletin-Einstellungen -> vBulletin ein- und ausschalten -> Ist das Forum aktiv? -> Ja

Entfernen Sie auch den .htaccess-Passwortschutz, falls Sie diesen eingerichtet haben.

Nach der Aktualisierung sollten Sie aus Sicherheitsgrnden das komplette install
Verzeichnis von Ihrem Server lschen. 

___________________________________________________________________________________

Anleitung fr die Aktualisierung einer lteren vBulletin 4 Version auf die aktuelle vBulletin 4 Version
=======================================================================================================

Schlieen Sie Ihr Forum ber das Administrator-Kontrollzentrum:
vBulletin-Einstellungen -> vBulletin ein- und ausschalten -> Ist das Forum aktiv? -> Nein

Alternativ knnen Sie das Forum-Verzeichnis auch mit einem .htaccess-Passwortschutz
schtzen (falls mglich). Mit diesem Passwortschutz verhindern Sie, dass Ihre Benutzer
whrend des Upgrades Fehlermeldungen sehen und dadurch verunsichert werden.

Erstellen Sie bitte eine komplette Sicherung Ihrer Datenbank. Dies knnen Sie mit
dem folgenden Befehl von der System-Befehlszeile (z.B. in der Shell via SSH/Telnet)
erledigen: 

mysqldump --add-drop-table -u benutzername -p datenbankname > datenbankname.sql

Sie knnen die Datenbank auch mit der Software MySQLDumper sichern:
http://www.mysqldumper.de/

Vergewissern Sie sich bitte unbedingt, dass die Datenbank-Sicherung vollstndig
und fehlerfrei ist. Die beste Mglichkeit dafr ist, die Sicherung in einer neuen
Datenbank einzuspielen und zu testen, ob die alte vBulletin-Version problemlos mit
der Sicherung funktioniert.

Laden Sie danach alle Dateien aus dem upload-Verzeichnis des vBulletin-Pakets auf
Ihren Server, mit Ausnahme der /install/install.php und /includes/config.php.new.
Das Verzeichnis /install/cmsdefaultdata/attachments mssen Sie auch nicht erneut
hochladen. 

ffnen Sie im Browser die URL http://www.ihredomain.de/forum/install/upgrade.php
wobei www.ihredomain.de/forum/ die URL Ihrer vBulletin 4 Dateien ist. Sie sollten
nun automatisch zum passenden Upgrade-Skript weitergeleitet werden.

Alternativ knnen Sie das Upgrade in der Kommandozeile (Shell) ausfhren,
was bei greren Foren Timeout-Fehler vermeiden kann.
Informationen dazu finden Sie weiter unten.

Geben Sie Ihre Kundennummer ein, klicken Sie auf Upgrade starten und folgen Sie den
weiteren Anweisungen.

Sobald das Skript fertig ist, knnen Sie das Administrator-Kontrollzentrum betreten und
Ihr Forum wieder ffnen:
vBulletin-Einstellungen -> vBulletin ein- und ausschalten -> Ist das Forum aktiv? -> Ja

Entfernen Sie auch den .htaccess-Passwortschutz, falls Sie diesen eingerichtet haben.

Nach der Aktualisierung sollten Sie aus Sicherheitsgrnden das komplette install
Verzeichnis von Ihrem Server lschen. 

___________________________________________________________________________________

Anleitung fr die Aktualisierung von lteren Versionen
======================================================

Fr die Aktualisierung auf vBulletin 4 muss Ihre bestehende Installation mindestens
mit vBulletin 3.5.4 laufen.

Bitte laden Sie daher zuerst Version 3.5.4 oder eine andere, neuere Version von
vBulletin 3.x herunter und fhren Sie damit eine Aktualisierung Ihrer
vBulletin-Version durch. 

Danach knnen Sie mit der Anleitung fr die Aktualisierung von vBulletin 3.5.4 - 3.8.x
auf vBulletin 4 weiter oben fortfahren.

Wenn Sie dabei Hilfe bentigen, kontaktieren Sie bitte den vBulletin-Support:
http://members.vbulletin-germany.com/membersupport_contactform.php

___________________________________________________________________________________

Upgrade in der Kommandozeile (Shell) ausfhren
==============================================

Wechseln Sie in das install Verzeichnis von vBulletin und geben Sie dort einfach
folgenden Befehl ein:

php -f upgrade.php


Um Probleme mit Rechten zu vermeiden (wenn man als root angemeldet ist), kann es
notwendig sein, dass man das Skript mit den Rechten des Webserverbenutzers
ausfhren muss, z.B. wenn CSS als Dateien gespeichert wird.

In dem Fall wre der Aufruf

sudo -u <user> php -f upgrade.php

wobei <user> mit dem Benutzer zu ersetzen ist, unter dem der Webserver luft. 

___________________________________________________________________________________

Anhang: Weitere Informationen
=============================

Hier finden Sie einige wichtige Links:

- vBulletin-Germany Kundenbereich:
  http://members.vbulletin-germany.com/
- vBulletin-Germany Support-Forum:
  http://www.vbulletin-germany.com/forum/
- vBulletin-Germany Support kontaktieren:
  http://members.vbulletin-germany.com/membersupport_contactform.php

___________________________________________________________________________________


Copyright 2000-2011 Adduco Digital e.K. und vBulletin Solutions, Inc.
Alle Rechte vorbehalten.
