Amtliche Schulverwaltung - Dokumentation - alle:technik:aktualisierungsdienst

Aktualisierungsdienst initialisieren

anonymous@undisclosed.example.com (Anonymous) — Fri, 25 Sep 2020 10:00:50 +0000

Aktualisierungsdienst initialisieren

Wenn der Aktualisierungsdienst in einen Zustand gerät, in dem die Aktualisierung nicht durchgeführt wird, dann sollte eine Initialisierung durchgeführt werden.

Folgende Schritte sind dann erforderlich:

Beenden des Aktualisierungsdienstes

Starten Sie als Administrator die Diensteverwaltung auf dem Server und beenden den Dienst asv-update-service.

Falls das Beenden über die Diensteverwaltung nicht erfolgreich ist, kann mit den Skripten unter server\update-service\launcher\bin auch der Dienst bearbeitet werden.

Bereinigen der Statusinformationen

Folgende Dateien bzw. Ordner müssen gelöscht werden, wenn sie vorhanden sind:

Datei update-service/service/download_state.xml
Datei update-service/service/dss_update_state.xml
Datei update-service/service/configuration/update-service.shutdown.filepart
Ordner update-service/launcher/input inkl. des ggf. vorhandenen Inhalts
Ordner update-service/download/dss inkl. des ggf. vorhandenen Inhalts

Starten des Aktualisierungsdienstes

Starten Sie als Administrator die Diensteverwaltung auf dem Server und starten den Dienst asv-update-service.

Wurde der Dienst korrekt gestartet?

Prüfen Sie in der Datei update-service/service/logs/update-service.log, ob die Einträge mit aktuellem Zeitstempel entstanden sind und eine Zeile mit dem Text „Update Service (1.29.189_032_13) started…“¹⁾ existiert.

10.09.2016, 09:35:55 [server-manager ] INFO  ServerManager                                      - --------------------------------------------------------------------------------
10.09.2016, 09:35:55 [server-manager ] INFO  ServerManager                                      - http server registered at: 0.0.0.0:9878
10.09.2016, 09:35:55 [server-manager ] INFO  ServerManager                                      - startup time: 8674ms
10.09.2016, 09:35:55 [server-manager ] INFO  ServerManager                                      - Update Service (1.29.189_032_13_by) started...
10.09.2016, 09:35:55 [server-manager ] INFO  ServerManager                                      - --------------------------------------------------------------------------------

Sollte der Dienst nicht richtig gestartet werden können, dann bereinigen Sie erneut die Statusinformationen und führen einen Neustart des Server (Betriebssystem) durch.

¹⁾

die Versionsnummer im Text variiert mit jedem Update

Individuelle Anpassungen des Aktualisierungsdienstes

anonymous@undisclosed.example.com (Anonymous) — Fri, 23 May 2025 13:47:47 +0000

Individuelle Anpassungen des Aktualisierungsdienstes

Entscheidung für einen Betriebsmodus

Der Aktualisierungsdienst kann individuell an die eigenen Bedürfnisse und Anforderungen angepasst werden. Gerade das vollautomatische Update bietet einerseits die Chance, möglichst wenig manuell eingreifen zu müssen. Andererseits besteht vielfach der Wunsch, bestimmte Dinge nur nach Rückfrage ausführen zu lassen.

Folgende Betriebsvarianten sind deshalb prinzipiell möglich:

Betriebsmodus	Erläuterung
Vollautomatisch (auto)	In der vollautomatischen Betriebsart erfolgen eine automatische, zeitgesteuerte Prüfung, Download und Installation der Aktualisierungspakete.
Teilautomatisch (mixed)	In der teilautomatischen Betriebsart erfolgen eine automatische, zeitgesteuerte Prüfung und Download der Aktualisierungspakete, wie in der vollautomatischen Betriebsart. Die Aktualisierung selbst wird, wie im manuellen Modus, durch einen berechtigten Benutzer im ASV-Client ausgelöst
Manuell (manual)	In der manuellen Betriebsart erfolgt eine automatische, zeitgesteuerte Prüfung auf Aktualisierungen. Der Download und die Installation der Aktualisierungspakete werden erst dann ausgeführt, wenn der Prozess durch einen berechtigten Benutzer im ASV-Client gestartet wird. Die Steuerung erfolgt über Konfigurationsparameter (siehe Tabelle unten).

Wurde eine manuelle oder teilautomatische Aktualisierung durch den Updateservice angestoßen und ist ein Update für den ASV-Server verfügbar, so wird dem berechtigten Benutzer im ASV-Client dies durch die rot umrandete Schaltfläche angezeigt, die man ggf. für das Durchführen des Downloads bzw. des Updates anklicken muss.

Erstellung einer eigenen Konfiguration

Wechseln Sie im Installationsordner des ASV-Servers in der Unterordner update-service/service/configuration. Legen Sie dort eine neue Textdatei mit dem Namen config.local.ini an.

