Update-Installation ASV-BW ASV-BW. Stand: Kontaktdaten SCS: .

Transkript

1 Stand: Kontaktdaten SCS: Telefon: Weitere Informationsquellen: Im Intranet Im Internet

2 Inhaltsverzeichnis Vorbereitung:... aktuelle Sicherung der ASV-Datenbank Manuelles... Update des -Servers Manuelles... Update der -Clients Automatisches... Update der -Clients (nur ab 1.29 möglich) 10

3 1 Beim Update werden die Daten übernommen und notwendige Aktualisierungen in der Datenbankstruktur und der Software durchgeführt. Je nach Installationsart sind unterschiedliche Schritte in einer festgelegten Reihenfolge auszuführen; diese werden in den jeweiligen Kapiteln ausführlich beschrieben. Hinweis: Das automatische Update des Clients ist nur möglich beim Update ab der Version Die installierte Version ist vor dem Update des Servers zu überprüfen. Notwendige Schritte Überprüfen der derzeit eingesetzten Version von (ersichtlich z.b. im ClientAnmeldefenster oder in der Titelleiste des Programmfensters). schließen. ASV-Server beenden (über Task-Manager bzw.computerverwaltung). Datensicherung in pgadmin III wie im Kapitel 'Vorbereitung: aktuelle Sicherung der ASVDatenbank' beschrieben durchführen. Manuelle des ASV-Servers. Neustart des ASV-Servers. Manuelle des ASV-Clients beim Update älterer Versionen, z.b Oder: Automatische des ASV-Clients durch Neustart des ASV-Clients. (Achtung: Nur möglich, wenn mindestens die Version 1.29 installiert ist.) 1.1 Vorbereitung: aktuelle Sicherung der ASV-Datenbank Aus Sicherheitsgründen ist eine aktuelle Datensicherung erforderlich, bevor Änderungen an der Installation von vorgenommen werden. Das Sichern erfolgt mit Hilfe des Anwendungstools pgadmin III, welches bei der Installation des PostreSQL-Datenbanksystems automatisch installiert wurde und die Instanzen graphisch darstellt. Vorgehen Stoppen Sie bitte zuerst den ASV-Server bzw. beenden Sie entsprechende ASVDienste über den Task-Manager bzw. die Computerverwaltung. Nähere Informationen finden Sie im Kapitel 'Manuelles Update des -Servers'. Starten Sie dann das Tool pgadmin III aus dem Ordner der PostgreSQL-Version mit der höchsten Versionsnummer, z.b Sie können es entweder über das Startmenü des Computers öffnen oder durch Doppelklick auf die Datei 'pgadmin3.exe' im Programmverzeichnis der verwendeten PostgreSQL-Datenbank, z.b. C:\Programme\PostgreSQL\9.4\bin. Bitte verwenden Sie unbedingt die aktuellste Version des Tools in Ihrem System. Dadurch hat Ihr pgadmin III die Versionsnummer oder höher. Ältere Versionen lassen sich nicht verwenden. Öffnen Sie nun durch Doppelklick den Datenbankserver und danach die Datenbankliste im Objektbrowser (hier funktioniert das Öffnen auch über das Plus-Zeichen vor dem Eintrag). Geben Sie bei Bedarf das Kennwort des Benutzers 'postgres' ein, standardmäßig 'SdW?vRZit1aB' bzw. das von Ihnen vergebene Passwort. 3

4 Markieren Sie die Datenbank, die Sie sichern wollen und wählen Sie per rechter Maustaste aus dem Kontextmenu den Punkt 'Sicherung..'. Wählen Sie im folgenden Dialogfenster auf dem Reiter 'Datei-Optionen' neben einem Speicherort und Dateinamen für ein -Backup als Format 'Benutzerspezifisch', als Kodierung 'UTF8' und als Rollenname 'asv'. Markieren Sie beim Reiter 'Dump Optionen #1'': Mit Blobs Markieren sie beim Reiter 'Dump Optionen #2': Ausführliche Meldungen 4

5 Nach Beendigung des Sicherungslaufs erhalten Sie eine Meldung. Ist der Exitcode in der letzter Zeile höher als 0, führen Sie die Sicherung bitte nochmals durch. 5

6 1.2 Manuelles Update des -Servers Voraussetzungen ist in einer Produktiv-Version installiert. PostgresSQL läuft und der Zugriff auf die Datenbank ist möglich. Das Update des Servers muss auf dem Server/PC ausgeführt werden, auf dem der ASV-Server installiert ist. Es darf kein Prozess oder Dienst von aktiv sein während des Upgrades, andernfalls wird es abgebrochen. Vorgehen zur Beendigung von Diensten oder Prozessen Öffnen Sie den Taskmanager bzw. die Computerverwaltung. Wird der Server über die 'asv-bw.exe' gestartet, beenden Sie den Prozess 'javaw.exe'. Hinweis: Sind Server und Client auf einem PC installiert und aktiv, ist der Prozess doppelt vorhanden. In diesem Fall müssen beide 'javaw.exe'-prozesse beendet werden. Ist der -Server als Dienst eingerichtet, stoppen Sie in der Computerverwaltung den Dienst 'asv-server'. Ist zusätzlich der Aktualisierungsdienst installiert, beenden Sie den 'asv-update-service'. Erstellen Sie mit pgadmin III eine Datensicherung der PostgreSQL-Datenbank, sofern Sie nicht über ein aktuelles Backup verfügen. Wie Sie dabei vorgehen, wurde im Kapitel 'Vorbereitung: aktuelle Sicherung der ASV-Datenbank' beschrieben. 6

