Updateprotokoll (Gttingen)

Datum: 26.09.04
Server: www.goettingen.studip.de
Ursprungsversion: 1.1
Zielversion: 1.1.5 (cvs vom 26.04.04)
siehe migration.sql fr SQL Befehle / Ablauf

Anmerkungen:

Achtung: Dieses Updateprotokoll soll Updates von einer Stud.IP Version auf die andere erleichtern. Der hier beschriebene
Ablauf wurde in dieser Reihenfolge auf der Gttinger Referenz-Installation getestet. Dennoch kann es im Einzelfall zu Abweichungen
kommen (insbesondere, falls eigene Anpassungen vorgenommen wurden).

Ausgangssituation:

Auf dem Server ist die Version 1.1 ohne spezielle Anpassungen installiert. 
Es soll die Version 1.1.5 mit smtlichen in der Distribution enthaltenen Modulen installiert werden.

Vorbereitungen:

Zunchst werden Datenbank und Webserver heruntergefahren. Anschlieend wird ein Backup der Datenbank und aller Scripte im vorliegenden 
Zustand vorgenommen. Die neue Version wird ber die alte vorhandenen Version installiert - auf diese Weise bleiben die Konfigurationsdateien 
local.inc und config.inc.php erhalten. Weitere eigene Scripte, die nur auf diesem Server zum Einsatz kommen, bleiben ebenfalls erhalten.
Aktualisiert werden muss das Stud.IP-Webroot und das Verzeichnis der PHP-Lib.
Zum Einsatz kommen die entsprechenden Version der CVS-Module studip und studip-phplib aus dem CVS vom 29.12.03 (Version 1.0beta).

PHP-Module:

Die Version 1.1.5 bentigt keine neuen PHP-Module oder andere Erweiterungen (einen berblick ber alle bentigten PHP-Module, Zusatzprogramme
und andere Erweiterungen wird in der Datei "studip_installation_guide.txt" im Verzeichnis studip-doc der Distribution gegeben).

Anpassung der Konfigurationsdateien:

Die Konfigurationsdateien local.inc im Verzeichnis der php-lib und die config.inc im Stud.IP-Root Verzeichnis mssen mit dem aktuellen
Stand der entsprechenden Distributionsversionen abgeglichen werden. Dabei knnen die alten Konfigurationsdateien als Ausgangszustand 
genommen werden und neu hinzugekommene Werte ergnzt (und nach eigenen Wnschen angepasst) sowie alte Eintrge entfernt werden. 
Je nach Umfang der eigenen Anpassungen kann natrlich auch die aktuelle Distributionsversion eingespielt werden und alte Eintrge wieder 
gesetzt werden. Dabei muss jedoch sehr genau darauf geachtet werden, dass keine Inkonsitenzen zwischen der alten und der neuen Version 
auftreten.
Es empfielt sich, den Abgleich der neuen Distributionsversionen und der eigenen Datei mit einem Differ vorzunehmen.

Datenbankupdate:

Das Datenbankupdate erfolgt in der angegebenen Reihenfolge (in Klammern stehen die Verweise auf die jeweiligen Abschnitte des
Migrationsscripts). 
ACHTUNG: Zum Ausfhren der SQL-Befehle und Updatescripte mssen Datenbank und Werbserver wieder gestartet werden. 

* neue Tabellen fr die object_user_visits (Anzeige von neuen Inhalten) in der Datenbank anlegen (#1)
* Konvertierungen fr die object_user_visits aus alten Daten vornehmen 
  Script: convert_loginfile.php als root ausfhren (#2)
  ACHTUNG: Dieser Schritt kann bei einer groen Installation einige Zeit dauern, da eine groe Anzahl an Eintrgen erzeugt
  werden (mehrere Minuten)
* nderungen am Messaging vornehmen (#3)
  ACHTUNG: Dieser Schritt kann bei einer groen Installation eine Zeit dauern (etwa 1 Minute)
* Indexe am Messaging verndern (#4)
  ACHTUNG: Dieser Schritt kann bei einer groen Installation eine Zeit dauern (etwa 1 Minute)
* Konvertierungen fr Betreffzeilen im Messaging vornehmen
  Script: convert_sms_subject.php als root ausfhren (#5)
  ACHTUNG: Da dieses Script sehr viel Speicher verbraucht, wenn eine groe Anzahl an Nachrichten im System vorliegen,
  mu entweder das Speicherlimit von PHP temporr sehr hoch gesetzt werden (etwa 50 MB) oder das Script mehrfach ausgefhrt 
  werden, bis alle Eintrge konvertiert sind.
* Konvertierungen fr Einstellungen der Weiterleitung im Messaging vornehmen
  Script: convert_sms_user_info.php als root ausfhren (#6)
* nderungen am Wiki (#7)
* nderungen an der Smileyverwaltung (#8)
* nderungen an der Tabelle user_indo (#9)
* nderungen an Indexes der Votes zur Steigerung der Performance (#10)