Folgende Einträge stehen zur Verfügung:

Eintrag	Bedeutung	Beispiel
update.check.start	Uhrzeit, ab der nach einem Update nachgefragt wird	update.check.start=10:00	Nachfrage nach Update ab 10:00 Uhr
update.check.end	Uhrzeit, bis zu der nach einem Update nachgefragt wird	update.check.end=12:00	Nachfrage nach Update bis 12:00 Uhr
update.check.days	Wochentage, an denen (im festg. Zeitraum nach einem Update nachgefragt wird)	update.check.days=mo,di,mi,do	Nachfrage nach Update Mo-Do
update.check.interval	Zeitraum, der zwischen zwei Updateanfragen liegt	update.check.interval=10	Nachfrage alle 10 Minuten
update.download.days	Wochentage, an denen Aktualisierungsdateien heruntergeladen werden	update.download.days=di,mi,do	Downloads nur Di, Mi und Do
update.download.start	Uhrzeit, ab der ein Download gestartet wird	update.download.start=13:00	Download ab 13:00 Uhr
update.download.end	Uhrzeit, bis zu der ein Download gestartet wird	update.download.end=15:00	Download bis 15:00 Uhr
update.execution.time	Uhrzeit, ab der eine Aktualisierung gestartet wird	update.execution.time=16:00	Start eines Updates ab 16:00 Uhr
update.execution.days	Wochentage, an denen ein Update des ASV-Server durchgeführt wird	update.execution.days=di,mi	Update nur Di oder Mi
update.mode	Wahl des Updatesmodes (vollautomatisch (auto), teilautomatisch (mixed), manuell (manual))	update.mode=auto	Vollautomatische Installation des Updates

Beispiel 1: Der Aktualisierungsdienst soll

Werktags zwischen 8 und 9 Uhr nach einer Aktualisierung suchen,
Werktags (außer Montag) zwischen 13 und 14 Uhr die Aktualisierungspakete für den DSS herunterladen,
das eigentliche Update nur Dienstag und Donnerstag ab 15 Uhr durchführen.

Lösung:

config.local.ini

# lokale Anpassung der Zeiten
update.check.start=08:00
update.check.end=09:00
update.check.days=mo,di,mi,do,fr
update.check.interval=10
update.download.days=di,mi,do,fr
update.download.start=13:00
update.download.end=14:00 
update.execution.days=di,do
update.execution.time=15:00

Beispiel 2: Der Aktualisierungsdienst soll in der Betriebsvariante teilautomatisch betrieben werden. Bei dieser Betriebsvariante soll automatisch nach Updates geprüft werden und auch die eventuell vorhandenen Downloads sollen automatisch heruntergeladen werden (sofern welche vorhanden). Dies erfolgt nur von 13 bis 14 Uhr täglich. Das Einspielen des Updates für den ASV-Server (DSS) wird durch den berechtigten Benutzer manuell angestoßen.

Lösung:

config.local.ini

# lokale Anpassung der Betriebsvariante und der Zeiten
update.mode=mixed
update.check.start=08:00
update.check.end=12:00
update.download.start=13:00
update.download.end=14:00

Beispiel 3: Der Aktualisierungsdienst soll in der Betriebsvariante „manuell“ betrieben werden. Das Herunterladen und Einspielen des Updates für DSS wird durch den berechtigten Benutzer manuell in ASV-Client angestoßen.

Lösung:

config.local.ini

# lokale Anpassung der Betriebsvariante
update.mode=manual

Beispiel 4: Der Aktualisierungsdienst soll im Parallelbetrieb verwendet werden.

Lösung:

config.local.ini

# Update für Parallelbetriebsumgebung suchen
update_environment=PARA

Automatische Programmaktualisierung des ASV-Servers (Aktualisierungsdienst)

anonymous@undisclosed.example.com (Anonymous) — Mon, 17 Nov 2025 16:48:39 +0000

Automatische Programmaktualisierung des ASV-Servers (Aktualisierungsdienst)

Die Installation der ASV-Software, besonders des ASV-Servers, ist für technisch weniger erfahrene Personen oft eine Hürde. In größeren Schulstrukturen übernehmen IT-Fachkräfte diese Aufgabe, so dass dort meist keine Probleme entstehen.

An Schulen, an denen keine Personen mit entsprechenden IT-Kenntnissen verfügbar sind, werden gerne externe Dienstleister hinzugezogen, was zu Verzögerungen führen kann.

Mit dem Aktualisierungsdienst kann das ASV Update weitestgehend automatisiert durchgeführt werden.

Typischer Ablauf eines automatischen ASV-Server-Updates

Wie in der Grafik bereits angedeutet, laufen folgende Schritte bei einem automatischen Update ab:

