Amtliche Schulverwaltung - Dokumentation - alle:technik:update

Automatisches Update

anonymous@undisclosed.example.com (Anonymous) — Wed, 09 Aug 2023 12:13:40 +0000

Automatisches Update

Die Software ASV beinhaltet seit dem ersten Betrieb an Schulen die Funktionalität zur Verteilung von Updates (Softwareaktualisierungen) vom ASV-Server (DSS) zum ASV-Client. Deshalb ist es in der Standardinstallation bisher erforderlich neue ASV-Versionen am DSS manuell zu installieren. Die Verteilung des Update auf die ASV-Clients geschieht dann automatisch.

Ab dem Release 1.27 (Mai 2016 und damit für die Erstinstallation an den Grund- und Mittelschulen für den produktiven Einsatz) enthält die Standardinstallation von ASV auch das automatische Update des ASV-Servers. Diese Zusatzkomponente prüft regelmäßig (täglich), ob eine neue Version vorliegt. Das passende Updatepaket wird ggf. heruntergeladen und die Software aktualisiert. Beim Neustart der ASV-Clients werden diese nach dem bisherigen Verfahren ebenfalls aktualisiert.

Dieser Mechanismus kann auch so umgestellt werden, dass bestimmte Benutzer über Updates informiert werden und die Installation gezielt steuern können. Es ist ebenfalls möglich auf die automatischen Updates ganz zu verzichten. Dann bleibt das Vorgehen wie bisher - Durchführung eines manuellen ASV-Server-Updates.

Weitere Informationen finden Sie unter Automatische Programmaktualisierung des ASV-Servers (Aktualisierungsdienst)

Manuelles Update des ASV-Servers

anonymous@undisclosed.example.com (Anonymous) — Fri, 27 Jun 2025 13:59:05 +0000

Manuelles Update des ASV-Servers

Vorbereitung

Zunächst müssen folgende Schritte durchgeführt werden:

Durchführung des Updates

Starten Sie die Installation durch Rechtsklick der Datei install-admin.exe –> Als Administrator ausführen (bzw. unter Linux starten Sie install.sh) Sie sind dann sicher, dass Sie auch wirklich mit Admin-Rechten installieren, was für die Funktion der Dienste besonders wichtig ist.

Sollte der Updateprozess blockiert sein, obwohl Sie die Dienste beendet und gewartet haben, dann überprüfen Sie, ob die Anwendung bei den Prozessen läuft und beenden Sie diese mit Task beenden.

Mit diesem Fenster startet die Updateinstallation:

Wählen Sie im zweiten Schritt des Assistenten den Eintrag Aktualisierung aus:

Im dritten Schritt wählen Sie das Verzeichnis, in welchem der Server installiert wurde und klicken Sie auf Weiter (im Regelfall c:\ASV\Server)

Sie erhalten anschließend Rückmeldung über den Ablauf des Aktualisierungsvorgangs.

Im nächsten Schritt könnten noch Desktop-Verknüpfungen eingerichtet werden

Am Ende erhalten Sie folgende Erfolgsmeldung (sowie die Möglichkeit ein automatisches Installationsskript zu generieren)

Abschließende Arbeiten

Nach erfolgtem Update muss der Dienst bzw. der ASV-Server wieder gestartet werden.

Hinweise zur Durchführung eines ASV-Updates

anonymous@undisclosed.example.com (Anonymous) — Fri, 12 May 2023 16:23:55 +0000

Hinweise zur Durchführung eines ASV-Updates

Vor einem Update wird dringend empfohlen, eine Sicherung der eigenen Berichte anzufertigen!

Wenn der Aktualisierungsdienst genutzt wird, dann wird das ASV-Update automatisch eingespielt. Da in der Standardeinstellung das automatische Update nachts eingespielt wird, sollte der ASV-Server dafür in der Nacht durchlaufen.

Wenn der Aktualisierungsdienst zwar eingerichtet ist, das Update aber nach mehreren Tagen nicht automatisch installiert ist, dann sollte ein manuelles Update durchgeführt werden.

Das Vorgehen beim Update einer ASV-Installation gliedert sich in folgende zwei Schritte auf:

