Table of Contents

DAKOTA Connection

Die nachfolgende Dokumentation beschreibt die technische Einrichtung der DAKOTA-Connection für das Zahlstellenmeldeverfahren (ZMV) in einer Azure-Umgebung. Sie enthält eine Übersicht der benötigten Azure-Ressourcen (wie Automation Accounts, virtuelle Maschinen und Storage Accounts) sowie Anweisungen zur Konfiguration des Azure Automation Hybrid Workers, der Variablen und Runbooks. Zusätzlich werden die Einrichtung des Azure File Shares, die Statusabfrage und die Installation der dakota.ag-Software erläutert. Ziel ist es, die automatisierte Verarbeitung und den sicheren Datenaustausch im ZMV-Verfahren zu ermöglichen.

Azure Ressourcen

Für den Betrieb der DAKOTA-Connection werden folgende Azure-Ressourcen benötigt. Stellen Sie sicher, dass alle Komponenten mit den angegebenen Mindestanforderungen bereitgestellt werden.

Auflistung
Automation Accounts
System assigned Enabled
Virtual machines
VM-Size (mind.) Standard_B2ls_v2
Image Windows Server 2022 Datacenter: Azure
Edition – x64 Gen2
Enable system assigned managed identity Enabled
Login with Azure AD Enabled
Extensions (Select an extension to install) Azure Automation Windows Hybrid Worker
Storage account
All in default

Einrichtung

Dieser Abschnitt beschreibt die vollständige Konfiguration des Azure Automation Hybrid Workers sowie die Einrichtung der erforderlichen Variablen und Runbooks.

Azure Automation Windows Hybrid Worker Extension

Führen Sie die folgenden Schritte für die Einrichtung des Hybrid-Workers durch.

Im Automation Account

  1. Hybrid Worker Group erstellen: Wählen Sie "Hybrid worker groups" → "Create hybrid worker group".

  2. Name vergeben: Einen Namen wählen – für später kopieren.

  3. VM hinzufügen: Wählen Sie "Add machines" → VM auswählen.

  4. Credentials hinterlegen: Unter "Credentials" → "Add a credential" den VMAdmin als Credential hinterlegen.

  5. Credentials konfigurieren: Wählen Sie "Hybrid worker groups" → "Group" → "Settings", setzen Sie die Credentials auf "Custom" und wählen Sie die Credentials aus Schritt 4 aus.

  6. Variablen eintragen: Wählen Sie "Variables" → "Add a variable" und tragen Sie folgende Variablen ein:

    Name Beschreibung Beispiel
    DakotaProgramDirectory Pfad zum Programmordner C:\Program Files (x86)\ITSG\dakotaag
    DakotaExe Name der dakota.ag-Exe aus dem Programmordner dakota20.exe
    DakotaFilePath Pfad zum Dakota Datei Verzeichnis E:\dakotaag-001
    DakotaMetadataFolder Name des Metadaten-Ordners (eXTra) eXTra
    DakotaDataFolder Name des Metadaten-Ordners (Daten) Daten
    ZMVFolder Pfad zum ZMV-Ordner aus Schritt 2.3 E:\ZMV
    FileShareRootUri Share URL des Azure File Share (Einrichtung 2.2) https://storageAccount.file.core.windows.net/file-share
    FileShareDriveLetter Laufwerksbuchstabe des eingerichteten File-Share auf der VM E

  7. Runbooks erstellen: Wählen Sie "Runbooks" → "Create a runbook" und laden Sie den Code aus dem dakota-Connection-Runbook Repository hoch. Link zum Ablageverzeichnis: unitopFreigabe-Dakota

    • Execute-DakotaDrv
    • Execute-DakotaStandard
    • Sync-DakotaBaseData

  8. Zeitplan einrichten: Wählen Sie "Runbooks" → "[Execute-Runbook Drv/Standard]" → "Schedules" → "Add a schedule".

    • Schedule: Täglicher Run für beide Runbooks. Halbe Stunde zwischen beiden Ausführungen – z.B. 08:00 Uhr und 08:30 Uhr.
    • Parameter and run settings: Hybrid Worker – Hybrid Worker Group auswählen.

Azure File Share

Richten Sie den Azure File Share ein und verbinden Sie ihn mit der virtuellen Maschine:

  1. File Share anlegen: File Share in Azure anlegen.
  2. Laufwerksbuchstaben wählen: Wählen Sie "Connect" → "Choose Drive letter".
  3. Skript kopieren: Wählen Sie "Show Script" und kopieren Sie das Skript.
  4. PowerShell starten: Starten Sie auf der VM PowerShell ISE als Administrator.
  5. Skript ausführen: Fügen Sie das Skript aus Schritt 3 ein und führen Sie es aus.
  6. Verzeichnis anlegen: Legen Sie das Verzeichnis dakotaag-001 an.

Einrichtung ZMV-Statusabfrage

Legen Sie die Statusabfrage-Dateien auf dem System ab, damit die DAKOTA-Connection die ZMV-Statusabfragen korrekt verarbeiten kann:

  1. ZMV-Ordner anlegen: Legen Sie einen ZMV-Ordner auf dem System an – z. B. C:\ZMV.

  2. Statusabfrage-Dateien ablegen: Legen Sie die Statusabfrage-Dateien in dem Ordner ab. Die Dateien werden durch die Consultants bereitgestellt.

    Hinweis

    Der Name der Dateien muss "Statusabfrage_Standard.xml" und "Statusabfrage_DRV.xml" lauten!

Installation dakota.ag

Führen Sie die Installation der dakota.ag-Software gemäß dem Handbuch durch und beachten Sie dabei die folgenden Abweichungen:

  1. Setup ausführen: Führen Sie das Setup der dakota.ag nach Handbuch aus. Dabei folgende Abweichungen beachten:
    • a. Datenverzeichnis: Pfad zum dakotaag-001 Directory im File Share.
    • b. Prüfen → Programm-Pfad: C:\Program Files (x86)\ITSG\dakotaag (wichtig für die Ausführung mittels Runbook).
  2. Software starten: Starten Sie das Setup, indem dakota.ag ausgeführt wird.
  3. Sicherung importieren: Importieren Sie die Sicherung oder nehmen Sie die Registrierung nach Handbuch/Kundeninfos durch die Consultants vor.
  4. Stammdaten aktualisieren: Starten Sie die Software und führen Sie die Stammdaten-Aktualisierung durch.
×
Vergrößertes Bild