Vidal MMI Update
Erscheinungsbild
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.
Funktionsweise
[Bearbeiten | Quelltext bearbeiten]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.