Amtliche Schulverwaltung - Dokumentation - alle:technik:install:dss:linux

Installation der ASV Serverkomponente (DSS)

anonymous@undisclosed.example.com (Anonymous) — Fri, 11 Aug 2023 07:51:32 +0000

Installation der ASV Serverkomponente (DSS)

Der Betrieb des DSS benötigt keine root-Rechte und sollte daher auch nicht mit root-Rechten laufen. Allerdings sollte er aus Sicherheitsgründen als root installiert werden. Im Betrieb läuft er dann mit den Rechten eines eigens angelegten, unprivilegierten Benutzers asvdss.

Vorbereitung

Anlegen des Benutzers asvdss

Legen Sie unter debian/Ubuntu einen Systembenutzer asvdss mit dem folgenden Kommando an:

root@sonne:/# adduser --system --no-create-home --disabled-login asvdss

SuSE/OSS-Nutzer verwenden den folgenden Befehl:

root@sonne:/# useradd -r  -g nogroup -M asvdss

Die Installation und spätere Updates des DSS sollten immer als root duchgeführt werden. Die Ausführung des DSS sollte jedoch immer unter dem Benutzer asvdss geschehen. Dies ist durch die Verwendung des init-Skripts (siehe unten) gewährleistet. Dieses wird zwar als root gestartet, übergibt jedoch die Ausführung an den user asvdss.

Ubuntu/Debian

An der graphischen Oberfläche starten Sie zunächst ein Terminal (Menü → Terminal). Für die Installation der ASV kopieren Sie dann das Installationspaket für die Serverkomponente (z.B. 1.16.348_030_03_by-installer.zip) sowie gegebenenfalls die OWA-Zertifikatsdatei in ein geeignetes Verzeichnis (z.B. /tmp/asv). Selbstverständlich kann hierfür auch der Dateimanager unter xfce benutzt werden. Nun Archiv entpacken¹⁾ und (sofern nötig) das Installationsskript ausführbar machen:

root@sonne:/# mkdir /tmp/asv
root@sonne:/# unzip 1.16.348_030_03_by-installer.zip -d /tmp/asv
root@sonne:/# cd /tmp/asv
root@sonne:/tmp/asv# chmod +x install.sh

Nun kann der Installationsassistent gestartet werden. Er entpackt das ASV-Archiv in ein Verzeichnis, passt die Konfigurationsdatei und legt eine intiale Datenbank an:

root@sonne:/tmp/asv# ./install.sh

Nach der Installation kann das temporäre Verzeichnis samt OWA-Zertifikatsdatei gelöscht werden.

OpenSchoolServer

Kopieren Sie das Installationspaket für die Serverkomponente 1.16.348_030_03_by-installer.zip sowie gegebenenfalls die OWA-Zertifikatsdatei z.B. in das home-Verzeichnis des Benutzers root. Rechtklicken Sie auf das Dateisymbol und wählen Sie im Kontext-Menü „Hier entpacken“.

Das Archiv wird nun in das Verzeichnis 1.16.348_030_03_by-installer.zip entpackt. Zunächst muss noch die Datei install.sh ausführbar gemacht werden. Hierzu rechtsklicken Sie auf das Dateisymbol und wählen Sie im Kontextmenü „Eigenschaften“. Im folgenden Dialog wählen Sie den Reiter „Zugriffsrechte“ und aktivieren das Optionsfeld „Datei als Programm ausführen“.

Schließen Sie nun das Dialogfenster und doppelklicken Sie auf die Datei install.sh. Die Datei install.sh ist ein shell-Skript, eine Art ausführbare Textdatei. Daher werden Sie nun gefragt, ob Sie die Datei mit einem Texteditor öffnen oder ausführen möchten. Wählen Sie „Ausführen“.

Anschließend startet der Installationsassistent:

Installationsassistent

Weiter geht es nun distributionsunabhängig.

Sollen auf dem DSS-Rechner mehrere DSS-Instanzen gleichzeitig installiert werden, beispielsweise eine zweite Instanz für Schulen im Parallelbetrieb, weicht die Installationen in einigen Punkten leicht ab. Bitte beachten Sie dazu die entsprechenden Hinweise.

Installationsart

Im folgenden Dialog wird die Installationsart gewählt. Wählen Sie hier „Mehrplatz-Server“ aus.

