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

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

Azure Automation Windows Hybrid Worker Extension

Folgende Schritte sind für die Einrichtung des Hybrid-Workers durchzuführen.

Im Automation Account

  1. Hybrid worker groups → Create hybrid worker group

  2. Name wählen – für später kopieren

  3. Add machines → VM auswählen

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

  5. Hybrid worker groups → Group → Settings die Credentials auf Custom setzen und die Credentials aus Schritt 4 auswählen

  6. Variables → Add a variable: Folgende Variablen eintragen

    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 → Create a runbook folgende Runbooks erzeugen und den Code aus dem dacota-Connection-Runbook Repository hochladen. Link zum Ablageverzeichnis: unitopFreigabe-Dakota

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

  8. 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

  1. File Share in Azure anlegen
  2. Connect → Choose Drive letter
  3. Show Script → Skript kopieren
  4. Auf der VM: PowerShell ISE als Admin starten
  5. Skript aus Schritt 3 hineinkopieren und ausführen
  6. dacotaag-001 Directory anlegen

Einrichtung ZMV-Statusabfrage

  1. ZMV-Ordner auf dem System anlegen – Z. B. C:\ZMV

  2. Statusabfrage-Dateien in dem Ordner ablegen. Die Dateien werden durch die Consultants bereitgestellt.

    Hinweis

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

Installation dakota.ag

  1. Setup der dakota.ag nach Handbuch ausführen
    Abweichung:
    a. Datenverzeichnis: Pfad zum dacotaag-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. Das Setup starten, indem dakota.ag ausgeführt wird.
  3. Sicherung importieren oder Registrierung nach Handbuch/Kundeninfos durch die Consultants vornehmen.
  4. Software starten und Stammdaten Aktualisierung durchführen.
×
Vergrößertes Bild