HPM Installation / Quartalsupdates

Anbei werden Informationen für eine sichere HPM Installation aufgeführt.

Vorbereitung

HPM Installationsdateien und Hinweise von https://aka-portal.haevg.de beziehen
Die Mindestanforderungen für die HPM Installation beachten
Sofern bestehende Installations-Verzeichnisse geändert oder gelöscht werden: Sicherung von bestehenden Log/Seed/Konfigurationen und vHOK Daten s. Sicherung von Konfig/vHOK/Logs
Sofern ein neuer Praxisserver angelegt oder sich die HPM Instanz-ID ändert (neue OS Installation)
- Anfrage für neue HOK an HÄVG stellen (Email vpn-zertifikat@haevg-rz.de)
  - Je BSNR, und je HPM Installation wird ein HOK benötigt. Bsp.:
    - 1 BSNR, 2 HPM Installationen → 2 HOKs
    - 3 BSNR, 1 HPM Installation (Server) → 3 HOKs
- Bei sich ändernder HPM Instanz-ID können bestehende vHOK nicht weiter genutzt werden
  - Die Instanz-ID hängt am Fingerabdruck der Systems (Hardware)

Es wird zwischen Erst- und Folgeinstallation unterschieden

Bei Erstinstallation
Ausführen des HPM Installer
- HOK an geeignete USB Ports anschließen
- Installer mit administrativen Rechten ausführen, damit Dienste installiert und Systemdateien geschrieben werden
- Im Standardfall kann der Installer ohne spezielle Konfiguration gestartet werden
  - Wenn Ports/Verzeichnisse angepasst werden sollen, Config-Datei anpassen und im Installeraufruf nutzen
  - Alternativ: nach der Installation die Config-Datei anpassen und den HPM-Dienst neu starten
Bei Folgeinstallation (Quartalsupdate)
HOK an geeignete USB Ports anschließen
Sofern bestehende Installations-Verzeichnisse geändert oder gelöscht wurden:
- Verzeichnis für HPM Konfiguration + vHOK + Logs anlegen
  - Gesicherte Dateien zurückkopieren
Ausführen des HPM Installer
- Installer mit administrativen Rechten ausführen, damit Dienste installiert und Systemdateien geschrieben werden
- Im Standard übernimmt der Installer Konfigurationen / Seeds / vHOK, wenn sie in den Verzeichnissen liegen

Prüfung der korrekten Installation
- Der Installer sollte mit ReturnCode 0 beendet sein
- Das Installer Logfile ist hpm_installer.log
Prüfung der Funktionalität
- Wichtige HZV Endpunkte Abrechnung, Update, vHOK sollten erreichbar sein
  - HPM Infoseite bietet Konnektivitäsprüfung und Status zu den Endpunkten
  - Sollte ein Endpunkt nicht erreichbar sein, Netzwerk/Firewall Einstellungen prüfen
    - https://docs.haevg-rz.de/haevg-pruefmodul-hilfestellung/#firewall-einstellungen
- Fachservices sollten gestartet sein
  - HPM Infoseite bietet Fachservice Status
Hinweis zum Start des HPMs nach Installation:
- Beim Start des HPMs wird automatisch auf HPM-Updates geprüft.
- Es kann sein, dass sofort ein Update der HPM Version erfolgt, inkl. Neustart der Dienste!
- Der Vorgang dauert 1 bis ca 5 Min. Hinweise dazu finden sich im Logfile hpm.log
  - Zeilen [ INFO] [ updater] Update wird ausgeführt.

Log, Seed und HPM Konfigurationen:

Pfad bei einer Standardinstallation
Windows: C:\ProgramData\HÄVG Rechenzentrum AG\HÄVG-Prüfmodul\
Linux: /usr/share/HÄVG_Rechenzentrum_AG/HÄVG-Prüfmodul/
macOS: /usr/local/share/HÄVG_Rechenzentrum_AG/HÄVG-Prüfmodul/
- *.log (Alle Logdateien)
- seed.file
- hpm_config.json
vHOK-Dateien:

Pfad bei einer Standardinstallation
- Windows: C:\ProgramData\HÄVG Rechenzentrum AG\HÄVG-Prüfmodul\vHOKs
- Linux: /usr/share/HÄVG_Rechenzentrum_AG/HÄVG-Prüfmodul/vHOKs
- macOS: /usr/local/share/HÄVG_Rechenzentrum_AG/HÄVG-Prüfmodul/vHOKs
  - *.vHOK (Alle vHOK)

Installationsschritte, Mindestanforderungen, Firewall Freischaltungen und mehr. https://docs.haevg-rz.de/haevg-pruefmodul-anleitung/