Zielverzeichnis

Nun legen Sie das Zielverzeichnis fest. Der Vorschlag /opt/asv sollte übernommen werden.

Bei mehreren DSS-Instanzen installieren Sie jede in ein eigenes Verzeichnis. Einen zusätzlichen DSS im Parallelbetrieb zum Beispiel nach /opt/asv_para

Zertifikats-Auswahl

Ein Zertifikat ist nötig, um den Datenverkehr zwischen dem DSS und dem ZSS zu verschlüsseln. Hierfür benutzen Sie das OWA-Zertifikat, welches sich bereits an Ihrer Schule befindet. Das anzugebende Passwort ist nicht Ihr OWA-Passwort, sondern jenes, welches Sie bei der Installation des Zertifikats auf den Clients verwendet hatten. Das Passwort sollte sich im Safe befinden.

PostgreSQL Verbindungsdaten

Die Werte des folgenden Dialogs sind bereits sinnvoll vorbelegt und brauchen normalerweise bis auf die Passwörter nicht geändert werden:

PostgreSQL Verbindungsdaten
- Kennung: postgres (Kennung des Datenbank-„Superusers“)
- Passwort: In das Passwort-Feld geben Sie beim OSS das root-Passwort bzw, bei Ubuntu/Debian das zuvor geänderte postgresql-Passwort ein.
- Host: localhost (Wenn DSS und Postgres auf derselben Maschine laufen, können Sie den eintrag stehen lassen)
- Port: 5432 (Standardport von Postgresql)
- Initiale Datenbank: postgres (In dieser Datenbank verwaltet postgres sich selbst)
ASV Datenbank
- Datenbankname: asv (Diesen Namen können Sie so belassen)
  
  Für mehrere DSS-Instanzen vergeben Sie bitte jeweils eigene Datenbank-Namen, sodass jede Instanz ihre Daten getrennt von den anderen ablegt. Im Parallelbetrieb beispielsweise asv_para statt asv.
- ASV DB Kennung: asv (Dies ist die Kennung des Datenbankbenutzers, der die Rechte an der Datenbank asv hat)
- ASV DB Kennwort: Das ASV DB Passwort können Sie frei wählen. Dieses wird als Passwort für den Datenbankbenutzer asv gesetzt.

Der ASV-Client kommuniziert mit dem DSS (ASV-Server) über den Port 8765. Dieser Port muss gegebenenfalls geöffnet werden. Dies gilt sowohl für den Server als auch für die Clients!

Bei mehreren DSS-Instanzen benötigt jede Instanz ihren eigenen Port. Finden Sie in der Datei „configuration/config.ini“ die Zeile „org.osgi.service.http.port=8765“. Vergeben Sie einen anderen Port, zum Beispiel 8766. Im zweiten Schritt muss bei den Mehrplatz-Clients der Port ebenfalls entsprechend geändert werden. Damit der zweite DSS auch nach einem Update noch funktioniert, legen Sie bitte eine config.local.ini mit genau dieser neuen Zeile an.

Installation

Nun werden die Dateien aus dem Installationspaket in das Zielverzeichnis kopiert und die Konfigurationsdatei der ASV angepasst. In einem weiteren Schritt wird die Datenbank angelegt und initialisiert.

Verknüpfungen einrichten

Das Einrichten eines Desktop-Starters funktioniert nicht mit allen Desktop-Oberflächen (und ist auch nicht nötig, da der DSS als Service gestartet werden sollte). Daher: Option ggf. deaktivieren

Nach diesem Schritt kann der Assistent beendet werden.

Anpassen der Verzeichnisrechte

Nach der Installation „gehören“ alle installierten Verzeichnisse und Dateien dem Benutzer root. Da der DSS jedoch als Benutzer asvdss ausgeführt wird und seine logfiles im Unterverzeichnis logs ablegt, muss der Benutzer asvdss Schreibrechte auf dieses Verzeichnis erhalten. Da das Verzeichnis direkt nach der Installation noch nicht existiert, muss es noch angelegt werden. Des weiteren legt der DSS im Verzeichnis /opt/asv eine Dateil .lock an und schreibt in das Unterverzeichnis configuration. Daher benötigt der Benutzer asvdss auch Rechte an diesen Verzeichnissen.