Die Updatepakete werden auf dem sog. Aktualisierungsserver zentral durch das ASV-Team im Ministerium bereitgestellt und das Update per RSS-Feed angekündigt
Der Aktualisierungsdienst, der auf dem Rechner installiert wurde, auf dem der ASV-Server betrieben wird, prüft in regelmäßigen Abständen, ob Updatepakete auf dem Aktualisierungsserver zur Verfügung stehen (abhängig von der jeweiligen Konfiguration!)
Wird ein Update erkannt, dann werden
1. die Programmpakete zunächst heruntergeladen
2. Zum konfigurierten Zeitpunkt (Standard: 4 Uhr nachts) wird der ASV-Server gestoppt.
3. Der ASV-Server wird auf die aktuelle Version aktualisiert.
4. Der ASV-Server wird wieder neu gestartet.
Beim nächsten Start des ASV-Clients prüft dieser gegen den ASV-Server, ob eine Aktualisierung des Clients erforderlich ist (automatisches Client-Update)

Somit wird im besten Fall ein ASV-Programmupdate vollautomatisch und ohne manuellen Eingriff durchgeführt.

Installation des Aktualisierungsdienstes

Bitte beachten Sie dazu die ausführlichen Installationshinweise unter Installation von ASV.

Anpassung des Aktualisierungsdienstes an eigene Bedürfnisse

Nach der Einrichtung des Dienstes ist es in bestimmten Situationen erforderlich, die Standardvorgaben an die Anforderungen der eigenen Schule anzupassen.

Beispiel: ASV-Server School wurde auf dem Bürorechner im Sekretariat installiert. Dieser läuft werktags immer von 7 bis 16 Uhr. Trotz der Ankündigung des ASV-Updates auf www.asv.bayern.de wird scheinbar das angekündigte Update nicht automatisch eingespielt - obwohl kein Fehler oder Problem in der eigenen Installation erkennbar ist

Die Ursache liegt sicherlich daran, dass nach Standardkonfiguration das Update nächtlich um 4 Uhr durchgeführt werden soll, der Rechner aber nie zu dieser Zeit in Betrieb sein wird.

Erstellung einer eigenen Konfiguration

Wechseln Sie im Installationsordner des ASV-Servers in der Unterordner update-service/service/configuration. Legen Sie dort eine neue Textdatei mit dem Namen config.local.ini an.

Eine Änderung von Originaldateien - insbesondere der config.ini - führt aufgrund der Konsistenzprüfung beim Start von ASV dazu, dass der Dienst nicht mehr starten wird. Gehen Sie deshalb unbedingt wie beschrieben vor. Bitte beachten Sie, dass die Zeiträume zwischen update.check, update,download und update.excecution dürfen sich nicht üerbschneiden.

Folgende Einträge stehen zur Verfügung:

Eintrag	Bedeutung	Beispiel
update.check.start	Uhrzeit, ab der geprüft wird, ob ein Update bereit steht	update.check.start=10:00	Nachfrage nach Update ab 10:00 Uhr
update.check.end	Uhrzeit, bis zu der geprüft wird, ob ein Update bereit steht	update.check.end=12:00	Nachfrage nach Update bis 12:00 Uhr
update.check.days	Wochentage, an denen (im festg. Zeitraum) nach einem Update nachgefragt wird	update.check.days=mo,di,mi,do	Nachfrage nach Update Mo-Do
update.check.interval	Zeitraum, der zwischen zwei Updateanfragen liegt	update.check.interval=10	Nachfrage alle 10 Minuten
update.download.days	Wochentage, an denen Aktualisierungsdateien heruntergeladen werden	update.download.days=di,mi,do	Downloads nur Di, Mi und Do
update.download.start	Uhrzeit, ab der ein Download gestartet wird	update.download.start=13:00	Download ab 13:00 Uhr
update.download.end	Uhrzeit, bis zu der ein Download gestartet wird	update.download.end =15:00	Download bis 15:00 Uhr
update.execution.time	Uhrzeit, ab der eine Aktualisierung gestartet wird	update.execution.time=16:00	Start eines Updates ab 16:00 Uhr
update.execution.days	Wochentage, an denen ein Update des ASV-Server durchgeführt wird	update.execution.days=di,mi	Update nur Di oder Mi
update.mode	Wahl des Updatemodes (vollautomatisch, teilautomatisch, manuell)	update.mode=auto	Vollautomatische Installation des Updates

Für den oben geschilderten Fall ergäbe sich damit folgende config.local.ini:

config.local.ini

update.check.start=10:00
update.check.end=12:00
update.check.days=mo,di,mi,do
update.check.interval=10
update.download.days=di,mi,do
update.download.start=13:00
update.download.end=15:00
update.execution.days=di,mi
update.execution.time=16:00

Nach dem Neustart des Aktualisierungsdienstes wird