Sie laden den Updateinstaller unter Programmversionen Produktivbetrieb herunter
Sie aktualisieren nur den ASV-Server (ASV Server School oder Enterprise).
Das Update der Clients wird bei deren nächsten Neustart automatisch durchgeführt

Im Folgenden wird der Updatevorgang für Windows beschrieben. Für Linux-Installationen ist der Ablauf analog (auf einzelne Abweichungen wird hingewiesen).

Anleitung allgemein: Durchführung eines manuellen Updates

Schritt-für-Schritt ASV manuell aktualisieren

Zentrale Installationen

Nutzen Sie

eine regional-zentrale Installation (beispielsweise LHM München, Regensburg, Bamberg, etc) oder
werden Sie bei einem externen Dienstleister betreut,

dann wird der Betreiber auch die Updates zentral durchführen. Für die einzelne Schule besteht - bis auf die organisatorische Absprachen - deshalb kein Handlungsbedarf. Die Clients an den Schulen werden bei einer Versionsänderung automatisch aktualisiert, so dass seitens der beteiligten Schulen weder ein Server - noch ein Client-Updates eingespielt werden müssen.

Falls Sie weitere Informationen benötigen, sprechen Sie sich bitte mit Ihrem für Sie zuständigen ASV-Betreiber ab.

Organisatorischer Ablauf eines ASV-Server-Updates

Für die Aktualisierung ist ein Wartungsfenster inklusive eines Neustarts des Servers zwingend notwendig, weshalb eine solche Maßnahme unbedingt

allen beteiligten Schulen,
allen beim Update involvierten Personen
sowie betroffenen Kolleginnen und Kollegen an der einzelnen Schule (Sekretariate)

im Vorfeld angekündigt werden sollte.

FAQ - Häufige Fragen

Woran kann ich erkennen, dass meine Installation erfolgreich durch den Aktualisierungsdienst aktualisiert wurde?

Die aktuellen Programmpakete werden Ihnen über das automatische Client-Update angeboten. Sie erhalten deshalb direkt beim Start des Clients den Hinweis auf eine Aktualisierung.

Muss das ASV Update eingespielt werden, obwohl die Schule bereits angelegt wurde?

Ja, das ASV-Update muss eingespielt werden bzw. wird durch den Aktualisierungsdienst automatisch eingespielt, auch wenn die Schule bereits angelegt wurde.

Das automatische Update wird nicht erfolgreich eingespielt, wie erhalte ich Hilfe?

Bitte wenden Sie sich zunächst an den für Sie zuständigen Multiplikator.

Wie kann ich in ASV prüfen, ob sich meine Installation auf dem aktuellen Stand befindet?

Bitte führen Sie die Aktualitätsprüfung wie unter Aktualität prüfen beschrieben durch.

Manuelles unattended Update unter Linux

anonymous@undisclosed.example.com (Anonymous) — Fri, 11 Jul 2025 06:59:23 +0000

Manuelles unattended Update unter Linux

Herunterladen des Update-Installers für die nächste Version.

Übertragen der Zip-Datei auf den Server in den Ordner /opt/asv.

Die weiteren Arbeiten führen Sie als Servicebenutzer asvdss aus. Es ist darauf zu achten, dass der Servicebenutzer asvdss die nötigen Rechte für die folgenden Schritte besitzt.

 sudo su - asvdss
 cd /opt/asv

Prüfen Sie zunächst, ob der Service DSS oder auch das Updateservice auf dem Server noch laufen:

 cd /opt/asv/server/bin
 ./dssctl status --user sys --password '!!ASV!!'

Sie erhalten als Meldung(en), ob der DSS und/oder der Updateservice noch laufen. Wenn dies der Fall ist, dann müssen sie beendet werden:

 ./dssctl stop --user sys --password '!!ASV!!' --time 0

Sie benötigen die Datei auto-install.xml (entweder die bei der Erstinstallation erzeugte oder Folgende). ACHTUNG: Wichtig ist, dass der Eintrag bei installType auf UPDATE steht und dass auch der Installationspfad (installPath) korrekt ist. Dieses XML-File führt bei der Unattended-Upateinstallation KEIN Zertifikatsupdate durch.