root@sonne:/# mkdir /opt/asv/logs
root@sonne:/# chown asvdss:nogroup /opt/asv/logs
root@sonne:/# chown asvdss:nogroup /opt/asv/configuration
root@sonne:/# chown -R asvdss:nogroup /opt/asv/client
root@sonne:/# chown asvdss:nogroup /opt/asv

WICHTIG: Falls die interne H2-Datenbank statt PostgreSQL verwendet wird (möglich ab Versison 1.27), ist noch zusätzlich der Besitzer des Verzeichnisses database anzupassen:

root@sonne:/# chown -R asvdss:nogroup /opt/asv/database

Installation eines init-scripts zum automatischen Start der ASV

Der DSS ist ein klassischer daemon und sollte nicht mit einem direkten Aufruf, sondern über ein Init-Script gestartet bzw. gestoppt werden. Dieses Init-Script übernimmt auch den automatischen Start bzw. Stop des DSS beim Hoch- bzw. Herunterfahren des Servers.

Das Init-Script dss können Sie hier herunterladen. Die müssen dieses einfach entpacken und in das Verzeichnis /etc/init.d kopieren, ausführbar machen und an Ihre Gegebenheiten anpassen.

Das Skript funktioniert sowohl für debian-basierende Distributionen (z.B. Ubuntu) als auch für OpenSuSE.

Wichtig sind vor allem folgende Einträge:

JAVA_HOME=/opt/Oracle_Java/jre1.8.x_xx

Passen Sie diese Zeile falls nötig an das Installationsverzeichnis Ihrer Java-Installation an.

serviceUser="asvdss" 
serviceGroup="nogroup"

Linux-Benutzer und -Gruppe, mit dessen Rechten die ASV läuft

applDir="/opt/asv"
serviceUserHome=""

Installationsverzeichnis der ASV und home-Verzeichnis des ASV-Benutzers

serviceLogFile="/opt/asv/$serviceNameLo-service.log"

Hier werden die log-Dateien des Dienstes abgelegt. Wenn Sie die log-Dateien lieber in das Verzeichnis /var/log legen möchten, achten Sie darauf, dass der Benutzer asvdss dort entsprechende Schreibrechte besitzt. Der DSS schreibt noch eigene Log-Fils, die ebenfalls in /opt/asv/logs geschrieben werden.

Falls die h2-Version der Datenbank verwendet wird (ASV-Server-School), müssen am Anfang des Skripts noch die Zeilen

# Required-Start:       postgresql
# Required-Stop:        postgresql

ersetzt werden durch

# Required-Start:       
# Required-Stop:

Setzen der Start-/Stop-Skripte -- System-V

Mit dem folgenden Befehl werden in den Verzeichnissen /etc/rcX.d symbolische Links gesetzt, die den DSS in den einzelnen Runleveln automatisch starten bzw. stoppen. Die Informationen hierzu sind im Kopf des init-Scripts abgelegt.

Debian/Ubuntu: root@sonne# update-rc.d dss defaults
OpenSuSE root@sonne# chkconfig --set dss on

Um die Links wieder zu entfernen, benutzen Sie die folgende Variante:

Debian/Ubuntu: root@sonne# update-rc.d -f dss remove
OpenSuSE: root@sonne# chkconfig --set dss off

Nun wird die ASV-Serverkomponente beim Herunterfahren des Servers beendet und beim Hochfahren automatisch gestartet.

Zum manuellen Starten, Stoppen und Statusabfragen können Sie nun die gewohnten Befehle verwenden:

root@sonne# /etc/init.d/dss start
root@sonne# /etc/init.d/dss stop
root@sonne# /etc/init.d/dss status

Test, ob ASV-Server läuft

Ein einfacher Test, ob der dss-Prozess läuft, kann mittels root@sonne:~/# ps –aux | grep java durchgeführt werden.

Wenn die ASV läuft, sollte die Ausgabe des obigen Befehls etwa so aussehen:

asvdss   12091  1.3  8.3 1925956 340104 ?      Sl   17:49   0:15 /usr/bin/java -Declipse.ignoreApp=true -Dosgi.noShutdown=true -Xmx512m -Xms128m -Xverify:none -XX:PermSize=128m -XX:MaxPermSize=160m -XX:+UseBiasedLocking -XX:+CMSClassUnloadingEnabled -XX:+UnlockDiagnosticVMOptions -XX:+UnsyncloadClass -jar startup.jar
root     12309  0.0  0.0   7048   860 pts/2    S+   18:08   0:00 grep java

Interessant ist die erste Zeile. Sie zeigt den laufenden Prozess des DSS an. In der ersten Spalte steht der Benutzer asvdss, unter dem der Porzess ausgeführt wird.

Deinstallation der ASV

Für die Deinstallation der ASV genügt es, /opt/asv sowie die Datenbank asv zu löschen. Die ASV muss hierfür vorher beendet werden.

Löschen des ASV-Verzeichnisses
Dies geschieht mit Hilfe des Dateimanagers oder von der Konsole aus mittels root@sonne:/opt# rm –r asv
Löschen der ASV-Datenbank
Die ASV-Datenbank löschen Sie am einfachsten an der Konsole mit Hilfe des Tools dropdb.
root@sonne:/# su postgres
postgres@sonne:/ dropdb –h localhost asv
Eine weitere Möglichkeit ist die Benutzung des graphischen Tools pgadmin.
Löschen der symbolischen Links in den init-Verzeichnissen: update-rd.d -f dss remove (Debian/Ubuntu) bzw. chkconfig --set dss off (OpenSuSE)

¹⁾

Falls das Paket unzip nicht installiert ist, lässt es sich mit dem Befehlt aptitude install unzip leicht nachinstallieren.

Installation von ASV unter Debian, Ubuntu-Server

anonymous@undisclosed.example.com (Anonymous) — Fri, 12 May 2023 11:08:35 +0000

Installation von ASV unter Debian, Ubuntu-Server

Dokumentation geprüft: Ubuntu 16.04 LTS, 18.04 LTS

Grundsätzliches zur Installation unter Linux

Der ASV-Server sollte grundsätzlich auf einem Linux-Serversystem installiert werden. In der Regel wird zu diesem Zweck eine Linux-System mit minimaler Softwareausstattung gewählt um höchstmögliche Stabilität zu erwirken. Diese Serversysteme werden überwiegend an der Kommandozeile administriert. Sofern man sich von einem Linux-Desktopsystem (Ubuntu, Mint, etc) per ssh einloggt, kann sogar der graphische Installations- und Update-Vorgang von ASV ausgeführt werden. Die beschriebene Vorgehensweise kann bei Bedarf auch von einem Linux-Live-system ausgeführt werden. Von einem Windowsgerät aus funktioniert die ssh-Übertragung der grafischen Ausgabe mittels Putty auch. Zu diesem Zweck sollte man diese Anleitung beherzigen!

Sollte der ASV-Server auf einem Linux mit graphischen Desktop-System installiert werden, kann die nachfolgende Anleitung ebenfalls verwendet werden. Die Unterscheidung zwischen Client und Server, sowie das einloggen mittels ssh ist jedoch hinfällig.

Eine Installation von ASV auf sogenannten „Schulserver-Lösungen auf Linuxbasis“ ist grundsätzlich denkbar, hierzu sollte jedoch unbedingt jemand zu Rate gezogen werden, der mit den individuellen Ausprägungen dieses Systems vertraut ist.

Vorbereitung des Server-Betriebssystems

Debian oder Ubuntu-Server Grundinstallation ohne graphisches Desktopsystem mit Internetzugang, statischer IP-Adresse im lokalen Netz.

Bitte beachten: der SSH-Dienst sollte X-Forwarding unterstützen (/etc/sshd/sshd_config: X11Forwarding yes; PermitRootLogin yes; anschließend SSH-Dienst neu starten)

Postgres muss installiert sein, das Passwort für den Benutzer postgres muss gesetzt sein.

Hinweis aus dem Forum:
Wenn man am Ende des Installers die Option „Zusammenfassung anzeigen“ anwählt, so muss auf einer CentOS 7 Minimal-Server-Installation das Paket „gtk2“ und dessen Abhängigkeiten mit installiert sein (am einfachsten über yum).
Wird die Option nicht gewählt, geht es auch ohne!

Vorbereitung des Linux-Desktop-Clients

