Zum Inhalt springen

Vidal MMI Update

Aus Gerhards Wiki
Version vom 25. November 2025, 11:17 Uhr von Gerhard (Diskussion | Beiträge) (→MediaWiki Quellcode (Wikitext))
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

PowerShell Skript: Vidal MMI Update mit Fehlerbenachrichtigung

[Bearbeiten | Quelltext bearbeiten]

Vidal MMI Update Skript ist ein Windows PowerShell-Skript, das den monatlichen oder quartalsweisen Update-Prozess der Vidal MMI (oder AMTS) Datenbanken automatisiert. Es beinhaltet Schritte zum Stoppen der Dienste, Erstellen eines Backups, Herunterladen des Updates über WebDAV (z.B. einer OwnCloud-Instanz) und Neustarten der Dienste. Ein wichtiger Bestandteil ist die automatische E-Mail-Benachrichtigung der Administratoren im Falle eines Fehlers während der Ausführung.

Das Skript führt die folgenden sequentiellen Schritte aus:

  • Vorbereitung: Erzwingt TLS 1.2 für sichere Downloads und überprüft, ob das Skript mit Administratorrechten ausgeführt wird.
  • Download und Entpacken: Lädt die Update-ZIP-Datei über WebDAV/OwnCloud herunter. Hierfür werden die im Konfigurationsabschnitt hinterlegten Anmeldeinformationen verwendet.
  • Dienstverwaltung und Backup: Stoppt die Windows-Dienste von MMI-AMTS/Pharmindex und erstellt ein Backup der aktuellen Live-Datenbankdateien.
  • Aktualisierung: Ersetzt die alten Datenbankdateien im Produktivpfad durch die entpackten neuen Dateien.
  • Abschluss: Startet die Dienste neu und bereinigt den temporären Arbeitsordner.
  • Fehlerbehandlung: Fängt Fehler ab und sendet eine detaillierte E-Mail-Benachrichtigung an die hinterlegten Adressaten, bevor versucht wird, die Dienste wiederherzustellen.

Hinweise zur Ausführung

[Bearbeiten | Quelltext bearbeiten]
⚠️
Warnung
Dieses Skript manipuliert kritische Produktionsdaten und Dienste. Es sollte vor dem Einsatz in einer Produktionsumgebung gründlich in einer Testumgebung geprüft werden.
ℹ️
Hinweis
Aufgrund der Verwendung von `Invoke-WebRequest` und `Send-MailMessage` mit möglicherweise unsicheren Passwörtern im Klartext (`-AsPlainText`) sollte die Ausführungsumgebung (Server) gegen unbefugten Zugriff gesichert sein. Alternativ sollte die Authentifizierung mit gesicherten Anmeldeinformationen (`SecureString`) implementiert werden.

MediaWiki Quellcode (Wikitext)

[Bearbeiten | Quelltext bearbeiten]
<#
.SYNOPSIS
    Automatisiertes Update für Vidal MMI mit Fehler-Benachrichtigung.
.DESCRIPTION
    1. Stoppt die Vidal/AMTS-Dienste.
    2. Erstellt ein Backup der aktuellen Datenbanken.
    3. Lädt das Update über WebDAV (OwnCloud) herunter und entpackt es.
    4. Tauscht die Datenbank-Dateien aus.
    5. Startet die Dienste neu.
    6. Bei Fehlern wird eine E-Mail an die Administratoren gesendet.
.NOTES
    Muss als Administrator ausgeführt werden.
#>

# Erzwingt TLS 1.2 für sichere Downloads (Wichtig für PowerShell 5.0/5.1)
[Net.ServicePointManager]::SecurityProtocol = [Net.ServiceProtocolType]::Tls12

# ---------------------------------------------------------------------------
# KONFIGURATION - BITTE HIER ANPASSEN
# ---------------------------------------------------------------------------

# 1. Dienste & Pfade
$ServiceNames   = @("MMI-AMTS-Service", "MMI-Pharmindex-Server")
$WorkDir        = "C:\Temp\VidalUpdate"      # Temporärer Arbeitsordner
$ProdDataDir    = "C:\Program Files\Vidal\Data"    # Live Datenpfad
$BackupDir      = "C:\VidalBackups"        # Backup-Ziel
$LogFile        = "C:\Logs\VidalUpdate.log"      # Log-Datei Pfad

# 2. OwnCloud (WebDAV) Download-Einstellungen
$OwnCloudUrl    = "https://fileshare.meierhofer.com/remote.php/webdav/Transfer/TechOps/windows/medikation/MMI_Services_MMI_PHARMINDEX_PRO.zip" # Exakter Pfad zur ZIP-Datei
$User           = "gerhardf"
$Pass           = "DHOFX-XCOXF-JPMDR-YEGVL"

