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

Inhaltsverzeichnis

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


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

- upload/ (Dieses Verzeichnis enthält alle Dateien von vBulletin, die Sie für die
  Installation bzw. Aktualisierung auf Ihren Server hochladen müssen.)
  Bitte lesen Sie die Anweisungen weiter unten, um zu erfahren, welche Dateien Sie
  anpassen und welche Sie nach der Installation/der Aktualisierung löschen müssen.

- do_not_upload/ (Dieses Verzeichnis enthält Dateien, die Sie im Normalfall nicht
  benötigen. Verwenden Sie diese Dateien nur, wenn Sie vom vBulletin-Support dazu
  aufgefordert wurden oder wenn Sie genau wissen, was Sie damit machen können.)
  - indexscript.php (Mit diesem Skript können Sie festlegen, ob die index.php
    standardmäßig das vBulletin-CMS oder das vBulletin-Forum anzeigen soll.)
  - Datei: tools.php (Mit diesem Skript können 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 können Sie den Suchindex via Telnet-/
    SSH-Zugang direkt über die Shell-Konsole aufbauen.)
  - Datei: vb_backup.sh (Mit diesem Skript können Sie die Datenbank via Telnet-/
    SSH-Zugang direkt über die Shell-Konsole sichern, ideal für nächtliche Backups
    via Cron Jobs.)

- lizenzvereinbarung.html (Alle Kunden müssen 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 für 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 für die Variablen entsprechend einzutragen. Dazu gehören u.a.: Name der
Datenbank, Benutzername und Kennwort für die Datenbank, Datenbank-Server, usw.

Suchen Sie z.B. diese Zeile:

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

Die Angabe forum müssen 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 für das neue vBulletin einzurichten. Ein paar
Klicks später ist das Skript fertig.

Bevor Sie sich in das Administrator-Kontrollzentrum begeben, löschen Sie bitte aus
Sicherheitsgründen das komplette install Verzeichnis von Ihrem Server. Danach können
Sie das Kontrollzentrum betreten und die Arbeit mit Ihrem neuen vBulletin beginnen. 

___________________________________________________________________________________

Anleitung für 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:
*****************************************************************************

- Überprüfen 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 möglich, sollten Sie die Aktualisierung zuerst mit einem Testforum durchführen:

  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 gehören auch die Anhänge, 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 können, haben Sie vermutlich einen Cookie-Pfad festgelegt, der
     mit der Kopie nicht funktioniert. Für 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
     führen Sie diese Datei im Browser aus. Setzen Sie damit alle Cookie-Einstellungen
     zurück und korrigieren Sie die "URL des Forums". 
  5. Wenn die Kopie Ihres Forums funktioniert, führen 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 können Sie Ihr "Live"-Forum aktualisieren. 


- Die alten CSS-Einstellungen der Styles sind in vBulletin 4 nicht mehr gültig.
  Da darüber hinaus auch so gut wie alle Templates in vBulletin 4 geändert 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.) können 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
  überprüfen Sie nach der Aktualisierung, ob die Add-ons/Plug-ins mit vBulletin 4
  kompatibel sind und führen Sie gegebenenfalls ein Update durch, bevor Sie sie
  wieder aktivieren. 
- Nach der Aktualisierung müssen Sie einige Wartungsfunktionen ausführen, dazu
  gehören: 
  - Themen-Informationen neu erstellen
  - Forum-Informationen neu erstellen
  - Fehlende Stichworte hinzufügen
  - Suchindex neu erstellen

  Hinweis: Bei größeren Foren können einige der Wartungsfunktionen sehr lange dauern
  und den Server stark belasten. Sie sollten das Forum währenddessen noch geschlossen
  lassen. 

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


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

Schließen Sie Ihr Forum über das Administrator-Kontrollzentrum:
vBulletin-Einstellungen -> vBulletin ein- und ausschalten -> Ist das Forum aktiv? -> Nein

Alternativ können Sie das Forum-Verzeichnis auch mit einem .htaccess-Passwortschutz
schützen (falls möglich). Mit diesem Passwortschutz verhindern Sie, dass Ihre Benutzer
während des Upgrades Fehlermeldungen sehen und dadurch verunsichert werden.

Erstellen Sie bitte eine komplette Sicherung Ihrer Datenbank. Dies können 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 können die Datenbank auch mit der Software MySQLDumper sichern:
http://www.mysqldumper.de/

Sichern Sie alle Dateien der alten vBulletin-Version. Dazu gehören auch die Anhänge,
Albumbilder, etc., falls diese im Dateisystem gespeichert werden. 

Vergewissern Sie sich bitte unbedingt, dass alle gesicherten Dateien und die
Datenbank-Sicherung vollständig und fehlerfrei sind. . Die beste Möglichkeit dafür
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 können Sie das Upgrade in der Kommandozeile (Shell) ausführen,
was bei größeren 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, können 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 Sicherheitsgründen das komplette install
Verzeichnis von Ihrem Server löschen. 

___________________________________________________________________________________

Anleitung für die Aktualisierung einer älteren vBulletin 4 Version auf die aktuelle vBulletin 4 Version
=======================================================================================================

Schließen Sie Ihr Forum über das Administrator-Kontrollzentrum:
vBulletin-Einstellungen -> vBulletin ein- und ausschalten -> Ist das Forum aktiv? -> Nein

Alternativ können Sie das Forum-Verzeichnis auch mit einem .htaccess-Passwortschutz
schützen (falls möglich). Mit diesem Passwortschutz verhindern Sie, dass Ihre Benutzer
während des Upgrades Fehlermeldungen sehen und dadurch verunsichert werden.

Erstellen Sie bitte eine komplette Sicherung Ihrer Datenbank. Dies können 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 können die Datenbank auch mit der Software MySQLDumper sichern:
http://www.mysqldumper.de/

Vergewissern Sie sich bitte unbedingt, dass die Datenbank-Sicherung vollständig
und fehlerfrei ist. Die beste Möglichkeit dafür 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 müssen 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 können Sie das Upgrade in der Kommandozeile (Shell) ausführen,
was bei größeren 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, können 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 Sicherheitsgründen das komplette install
Verzeichnis von Ihrem Server löschen. 

___________________________________________________________________________________

Anleitung für die Aktualisierung von älteren Versionen
======================================================

Für 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 führen Sie damit eine Aktualisierung Ihrer
vBulletin-Version durch. 

Danach können Sie mit der Anleitung für die Aktualisierung von vBulletin 3.5.4 - 3.8.x
auf vBulletin 4 weiter oben fortfahren.

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

___________________________________________________________________________________

Upgrade in der Kommandozeile (Shell) ausführen
==============================================

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
ausführen muss, z.B. wenn CSS als Dateien gespeichert wird.

In dem Fall wäre der Aufruf

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

wobei <user> mit dem Benutzer zu ersetzen ist, unter dem der Webserver läuft. 

___________________________________________________________________________________

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.
