Update des Servers

HELIUM 5 Server aktualisieren

Im Folgenden beschreiben wir, wie Sie Ihren HELIUM 5 Server aktualisieren. Das Update wird direkt auf Ihrem HELIUM 5 Server ausgeführt.

Innerhalb der HELIUM 5 Dateistruktur befindet sich auf Ihrem Server ein Ordner update, zum Beispiel:

C:\helium_v\update

Wechseln Sie in diesen Ordner.

Vorbereitung

Einstellungen überprüfen

Überprüfen Sie die Einstellungen in der Datei update.properties. Die Datei liegt im Update-Ordner.

Stellen Sie sicher, dass Sie die korrekten FTP-Einstellungen verwenden:

ftp_server = ftps://release.microtech.de
ftp_user = helium5
ftp_password = **********
ftp_port = 222
ftps_implicit_mode = false

Stellen Sie sicher, dass der richtige Datenbankname eingetragen ist:

db_name = LP

Bei einem Update eines Testsystems verwenden Sie stattdessen:

db_name = LP_TEST

Update herunterladen

1. Öffnen Sie eine Kommandozeile.

2. Navigieren Sie in den Ordner update.

3. Geben Sie folgenden Befehl ein und drücken Sie Enter:

java -jar hvserverupdater.jar nur_herunterladen

Wählen Sie die gewünschte Version aus. Die aktuelle Version ist bereits markiert. Wenn Sie diese installieren möchten, drücken Sie einfach Enter.

Sie können das Update im Hintergrund herunterladen und währenddessen weiterarbeiten. Sobald der Download abgeschlossen ist, erscheint eine Erfolgsmeldung in der Kommandozeile.

Dienste beenden

Informieren Sie alle Benutzer, dass ein Update installiert wird. Planen Sie dafür etwa 30 Minuten ein. Während des Updates steht HELIUM 5 nicht zur Verfügung.

Beenden Sie alle HELIUM 5 Dienste.

• Windows Server: Beenden Sie den HELIUM V Applikationsserver (WildFly) und gegebenenfalls den Dienst HELIUM V Apache Tomcat. Sie stoppen die Dienste im Task-Manager über den Tab Dienste.

• Linux Server: Beenden Sie den Service wildfly und gegebenenfalls den Service hvtomcat mit systemctl stop.

systemctl stop wildfly
systemctl stop hvtomcat

Datensicherung

Erstellen Sie eine Datensicherung Ihrer HELIUM 5 Umgebung. Eine vollständige Datensicherung besteht aus:

• einem Datenbank-Backup

• einer Sicherung Ihrer Reports und Skripte

Sichern Sie das Verzeichnis für Reports und Skripte. Sie finden es in der HELIUM 5 Verzeichnisstruktur auf Ihrem Server unter folgendem Pfad:

wildfly-12.0.0.final\server\helium

Beispiel:

C:\helium_v\wildfly-12.0.0.final\server\helium

Sichern Sie den gesamten Ordner.

Erstellen Sie anschließend ein Backup Ihrer Datenbank. Wir empfehlen, das Datenbank-Backup zu erstellen, wenn alle Benutzer abgemeldet sind und keine HELIUM 5 Dienste mehr laufen.

Backup einer Microsoft SQL Server Datenbank

1. Öffnen Sie das SQL Server Management Studio.

2. Melden Sie sich an.

3. Wählen Sie Ihre Datenbanken aus.

4. Erstellen Sie pro Datenbank eine Backup-Datei über Rechtsklick → Sichern.

Backup einer PostgreSQL Datenbank

Wenn Sie das Programm pgAdmin installiert haben, melden Sie sich an und wählen Sie Ihre Datenbanken aus. Erstellen Sie pro Datenbank eine Backup-Datei über Rechtsklick → Sichern.

Wenn pgAdmin nicht installiert ist, erstellen Sie die Sicherung über die Kommandozeile. Dafür benötigen Sie den Installationspfad von PostgreSQL.

Vorgehen unter Windows

Befehl für Windows, wenn PostgreSQL 10 installiert ist:

"C:\Program Files\PostgreSQL\10\bin\pg_dump.exe" -Fc -h localhost -U postgres --verbose -f LP.backup LP

Vorgehen unter Linux

1. Melden Sie sich zunächst per SSH an.

2. Wechseln Sie bei Bedarf mit sudo -s zum Benutzer root.

3. Wechseln Sie in den Ordner, in dem das Backup gespeichert werden soll.

4. Führen Sie folgenden Befehl aus:

pg_dump -Fc -h localhost -U postgres --verbose -f LP.backup LP

Installation

Die Installation des Updates wird über die Kommandozeile ausgeführt.

1. Öffnen Sie eine Kommandozeile.

2. Navigieren Sie in den Ordner update.

3. Geben Sie folgenden Befehl ein und drücken Sie Enter:

java -jar hvserverupdater.jar ohne_ftp

Wählen Sie die gewünschte Version aus. Die aktuelle Version ist bereits markiert. Wenn Sie diese installieren möchten, drücken Sie einfach Enter.

Bestätigen Sie anschließend die Prüfung der Konfigurationsdatei. Prüfen Sie den angezeigten Inhalt und stellen Sie insbesondere sicher, dass der Datenbankname korrekt ist. Bestätigen Sie mit Enter.

Eventuelle Rückfragen können Sie in der Regel mit Enter bestätigen.

Warten Sie, bis das Update vollständig installiert ist. Danach erscheint eine Erfolgsmeldung in der Kommandozeile.

Nachbereitung

Dienste starten

Starten Sie die zuvor beendeten Dienste wieder.

• Windows Server: Starten Sie den HELIUM V Applikationsserver (WildFly) und gegebenenfalls den Dienst HELIUM V Apache Tomcat. Sie starten die Dienste im Task-Manager über den Tab Dienste.

• Linux Server: Starten Sie den Service wildfly und gegebenenfalls den Service hvtomcat mit systemctl start.

systemctl start wildfly
systemctl start hvtomcat

Clients aktualisieren

Sobald Sie sich an einem Client anmelden, werden Sie gefragt, ob Sie ein Update installieren möchten. Bestätigen Sie die Abfrage, um automatisch ein Client-Update zu erhalten.

Sollte das automatische Update nicht möglich sein, können Sie den Client manuell installieren. Informationen dazu finden Sie im Kapitel Installation des Clients.

Wartungsaufgabe: Sperren lösen

Gegebenenfalls bestehen noch Datensatzsperren, zum Beispiel aufgrund eines ungeplanten Programmendes.

1. Öffnen Sie einen HELIUM 5 Client.

2. Melden Sie sich mit höchstmöglichen Rechten an.

3. Stellen Sie sicher, dass alle anderen Benutzer abgemeldet sind.

4. Öffnen Sie System → unterer Reiter Gesperrt → oberer Reiter 1 Gesperrt.

5. Prüfen Sie die Liste. In der Regel ist sie leer.

6. Wenn Einträge vorhanden sind, obwohl alle Benutzer abgemeldet sind, löschen Sie diese über das X.