Updates einspielen

HINWEIS: Dieser Artikel betrifft ausschließlich die Lokalinstallation 2.9xx

Online Update

Für die Onlineversionen regelt NETZkultur zentral das regelmäßige einspielen der Updates. Für eigene Server kann man selber das updaten übernehmen.

Update einer Lokalinstallation

Die Updates werden dadurch initiiert, indem man die Quellen, also das /webroot Verzeichnis austauscht. Alle Datenbankveränderungen werden automaitsch durchgeführt. Die aktuellen Quellen findet man immer im Downloadverzeichnis. Folgende Schritte müssen durchgeführt werden:

• Verzeichnis webroot umbenennen (sichern)
• Neue Quellen mit dem Verzeichnisnamen webroot entzippen
• .htaccess anpassen !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
• folgende Dateien aus der Sicherung umkopieren und lt. Vorlage anpassen

   /include/config.db
   /.htaccess
   /license/*.zl

-> Apache neu starten, einloggen, es kommt beim ersten Aufruf zu Konvertierungen und das Update kann einige Minuten dauern!

Allgemeine Hinweise

ACHTUNG: Vor dem ersten einloggen den Browser Cache leeren!!!

ACHTUNG: Ab der Version 2.9.5.x benötigen Sie wieder eine veränderte htacces-Datei

ACHTUNG: ein Downgrade von infra-struktur ist grundsätzlich nicht möglich!

ACHTUNG: Ab der Version 2.9.6.X wird auf dem Server die php-SOAP Extension benötigt.

ACHTUNG: Vor einem Update sollte man alle beteiligten Dienste(mailparser, memcache, solr u.s.w.) einmal beenden. In Einzelfällen kann es da sonst zu Fehlermeldungen kommen.

Besonderheit für Updates von 2.9.5.x -> 2.9.6x!

Es werden für die Benutzung der Zusatzmodule die Masterkeys in die lokale Datenbank eingespielt. Es erscheint also folgende Meldung:

Der Partnername ist der Name lt. der Passwortliste, die zertifizierte Partner von NETZkultur bekommen.

Als Instanzname kann man einen Namen frei wählen, dient nur der Zuordnung zu einem Key, also nur der Übersicht.

Die Lizenzstufe ist die Stufe, passend zum Masterkey, i.d.R. Lizenzstufe 2.

Als Masterkey bitte den gleichen eintragen, den man damals bei der Freischaltung benutzt hat, bei Fragen zum Masterkey, einfach das Supportmodul benutzen.

EXAMPLE .htaccess

# Datenbankserver
SetEnv MYSQL_HOST localhost
SetEnv MYSQL_USER root
SetEnv MYSQL_PW infra-struktur
SetEnv MYSQL_DB infrastruktur

# Aktivierung von Memcache (default false)		
SetEnv EXTENDED_CACHING false
SetEnv MEMCACHEHOST localhost

# MySQLi Anbindung für DAO
SetEnv MySQLiConnectionID	"default,admin,language,message,communication"
SetEnv MySQLiHost		"localhost,localhost,localhost,localhost,localhost"
SetEnv MySQLiUser		"root,root,root,root,root"
SetEnv MySQLiPassword		"infra-struktur,infra-struktur,infra-struktur,infra-struktur,infra-struktur"
SetEnv MySQLiDatabase		"infrastruktur,infrastruktur,infrastruktur,infrastruktur,infrastruktur"
SetEnv MySQLiCharSet		"latin1,latin1,utf8,utf8,utf8"
SetEnv MySQLiMaster		"true,true,true,true,true"

# Quellenpfad der PHP Dateien
SetEnv ifsroot C:/ifs/webroot

# Apache Modul mod_rewrite 
RewriteEngine On
RewriteBase /
RewriteRule ^javascript/(.*\.js) scriptcache.php?type=javascript&files=$1

# Kalender Export aktivieren
SetEnv iCalExport true

EXAMPLE config.db

<?
putenv("MYSQL_HOST=localhost");
putenv("MYSQL_USER=root");
putenv("MYSQL_PW=infra-struktur");
putenv("MYSQL_DB=infrastruktur");

putenv("MySQLiConnectionID=default,memcache,admin,language,message");
putenv("MySQLiHost=localhost,localhost,localhost,localhost,localhost");
putenv("MySQLiUser=root,root,root,root,root");
putenv("MySQLiPassword=infra-struktur,infra-struktur,infra-struktur,infra-struktur,infra-struktur");
putenv("MySQLiDatabase=infrastruktur,MEMCACHE_SERVER_POOL,infrastruktur,infrastruktur,infrastruktur");
putenv("MySQLiCharSet=latin1,utf8,utf8,utf8,utf8");
putenv("MySQLiMaster=true,true,true,true,true");
?>

HINWEIS: die config.db wird nur noch gebraucht, wenn man das verschicken der Mails über die DOS Textconsole realisieren will, weil sonst die ENV Variablen nicht vom Apache ausgelesen werden können.

Update-Hinweis für die Version 2.9.7.59 oder höher!

Beginnen sie mit den Vorbereitungen!

Vorbereitungen

1. Lesen Sie, bevor Sie das Update durchführen, die komplette Anleitung!
2. Erstellen Sie von allen zu ändernden Programmen und Dateien ein Backup!
3. Stoppen Sie den Mailparser.
4. Stoppen Sie, falls vorhanden, den Solr Server.
5. Führen Sie jetzt das Codeupdate durch.

Codeupdate

1. Führen Sie ein normales Codeupdate durch.
2. Führen Sie jetzt, falls vorhanden, das Solr-Update durch.
3. Führen Sie jetzt das Mailparserupdate durch.
4. Führen Sie jetzt, falls ein Solr Server vorhanden ist, das SolrJIndexBuilder-Update durch.
5. Testen Sie die Lokalinstallation!

Solr-Update (falls vorhanden)

1. Installieren Sie den Inhalt des Verzeichnisses "apache-solr-3.5.0" in Ihrer Lokalinstallation.
2. Überprüfen sie ob der Pfad und der Port in den folgenden Dateien auf ihre Konfiguration passt, ggf. passen Sie diese an.

apache-solr-3.5.0/solr.start

apache-solr-3.5.0/solr.stop

apache-solr-3.5.0/logging.properties

1. Die Datenbank der Lokalinstallation muss nach folgendem Muster vorliegen "infrastruktur_{INSTANZ_NAME}".
2. Kopieren Sie das Solr-Template von "apache-solr-3.5.0/solr/infrastruktur_TEMPLATE/" nach "apache-solr-3.5.0/solr/{NAME_DER_DATENBANK}"
3. Starten Sie den Solr-Server mittels "apache-solr-3.5.0/solr.start".
4. Anschließend rufen Sie folgende URL in einem Browser einmalig auf:

http://{URL_DES_SOLR_SERVERS}:{IHR_SOLR_PORT}/solr/admin/cores?action=CREATE&name={INSTANZ_NAME_(DER_TEIL_NACH_"infrastruktur_")}&instanceDir={NAME_DER_DATENBANK}

1. Führen Sie den nächsten Punkt im Codeupdate aus.

Mailparserupdate

1. Installieren Sie den Inhalt des Verzeichnisses "mailparser-4.1.15" in Ihrer Lokalinstallation.
2. Passen Sie in Ihrem Startscript des Mailparsers den Parameter -solrServerURL nach folgendem Muster an:

-solrServerURL http://{URL_DES_SOLR_SERVERS}:{IHR_SOLR_PORT}/solr/{INSTANZ_NAME_(DER_TEIL_NACH_"infrastruktur_")}

1. Starten Sie den Mailparser.
2. Führen Sie den nächsten Punkt im Codeupdate aus.

SolrJIndexBuilder-Update

1. Installieren Sie den Inhalt des Verzeichnisses "SolarJIndexBuilder-0.0.5" in Ihrer Lokalinstallation.
2. Wenn Ihr Server über genügend Kapazitäten verfügt (>3GB freien RAM), können Sie den Index Ihres Solr-Servers direkt bauen. Alternativ kann dieser auch über Nacht gebaut werden. Je nach Größe der Lokalinstallation kann dies mehrere Stunden dauern. Den Index können Sie mit folgendem Befehl erstellen:

java -Xmx3000M -jar SolarJIndexBuilder.jar -solrServerURL http://{URL_DES_SOLR_SERVERS}:{IHR_SOLR_PORT}/solr -host {DIE_ADRESSE_IHRES_DB_SERVERS} -dblogin {BENUTZER_FÜR_DEN_DB_SERVER} -dbpwd {DAS_PASSWORT_FÜR_DEN_BENUTZER} -v -c -dbname {NAME_DER_DATENBANK} -rebuild -optimize

1. Nach Abschluss der Erstellung des Indexes, führen Sie den nächsten Punkt im Codeupdate aus. Sollten Sie Sich dazu entschlossen haben, den Index über Nacht zu bauen, bedenken Sie bitte, das die Suche in der Mailzentrale nicht die gewohnten Resultate liefert, bis der Index fertig erstellt wurde.

Verwandte Themen

• Bsp. Konfigurationsdateien
• PEAR