auto-install.xml

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="deu">
    <de.isb.svp.installer.panels.HelloPanel id="hello"/>
    <de.isb.svp.installer.panels.InstallTypePanel id="type" installType="UPDATE"/>
    <de.isb.svp.installer.panels.TargetPanel id="destination" installPath="/opt/asv/server" useH2=""/>
    <de.isb.svp.installer.panels.ZertifikatPanel id="certs"/>
    <de.isb.svp.installer.panels.CheckSystemPanel id="checks"/>
    <de.isb.svp.installer.panels.DSSClientPanel id="client"/>
    <de.isb.svp.installer.panels.PostgreSQLPanel id="postgres"/>
    <de.isb.svp.installer.panels.InstallationPanel id="install"/>
    <de.isb.svp.installer.panels.MigrationProcessPanel id="dbsetup"/>
    <com.izforge.izpack.panels.ShortcutPanel id="shortcuts"/>
    <de.isb.svp.installer.panels.FinishPanel id="finish" installService="false" installUS="false" showInfo="true" startApp="false" updateServiceBackupEnabled="false"/>
</AutomatedInstallation>

Wenn Sie eine Updateinstallation mit einem Zertifikatsupdate durchführen wollen, dann muss sowohl der Pfad zur Zertifikatsdatei mit dem korrekten Dateinamen in der auto-install.xml-Datei angegeben werden. Der Pfad kann relativ zum Installationsordner oder absolut angegeben werden. Desweiteren wird das zugehörige Passwort für die Zertifikatsdatei benötigt. Beides kann ein Klartext angegeben werden:

auto-install.xml

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="deu">
    <de.isb.svp.installer.panels.HelloPanel id="hello"/>
    <de.isb.svp.installer.panels.InstallTypePanel id="type" installType="UPDATE"/>
    <de.isb.svp.installer.panels.TargetPanel id="destination" installPath="/opt/asv/server" useH2=""/>
    <de.isb.svp.installer.panels.ZertifikatPanel id="certs">
        <clientCertificateKeyStore>//HierStehtDerRelativeOderAbsolutePfadZurZertifikatsdateit/ssl_Z_KM20JJ_SSSS.p12//</clientCertificateKeyStore>
        <clientCertificatePassword>//HierStehtDasZertifikatpasswort//</clientCertificatePassword>
    </de.isb.svp.installer.panels.ZertifikatPanel>
    <de.isb.svp.installer.panels.CheckSystemPanel id="checks"/>
    <de.isb.svp.installer.panels.DSSClientPanel id="client"/>
    <de.isb.svp.installer.panels.PostgreSQLPanel id="postgres"/>
    <de.isb.svp.installer.panels.InstallationPanel id="install"/>
    <de.isb.svp.installer.panels.MigrationProcessPanel id="dbsetup"/>
    <com.izforge.izpack.panels.ShortcutPanel id="shortcuts"/>
    <de.isb.svp.installer.panels.FinishPanel id="finish" installService="false" installUS="false" showInfo="true" startApp="false" updateServiceBackupEnabled="false"/>
</AutomatedInstallation>

Nun kann die unattended Updateinstallation durchgeführt werden

 mkdir update2.14.7
 cd update2.14.7
 unzip ../2.14.7_036_03_by-update-installer.zip
 cd install
 chmod u+x *.sh
 cp /opt/asv/server/auto-install.xml .
 sed --in-place -e 's/SERVER/UPDATE/' auto-install.xml

Der letzte Befehl sorgt dafür, dass ein Update statt einer Neuinstallation durchgeführt wird. Der Wert von installType soll auf UPDATE geändert werden. Es sollten keine anderen Veränderungen an der Datei vorgenommen werden.

Dann erfolgt das eigentliche Update:

 ./install-unattended.sh >update.log 2>&1

Jetzt noch das Protokoll sichten und die Dienste wieder starten.

 less update.log
 
 cd /opt/asv/server/bin
 ./dssctl start

Nach kurzer Zeit müssten der DSS und das updateservice in der neuen Version laufen. Im bin-Verzeichnis des Servers kann man mit Hilfe des Befehls

 ./dssctl status --user sys --password '!!ASV!!'

sichten, ob DSS und Updateservice wieder laufen. Ist das der Fall, wird sich der ASV-Client nach seinem Start wieder verbinden können und sich selbst aktualisieren.