7 Laden Sie das aktuelle Update (Dateiname '<Versionsnummer>_bw-update-installer.zip') von unserer Homepage unter herunter und entpacken Sie sie in einem neuen Ordner. Starten Sie anschließend die darin enthaltene Datei 'install-admin.exe' durch Rechtsklick auf den Dateinamen. Wählen Sie 'als Administrator ausführen'. Verlassen Sie den Willkommensbildschirm mit Klick auf 'Weiter'. Wählen Sie in der Dialogbox 'Installationsart' 'Aktualisierung' und bestätigen Sie dies mit 'Weiter'. Wählen Sie anschließend das Verzeichnis des ASV-Servers zur Aktualisierung aus und bestätigen Sie mit Klick auf 'Weiter'. 7

8 Bei der des Servers werden sowohl die Softwarekomponente als auch die Datenbankstruktur aktualisiert; es werden z.b. neue Tabellen hinzugefügt. Abschließend haben Sie noch die Möglichkeit, Verknüpfungen zum Start-Menü oder Desktop einzurichten. Damit ist die für den ASV-Server beendet. 1.3 Manuelles Update der -Clients Wichtiger Hinweis Eine automatische Softwareaktualisierung kann nicht vorgenommen werden, wenn Sie nicht mindestens die Version 1.29 installiert haben. Bitte starten Sie deshalb auf keinen Fall nach nach dem Update des Servers irgendeinen damit verbundenen Client. Führen Sie stattdessen nach dem Server-Update und Start des ASV-Servers die folgenden Schritte aus. Vorgehen Auf jedem Rechner, auf dem ein Client installiert ist, muss das Update des Clients manuell per Update-Installer mithilfe der Datei 'install-admin.exe' im Ordner '<versionsnummer>_bw-update-installer' durchgeführt werden. Diese steht auf unserer Homepage zur Verfügung unter Beginnen Sie das Client-Update wie zuvor beim Server-Update durch Rechtsklick auf die Datei 'install-admin.exe'. Wählen Sie wieder 'als Administrator ausführen'. 8

9 Verlassen Sie den Willkommensbildschirm mit Klick auf 'Weiter'. Wählen Sie in der Dialogbox 'Installationsart' 'Aktualisierung' und bestätigen Sie dies mit 'Weiter'. Wählen Sie anschließend das Verzeichnis des ASV-Clients zur Aktualisierung aus und bestätigen Sie mit Klick auf 'Weiter'. Der Client wird nun upgedatet. 9

10 Abschließend haben Sie noch die Möglichkeit, Verknüpfungen zum Start-Menü oder Desktop einzurichten. Damit ist die für den ASV-Client erfolgreich abgeschlossen. Nach dem Start des Clients erscheint das Anmeldefenster in der neuen Programmversion. 1.4 Automatisches Update der -Clients (nur ab 1.29 möglich) Die Softwareaktualisierung der Clients wird nur dann erfolgreich automatisch durchgeführt, wenn Sie vorher mindestens die Version 1.29 installiert hatten. Andernfalls ist der Client wie der Server manuell upzudaten. Das Vorgehen wurde im Kapitel 'Manuelles Update des -Clients' ausführlich beschrieben. Zum automatischen Update des Clients sind folgende Schritte nötig: Vorgehen Starten Sie nach dem manuellen Update des ASV-Servers wieder den ASV-Server. Starten Sie dann einen ASV-Client. Beim Start eines noch nicht aktualisierten Clients wird die neue Programmversion automatisch installiert, sobald der ASV-Client sich das erste Mal mit dem ASV-Server verbindet. 10

11 Bestätigen Sie mit 'OK'. Anschließend öffnet sich das Anmeldefenster in der neuen Programmversion. Falls die automatische Softwareaktualisierung bei einem Client im Netzwerk nicht funktioniert, sollte dessen Konfigurationsdatei 'config.ini' überprüft werden. Öffnen Sie die Datei 'config.ini' im ASV-Client-Installationsverzeichnis '\configuration'. Setzen Sie dort den Parameter 'update.automatic' auf 'true'. Achten Sie darauf, dass der Servername von DSS und Updateserver identisch ist. Die angepasste 'config.ini' kann auf die anderen Clients kopiert werden. Speichern Sie zum Schluss auf dem betroffenen Rechner die geänderten 'config.ini'-einstellungen und starten Sie den angepassten Client neu. Nun sollte er sich automatisch aktualisieren und sich anschließend das Anmeldefenster der neuen Programmversion öffnen. 11