Mo-Do zwischen 10 und 12 Uhr nach einem ASV-Update angefragt
Di-Do zwischen 13 und 15 Uhr mögliche Pakete herunterladen und
Di oder Mi ab 16 Uhr das eigentliche Update durchgeführt.

Bitte beachten Sie, dass die verschiedenen Zeitintervalle nicht überlappen und die Uhrzeiten von update.check.end und update.download.start sowie von update.download.end und update.execution.time nicht gleich sein dürfen.

Weitere Informationen finden Sie unter Individuelle Anpassungen des Aktualisierungsdienstes

Vorgehen im Problemfall

Bitte kontrollieren Sie vorab folgende Punkte, bevor Sie sich mit Ihrem zuständigen Multiplikator in Verbindung setzen:

Wird mindestens ASV-Version 1.27.379 bei Programm- und Aktualisierungsdienst eingesetzt (siehe FAQ unten)? Falls nein, ist eine Neuinstallation der aktuellen ASV-Version erforderlich, das automatische Update wird mit früheren Versionen grundsätzlich nicht funktionieren.
Ist im Netzwerk der Zugriff auf https://update.asv.bayern.de möglich?
Erscheinen Fehlermeldungen in den Log-Dateien des Aktualisierungsdienstes (update-service/service/logs/… und update-service/launcher/logs/…)?
1. Eintrag „Skip … update in progress“, dann folgen Sie der Anleitung zum Initialisieren des Aktualisierungsdienstes.
Sollte der Dienst asv-update-service nach einem Systemstart nicht laufen, obwohl die Konfiguration des Dienstes auf „Automatisch“ steht, dann stellen Sie den Start auf „Automatisch (verzögert)“ um.

Falls Sie zu keiner Lösung kommen, wenden Sie sich an Ihren Multiplikator bzw. eröffnen Sie eine Supportanfrage unter https://helpdesk.asv.bayern.de/ mit dem Hilfethema Installation / Automatisches Update

FAQ - Häufige Fragen

Die ASV-Server Installation auf dem Rechner, auf dem der ASV-Server installiert wurde, wird trotz angekündigtem Update nicht aktualisiert.

Kontrollieren Sie zunächst - wie oben beschrieben - die Konfiguration des Aktualisierungsdienstes und nehmen Sie eventuell nochmals Änderungen vor (Beispiel: Rechner läuft nur tagsüber). Falls das nicht helfen sollte, gehen Sie bitte alle Schritte unter Vorgehen im Problemfall durch, um eine mögliche Ursache zu finden.

ASV wird in einer (regional) zentralen Installation betrieben. Muss ich das autom. Update einrichten?

Nein, der Betreiber ist für die Einrichtung und den Betrieb verantwortlich. Er wird selbst entscheiden, ob er ein ASV-Update manuell einspielt oder den Aktualisierungsdienst einsetzt.

Woran erkenne ich als ASV-Nutzer, dass der ASV-Server aktualisiert werden muss?

Sie erhalten bei der Aktualitätsprüfung eine abweichende Version angezeigt.

Was passiert, wenn beim Start eines Updates noch Benutzer an ASV angemeldet sind?

Bei Beginn des Updates werden erhalten alle angemeldeten Nutzer in ASV einen Hinweis, Ihre Arbeit innerhalb einer festgelegten Zeit zu beenden, da sie sonst automatisch abgemeldet und der Arbeitsstand gespeichert werden.

Wie kann ich die Version von ASV und des Aktualisierungsdienstes kontrollieren?

Die eingesetzte ASV-Version können Sie über die Aktualitätsprüfung ablesen. Die Version des Aktualisierungsdienstes lesen Sie aus der Log-Datei update-service.log im Verzeichnis update-service/service/logs/ aus. Starten Sie den Dienst neu und suchen Sie im Log nach folgendem Eintrag:

03.07.2016, 17:28:41 [server-manager ] INFO ServerManager - startup time: 2858ms
03.07.2016, 17:28:41 [server-manager ] INFO ServerManager - Update Service (1.27.243_032_12) started…

Gibt es neben dem vollautomatischen Update noch weitere Möglichkeiten?

Neben der Einstellung Vollautomatisch (auto) kann auch die Installation auch noch nach manueller Rückfrage eingespielt werden (siehe Erstellung einer eigenen Konfiguration)

Muss ich beim Einsatz eines Proxys im Netzwerk etwas beachten?

Wird im Netzwerk selbst für den Zugriff auf das Netzwerk ein Proxy verwendet, so muss im Normalfall keine weitere Änderung erfasst werden. Durch den erforderlichen Zugriff auf das Zentralsystem wurde im Regelfall bereits eine Proxy-Konfiguration vorgenommen.

Ist eine Anpassung an einer Firewall erforderlich?

Der Zugriff auf https://update.asv.bayern.de muss gewährleistet sein.