Java muss bereits installiert sein. Siehe dazu Java-Installation.

Standardinstallation eines graphischen Linux-Desktops (Ubuntu, Mint, etc.) ASV-Installationsprogramm herunterladen: Downloads
ASV-Server-Startskript herunterladen: dss.zip

Falls die h2-Version der Datenbank verwendet wird (ASV-Server-School), muss das Skript dss mit einem Texteditor angepasst werden. Die Zeilen

# Required-Start:       postgresql
# Required-Stop:        postgresql

müssen ersetzt werden durch

# Required-Start:       
# Required-Stop:

Installation

Im Terminalfenster eines graphischen Clients:

 user@client ~$ scp Downloads/2.X.XXX_XXX_XX_by-installer.zip root@SERVER-IP:.
 user@client ~$ scp Downloads/dss.zip root@SERVER-IP:.
 user@client ~$ scp Downloads/ssl_KM_Z2015_1234.p12 root@SERVER-IP:.
 user@client ~$ ssh -X root@SERVER-IP

Per SSH (mit -X) als Benutzer root auf dem Server eingeloggt:

 server ~# adduser --system --no-create-home --disabled-login asvdss
 server ~# unzip 2.X.XXX_XXX_XX_by-installer.zip
 server ~# xterm      
 server ~# /usr/bin/java -Xmx512m -jar ASV_by_install.jar

Evtl. müssen die Pakete für unzip und xterm erst installiert werden:

apt-get install zip xterm

Auswählen: Mehrplatz-Server
Zertifikat eingeben
Falls ASV-Server-Enterprise mit PostgreSQL:
- postgres-Passwort: supergeheim
- asv-Passwort: supergeheim

 server ~# unzip dss.zip
 server ~# cp dss /etc/init.d/
 server ~# chmod +x /etc/init.d/dss
 server ~# update-rc.d dss defaults
 server ~# chown -R asvdss:nogroup /opt/asv 
 server ~# reboot

Im Terminalfenster eines graphischen Clients:

Nach dem Neustart des Servers sollte der ASV-Server laufen. Dies kann mit folgendem Befehl überprüft werden:

 user@client ~$ ssh root@SERVER-IP

Per SSH auf dem Server eingeloggt:

 server ~# ps aux | grep java

Die Ausgabe sollte dann ungefähr so aussehen:

 server ~# root      2708  214  3.8 1071404 300532 ?      Sl   09:57   0:10 
 /usr/bin/java -Declipse.ignoreApp=true -Dosgi.noShutdown=true 
 -Xmx512m -Xms128m -Xverify:none -XX:PermSize=128m -XX:MaxPermSize=160m 
 -XX:+UseBiasedLocking -XX:+CMSClassUnloadingEnabled 
 -XX:+UnlockDiagnosticVMOptions -XX:+UnsyncloadClass -jar startup.jar

Hinweis: UTF-8 bei PostgreSQL

Bitte achten Sie darauf, dass bei der Initialisierung der Datenbank die richtige Kodierung verwendet wird, da ASV zwingend eine UTF8-Kodierung voraussetzt. Sie erkennen dies beispielsweise

beim Anlegen der Datenbank asv am Befehl CREATE DATABASE asv WITH OWNER = asv ENCODING = 'UTF8' ….,
mit dem Befehl psql -l,
oder über das Tool pgAdmin über die Eigenschaften der Datenbank asv

Sollte dies nicht der Fall sein, muss die Kodierung geändert werden, da der Installer sonst mit einer Fehlermeldung abbricht. Die Datenbank muss gelöscht und nochmals mit der passenden Codierung angelegt werden.

Installation Java

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

Installation Java

Die Installation von Java ist nicht erforderlich.

Der ASV Installer beinhaltet eine JVM (Java Virtual Machine) und nutzt diese für sowohl Installation als auch Betrieb von DSS und Client.

pgAdmin

anonymous@undisclosed.example.com (Anonymous) — Mon, 29 Feb 2016 06:48:26 +0000

pgAdmin

Das graphische Tool pgadmin ist während der Testphase hilfreich, um die asv-Datenbank zu löschen, zu sichern oder zurückzuspielen. Im Regelbetrieb geschieht dies dann direkt aus der ASV heraus.

Installation

Ubuntu/Debian

