HANDBUCH ZUR UPDATE-INSTALLATION Das Dokument gibt eine Überblick über das Update eines MAQSIMA LAW-Systems und erläutert die Vorgehensweise Schritt für Schritt. Dokument: Inf_Update_MAQSIMA_LAW.odt (und *.pdf) Version: 1.3 Erstellt am: 10.08.2006 Letzte Aktualisierung am: 17.01.2011 MAQSIMA GmbH Am TÜV 1 D-66280 Sulzbach Tel: +49 (0) 6897 / 506 41 Fax: +49 (0) 6897 / 506491 E-Mail: info@maqsima.de Internet: www.maqsima.de EIN GEMEINSCHAFTSUNTERNEHMEN DER CERTINA-GRUPPE UND DES TÜV SAARLAND 1
Inhalt 1 Hinweise zu Oracle-Datenbanken...3 1.1 Oracle 9i Support beendet...3 1.2 Oracle 11g Besonderheiten...3 2 Überblick über das Update...4 2.1 Grundsätzliches...4 2.2 Überblick...5 2.2.1 Datenbanksicherung (serverseitig)...5 2.2.2 Datenbank-Update (serverseitig)...5 2.2.3 MAQSIMA LAW HTML-Client aktualisieren (serverseitig)...5 2.2.4 MAQSIMA LAW Scheduler-Jobs aktualisieren (serverseitig)...5 2.2.5 MAQSIMA Scheduler aktualisieren (serverseitig, bei Bedarf)...5 2.2.6 MAQSIMA LAW Full-Client aktualisieren (clientseitig)...5 3 Durchführung des Updates...6 3.1 Datenbanksicherung...6 3.2 Datenbank-Update...6 3.3 MAQSIMA LAW HTML-Client aktualisieren...7 3.4 MAQSIMA LAW Scheduler-Jobs aktualisieren...7 3.5 MAQSIMA Scheduler aktualisieren...7 3.6 MAQSIMA LAW Full-Clients aktualisieren...7 4 Funktionsprüfung...8 4.1 Full-Client...8 4.2 HTML-Client...8 4.3 Scheduler...8 2
HINWEISE ZU ORACLE-DATENBANKEN 1 HINWEISE ZU ORACLE-DATENBANKEN 1.1 Oracle 9i Support beendet Bitte beachten Sie: === Der Support für Oracle 9i Datenbanken endete zum Ende des Jahres 2010 === Der durch die MAQSIMA im Rahmen des Wartungsvertrages bereitgestellte Support für Oracle Datenbanken in der Version 9i endete zum 31.12.2010. Oracle hat den Support für das Release 9i bereits zum Juli 2007 eingestellt. Nach Ablauf einer Übergangszeit von drei Jahren hat nun auch die MAQSIMA den Support für diese Datenbank- Version beendet. Wir empfehlen allen Kunden den Umstieg auf die Version 11g R1 oder höher (auch für die Version 10g R1 und R2 hat Oracle den Premier Support bereits eingestellt). Bei Fragen wenden Sie sich bitte an unseren Support unter der E-Mail-Adresse support@maqsima.de oder unter der Telefonnummer 06897/506 42. Weitere Informationen zu den Oracle-Support-Zeiträumen finden Sie unter folgender Adresse: http://www.oracle.com/us/support/library/lifetime-support-technology-069183.pdf 1.2 Oracle 11g Besonderheiten Bitte beachte Sie: Bei Verwendung einer Oracle 11g-Datenbank mit Standard-Einstellungen muss das Passwort des Datenbank-Benutzers für das MAQSIMA LAW-System komplett in Großbuchstaben angelegt werden, damit es keine Probleme beim Aufruf der Oracle Reports Runtime und des Betreiberpflichten-Importers gibt! Dies gilt nur für MAQSIMA LAW, nicht für MAQSIMA LAW/GB. 3
ÜBERBLICK ÜBER DAS UPDATE M A Q S I M A L A W 2 ÜBERBLICK ÜBER DAS UPDATE 2.1 Grundsätzliches Die Vorbereitung eines Updates besteht grundsätzlich aus Informations- und Datenbeschaffung. Zur Durchführung werden folgende Informationen benötigt: 1. Name und IP-Adresse des Datenbankservers 2. Name und IP-Adresse des WEB-Servers (Internet Information Server) 3. TNSNAME und SID der Oracle Datenbank 4. Datenbankzugangsdaten (Benutzer und Passwort des MAQSIMA LAW-Datenbankbenutzers) 5. Verzeichnispfad des installierten HTML-Clients (auf dem WEB-Server) 6. Verzeichnispfad des installierten MAQSIMA-Schedulers. Alle nötigen Informationen sind im Installationsabnahmeprotokoll zu finden, das Ihnen nach der Erstinstallation ausgehändigt wurde. Sollte es Ihnen nicht vorliegen, setzen Sie sich mit uns unter 06897/506-42 in Verbindung oder senden Sie eine E-Mail an support@maqsima.de Zum Update sind folgende Dateien notwendig: 1. setup_x.y.p.s_oracle9i.exe 1 bzw. setup_x.y.p.s_oracle10g.exe oder setup_x.y.p.s_oracle11g.exe Setup des neuen MAQSIMA LAW Full-Clients. 2. DB-Update_A_B.zip 2 Datenbankscripte zur Migration der Oracle-Datebank auf die neue Version. 3. LAW_ASP_X.Y.P (DB-Version B).zip ZIP-File, das alle ASP-Dateien des HTML-Client beinhaltet. 4. Scheduler_2.6.0.zip Programmdateien des MAQSIMA Schedulers. 5. lawschedulerjobs.zip Die passenden Scheduler-Jobs zur MAQSIMA LAW Programmversion. Bitte beachten Sie, dass niemand mit dem System arbeiten darf, während das Update durchgeführt wird! 1 X.Y: Produkt-Version; P: Produkt-Patch-Version; S: Setup-Version 2 A: DB-Version der installierten Produkt-Version; B: DB-Version der neuen Produkt-Version 4
ÜBERBLICK ÜBER DAS UPDATE 2.2 Überblick 2.2.1 Datenbanksicherung (serverseitig) Vor dem Update sollte die Datenbank komplett gesichert werden. Mit Hilfe der Sicherung kann der Zustand vor dem Update wieder hergestellt werden. 2.2.2 Datenbank-Update (serverseitig) Durch das Datenbank-Update werden die Änderungen im Datenbankschema, die für die neue Version erforderlich sind, durchgeführt. Das Datenbankscript wird über das Datenbanktool SQLPLUS eingespielt. 2.2.3 MAQSIMA LAW HTML-Client aktualisieren (serverseitig) Passend zur Full-Client-Version wird auch ein HTML-Client ausgeliefert, der in das passende Verzeichnis entpackt werden muss. 2.2.4 MAQSIMA LAW Scheduler-Jobs aktualisieren (serverseitig) Für jede Datenbankversion werden passende Scheduler-Jobs erstellt. Zu Beginn jedes Jobs wird die Datenbankversion geprüft. Sollte das Datenbankschema nicht die passende Datenbankversion aufweisen, wird der Scheduler-Job nicht ausgeführt und gesperrt. 2.2.5 MAQSIMA Scheduler aktualisieren (serverseitig, bei Bedarf) Die Scheduler-Jobs setzen eine bestimmte Version des MAQSIMA Schedulers voraus. Ist diese nicht installiert, muss auch der Scheduler selbst aktualisiert werden. 2.2.6 MAQSIMA LAW Full-Client aktualisieren (clientseitig) Zum Aktualisieren der Full-Clients muss nur das SETUP-Programm ausgeführt werden. Hierzu sind auf dem Client kurzzeitig Administrator-Rechte notwendig. 5
DURCHFÜHRUNG DES UPDATES M A Q S I M A L A W 3 DURCHFÜHRUNG DES UPDATES 3.1 Datenbanksicherung Bei der Installation von MAQSIMA LAW wird in der Regel eine Batchdatei mit installiert, die die Datensicherung täglich durchführt. Es genügt diese Batchdatei einmal manuell zu starten. Danach liegen im Sicherungsverzeichnis Datenbank-DUMP Files, die die notwendigen Daten beinhalten. 3.2 Datenbank-Update Ein Datenbank-Update muss nur dann ausgeführt werden, wenn Dateien der Art DB- Update_A_B.zip mitgeliefert werden. Falls dies nicht der Fall ist, überspringen Sie dieses Kapitel (Datenbank-Update). Zur Durchführung des Datenbank-Updates entpacken Sie alle Dateien DB-Update_A_B.zip in gleichnamige Verzeichnisse ( DB-Update_A_B ) auf dem Datenbankserver. Jedes dieser Verzeichnisse enthält zwei Unterverzeichnisse: updates und packages. Die Update-Scripte müssen in aufsteigender Reihenfolge ausgeführt werden, beispielsweise zuerst die Scripte im Verzeichnis DB-Update_52_53, dann die Scripte aus DB-Update_53_54, dann DB- Update_54_55. Öffnen Sie nun eine Eingabeaufforderung. Für jedes mitgelieferte Datenbank-Update-Script führen Sie die folgenden Schritte aus: Wechseln Sie in der Eingabeaufforderung in das Unterverzeichnis updates des einzuspielenden Update-Scripts und starten Sie das Datenbanktool SQLPLUS. Wenn Sie die Update-Scripte also beispielsweise im Verzeichnis C:\temp ausgepackt haben: C: cd \temp\db-update_52_53\updates sqlplus Bitte stellen Sie sicher, dass Sie wirklich in das updates -Unterverzeichnis gewechselt sind, da andernfalls das Update nicht erfolgreich sein wird! Dies können Sie überprüfen, indem Sie den Befehl cd ohne Parameter eingeben. Es wird dann das aktuelle Verzeichnis ausgegeben. In der Anmeldemaske der Datenbank geben Sie den Benutzernamen, Passwort und den TNS-Namen der Oracle-Datenbank ein. Sollte die Anmeldung nicht erfolgreich sein, so erscheint die Anmeldemaske erneut. Nach erfolgreicher Anmeldung starten Sie das Datenbankscript über den Befehl @update_a_b.sql. (Bitte ersetzen Sie A und B mit den korrekten Werten.) Beobachten Sie die Anzeige, ob Fehlermeldungen angezeigt werden. Falls dies der Fall sein sollte, unterbrechen Sie bitte das Update und schicken die Fehlerbeschreibung an den Support 1 der MAQSIMA GmbH (support@maqsima.de, 06897 / 506 42). Nach Ablauf des Scripts beenden Sie SQLPLUS mit dem Befehl quit. 1 Bitte beachten Sie, dass ein gültiger Softwarepflege-Vertrag Voraussetzung für die Inanspruchnahme des Supports ist! 6
DURCHFÜHRUNG DES UPDATES 3.3 MAQSIMA LAW HTML-Client aktualisieren Sichern Sie die Konfigurationsdatei jedes HTML-Clients, bevor Sie mit dem Update beginnen. Der Dateiname lautet maqsimalaw_config.inc.asp. In der Datei sind Konfigurationseinstellungen hinterlegt, unter anderem der Datenbanktreiber und auch die Datenbankverbindung, die dieser HTML-Client benutzt. Die wichtigsten Einstellungen sind: db_driver = "<treiber>" db_host = "<servername>" db_user = "<dbuser>" db_pwd = "<db_password>" Entpacken Sie die Datei LAW_ASP_X.Y.0 (DB-Version B).zip in jedes Verzeichnis, in dem ein MAQSIMA LAW HTML-Client eingerichtet ist, wobei alle existierenden Dateien überschrieben werden müssen. Ab dem HTML-Client 2.54 wird die Konfigurationsdatei beim Update nicht mehr überschrieben. Sie können die bisherige Datei weiterverwenden. Bitte schauen Sie aber in den Release-Notes nach, ob neue Optionen hinzugekommen sind, die sie in Ihrer Konfigurationsdatei eintragen müssen. Falls Sie neu hinzugekommene Konfigurations-Optionen nicht eintragen, wird es zu Fehlermeldungen im HTML-Client kommen! 3.4 MAQSIMA LAW Scheduler-Jobs aktualisieren Das Update der Scheduler-Jobs erfolgt durch Überschreiben der Datei lawschedulerjobs.jar mit der gleichnamigen Datei aus dem gelieferten ZIP-Archiv lawschedulerjobs.zip. 3.5 MAQSIMA Scheduler aktualisieren Sollten nicht nur die Scheduler-Jobs, sondern auch der Scheduler aktualisiert werden, so wird eine Datei Scheduler_X_Y.zip mitgeliefert und in den Release-Notes gesondert daraufhin gewiesen. Zur Installation des Schedulers müssen Sie lediglich den Inhalt der ZIP-Datei in das Verzeichnis des Schedulers auspacken. Sollten weitere Schritte notwendig sein, so wird darauf ebenfalls in den Release-Notes hingewiesen. 3.6 MAQSIMA LAW Full-Clients aktualisieren Zum Aktualisieren der Full-Clients auf den Client-PCs melden Sie sich am entsprechenden Arbeitsplatz mit einem Benutzer an, der über lokale Administratorrechte verfügt. Starten Sie das SETUP-Programm. Füllen Sie alle Daten wie bei der Erst-Installation aus, um das Setup erfolgreich abzuschließen. 7
FUNKTIONSPRÜFUNG M A Q S I M A L A W 4 FUNKTIONSPRÜFUNG 4.1 Full-Client Starten Sie nach der Installation den Full-Client. Es scheint die Anmeldemaske. Stimmt die angezeigte Versionsnummer mit der neuen Versionsnummer überein und sind und im Feld Mandant Ihre angelegten Mandanten enthalten, so war das Datenbank- und Full-Client-Update erfolgreich. 4.2 HTML-Client Öffnen Sie den Web-Browser und öffnen Sie die Anmelde-Maske des HTML-Clients. Prüfen Sie wiederum, ob im Feld Mandant der Inhalt korrekt ist und ob die angezeigte Programmversion dem Namen der HTML-Client-ZIP-Datei entspricht. 4.3 Scheduler Starten Sie den Scheduler über die Datei MAQSIMAScheduler.bat und kontrollieren Sie die Meldungen im Log-File, das bei jedem Start im Unterverzeichnis logs erzeugt wird. Sollten Sie speziell für Sie erstellte Scheduler-Jobs erhalten haben (beispielsweise für Schnittstellen), so fragen Sie erst nach, ob ein Scheduler-Lauf außerhalb der normalen Ausführungsfrequenz möglich ist! 8