vBulletin 4 (Deutsch) Installations- und Aktualisierungshinweise

Inhalt des vBulletin 4 Pakets

upload/ (Dieses Verzeichnis enthält alle Dateien und Ordner 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.)
- Datei: 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.
Lizenzvereinbarung lesen)
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)

Nach oben

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 fettgedruckte 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.

Nach oben

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:
Kollation der Datenbank mit phpMyAdmin überprüfen
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) 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

Entpacken Sie das aus dem Kundenbereich heruntergeladene vBulletin-Paket auf Ihrer Festplatte.
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.
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.

Alternativ können Sie das Upgrade in der Kommandozeile (Shell) ausführen, was bei größeren Foren Timeout-Fehler vermeiden kann.
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.

Nach oben

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

Entpacken Sie das aus dem Kundenbereich heruntergeladene vBulletin-Paket auf Ihrer Festplatte.
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.
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.

Alternativ können Sie das Upgrade in der Kommandozeile (Shell) ausführen, was bei größeren Foren Timeout-Fehler vermeiden kann.
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.

Nach oben

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.

Nach oben

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 wie folgt, wobei <user> mit dem Benutzer zu ersetzen ist, unter dem der Webserver läuft.

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

Nach oben

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)

Nach oben

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

Upgrade in der Kommandozeile (Shell) ausführen

Anhang: Weitere Informationen