DTS
Einleitung
Das Programm DTS\dataTransfer.exe ist für den gesamten Cube-Load zuständig. Es transferiert die Daten von den Applikationen in die Datawarehouse Datenbank, führt die ETL Prozeduren aus und verarbeitet die Cubes.
Einstellungen
Die Einstellungen dataTransfer.exe werden aus dem File CubeSettings.xml gelesen. Das File CubeSettings.xml wird nach der Installation im CubeWizard erstellt.
Parameter
Das Programm DTS\dataTransfer.exe kann mit folgenden Parametern ausgeführt werden.
| Parameter | Beschreibung | Default-Wert | Beispiel | Pflicht |
|---|---|---|---|---|
| /OnDemand | Dieser Parameter dient zur Ermittlung, ob ein User einen manuellen Cube-Load wünscht | N | /CheckExecutionFromNonAdminUserPending Y | Nein |
| /TransferDataFromERP | Dies ist ein technischer Parameter und sollte nicht auf Produktiv-Umgebungen verwendet werden. Ist der Parameter auf N gesetzt, werden die Daten nicht erneut von der Source-DB ins DWH übertragen. | Y | /TransferDataFromERP N | Nein |
| /ExecuteETLs | Dies ist ein technischer Parameter und sollte nicht auf Produktiv-Umgebungen verwendet werden. Ist der Parameter auf N gesetzt, werden die ETL-Prozeduren nicht erneut ausgeführt. | Y | /ExecuteETLs N | Nein |
| /ProcessCubes | Dies ist ein technischer Parameter und sollte nicht auf Produktiv-Umgebungen verwendet werden. Ist der Parameter auf N gesetzt, werden die Cubes nicht erneut verarbeitet | Y | /ProcessCubes N | Nein |
Agent-Jobs
Daily-Load
Deaktivieren Sie die bisherigen Agent-Jobs (bei einem Update) und richten Sie die Jobs wie folgt ein:
Erstellung des Agent-Jobs |
|
Name: Dieser kann beliebig vergeben werden. Owner: Hier empfehlen wir ebenfalls den Admin-Account einzutragen. |
|
Unter Steps, einen neuen Step eintragen: |
|
Step name: Kann beliebig vergeben werden Type: Operatin system (CmdExec) Run as: Hier wählen wir wieder den Admin-Account Command: "C:\Pfad\Zu\dataTransfer.exe" Bsp.: "C:\NexusCube\DTS \dataTransfer.exe" |
|
Unter Schedules -> New einen neuen Zeitplan anlegen: Name: Kann frei vergeben werden Schedule type: Recurring Enabled: YES Occurs: Weekly Monday, Tuesday, Wednesday,Thursday, Friday Occurs once: at 01:05:00 Wir empfehlen eine Uhrzeit nach Mitternacht. Die Anzeige hat das Format (HH:MM:SS) No end date |
|
Cube-Load via Agent-Job schedulen
Damit dies aufgesetzt werden kann, müssen folgende Vorkehrungen getroffen werden:
- Es braucht einen Lokalen-Account auf dem Server (NexusCube // dcag!6246)
- Der Account bekommt Adminrechte auf die ERP-Datenbanken
- Der Account wird für die Credentials und den Proxy verwendet
Der Account muss in der Lage sein, die Cubes auf den Cube-Server zu verarbeiten
Bebilderte Anleitung
User Account auf dem Server anlegen |
|
| |
Admin Account auf dem SSAS hinterlegen |
|
Unter Security -> Add |
|
Account als Login hinterlegen: |
|
Unter "Login name" den neuen User hinzufügen und OK klicken. |
|
| Proxy Account anlegen |
|
Der neue Proxy braucht nur Zugriff auf CmdExec: NexusCube |
|
Load während Bürozeiten
Es wurde der Wunsch geäussert, dass ein User (welcher keine Admin-Rechte hat) eine Cube-Verarbeitung anstossen kann.
Dafür wurde im Cube Browser unter dem Reiter "Konfiguration" Die Funktionalität des Buttons Cube Laden wie folgt geändert: Nun erscheint eine Warnung, wird diese Warnung mit JA bestätigt, so wird auf der DB ein Flag gesetzt und die Ausführung startet nach einer gewissen Zeit.
Dafür braucht es einen zusätzlichen Agent-Job.
Job für die auf Anfrage-Verarbeitung
Voraussetzungen:
- Der Job aus Abschnitt 2 ist bereits aufgesetzt und läuft erfolgreich durch.
Job kopieren: |
|
Folgende Zeichen entfernen: |
|
Suchen Ersetzen Nexus-Cube-Load Nexus-Cube-Load-On-Demand |
|
F5 -> der Job wird angelegt | |
Die Properties des Jobs "Nexus-Cube-Load-On-Demand" öffnen und unter Steps folgende Zeile hinzufügen: /OnDemand Y |
|
Schedules verändern |
|
Logging und Error-Handling
Im Ordner wo sich die dataTransfer.exe befindet wird beim ersten Start ein Ordner "log" angelegt, darin wird für jede Ausführung ein TXT-File mit dem Aktuellen Zeitstempel angelegt:
Auszug aus einem log-File:
2022-06-15 16:01:40 - Start 2022-06-15 16:01:40 - Applikations-Pfad: C:\tmp\cube\DTS\dataTransfer.exe 2022-06-15 16:01:40 - Finanz Server: CHAN-VM-SQL2019 2022-06-15 16:01:40 - Pers Server: CHAN-VM-SQL2019 2022-06-15 16:01:40 - Peps Server: CHAN-VM-SQL2019 2022-06-15 16:01:40 - Heim Server: CHAN-VM-SQL2019 2022-06-15 16:01:40 - Pflege Server: 2022-06-15 16:01:40 - Spitex Server: (local) 2022-06-15 16:01:40 - Tacs Server: 2022-06-15 16:01:40 - DWH Server: (local) 2022-06-15 16:01:40 - Cube-Server: (local) 2022-06-15 16:01:40 - Finanz-Mandanten: 01,10,15,16,18,20,25,30,99,Z1,ZZ 2022-06-15 16:01:40 - Datum-Von: 01.01.2018 |