# 3. NEU: E-MAIL-EINSTELLUNGEN
$SmtpServer     = "smtp.meierhofer.com"           # SMTP-Server (z.B. mail.gmx.net)
$SmtpPort       = 587              # Port (TLS/STARTTLS: oft 587; SSL: oft 465)
$MailFrom       = "gerhard.foschum@asklepios.com"
$MailTo         = @("gerhard.foschum@meierhofer.com") # Empfänger können mehrere sein
$MailSubject    = "FEHLER: Vidal MMI Update Skript fehlgeschlagen auf $($env:COMPUTERNAME)"


# Wenn der SMTP-Server eine Authentifizierung benötigt (sehr wahrscheinlich):
# $SmtpCreds = New-Object System.Management.Automation.PSCredential($SmtpUser, (Convertto-SecureString $SmtpPass -AsPlainText -Force))
# Oder: $SmtpCreds = $null, wenn keine Auth nötig ist.
$SmtpCreds = $null # Falls keine SMTP-Anmeldung nötig ist

# ---------------------------------------------------------------------------
# HILFSFUNKTIONEN
# ---------------------------------------------------------------------------

function Write-Log {
    Param ([string]$Message, [string]$Level="INFO")
    $TimeStamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $LogLine = "[$TimeStamp] [$Level] $Message"
    Write-Host $LogLine -ForegroundColor ($Level -eq "ERROR" ? "Red" : ($Level -eq "SUCCESS" ? "Green" : "Cyan"))
    Add-Content -Path $LogFile -Value $LogLine -Force
}

# ---------------------------------------------------------------------------
# HAUPTPROGRAMM
# ---------------------------------------------------------------------------

# Administrator-Check
if (-NOT ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
    Write-Warning "Dieses Skript muss als Administrator ausgeführt werden!"
    Break
}

Try {
    Write-Log "--- START UPDATE PROZESS ---"

    # Ordner erstellen falls nicht vorhanden
    if (!(Test-Path $WorkDir)) { New-Item -ItemType Directory -Path $WorkDir | Out-Null }
    if (!(Test-Path $BackupDir)) { New-Item -ItemType Directory -Path $BackupDir | Out-Null }

    # 1. Download des Updates (WebDAV)
    Write-Log "Starte WebDAV Download von OwnCloud..."
    $ZipOutput = Join-Path $WorkDir "Update_$(Get-Date -Format 'yyyyMMdd').zip"
    
    # Credentials Objekt für OwnCloud erstellen
    $SecPass = ConvertTo-SecureString $Pass -AsPlainText -Force
    $CloudCreds = New-Object System.Management.Automation.PSCredential($User, $SecPass)
    
    Invoke-WebRequest -Uri $OwnCloudUrl -Credential $CloudCreds -OutFile $ZipOutput -ErrorAction Stop
    Write-Log "Download erfolgreich."

    # Entpacken
    $ExtractDir = Join-Path $WorkDir "Extracted"
    if (Test-Path $ExtractDir) { Remove-Item $ExtractDir -Recurse -Force }
    Expand-Archive -Path $ZipOutput -DestinationPath $ExtractDir -Force
    Write-Log "Dateien entpackt."

    # 2. Dienste stoppen
    foreach ($Service in $ServiceNames) {
        Write-Log "Stoppe Dienst: $Service"
        Stop-Service -Name $Service -Force -ErrorAction Stop
        $ServiceStatus = Get-Service -Name $Service
        if ($ServiceStatus.Status -ne 'Stopped') { throw "Dienst $Service konnte nicht gestoppt werden." }
    }

    # 3. Backup erstellen
    $DateStamp = Get-Date -Format "yyyy-MM-dd_HHmm"
    $BackupDest = Join-Path $BackupDir $DateStamp
    Write-Log "Erstelle Backup unter: $BackupDest"
    Copy-Item -Path $ProdDataDir -Destination $BackupDest -Recurse
    
    # 4. Dateien ersetzen
    Write-Log "Kopiere neue Datenbank-Dateien..."
    Get-ChildItem -Path $ExtractDir -Recurse -Filter "*.*" | ForEach-Object {
        $DestFile = Join-Path $ProdDataDir $_.Name
        Copy-Item -Path $_.FullName -Destination $DestFile -Force
        Write-Log "Aktualisiert: $($_.Name)"
    }

    # 5. Dienste starten
    foreach ($Service in $ServiceNames) {
        Write-Log "Starte Dienst: $Service"
        Start-Service -Name $Service
    }

    # Aufräumen
    Remove-Item $WorkDir -Recurse -Force
    Write-Log "--- UPDATE ERFOLGREICH ABGESCHLOSSEN ---" "SUCCESS"

} Catch {
    $ErrorMessage = $_.Exception.Message
    $FailedCommand = $_.InvocationInfo.MyCommand.Name
    
    Write-Log "FEHLER: $ErrorMessage" "ERROR"

    # NEU: Fehler-Mail senden
    $MailBody = "Es ist ein Fehler im Vidal MMI Update Skript auf $($env:COMPUTERNAME) aufgetreten.`n"
    $MailBody += "----------------------------------------------------`n"
    $MailBody += "Fehlermeldung: $ErrorMessage`n"
    $MailBody += "Fehler beim Befehl: $FailedCommand`n"
    $MailBody += "Letzter Log-Eintrag: $(Get-Content $LogFile -Tail 1)`n"
    $MailBody += "`n"
    $MailBody += "Bitte prüfen Sie das vollständige Log: $LogFile"

    try {
        # Versucht, TLS zu verwenden, und sendet die Mail
        Send-MailMessage `
            -SmtpServer $SmtpServer `
            -From $MailFrom `
            -To $MailTo `
            -Subject $MailSubject `
            -Body $MailBody `
            -Port $SmtpPort `
            -Credential $SmtpCreds `
            -UseSsl # Standardmäßig wird hier oft SSL/TLS verwendet (z.B. bei Port 587)
            
        Write-Log "Fehler-Mail erfolgreich an '$($MailTo -join ', ')' gesendet."
    } catch {
        Write-Log "KRITISCHER FEHLER: Senden der Fehler-Mail ist fehlgeschlagen: $($_.Exception.Message)" "CRITICAL"
        Write-Log "SMTP-Einstellungen oder Firewall prüfen!" "CRITICAL"
    }
    
    # Versuch, Dienste wieder zu starten
    Write-Log "Versuche Dienste wiederherzustellen..."
    foreach ($Service in $ServiceNames) {
        Start-Service -Name $Service -ErrorAction SilentlyContinue
    }
}