Die Installation geschieht mittels:

root@sonne:/# aptitude install pgadmin3

Nach der Installation ist es unter der graphischen Oberfläche xfce im Menü Entwicklung zu finden.

OpenSchoolServer

Leider ist pgadmin auf der OSS-DVD nicht enthalten. Alternativ kann das rpm-Paket heruntergeladen und per Doppelklick installiert werden. Neuere Versionen des pgAdmin stehen für SuSE leider nur noch als Quellcode zur Verfügung.

Konfiguration von pgAdmin

Zunächst müssen die Daten des postgres-Servers eingegeben werden. Hierzu das „Stecker“-Symbol anklicken

Und die Parameter eintragen:

Name: Z.B. ASV-Server
Server: localhost
Port: 5432
Passwort: Auf das Postgres-Passwort ändern!

SSH-Zugriff von Windows auf Linux-Server mit Grafik-Übertragung mittel Putty und Xming

anonymous@undisclosed.example.com (Anonymous) — Mon, 28 Nov 2016 10:35:42 +0000

SSH-Zugriff von Windows auf Linux-Server mit Grafik-Übertragung mittel Putty und Xming

Xming

Xmin unter Windows installieren und starten (Default-Konfiguration). Es reicht dazu die Version 6.x. zu verwenden. Die Version 6.9.0.31 ist unter http://sourceforge.net/projects/xming/files/Xming/6.9.0.31/ erhältlich.

Putty

Einloggen auf dem ASV-Server mit putty.exe

Im xterm-Fenster die ASV-Installation starten:

 server ~# xterm
 server ~# unzip <versionsnummer>-by_installer.zip
 server ~# sh install.sh

Besonderheit bei Ubuntu

Unter Ubuntu Server darf sich der Benutzer root standardmäßig nicht anmelden. Wechselt man mit su oder sudo den Benutzer, funktioniert aber die X11-Weiterleitung auf das Windows-System nicht mehr.

Schnelle Abhilfe:

 user@server$ sudo su - 
 root@server# passwd
   (neues Passwort für Benutzer root festlegen)

Zuletzt muss noch in der Datei /etc/ssh/sshd_config die Zeile

 PermitRootLogin prohibit-password

 PermitRootLogin yes

geändert werden.

Jetzt ist ein Login für den Benutzer root per ssh erlaubt und auch X11-Forwarding funktioniert.

DSS und Updateservice einrichten und automatisiert starten lassen unter Linux (Ubuntu-Server)

anonymous@undisclosed.example.com (Anonymous) — Wed, 02 Apr 2025 14:44:54 +0000

DSS und Updateservice einrichten und automatisiert starten lassen unter Linux (Ubuntu-Server)

Dokumentation geprüft: Ubuntu 18.04 LTS

Legen Sie die folgende Datei im Ordner /opt/asv ab.

cron_start.sh

heute=`date +%Y%m%d_%T`
 
cd /opt/asv/server/bin
 
mkdir -p ../logs
 
if test -d ../logs/old
then
   mv ../logs/nohup.*.out ../logs/old
fi
 
nohup ./dssctl start >../logs/nohup.$heute.out 2>&1 &

Die Datei ausführbar machen und testweise ausführen.

 chmod u+x cron_start.sh
 ./cron_start.sh
 less logs/nohup.*.out
 less logs/asv.log

Beendet werden die Dienste mit:

 cd /opt/asv/server/bin
 ./dssctl stop --user sys --password '!!ASV!!' --time 0

Zur Konfiguration eines robusten Starts des Servers wird im Ordner configuration folgende Datei angelegt oder ergänzt:

config.local.ini

#Diese Datei sollte mit einer Leerzeile beginnen
 
#Anpassung der Konfiguration
 
#Falls die Datenbank noch nicht erreichbar ist, soll es verzögert mehrmals versucht werden.
DB_ConnectionTrials=4
DB_ConnectionWaitingTime=15

Ziel ist es, dass bei einem Start des Linux-Servers die Dienste DSS und Updateservice automatisch gestartet werden. Dazu muss die Datei crontab bearbeitet werden. Es wurde dazu eingefügt, dass nach dem Ladevorgang des Betriebssystems 120 Sekunden gewartet wird, ehe die Dienste vom System automatisch gestartet werden. Die Dauer von 120 Sekunden „Wartezeit“ ergibt sich aus dem Bootvorgang einer virtuellen Linuxmaschine. Ggf. muss diese Zeit noch angepasst werden, weil evtl. noch nicht alle Systemprogramme und -dienste zur Verfügung stehen. Hier muss man also an der Stellschraube etwas drehen. Dazu in der crontab (immer noch als user asvdss) zum Start der Dienste folgende Zeile eintragen (crontab -e):

 @reboot  sleep 120 && /opt/asv/cron_start.sh

Den Server neu starten.

 reboot now

Unattended Installation von ASV unter Debian, Ubuntu-Server

anonymous@undisclosed.example.com (Anonymous) — Fri, 11 Jul 2025 07:00:30 +0000

Unattended Installation von ASV unter Debian, Ubuntu-Server

Dokumentation geprüft: Ubuntu 18.04 LTS

Grundsätzliches zur Installation unter Linux

Der ASV-Server sollte grundsätzlich auf einem Linux-Serversystem installiert werden. In der Regel wird zu diesem Zweck ein Linux-System mit minimaler Softwareausstattung gewählt um höchstmögliche Stabilität zu erwirken. Diese Serversysteme werden überwiegend über die Kommandozeile administriert. Sofern man sich von einem Linux-Desktopsystem (Ubuntu, Mint, etc) per ssh einloggt, kann sogar der graphische Installations- und Update-Vorgang von ASV ausgeführt werden. Die beschriebene Vorgehensweise kann bei Bedarf auch von einem Linux-Live-system ausgeführt werden. Von einem Windows PC aus funktioniert der ssh-Zugang mittels Putty auch.

Vorbereitung des Server-Betriebssystems

Debian oder Ubuntu-Server Grundinstallation ohne graphisches Desktopsystem mit Internetzugang, statischer IP-Adresse oder zumindest festem Namen im lokalen Netzwerk.

Installation

Vor der Installation des ASV-Servers muss PostgreSQL Server installiert werden.

Folgende Dateien müssen auf den Server übertragen werden:

2X.X.XXX_XXX_XX_by-installer.zip
ssl_Z_KM20XX_1234.p12

Es wird empfohlen, als Installationsordner /opt/asv zu verwenden. Es kann aber auch ein anderer Ordner gewählt werden. Dabei ist zu beachten, dass keine Leerzeichen, Umlaute oder Sonderzeichen im Pfad verwendet werden.

 sudo adduser asvdss
 sudo mkdir /opt/asv
 sudo chown asvdss:asvdss /opt/asv

Evtl. muss das Paket für unzip erst installiert werden:

 apt-get install zip

Die weiteren Schritte als Benutzer asvdss durchführen:

 sudo su --login asvdss
 cd /opt/asv
 mkdir server
 mkdir installer_2X.X.XXX
 cd installer_2X.X.XXX

ACHTUNG: Das gezippte Installationsfile 2X.X.XXX_XXX_XX_by-installer.zip bzw. das Installationsverzeichnis müssen nun im Verzeichnis installer_2X.X.XXX liegen!

 unzip 2X.X.XXX_XXX_XX_by-installer.zip
 cd install
 chmod u+x *.sh

Die folgende Datei mit dem Namen „auto-install.xml“ muss ebenfalls im Ordner installer_2X.X.XXX/install abgelegt und angepasst werden. Folgendes ist unbedingt in diesem XML-File zu prüfen und ggf. anzupassen (insbesondere die postgres-Konfigurationswerte und - bei Bedarf - die Zertifikatsdaten):

Variable installPath : Der absolute Pfad des Installationsverzeichnisses des DSS, hier /opt/asv/server
Variable clientCertificateKeyStore : Der relative oder absolute Pfad zur Zertifikatsdatei .p12 mit dem Namen der Zertifkatsdatei
Variable clientCertificatePassword : Das Passwort zum zugehörigen Zertifikat .p12
Variable postgreHost : Host der Postgresdatenbank, hier localhost
Variable postgrePort : Die Portnummer der Postgresdatenbank
Variable postgreUsername : Der Benutzer Postgres, hier postgres (default)
Variable postgrePassword : Das Passwort des Postgresusers
Variable postgreDatabase : Die Datenbank, hier postgres
Variabel postgreSchema : Das Schema, hier asv
Variable postgreSchemaPwd : Das Passwort für das Schema
Variable postgreDBName : Der Datenbankname, hier asv