Konfigurationsdetails

[Bearbeiten | Quelltext bearbeiten]

Das Skript erfordert, dass die im folgenden Abschnitt aufgeführten Variablen vor der ersten Ausführung angepasst werden.

Dienste & Pfade

[Bearbeiten | Quelltext bearbeiten]
  • $ServiceNames: Die Namen der Windows-Dienste, die gestoppt und neu gestartet werden müssen. Standardmäßig sind dies die MMI- oder AMTS-Dienste.
  • $WorkDir: Der temporäre Ordner für den Download und das Entpacken der Update-Datei.
  • $ProdDataDir: Der Pfad zu den aktuell verwendeten Vidal MMI Live-Datenbankdateien.
  • $BackupDir: Der Zielpfad für die Backups der aktuellen Datenbanken.
  • $LogFile: Der vollständige Pfad zur Log-Datei, in die alle Skriptaktivitäten geschrieben werden.

OwnCloud/WebDAV Einstellungen

[Bearbeiten | Quelltext bearbeiten]
  • $OwnCloudUrl: Der exakte URL zur Update-ZIP-Datei auf dem OwnCloud-/WebDAV-Server.
  • $User und $Pass: Die Anmeldeinformationen für den Zugriff auf die OwnCloud-Instanz.

E-Mail-Einstellungen (Fehlerbenachrichtigung)

[Bearbeiten | Quelltext bearbeiten]
  • $SmtpServer und $SmtpPort: Die Verbindungsdaten für den SMTP-Server. Port 587 mit TLS/STARTTLS ist am gebräuchlichsten.
  • $MailFrom und $MailTo: Die Absenderadresse und die Liste der Empfängeradressen im Fehlerfall.
  • $MailSubject: Die Betreffzeile der Fehler-E-Mail.
  • $SmtpCreds: Ein PSCredential-Objekt für die SMTP-Authentifizierung. Ist standardmäßig auf $null gesetzt und muss bei Bedarf mit den Zeilen für `$SmtpCreds` in der Konfiguration aktiviert werden.
💡
Tipp
Für eine höhere Sicherheit sollten Passwörter nicht im Klartext im Skript gespeichert werden. Eine bessere Methode ist das Laden eines verschlüsselten `SecureString`-Objekts, das zuvor mit `Export-Clixml` erstellt wurde.