Sollten Sie eine unattended Erstinstallation des ASV Servers mit einer integrierten H2-Datenbank vornehmen wollen, so ändern Sie einfach die Eintragung useH2 von false auf true im TargetPanel der auto-install.xml-Datei. Die restlichen Zeilen müssen bestehen bleiben, wobei die Eintragungen für die Postgres-Datenbank vorhanden sein sollen aber für die Installation irrelevant sind.

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="SERVER"/>
    <de.isb.svp.installer.panels.TargetPanel id="destination" installPath="/opt/asv/server" useH2="false"/>
    <de.isb.svp.installer.panels.ZertifikatPanel id="certs">
        <clientCertificateKeyStore>//HierStehtDerRelativeOderAbsolutePfadZurZertifikatsdateit/ssl_Z_KM20XX_asv.zauner.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">
        <postgreHost>localhost</postgreHost>
        <postgrePort>5432</postgrePort>
        <postgreUsername>postgres</postgreUsername>
        <postgrePassword>geheimesPOSTGRESpasswort</postgrePassword>
        <postgreDatabase>postgres</postgreDatabase>
        <postgreSchema>asv</postgreSchema>
        <postgreSchemaPwd>geheimesASVpasswort</postgreSchemaPwd>
        <postgreDBName>asv</postgreDBName>
    </de.isb.svp.installer.panels.PostgreSQLPanel>
    <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="finsish" installService="false" installUS="true" showInfo="false" startApp="false" updateServiceBackupEnabled="true"/>
</AutomatedInstallation>

ACHTUNG HINWEIS: Der einfachste Weg, ein erstes Skript zu generieren, besteht darin, eine Installation durchzuführen und am Ende des Prozesses das automatisch generierte XML-File (siehe oben) zu speichern:

Anschließend können die Einstellungen für Installationspfad, Port oder IP-Adresse angepasst werden.

Ausführen der Installation des ASV-Servers und Kontrolle der Protokolldatei:

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

Um unter Linux sowohl den DSS als auch das Updateservice als Dienst einzurichten, besuchen Sie die Seite DSS und Updateservice einrichten.

JVM Parameter

Der Installer kennt Parameter ( welche)?, die man der JVM mittels „-D“ übergeben kann. Nun ist es aber unbequem, hierfür die install.sh zu editieren.

Alternative: Die JVM ergänzt Parameter aus der Umgebungsvariablen JAVA_TOOL_OPTIONS.

Beispiel:

export JAVA_TOOL_OPTIONS="-Dskip.db.version.check=true -Dskip.installer.screen.check=true"

Zertifikat installieren

anonymous@undisclosed.example.com (Anonymous) — Tue, 06 Jul 2021 12:32:37 +0000

Zertifikat installieren

Folgende Dateien müssen auf den Server übertragen werden:

2.X.XXX_XXX_XX_by-installer.zip
ssl_XXXX_Z_KM2021.p12

Evtl. muss das Paket für unzip erst installiert werden:

 apt-get install zip

Die weiteren Schritte als Benutzer asvdss (Beziehungsweise mit dem Benutzer, welcher bei der Installation angelegt wurde) durchführen:

 sudo su --login asvdss
 cd /opt/asv
 
 cd installer_2.X.XXX

ACHTUNG: Das gezippte Installationsfile 2.X.XXX_XXX_XX_by-installer.zip bzw. das Installationsverzeichnis müssen nun im Verzeichnis installer_2.X.XXX liegen!

 unzip 2.X.XXX_XXX_XX_by-installer.zip
 cd install
 chmod u+x *.sh
 
 Ausführen der Installation des ASV-Servers und Kontrolle der Protokolldatei:
 ./install.sh >install.log 2>&1
 less install.log
 #

Installationsassistent

Installationsart

Im folgenden Dialog wird die Installationsart gewählt. Wählen Sie hier „Zertifikat Installation“ aus.

Zielverzeichnis

Nun legen Sie das Zielverzeichnis fest, welches bei der Grundinstallation angelegt wurde. Hier in diesem Beispiel /opt/asv.